Publish LinxCore architecture contracts and policy-driven SPEC lane docs#34
Publish LinxCore architecture contracts and policy-driven SPEC lane docs#34zhoubot wants to merge 1 commit into
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces comprehensive architectural documentation for LinxCore v0.56, including external interface contracts, microarchitecture specifications, a module catalog, a pipeline stage catalog, and a verification matrix mapping architectural intent to validation gates. Additionally, it updates the SPEC benchmark test scripts to dynamically resolve the bring-up subset from the policy manifest instead of using hardcoded lists. Feedback on the documentation highlights a hardcoded user-specific absolute path in the overview document that should be replaced with a generic placeholder for portability.
| - Standalone trees such as `/Users/zhoubot/LinxCore` are development mirrors, | ||
| not contract authority. |
There was a problem hiding this comment.
The document contains a hardcoded absolute path specific to a user (/Users/zhoubot/LinxCore). Hardcoded user-specific paths should be avoided in shared documentation to ensure portability and maintain privacy. Consider using a generic placeholder or referring to local development clones abstractly.
| - Standalone trees such as `/Users/zhoubot/LinxCore` are development mirrors, | |
| not contract authority. | |
| - Standalone trees (e.g., local development clones) are development mirrors, | |
| not contract authority. |
The old PR branch was pinned before the Janus documentation wave landed, so it could no longer merge cleanly and still referenced stale v0.4 contract wording and obsolete SPEC manifest keys. Rebuilding it on top of current main keeps the surviving contract clarifications while dropping the now-superseded history. Constraint: The branch must be rebuilt on top of current main rather than replayed conflict-by-conflict from a stale base Rejected: Preserve the original stale branch history | it obscures the surviving diff and keeps the PR conflict-heavy Confidence: high Scope-risk: narrow Reversibility: clean Directive: Keep architecture contract version bumps and SPEC policy-key changes synchronized across overview, interface, stage-catalog, and wrapper scripts Tested: git diff --check; bash -n tests/test_specint_stage_a_xcheck.sh tests/test_specint_full_xcheck_nightly.sh Not-tested: full architecture lint, mkdocs publish, SPEC xcheck execution
1b9213a to
c839551
Compare
Summary
Testing
git diff --checkNot tested