docs: canonical-substrate pointer in CLAUDE.md + stale-section status headers in QUEUE-DRIVEN-COGNITION / UNIVERSAL-LEARNING / UNIVERSAL-SENSORY#1329
Merged
Conversation
…tatus headers Five-file batch. Each touched file gets a small status block at the top pointing readers at the canonical truth docs (CBAR-SUBSTRATE, GENOME-FOUNDRY-SENTINEL, ALPHA-GAP). Body content of each doc is UNCHANGED — only the framing is updated so a reader knows which parts are still load-bearing and which parts have been superseded by Rust substrate work. CLAUDE.md: - New "Canonical Substrate Docs (read first)" section at the top of the file, before the existing FORGE TEMPLATE ARCHITECTURE section. Names CBAR-SUBSTRATE-ARCHITECTURE.md, GENOME-FOUNDRY-SENTINEL.md, and ALPHA-GAP-ANALYSIS.md as precedence-winning truth, with one line each on what they own. States the precedence rule: this file is project guidance; canonical docs win on substrate-shaped questions (concurrency, scheduling, memory, pressure, telemetry, artifact handles). QUEUE-DRIVEN-COGNITION.md: - Status @ 2026-05-16 block names the principle as still load-bearing (queue item carries its own RAG contract; persona composes generically; substrate stays domain-agnostic) and the TS-shaped implementation as superseded by RuntimeFrame / CognitionTurnFrame (CBAR) + DemandAlignedRecall (GENOME-FOUNDRY- SENTINEL). UNIVERSAL-LEARNING-ARCHITECTURE.md: - Status block names the insight as still load-bearing (cognition trace is universal training signal; training + memory + action all consume the same generic output) and the TS-shaped implementation as superseded by sentinel-AI as profile-guided optimizer + foundry as JIT, both writing to the same genome pool with provenance. Reframes "skill marketplace" as the sharing protocol with eventual consistency. UNIVERSAL-SENSORY-ARCHITECTURE.md: - Status block names the principle as still load-bearing (every model gets every modality through universal sensory adapters; no model is structurally blind/deaf/mute) and the TS-shaped implementation as superseded: sensory adapters are RuntimeModules with typed subscriptions; modality models are ImportedArtifacts the foundry adapts from SOTA; composition is dynamic and demand-aligned. None of the docs are deleted or rewritten. The bodies still read clearly as the architectural intent they originally captured. The status blocks just pin the reader to the current canonical Rust location for the implementation.
joelteply
pushed a commit
that referenced
this pull request
May 16, 2026
…ning; navigate to MODULE-CATALOG queue Second refresh of ALPHA-GAP Immediate Next Actions to reflect work landed since #1316 merged. Six items closed; navigation into MODULE-CATALOG queue made explicit. Closed: #6 contract widening (#1341), #8 GRID-INFERENCE-ROUTING PR-1 (#1315), CBAR-PIECE-5 end-to-end (#1331/#1333/#1335/#1338), PIECE-8 inference-grpc hardcoded-clamps (#1340), doc family architecture surface (#1324/#1327/#1332/#1336/#1337 open; #1316/#1317/#1320/#1329 merged). Item #9 reorganized to point at MODULE-CATALOG's 'Next Modules To Build' queue (audit-recorder → threat-detector → working-set-manager → demand-aligned-recall → substrate-governor). Adds closeout summary section listing what's done, what's open (5 architecture-doc PRs ready for review + 2 airc PRs), and what's queued (5 modules with dependency state + LoC + acceptance criteria in MODULE-CATALOG). Doc-driven development cycle is working: doc spec → implementing agent picks up → ships PR → next spec referenced.
joelteply
added a commit
that referenced
this pull request
May 16, 2026
…ning; navigate to MODULE-CATALOG queue (#1342) Second refresh of ALPHA-GAP Immediate Next Actions to reflect work landed since #1316 merged. Six items closed; navigation into MODULE-CATALOG queue made explicit. Closed: #6 contract widening (#1341), #8 GRID-INFERENCE-ROUTING PR-1 (#1315), CBAR-PIECE-5 end-to-end (#1331/#1333/#1335/#1338), PIECE-8 inference-grpc hardcoded-clamps (#1340), doc family architecture surface (#1324/#1327/#1332/#1336/#1337 open; #1316/#1317/#1320/#1329 merged). Item #9 reorganized to point at MODULE-CATALOG's 'Next Modules To Build' queue (audit-recorder → threat-detector → working-set-manager → demand-aligned-recall → substrate-governor). Adds closeout summary section listing what's done, what's open (5 architecture-doc PRs ready for review + 2 airc PRs), and what's queued (5 modules with dependency state + LoC + acceptance criteria in MODULE-CATALOG). Doc-driven development cycle is working: doc spec → implementing agent picks up → ships PR → next spec referenced. Co-authored-by: Test <test@test.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.
What
Four-file batch. Each touched file gets a small status block at the top pointing readers at the canonical truth docs (CBAR-SUBSTRATE, GENOME-FOUNDRY-SENTINEL, ALPHA-GAP). Body content of each doc is UNCHANGED — only the framing is updated so a reader knows which parts are still load-bearing and which parts have been superseded by Rust substrate work.
Why
The vision-side docs (QUEUE-DRIVEN-COGNITION, UNIVERSAL-LEARNING, UNIVERSAL-SENSORY) and the project-level CLAUDE.md were written before the canonical Rust substrate landed. Their principles are still load-bearing; their implementation sketches are now stale relative to CBAR-SUBSTRATE + GENOME-FOUNDRY-SENTINEL. Without status pointers, a reader picking these up first gets a TS-shaped mental model that the codebase has moved past.
Changes
`CLAUDE.md`
New "Canonical Substrate Docs (read first)" section at the top of the file, before the existing FORGE TEMPLATE ARCHITECTURE section. Names the three precedence-winning truth docs with one-line summaries and states the rule: this file is project guidance; canonical docs win on substrate-shaped questions.
`docs/QUEUE-DRIVEN-COGNITION.md`
Status block names the principle as still load-bearing (queue item carries its own RAG contract; persona composes generically; substrate stays domain-agnostic) and the TS-shaped implementation (`BaseQueueItem`, `PersonaUser.consolidate`) as superseded by `RuntimeFrame` / `CognitionTurnFrame` (CBAR) + `DemandAlignedRecall` (GENOME-FOUNDRY-SENTINEL).
`docs/UNIVERSAL-LEARNING-ARCHITECTURE.md`
Status block names the insight as still load-bearing (cognition trace is universal training signal; training + memory + action all consume the same generic output) and the TS-shaped implementation as superseded by sentinel-AI as profile-guided optimizer + foundry as JIT, both writing to the same genome pool with provenance. Reframes "skill marketplace" as the sharing protocol with eventual consistency.
`docs/UNIVERSAL-SENSORY-ARCHITECTURE.md`
Status block names the principle as still load-bearing (every model gets every modality through universal sensory adapters; no model is structurally blind/deaf/mute) and the TS-shaped implementation as superseded: sensory adapters are `RuntimeModule`s with typed subscriptions; modality models are `ImportedArtifact`s the foundry adapts from SOTA; composition is dynamic and demand-aligned.
Not Touched
Validation
Companion PRs in flight
This PR closes the doc-track loop: every supporting doc now points at the canonical truth, and the canonical truth points back at the supporting docs via See Also and Document Map.