Skip to content

docs: canonical-substrate pointer in CLAUDE.md + stale-section status headers in QUEUE-DRIVEN-COGNITION / UNIVERSAL-LEARNING / UNIVERSAL-SENSORY#1329

Merged
joelteply merged 1 commit into
canaryfrom
joel/docs-stale-deprecation
May 16, 2026
Merged

docs: canonical-substrate pointer in CLAUDE.md + stale-section status headers in QUEUE-DRIVEN-COGNITION / UNIVERSAL-LEARNING / UNIVERSAL-SENSORY#1329
joelteply merged 1 commit into
canaryfrom
joel/docs-stale-deprecation

Conversation

@joelteply
Copy link
Copy Markdown
Contributor

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

  • `docs/UNIVERSAL-COGNITION-ARCHITECTURE.md` — wasn't on the deprecation audit target list; will check separately.
  • `docs/UNIVERSAL-PRIMITIVES.md` — Commands.execute / Events.subscribe are still load-bearing as-is; no status pointer needed.

Validation

  • Local precommit passed (TypeScript compile clean; no Rust/TS files staged).
  • All four files render with the new status blocks at the top.
  • Cross-links resolved against actual file paths.

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.

…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 joelteply merged commit 9af0105 into canary May 16, 2026
2 checks passed
@joelteply joelteply deleted the joel/docs-stale-deprecation branch May 16, 2026 21:19
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant