Docs & site architecture: RFC process, FAQ, concepts/vision, breadcru…#7
Merged
Merged
Conversation
…mbs, neutral runtime Documentation and static-site changes only. The normative specification, schema, and conformance corpus are unchanged, so there is no new spec version. - Rename the change-proposal process JEP -> RFC (rfcs/0000-rfc-process.md) and seed draft RFCs 0001-0005 (pack manifest, Judgment Graph, evidence reference, planner interface, pack discovery). Update README/GOVERNANCE/CONTRIBUTING/PR template; record the rename in CHANGELOG (JEP kept only as history). - Add FAQ.md (47 entries), including a "Skills, tools, and agent integration" section whose "Skills and Tools" subsection answers the SKILL.md / codified- skill objection honestly, with a static SVG integration diagram. - Add docs/architecture/vision.md (non-normative layered picture) with three static SVG diagrams, and docs/concepts/comparison.md (vs DMN/OPA/BPMN/rules). - Site information architecture: a Concepts hub, breadcrumbs on every page, footer "Project & docs"/"Concepts" hubs, nav compaction, and a reachability fix (no orphaned pages) guarded by a standing test. - Implementations: replace the Protoss CLI listing with the vendor-neutral judgment-pack reference runtime (which inherited the CLI); remove the Protoss-branded on-site CLI page. Every page is now vendor-neutral (Protoss survives only in the changelog as history). - All diagrams render as static SVG to preserve the strict script-src 'none'. - Tests: 45 passing (added breadcrumb/orphan-guard, concepts-hub, FAQ-skills, implementations-runtime, and framing invariants). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
…mbs, neutral runtime
Documentation and static-site changes only. The normative specification, schema, and conformance corpus are unchanged, so there is no new spec version.
Summary
Describe the problem and the proposed change.
Interoperability evidence
Explain why this belongs in the shared specification rather than an extension, profile, or product.
Compatibility
Describe reader, writer, semantic, and migration impact.
Conformance
List positive, negative, boundary, or adversarial cases added or changed.
Security and privacy
Describe relevant risks, or explain why there are none.
Checklist