R75 PLAN-RED — Step 3 Packet
Authority: audit docs/audits/r75-plan-red-audit.md (commit eb15dd31) defines the starting state; contract docs/contracts/r75-plan-red-contract.md (commit ed470fc5) defines the end-state invariants. This packet is the execution script that takes the worktree from the former to the latter.
§0. Execution order
Four sub-phases, each a single commit on feature/r75-plan-red-execution: 4A — author missing glue → 4B — ABSORB moves + content reconciliation → 4C — KILL deletions → 4D — nav + root alignment. Strict linear order. No sub-phase may begin until the prior sub-phase’s commit is on the branch and its gate check has passed. Parent T2 PM dispatches one sub-agent per sub-phase and verifies the gate before dispatching the next.
§1. Sub-phase 4A — Author missing Phase 0 glue files
Sub-agent 4A creates every file below. All paths relative to the worktree root (E:/AMS/.worktrees/claude/r75-plan-red/). Parent dirs are created with mkdir -p where missing (notably docs/3-world/physics/laws/ and docs/3-world/physics/enforcement/ — both do not yet exist).
Content rule (contract §2): every file describes Phase 0 Colibri or the stable target shape. No unlabeled “78 tables”, “484 tools”, “data/ams.db as live write target”, “11 middleware”, “AMS_*” env vars, or bulk env-var counts. Permitted phrasings: data/colibri.db (Phase 0 target), exactly 19 tools (Phase 0 per ADR-004), 5-stage α chain, 28 Phase 0 sub-tasks. Any donor-AMS number may appear only inside a labeled HERITAGE block (and these files should not need such blocks at all).
Source-material rule: the concept files under docs/concepts/*.md are the primary donor of substance — the new file restates the concept’s behavior for Phase 0, trimmed to what Phase 0 actually delivers. docs/reference/extractions/*.md files are the algorithmic archive. docs/spec/sNN-*.md files carry normative rules. All three sources are READ-ONLY during 4A (none are modified). Concept files will be deleted in 4C — so any prose imported from them must be stabilized into the new doc, not linked back.
Files to create
docs/3-world/execution/task-pipeline.md— β Task Pipeline (8-state FSM, claim protocol, retry ladder). ~180 lines. Sources:spec/s15-gsd-contract.md,reference/extractions/beta-task-pipeline-extraction.md,concepts/β-task-pipeline.md.docs/3-world/execution/skill-registry.md— ε SKILL.md contract, discovery, loading, Phase 0 surface. ~140 lines. Sources:spec/s06-skill-registry.md,reference/extractions/epsilon-skill-registry-extraction.md,concepts/ε-skill-registry.md.docs/3-world/execution/decision-trail.md— ζ hash-chained append-only thought store. ~150 lines. Sources:spec/s03-decision-trail.md(+s02),reference/extractions/zeta-decision-trail-extraction.md,concepts/ζ-decision-trail.md.docs/3-world/physics/laws/proof-store.md— η Merkle proof store (leaves, internal nodes, root, anchoring). ~170 lines. Sources:spec/s14-integrity-monitor.md(+s04if present),reference/extractions/eta-proof-store-extraction.md,concepts/η-proof-store.md.docs/3-world/physics/laws/consensus.md— θ BFT quorum model, tolerance, timing. ~130 lines. Sources:spec/s11-consensus.md(or the closest spec),reference/extractions/theta-consensus-extraction.md,concepts/θ-consensus.md, ADR-003.docs/3-world/physics/laws/state-fork.md— ι state-fork protocol, replay, reconciliation. ~120 lines. Sources:spec/s13-state-fork.md,reference/extractions/iota-state-fork-extraction.md,concepts/ι-state-fork.md.docs/3-world/physics/laws/rule-engine.md— κ DSL, integer math, evaluation model. ~140 lines. Sources:spec/s12-rule-engine-dsl.md,reference/extractions/kappa-rule-engine-extraction.md,concepts/κ-rule-engine.md.docs/3-world/physics/enforcement/integrity.md— μ three integrity detectors, alarm surface. ~120 lines. Sources:spec/s14-integrity-monitor.md,reference/extractions/mu-integrity-monitor-extraction.md,concepts/μ-integrity-monitor.md.docs/3-world/physics/enforcement/governance.md— π voting, time-lock, constitutional amendment. ~130 lines. Sources:spec/s19-governance.md,reference/extractions/pi-governance-extraction.md,concepts/π-governance.md.docs/3-world/social/identity.md— ξ soul vector, Ed25519 keys, tier binding. ~140 lines. Sources:spec/s18-identity.md,reference/extractions/xi-identity-extraction.md,concepts/ξ-identity.md.docs/3-world/social/reputation.md— λ five domains, decay model. ~130 lines. Sources:spec/s10-reputation.md(or closest),reference/extractions/lambda-reputation-extraction.md,concepts/λ-reputation.md.docs/3-world/social/llm.md— δ model scoring, fallback, Phase 0 Claude-only posture, Phase 1.5 multi-model. ~120 lines. Sources:spec/s09-model-router.md(or closest),reference/extractions/delta-model-router-extraction.md,concepts/δ-model-router.md, ADR-005.docs/5-time/round.md— round definition, planning phase A, sealing phase B, sigma orchestrator contract pointer. ~110 lines. Sources:docs/pipeline-definition.md(ABSORB source, READ-ONLY during 4A — deleted in 4C),docs/agents/sigma-orchestrator.md,docs/agents/pm-contract.md.docs/5-time/task.md— task zoom level: status FSM, claim, 5-step chain placement, writeback. ~120 lines. Sources:docs/pipeline-definition.md,docs/agents/executor-contract.md,docs/agents/writeback-protocol.md,docs/concepts/β-task-pipeline.md.docs/2-plugin/modes.md— γ server modes (mcp, cli, watch, maintenance), shutdown behavior. ~120 lines. Sources:spec/s07-server-lifecycle.md(or closest),reference/extractions/gamma-server-lifecycle-extraction.md,concepts/γ-server-lifecycle.md.docs/0-mutate/promises.md— six core system promises (mutation atomicity, append-only ζ, proof coverage, etc.) restated for Phase 0. ~100 lines. Sources:docs/promise.md(ABSORB source, deleted in 4C),docs/colibri-system.md.
Tally: 16 new files, est. ~2,120 lines.
4A commit + gate
Commit message (single commit for all 16 files):
feat(docs): R75 sub-phase 4A — author missing Phase 0 glue files for World Schema v3
Gate check (sub-agent runs before reporting done):
git status→ clean working tree after commit.- For each of the 16 target paths,
ls -l <path>returns a file with>0bytes. grep -rnE "78 tables|484 tools|AMS_[A-Z_]+|11 middleware|6-layer middleware" docs/0-mutate/promises.md docs/2-plugin/modes.md docs/3-world/ docs/5-time/round.md docs/5-time/task.mdreturns zero matches — or any match is wrapped in azone: heritagefrontmatter block (which none of these new files should have).grep -rn "data/ams.db" <the 16 new files>returns zero matches. (Phase 0 canon target isdata/colibri.db;data/ams.dbbelongs to heritage language in pre-existing docs only.)- No new file contains a markdown link to
concepts/,how-it-works/,architecture/component-map.md,architecture/system-overview.md,architecture/gsd-internals.md,architecture/index.md,architecture/data-model.md,architecture/router.md,architecture/server-lifecycle.md,architecture/p2p-layer.md,architecture/claude-api.md,architecture/obsidian-sync.md,architecture/implementation-status.md,operations/,security/,comparisons/,developers/,how-it-works/,faq.md,inventory-r74-2.md, or any KILL target listed in §3 below. (These files are about to die in 4C; no new file may anchor to them.)
§2. Sub-phase 4B — ABSORB moves + content reconciliation
Sub-agent 4B reconciles every ABSORB pair listed in audit §2. Classified into three tiers for operational clarity.
Tier 4B-i — pure git-mv (old source cleanly supersedes, or target dir did not exist pre-4A)
For each pair: git mv <old> <new> inside the worktree. After the move, run grep -nE "78 tables|484 tools|data/ams\.db|11 middleware" on the moved file; if any match is unlabeled, edit to either (a) remove the phrase or (b) wrap the paragraph in an explicit HERITAGE block. These are moves where the target directory is being created by 4A, so the move is the reconciliation.
Moves executed in 4B-i:
git mv docs/concepts/β-task-pipeline.md docs/3-world/execution/task-pipeline.md— BUT target was just created by 4A. Instead:git rm docs/concepts/β-task-pipeline.md(content already absorbed by 4A’s authored file).- Same pattern for the other 11 concept files whose target was authored in 4A:
git rm docs/concepts/ε-skill-registry.md,git rm docs/concepts/ζ-decision-trail.md,git rm docs/concepts/η-proof-store.md,git rm docs/concepts/θ-consensus.md,git rm docs/concepts/ι-state-fork.md,git rm docs/concepts/κ-rule-engine.md,git rm docs/concepts/λ-reputation.md,git rm docs/concepts/μ-integrity-monitor.md,git rm docs/concepts/π-governance.md,git rm docs/concepts/ξ-identity.md,git rm docs/concepts/δ-model-router.md,git rm docs/concepts/γ-server-lifecycle.md. git rm docs/pipeline-definition.md— content absorbed into5-time/round.mdand5-time/task.mdby 4A.git rm docs/promise.md— absorbed into0-mutate/promises.mdby 4A.
(Note: “pure git-mv” collapses to “git-rm source” here because 4A already authored the Phase-0 target. This is cleaner than moving donor prose into the new layer and then editing it.)
Tier 4B-ii — drift reconciliation (both old and new exist; keep the Phase-0 version)
For each pair: read both files, pick the newer/Phase-0-accurate one per contract §2, then git rm the loser. No content merge is required — the audit confirmed the new target is already substantial in every case below.
Actions (decision already made; sub-agent executes):
git rm docs/multi-surface-topology.md— new target3-world/social/surfaces.md(216L) is canonical.git rm docs/master-flow.md— new target5-time/master-flow.md(301L) is canonical.git rm docs/concepts/α-system-core.md— covered by2-plugin/boot.md(232L) +2-plugin/index.md(149L).git rm docs/constraints.md—3-world/physics/constitution.md(925L) absorbs s01.git rm docs/scenario.md—0-mutate/lifecycle.md(364L) is canonical.git rm docs/scale.md—3-world/execution/scale.md(784L) contains the content; its 6 inbound KILL links are fixed in 4D.git rm docs/extensions.md—5-time/roadmap.md(692L) is canonical.git rm docs/glossary.md—reference/glossary.md(401L) is canonical.git rm docs/cross-reference.md—reference/cross-reference.md(246L) is canonical.git rm docs/design-system.md—reference/design-system.md(339L) is canonical.git rm docs/architecture/database.md—2-plugin/database.md(262L) is canonical.git rm docs/architecture/domains.md—3-world/index.md(86L) is canonical.git rm docs/architecture/execution-axis.md—3-world/execution/index.md(213L) is canonical.git rm docs/architecture/legitimacy-axis.md—3-world/physics/index.md(182L) is canonical.git rm docs/architecture/intelligence-axis.md— content absorbed into3-world/social/llm.md+3-world/execution/decision-trail.md(both authored in 4A).git rm docs/security/hardening.md—3-world/physics/hardening.md(369L) is canonical.git rm docs/security/auth.md—3-world/physics/hardening.mdcovers auth Phase 1+ plans.git rm docs/roadmap/R73-R80-plan.md—5-time/roadmap.md(692L) is canonical.git rm docs/roadmap/phase-0-execution.md—5-time/roadmap.mdabsorbed it.
Tier 4B-iii — content rewrites requiring an edit before the mv/rm
Three files require in-place rewrite before their source is deleted:
docs/2-plugin/middleware.md(187L) — audit §5 flagged donor body below the heritage banner. Rewrite the body (lines ~30-176) to describe the Phase 0 5-stage α chain (tool-lock → schema-validate → audit-enter → dispatch → audit-exit) per contract §2. Keep the heritage banner (lines 1-29) intact. Target length ~150 lines. Thengit rm docs/architecture/middleware.md(the ABSORB source).docs/2-plugin/health.md(61L) — audit §5 flagged thin file + unimplementednpm run dashboard+ donorGET /api/health. Expand by absorbingoperations/monitor.md: describeserver_healthas an MCP tool (not HTTP), removenpm run dashboard, keep theCOLIBRI_LOG_LEVELcorrection. Target length ~130 lines. Thengit rm docs/operations/monitor.md.docs/0-mutate/where-truth-lives.md(230L) — audit §5 verified the body is already Phase 0 accurate (reality stamp at L15-22 namesdata/colibri.db, L25 and L209-211 explicitly labelams.dbas legacy bootstrap store). Keep as-is; no body rewrite needed. The single outbound KILL link at L230 is patched in 4D. Thengit rm docs/truth.md.
Tier 4B-iv — ν integrations absorption
git rm docs/concepts/ν-integrations.md—4-additions/index.md(226L) already covers integration patterns. Audit L118 confirms4-additions/index.mdis substantial; no merge needed.
Tier 4B-v — root world-schema duplicate
- Step 1:
git diff --no-index colibri-world-schema.md docs/world-schema.md— inspect output. - Step 2: if the two files are identical,
git rm colibri-world-schema.md. - Step 3: if they differ, the docs/ copy is canonical per contract §4 — still
git rm colibri-world-schema.mdat the repo root. (Contract §4 already decided: the root copy must not exist post-round;docs/world-schema.mdis canonical.)
Tier 4B-vi — residual ABSORB sources
git rm docs/operations/deploy.md—guides/deploy.md(52L) exists; audit flagged it as likely donor residue. 4B does NOT rewriteguides/deploy.mdin this round (tight scope); the existing 52L is retained as-is. Same pattern foroperations/troubleshooting.md→guides/troubleshoot.md(71L kept as-is) andoperations/backup.md→guides/backup.md(53L kept as-is). The operations/* source files are deleted here in 4B.git mv docs/guides/agent-handoff-protocol.md docs/guides/agent-handoff.md— simple rename per ABSORB row 121.git mv docs/guides/implementation/PHASE-0-EXECUTION-GUIDE.md docs/guides/implementation/index.md— only ifdocs/guides/implementation/index.mddoes NOT already exist. If it exists (audit row 122 suggests it does at ~150L),git rm docs/guides/implementation/PHASE-0-EXECUTION-GUIDE.mdinstead. Sub-agent runsls -l docs/guides/implementation/index.mdfirst to decide.
4B-vii — reading-order absorption
git rm docs/guides/reading-order.md— content absorbed into the rebuiltdocs/index.mdwhich 4D finalizes. (Ifdocs/index.mdat this point does not yet carry the reading paths, flag back to parent; 4D is where the master hub is rebuilt.)
4B commit + gate
Single commit, combining all moves/deletes + the two body rewrites (middleware.md, health.md):
refactor(docs): R75 sub-phase 4B — ABSORB moves + Phase 0 content reconciliation
Gate check:
git status→ clean.- Every
oldpath enumerated in audit §2 (41 rows) returns “No such file or directory” whenlstries to stat it. Spot-check three:ls docs/multi-surface-topology.md,ls docs/pipeline-definition.md,ls docs/truth.md— all absent. - Every
newtarget enumerated in audit §2 exists with>0bytes. ls colibri-world-schema.md→ “No such file or directory”.grep -nE "GET /api/health|npm run dashboard|AMS_LOG_LEVEL" docs/2-plugin/health.mdreturns zero matches (unless inside a negation sentence that starts with “Not” / “does NOT”).grep -nE "6-layer|11 middleware|11-layer" docs/2-plugin/middleware.mdreturns zero unlabeled matches.
§3. Sub-phase 4C — KILL deletions
Sub-agent 4C runs git rm on every KILL target enumerated in audit §3 that was not already deleted by 4B. Grouped for reviewability.
Ordering contract: 4C MUST run AFTER 4B. If 4B failed to delete a source that 4C targets, 4C will still delete it (idempotent). But if 4C ran before 4B, it would remove files that 4B expected to git mv.
Group 4C-i — docs/ KILL (audit §3a; ~91 files)
Run in one shell pass per directory for atomicity:
git rm -r docs/how-it-works/
git rm -r docs/concepts/ # if any of α–ξ survived 4B they die here; arbitration, index, map included
git rm -r docs/comparisons/
git rm -r docs/developers/
git rm -r docs/security/ # hardening.md + auth.md already removed by 4B; dir now empty
git rm -r docs/operations/ # monitor, deploy, troubleshooting, backup all removed by 4B; changelog + config-reference + any remainder die here
git rm -r docs/roadmap/ # R73-R80-plan.md + phase-0-execution.md removed by 4B; any remainder dies here
Architecture KILLs (keep decisions/ + README.md):
git rm docs/architecture/component-map.md
git rm docs/architecture/system-overview.md
git rm docs/architecture/gsd-internals.md
git rm docs/architecture/implementation-status.md
git rm docs/architecture/claude-api.md
git rm docs/architecture/obsidian-sync.md
git rm docs/architecture/p2p-layer.md
git rm docs/architecture/router.md
git rm docs/architecture/server-lifecycle.md
git rm docs/architecture/index.md
git rm docs/architecture/data-model.md
# database.md, middleware.md, domains.md, execution-axis.md, intelligence-axis.md, legitimacy-axis.md already removed in 4B
# architecture/decisions/ and architecture/README.md survive (contract §7)
Root docs/ KILLs:
git rm docs/colibri-master-context.md
git rm docs/faq.md
git rm docs/inventory-r74-2.md
git rm docs/session-seal-s6.md
git rm docs/README.md
Reference/ KILLs (keep glossary, cross-reference, design-system, mcp-tools-phase-0, extractions/):
git rm docs/reference/config.md
git rm docs/reference/controllers.md
git rm docs/reference/gsd-engine.md
git rm docs/reference/greek-vocabulary.md
git rm docs/reference/repo-structure.md
git rm docs/reference/api-rest.md
git rm docs/reference/database-schema.md
git rm docs/reference/domain-contracts.md
git rm docs/reference/dsl.md
git rm docs/reference/dashboard.md
git rm docs/reference/composition.md
git rm docs/reference/events.md
git rm docs/reference/error-codes.md
git rm docs/reference/security.md
git rm docs/reference/phoenix-python-reference.md
git rm docs/reference/cli.md
git rm docs/reference/index.md
git rm docs/reference/mcp-tools.md
Guides/ KILLs (keep quick-start, first-pr, write-a-skill, agent-bootstrap, agent-handoff, self-build-loop, deploy, troubleshoot, backup, implementation/):
git rm docs/guides/quickstart.md
git rm docs/guides/glossary.md
git rm docs/guides/greek-letters.md
git rm docs/guides/obsidian-setup.md
git rm -r docs/guides/tutorials/
git rm -r docs/guides/examples/
git rm docs/guides/implementation/pre-mcp-bootstrap-sequence.md
git rm docs/guides/implementation/skill-to-task-map.md
git rm docs/guides/implementation/task-dependency-graph.md
git rm docs/guides/implementation/phoenix-port-map.md
git rm docs/guides/implementation/phase-1-kappa-rule-engine.md
git rm docs/guides/implementation/phase-2-lambda-reputation.md
git rm docs/guides/implementation/phase-3-theta-consensus.md
git rm docs/guides/implementation/phase-4-complete-legitimacy.md
git rm docs/guides/implementation/phase-5-extensibility.md
git rm docs/guides/implementation/kappa-rule-engine.md
git rm docs/guides/implementation/lambda-reputation.md
git rm docs/guides/implementation/theta-consensus.md
Group 4C-ii — .claude/skills/ams-* stubs
git rm -r .claude/skills/ams-executor/
git rm -r .claude/skills/ams-observability/
git rm -r .claude/skills/ams-pm/
git rm -r .claude/skills/ams-tier1-chains/
Group 4C-iii — data/ heritage (audit §3b; 77 files)
git rm -r data/meta-prompts/
git rm -r data/roadmaps/
# data/projects/ already absent per audit §3b — skip
# data/*.md remainder (audit says only README.md is present and it is UPDATED not killed in 4D) — skip
Group 4C-iv — temp/rewrite-r74-plan/
Audit §3b confirms directory does not exist in worktree. Skip — no action required.
4C commit + gate
chore(docs): R75 sub-phase 4C — delete KILL list per PLAN-RED
Gate check:
git status→ clean.find docs -name "*.md" | wc -l→ integer in[110, 135](contract §8 criterion 1, target ~120).- For each of these,
ls <path>returns “No such file or directory”:docs/concepts,docs/how-it-works,docs/comparisons,docs/developers,docs/security,docs/operations,docs/roadmap,docs/colibri-master-context.md,docs/faq.md,docs/inventory-r74-2.md,docs/session-seal-s6.md,docs/README.md,.claude/skills/ams-executor,data/meta-prompts,data/roadmaps. find data -name "*.md" | wc -l→ exactly1(contract §8 criterion 9; onlydata/README.mdremains).ls docs/architecture/decisions/→ returns the 6 ADRs + README (frozen per contract §7).ls docs/spec/ | wc -l→ returns the full SEED set untouched.
§4. Sub-phase 4D — Nav rebuild + root-file alignment
Sub-agent 4D edits the surviving navigation and root files so every link resolves to a surviving target. This is the link-hygiene pass.
4D-i — docs/index.md
Rebuild the master hub around the World Schema tree. Full rewrite rather than spot-edit (the audit showed the current 72-line file has two KILL links and does not enumerate the new layers). Target ~130 lines.
- Top section: the five reading paths (Path 1: operator, Path 2: Phase 0 contributor, Path 3: system designer — each pointing to survivors only).
- World Schema tree: 0-mutate/ → 1-transport/ → 2-plugin/ → 3-world/ (physics/social/execution) → 4-additions/ → 5-time/. Each entry links to its
index.md. - Law library: spec/ index, ADRs, agent contracts.
- Phase 0 pointer:
guides/implementation/task-breakdown.md— the sentence must read “28 sub-task Phase 0 plan (a subset of the 63-task full breakdown)”. The word “63-task Phase 0 list” MUST NOT appear (contract §2 rule 5). - References:
reference/glossary.md,reference/cross-reference.md,reference/design-system.md,reference/mcp-tools-phase-0.md,reference/extractions/. - Plan:
PLAN-RED.md,world-schema.md,colibri-system.md. - Remove any reference to
inventory-r74-2.md,concepts/index.md,faq.md,how-it-works/,architecture/index.md.
4D-ii — CLAUDE.md (root)
- §9.3 header:
### 9.3. Root-level files (5, all CANON)→### 9.3. Root-level files (6, all CANON). Ensure the body line that lists files readsAGENTS.md · CLAUDE.md · CODE_OF_CONDUCT.md · CONTRIBUTING.md · README.md · SECURITY.md(it already does at commited470fc5— verify, no rewrite needed if already present). - §9.2
docs/row: rewrite the “Role” cell to describe the World Schema tree and drop the sentence abouttemp/plan-red-cleanup.bat. New wording: “Apex of the Colibri corpus. Organized by World Schema v3:0-mutate/through5-time/(runtime layers) +spec/(s01–s19 law library) +architecture/decisions/(ADRs) +agents/(contracts) +reference/extractions/(heritage archive) +reference/(glossary, cross-reference, design-system, mcp-tools-phase-0) +guides/.” The “Edit rule” cell remains: edit via 5-step chain; mirror to Obsidian viarobocopyexcluding.git _vault .worktrees node_modules temp vault-staging. - §9.2
.claude/row: remove the “plus 4ams-*redirect stubs” clause and the “ams-* stubs may be edited directly” sentence — both refer to KILLed files. Update .md count from 27 to 23. - §3 forbidden-actions block: the line “See
docs/multi-surface-topology.mdfor the full surface rules.” → “Seedocs/3-world/social/surfaces.mdfor the full surface rules.” - §6 Gate rule: the line “See
docs/pipeline-definition.md§5.2.” → “Seedocs/5-time/round.mdanddocs/5-time/task.md.” - §11 Documentation reference: verify all 14 bullets resolve to surviving paths. Remove the top note paragraph “Run
temp/plan-red-cleanup.batto delete old files.” (the cleanup is now history, not a pending action). - Footer date stamp: update to
2026-04-16and note§9.3 root-file count 6; §11 all links verified post-Phase 4.
4D-iii — AGENTS.md (root)
AGENTS.md:156— rewrite](docs/concepts/index.md)→](docs/index.md)OR](docs/world-schema.md), depending on paragraph intent (sub-agent reads surrounding 5 lines to decide).AGENTS.md:167—](docs/multi-surface-topology.md)→](docs/3-world/social/surfaces.md).AGENTS.md:168—](docs/pipeline-definition.md)→ point at whichever of5-time/round.md/5-time/task.mdthe context calls for (round-vs-task disambiguated by the surrounding prose; if ambiguous, use5-time/round.md).- Reading-order section: align layer sequence with 0-mutate → 5-time.
4D-iv — CONTRIBUTING.md (root)
- Lines 11 and 15:
](docs/concepts/index.md)→](docs/index.md). If the linked paragraph is about Greek-letter navigation specifically, use](docs/world-schema.md)instead.
4D-v — README.md (root)
- Verify the “Documentation” link points at
docs/index.md. If it points anywhere else (e.g.docs/README.mdwhich was killed in 4C), fix.
4D-vi — _config.yml (Jekyll)
- Read the file first (contract §7 forbids any edit other than the
navkey). If anav:block enumerates doc paths, update path entries to match the new tree. If nonav:block exists, no edit.
4D-vii — .claude/skills/README.md
- Remove every
ams-*reference (contract §5). If the file enumerates skills, update the list to only the 22colibri-*entries.
4D-viii — .agents/README.md
- Add the active/deferred skill split per PLAN-RED §267-269:
- 10 Phase 0 active skills: colibri-pm, colibri-executor, colibri-tier1-chains, colibri-task-management, colibri-audit-proof, colibri-verification, colibri-mcp-server, colibri-docs-check, colibri-docs-sync, colibri-greek-nav.
- 12 heritage/deferred skills: colibri-growth-strategy, colibri-truthing, colibri-audit-review, colibri-context-primer, colibri-cross-reference, colibri-obsidian-sync, colibri-pr-review, colibri-round-close, colibri-skeleton-generator, colibri-status, colibri-writeback, repo-facing-polish.
- Note that
swarms/colibri-5/is ACTIVE (not HERITAGE) per PLAN-RED §271.
4D-ix — data/README.md
- Reduce to a one-line heritage banner per PLAN-RED §305:
Heritage AMS donor data.ams.dbkept as Phase 0 writeback target. All other content removed in R75 per PLAN-RED.
4D-x — Link sweep on surviving high-damage files
Per audit §4c, two files hold 84 of the 453 broken links. Sub-agent 4D patches each:
docs/reference/glossary.md(34 KILL links) — update every concept definition’s “See” line to point at the new3-world/*location of that concept (e.g.See [η Proof Store](/AMS/3-world/physics/laws/proof-store.html)instead ofSee [η](../concepts/η-proof-store.md)).docs/reference/cross-reference.md(50 KILL links) — this file is a reverse index intoconcepts/. The entire body needs its 50 links retargeted to the new World Schema locations. If the file structure makes a blanket rewrite easier, the sub-agent may rewrite; otherwise patch per-link.
4D-xi — Link sweep on remaining surviving files
For each survivor in audit §4b with KILL links, the sub-agent retargets every broken link:
docs/3-world/index.md(10 KILL links at L27-28, 45-46, 57-61, 86) → retarget tophysics/index.md,social/index.md,execution/index.md, and into3-world/*/*.mdauthored in 4A.docs/5-time/master-flow.md(7 KILL links at L147, 177, 255, 271, 292-296) → retarget to5-time/round.md,5-time/task.md,5-time/roadmap.md, and into3-world/as appropriate.docs/3-world/physics/constitution.md(7 KILL links at L911-917) → retarget the “See also” footer block to3-world/physics/index.md,3-world/physics/laws/*.md,3-world/physics/enforcement/*.md.docs/3-world/physics/index.md(6 links at L175-180),docs/3-world/execution/scale.md(6 at L772-777; also fix missing../relative prefix per audit),docs/2-plugin/middleware.md(4 at L10, 184-186),docs/2-plugin/database.md(4 at L259-262),docs/3-world/execution/index.md(4 footer),docs/4-additions/index.md(3 at L222-224),docs/2-plugin/index.md(3 at L100, L147-148),docs/2-plugin/boot.md(2 at L230-231),docs/3-world/social/index.md(2 at L171-172),docs/0-mutate/index.md(1 at L27 — also fix to point at../3-world/physics/constitution.md, not../concepts/constitution.md),docs/0-mutate/where-truth-lives.md(1 at L230),docs/1-transport/index.md(1 at L179),docs/5-time/index.md(1 at L230).docs/spec/s15-gsd-contract.md,docs/spec/s17-mcp-surface.md,docs/spec/s18-identity.md,docs/spec/s19-governance.md— footer “See also” blocks (1-5 links each). Contract §7 permits edits ONLY to fix outbound links into KILL paths — any link still pointing atconcepts/gets rewritten to the new3-world/*target; no other content change.docs/architecture/decisions/ADR-003-bft-library.md— single footer link toconcepts/θ-consensus.md→3-world/physics/laws/consensus.md. Same contract §7 scope constraint.docs/reference/extractions/*(13 hits across 11 files) — footer “See also” patches. Same constraint: outbound link fix ONLY. Body frozen.docs/agents/*(4 files) — same pattern if any outbound KILL links exist.docs/guides/first-pr.md,docs/guides/quick-start.md,docs/guides/write-a-skill.md,docs/guides/agent-bootstrap.md,docs/guides/implementation/first-7-prs.md,docs/guides/implementation/task-breakdown.md— retarget any outbound KILL links.
4D commit + gate
chore(docs): R75 sub-phase 4D — nav rebuild + root file alignment
Gate check:
git status→ clean.grep -n "63-task Phase 0 list" docs/index.md→ zero matches.grep -n "28 sub-task" docs/index.md→ one or more matches.grep -c "ams-" .claude/skills/README.md→0.grep -n "6, all CANON" CLAUDE.md→ matches §9.3 header.grep -n "colibri-5" .agents/README.md→ matches the ACTIVE classification line.wc -l data/README.md→ integer ≤ 3 (one-line banner with optional frontmatter).- Link checker pass:
grep -rnoE "\]\([^)]+\.md\)" docs/ CLAUDE.md AGENTS.md CONTRIBUTING.md README.md | grep -vE "(archive|spawns|swarms)" | sort -u— for every surviving]( )target, run a file-existence check; zero results for missing targets. grep -rnE "78 tables|484 tools|data/ams\.db" docs/returns only matches insidedocs/reference/extractions/, files withzone: heritagefrontmatter, ordocs/PLAN-RED.md(contract §8 criterion 2).
§5. Sub-agent dispatch instructions
Each sub-phase is executed by exactly ONE sub-agent invocation. The parent (T2 PM) dispatches in strict order 4A → 4B → 4C → 4D and verifies each commit before dispatching the next. Each sub-agent:
- Works inside the worktree
E:/AMS/.worktrees/claude/r75-plan-red/. - Is given as context: this packet,
docs/audits/r75-plan-red-audit.md,docs/contracts/r75-plan-red-contract.md, anddocs/PLAN-RED.md. - Uses
Read,Write,Edit, andBash(forgit mv,git rm,git add,git commit). No push. - Produces exactly ONE commit with the commit message specified for its sub-phase in §1-§4 above.
- Reports back: commit SHA, list of files touched (new / modified / deleted), and the gate-check command output.
The parent verifies the reported gate-check output and runs a quick spot-check (git log -1, git status, a sample ls on one expected post-state file) before dispatching the next sub-agent. Any gate failure halts the chain — the parent re-dispatches with corrective instructions rather than allowing advancement.
§6. Risk + rollback
- Risk 4A-1 (content freshness): a new glue file imports donor prose verbatim and carries unlabeled
78 tables/data/ams.db/AMS_*language. Mitigation: 4A gate check #3 greps the 16 new files; any match halts the commit. Rollback: the sub-agent edits the offending lines before committing — nogit resetneeded (commit is the gate). - Risk 4B-1 (parent dir missing):
git mvfails because the target directory does not exist. Mitigation: 4A authored every new target file, which implicitly created every needed subdirectory. 4B sub-agent still runsmkdir -p <parent>defensively before any rename that might target a fresh path. - Risk 4C-1 (ordering): if 4C ran before 4B,
git mvin 4B would fail because the source was deleted. Mitigation: dispatch order is enforced by §5; each sub-phase’s commit precedes the next sub-phase’s dispatch. - Risk 4D-1 (root duplicate coexistence):
colibri-world-schema.mdat the repo root anddocs/world-schema.mdboth exist. 4B Tier 4B-v deletes the root copy. 4D verification greps forls colibri-world-schema.mdabsence (contract §8 criterion 7). - Risk 4D-2 (link-checker false positive): a link to an anchor (
#section) in a surviving file is flagged as broken because the anchor doesn’t exist. Mitigation: gate check #8 ignores anchors when the file itself exists; a dedicated anchor check is a Step 5 Verify concern, not 4D. - Rollback strategy (any sub-phase): sub-phase commits are linear. If a sub-phase’s gate fails post-commit, parent either asks the sub-agent for a follow-up commit that patches the regression (preferred) or, in the last resort, runs
git revert <SHA>on the feature branch. Nogit reseton shared history. No force-push. - Halting condition: any sub-phase that cannot reach its gate within one follow-up commit halts the chain. Parent escalates to T0.
R75 Step 3 Packet — 2026-04-16 — branch feature/r75-plan-red-execution. Gates sub-phases 4A, 4B, 4C, 4D. Audit baseline: eb15dd31. Contract baseline: ed470fc5. Next: sub-agent 4A begins implementation.