Context
Operator finding (2026-06-13): AGENTS_STARTUP.md is "vastly outdated, wrong references, wrong content." V-B-A at filing confirms three structural staleness classes (receipts below). This is repo-wide boot substrate consumed by every harness's cold session — drift here actively mis-grounds new sessions.
The Problem — V-B-A'd staleness receipts
- Wrong organ inventory: claims "four MCP servers" (
knowledge-base, memory-core, github-workflow, chrome-devtools) — neural-link has ZERO mentions in the file, and chrome-devtools is not part of the current canonical neo server set. The boot document mis-lists the organism's own organs.
- §0 mirror drift: the file mirrors "eight rules" while the live turn-loaded substrate carries NINE critical gates (the client-names gate is absent; gate 7's suppression-fallback nuance likewise). The mirror covenant ("updates here MUST also land in AGENTS.md §0 and vice versa") failed in exactly the direction the #10736 AC11 note feared.
- Dead references: the
AGENTS.md §15–§21 numeric pointers reference a section scheme that no longer exists (current substrate uses named anchors: §verify_before_assert, §knowledge_base_primary_truth, etc.). Step-1 boot-read paths and the Strategic Workflows pointer need re-verification against the current tree.
Prior art: #10586 (a single silently-false boot claim, fixed) — this is the same failure class at file scale.
The Architectural Reality
- Boot substrate across ALL harnesses (Claude Code via symlink wiring, Codex, Antigravity) — changes need
turn-memory-pre-flight discipline and cross-harness thinking.
- The #10736 AC11 decision is due: the §0 mirror exists "until active-harness boot transcripts verify AGENTS.md loads reliably before AGENTS_STARTUP execution." That verification condition should be evaluated NOW — if met, replace the mirror with a short canonical pointer (kills the drift class permanently); if not met, fix the mirror AND record why it stays.
- The
.agents/workflows/ convention (sibling leaf) may absorb some of this file's per-mission content — the overhaul should leave AGENTS_STARTUP scoped to: one-time boot sequence + Memory Core healthcheck + worktree bootstrap mechanics, exactly as its own closing note already claims.
The Fix
One PR: (1) correct the MCP server inventory (+neural-link, current canonical set, source it from a single authority — ADR/config — rather than hand-listing); (2) resolve the §0 mirror per the #10736 AC11 evaluation (pointer-replacement preferred if the condition holds); (3) fix or remove the dead §-references (point at named anchors); (4) re-verify every boot-read path (Step 1 docs, tree.json claim, StrategicWorkflows) against the live tree; (5) prune content the skills/workflows substrate now owns.
Acceptance Criteria
Out of Scope
- The
.agents/workflows/agent-harness.md creation (sibling leaf under Epic #13012).
- AGENTS.md / CLAUDE.md changes beyond what the mirror decision strictly requires.
Related
- Operator finding provenance: 2026-06-13 session-end review. Prior art: #10586, #10736 (AC11 mirror condition), #10782/#10784 (last STARTUP retrofit wave).
- Sibling: the workflows-convention leaf (filed alongside).
Origin Session ID: c4caff26-d818-486b-8663-19b85ac3cc11
Retrieval Hint: "AGENTS_STARTUP outdated overhaul mirror drift nine gates neural-link missing boot substrate"
Context
Operator finding (2026-06-13):
AGENTS_STARTUP.mdis "vastly outdated, wrong references, wrong content." V-B-A at filing confirms three structural staleness classes (receipts below). This is repo-wide boot substrate consumed by every harness's cold session — drift here actively mis-grounds new sessions.The Problem — V-B-A'd staleness receipts
knowledge-base,memory-core,github-workflow,chrome-devtools) —neural-linkhas ZERO mentions in the file, andchrome-devtoolsis not part of the current canonical neo server set. The boot document mis-lists the organism's own organs.AGENTS.md §15–§21numeric pointers reference a section scheme that no longer exists (current substrate uses named anchors: §verify_before_assert, §knowledge_base_primary_truth, etc.). Step-1 boot-read paths and the Strategic Workflows pointer need re-verification against the current tree.Prior art: #10586 (a single silently-false boot claim, fixed) — this is the same failure class at file scale.
The Architectural Reality
turn-memory-pre-flightdiscipline and cross-harness thinking..agents/workflows/convention (sibling leaf) may absorb some of this file's per-mission content — the overhaul should leave AGENTS_STARTUP scoped to: one-time boot sequence + Memory Core healthcheck + worktree bootstrap mechanics, exactly as its own closing note already claims.The Fix
One PR: (1) correct the MCP server inventory (+neural-link, current canonical set, source it from a single authority — ADR/config — rather than hand-listing); (2) resolve the §0 mirror per the #10736 AC11 evaluation (pointer-replacement preferred if the condition holds); (3) fix or remove the dead §-references (point at named anchors); (4) re-verify every boot-read path (Step 1 docs, tree.json claim, StrategicWorkflows) against the live tree; (5) prune content the skills/workflows substrate now owns.
Acceptance Criteria
turn-memory-pre-flightpass documented in the PR (substrate-mutation gate).Out of Scope
.agents/workflows/agent-harness.mdcreation (sibling leaf under Epic #13012).Related
Origin Session ID: c4caff26-d818-486b-8663-19b85ac3cc11 Retrieval Hint: "AGENTS_STARTUP outdated overhaul mirror drift nine gates neural-link missing boot substrate"