Namespec 2.0 (ADR-0008): naming-constitution supersession and full cascade - #3
Merged
Conversation
…0018); design-system recovery gated on owner (PDR-0019); pacing warning fired Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sarpadia→Urborg, Tamiyo→Ugin, Narset→Aurelia, Tezzeret→Urabrask, Urabrask→Jin-Gitaxias, Augustin→Isperia, Kasmina→Wrenn, Oona→Tamiyo; mechanics, contracts and all 45 invariants unchanged. Constitution rewritten with the synthesis-core/governance-cage framing and the new canonical sentence; domain chapters renamed collision-safe; Urabrask dual compilation mode made explicit; appendices, root docs, product workspace (PDR-0020) cascaded; ADR-0001..0007 carry a namespec banner; Esper-era references in ops/migration.md kept era-correct names. model.dsl and mermaid sources renamed and re-rendered (dimension gate green); stage.py drift gate learns the underscore/hyphen convention; wiki builds strict (54 pages, 3888 links resolve) and the site linkcheck + html-validate gates pass. Open tracker issues retitled. Reconciled atop the concurrent session-9 checkpoint (ead4591): PDR renumbered 0018→0020, resume brief carries a dated namespec note. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012qVBdHQtjsNsUbfMHSdyeF
…-0020); burn-down flat at 38, pacing warning stands; publish gated on owner Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012qVBdHQtjsNsUbfMHSdyeF
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
There was a problem hiding this comment.
Pull request overview
This PR implements the Namespec 2.0 (ADR-0008) rename cascade across Simic’s design authority and all derived artifacts (wiki staging, Structurizr/mermaid diagrams, static site, and product workspace), while keeping mechanics/contracts/invariants unchanged. It ensures the canonical codenames, diagrams, and generated surfaces consistently reflect the new naming constitution.
Changes:
- Adopt Namespec 2.0 via ADR-0008 and cascade the rename across design chapters, domain specs, appendices, and the public site/wiki outputs.
- Update wiki staging and diagram tooling to handle new hyphenated proper names (notably “Jin-Gitaxias”) and underscore↔hyphen normalization between DSL identifiers and doc paths.
- Record product-tier consequences (PDR-0020) and refresh product workspace checkpoints/metrics/roadmap text to match the new constitution.
Reviewed changes
Copilot reviewed 69 out of 75 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| tools/wiki/stage.py | Updates wiki staging/title derivation and DSL/domain consistency checks for Namespec 2.0 (incl. hyphenated proper names). |
| tools/diagrams/observation-loop.mmd | Renames loop actors to Namespec 2.0 in the mermaid source. |
| tools/diagrams/core-loop.mmd | Renames end-to-end core loop actors to Namespec 2.0 in the mermaid source. |
| tools/diagrams/assurance-loop.mmd | Renames assurance/adjudication loop actors to Namespec 2.0 in the mermaid source. |
| site/lineage.html | Updates published site copy for Namespec 2.0 actor names. |
| site/index.html | Updates published landing page names and diagram accessibility text for Namespec 2.0. |
| site/architecture.html | Updates published architecture page names, tables, and diagram a11y text for Namespec 2.0. |
| site/404.html | Updates footer Namespec reference to 2.0. |
| README.md | Updates top-level repo narrative and canonical sentence to Namespec 2.0. |
| docs/product/vision.md | Updates product vision references to Namespec 2.0. |
| docs/product/roadmap.md | Refreshes roadmap header and replaces Namespec 1.0 names with 2.0 equivalents. |
| docs/product/metrics.md | Updates checkpoint stamp and replaces Namespec 1.0 names with 2.0 equivalents. |
| docs/product/decisions/0020-namespec-2.0-adoption.md | Adds PDR-0020 recording the Namespec 2.0 adoption and cascade impact at product tier. |
| docs/product/decisions/0019-design-system-recovery-path.md | Adds PDR-0019 proposing an owner-gated recovery path for the design system project/export gap. |
| docs/product/decisions/0018-static-content-review-and-hardening.md | Adds PDR-0018 documenting static-site/wiki review hardening and deploy gates. |
| docs/product/current-state.md | Updates current-state checkpoint and notes Namespec 2.0 branch/cascade status. |
| docs/product/commissioning/README.md | Updates commissioning doc references from Tezzeret tests to Urabrask tests per Namespec 2.0. |
| docs/design/TEMPLATE-lld.md | Updates LLD template example sentence to Isperia naming. |
| docs/design/programme/risks-and-open-decisions.md | Renames risks/open-decisions references to Namespec 2.0 actors and contract boundaries. |
| docs/design/programme/phases.md | Renames phase plan references to Namespec 2.0 actors and adjusts phase headings accordingly. |
| docs/design/programme/learning.md | Renames learning responsibilities sections to Namespec 2.0 actors. |
| docs/design/programme/evaluation.md | Renames evaluation/test sections to Namespec 2.0 actors and boundaries. |
| docs/design/programme/curriculum.md | Renames curriculum scaffolds/owners and references to Namespec 2.0 actors. |
| docs/design/ops/repo-structure.md | Updates target package layout and dependency examples for Namespec 2.0. |
| docs/design/ops/observability.md | Renames observability/witness responsibilities to Tamiyo (Namespec 2.0) and updates referenced actors. |
| docs/design/ops/migration.md | Updates migration guidance text to Namespec 2.0 roles while keeping era-correct notes. |
| docs/design/domains/wrenn.md | Renames embodiment domain chapter to Wrenn and updates invariants/smells accordingly. |
| docs/design/domains/urborg.md | Renames historical infrastructure chapter to Urborg (incl. §15 data model references) and updates role mentions. |
| docs/design/domains/urabrask.md | Recasts Urabrask as compiler (Namespec 2.0) and documents dual compilation mode. |
| docs/design/domains/ugin.md | Adds the Ugin strategic-controller domain chapter (Namespec 2.0). |
| docs/design/domains/tezzeret.md | Removes Tezzeret domain chapter (superseded by Urabrask compiler role). |
| docs/design/domains/tamiyo.md | Recasts Tamiyo as witness/operator surface (Namespec 2.0) and updates invariants/smells. |
| docs/design/domains/README.md | Updates the domains index to the Namespec 2.0 domain list and links. |
| docs/design/domains/oona.md | Removes Oona domain chapter (superseded by Tamiyo witness role). |
| docs/design/domains/nissa.md | Updates Nissa domain chapter recipients/roles to Namespec 2.0 (Aurelia/Ugin). |
| docs/design/domains/momir.md | Updates Momir domain chapter references to Urborg/Aurelia. |
| docs/design/domains/leyline.md | Updates Leyline domain chapter references to Ugin/Wrenn/Aurelia/Isperia. |
| docs/design/domains/jin-gitaxias.md | Adds Jin-Gitaxias QA domain chapter (Namespec 2.0). |
| docs/design/domains/isperia.md | Renames judge domain chapter to Isperia and updates QA/judgement references accordingly. |
| docs/design/domains/emrakul.md | Updates Emrakul domain chapter inputs/constraints to Namespec 2.0 counterparts. |
| docs/design/domains/elesh.md | Updates Elesh domain chapter runtime-certification reference to Jin-Gitaxias. |
| docs/design/domains/aurelia.md | Renames tactical controller domain chapter to Aurelia and updates invariants accordingly. |
| docs/design/assets/model.dsl | Cascades Namespec 2.0 into the Structurizr model (containers, relationships, and views). |
| docs/design/appendices/scaffold-pattern.md | Updates scaffold pattern appendix to Namespec 2.0 owners/roles. |
| docs/design/appendices/newsroom.md | Updates newsroom appendix mapping and routing rule to Namespec 2.0 actors. |
| docs/design/appendices/good-bad-sentences.md | Updates example sentences to Namespec 2.0 actors. |
| docs/design/appendices/glossary.md | Updates glossary table entries to Namespec 2.0. |
| docs/design/appendices/caveman-mode.md | Updates caveman-mode analogy roles to Namespec 2.0 actors. |
| docs/design/07-counterfactual-engine.md | Updates counterfactual engine chapter references to Jin-Gitaxias/Isperia/Urborg/Ugin/Aurelia. |
| docs/design/06-growth-model.md | Updates growth model chapter references to Urabrask compiler + Jin-Gitaxias QA + Isperia judge + Urborg store. |
| docs/design/05-leyline-contracts.md | Updates Leyline contract chapter actor references and field names (e.g. aurelia/ugin). |
| docs/design/03-principles.md | Updates principles chapter authority-separation examples to Namespec 2.0 actors. |
| docs/design/01-claim.md | Updates executive claim chapter (core loop narrative and canonical sentence) to Namespec 2.0. |
| docs/design/00-INDEX.md | Updates index reading paths and concordance references for Urborg/Isperia/Jin-Gitaxias. |
| docs/adr/README.md | Updates ADR tiering description to reference Namespec 2.0. |
| docs/adr/0008-namespec-2.0.md | Adds ADR-0008 defining Namespec 2.0 concordance, sentence, and interpretation rule. |
| docs/adr/0007-wiki-projection-regime.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0006-ban-silent-defaulting-telemetry-access.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0005-retention-hysteresis-schmitt-trigger.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0004-lexicographic-admission.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0003-project-name-simic-clean-seam.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0002-information-management-regime.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| docs/adr/0001-hld-decomposition-structure.md | Adds Namespec note banner pointing to ADR-0008 for pre-2.0 record interpretation. |
| ARCHITECTURE.md | Updates the repo-level architecture summary and mermaid pipeline diagram to Namespec 2.0. |
| AGENTS.md | Updates contributor/agent guidance to Namespec 2.0, including canonical sentence and domain list. |
| .claude/skills/simic-design/readme.md | Updates the design-system skill readme’s Namespec references to 2.0. |
| .claude/skills/simic-design/_ds_bundle.js | Updates embedded canonical-sentence string to Namespec 2.0. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
16
to
+21
| workspace "Simic" "Counterfactual Generative Morphogenesis — the fourteen-domain architecture (HLD v4.1, Namespec 1.0)" { | ||
|
|
||
| !impliedRelationships false | ||
|
|
||
| model { | ||
| operator = person "Operator" "Reads the account through Oona; owns escalations. Never a control-path participant." | ||
| operator = person "Operator" "Reads the account through Tamiyo; owns escalations. Never a control-path participant." |
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.
Owner-directed (2026-08-09, session goal): supersede Namespec 1.0 with Namespec 2.0 across the design authority and every derived artifact.
Merging publishes the renamed site and wiki at simic.foundryside.dev.
🤖 Generated with Claude Code
https://claude.ai/code/session_012qVBdHQtjsNsUbfMHSdyeF