Description
After the canonical AGENTS/CLAUDE arrangement is repaired, reduce the root always-loaded instruction file so cloned-repo contributors and operational agents see architecture, safety, verification, tracker routing, and entrypoints without maintainer history or harness-specific workflow detail crowding their context.
Acceptance Criteria
- #1 AGENTS.md retains all non-negotiable architecture, secret, verification, concurrency, and Backlog workflow rules
- #2 Maintainer history and detailed campaign procedures move behind named on-demand Backlog docs or repository references without becoming unavailable
- #3 The portable contract contains no personal model allocation or external-machine assumptions
- #4 A fresh Claude Code and Codex instruction-discovery audit confirms the same effective project rules with less always-loaded text
Definition of Done
- #1 make gate (build vet test race rw-proto-check spdx-check forbidden-words)
- #2 make blueprint-schema (only if a blueprint field or construct/workload config struct changed)
- #3 DRY_RUN=true go run ./cmd/synthkit -once -dump — inventory diffed against signals/
Implementation Plan
-
Inventory portable non-negotiables versus maintainer/history detail in AGENTS.md.
-
Reduce always-loaded text by routing detail to existing Backlog docs and durable references without weakening architecture, safety, verification, concurrency, or tracker contracts.
-
Re-run root/dashboard Claude and Codex discovery checks and compare effective rule coverage.
Implementation Notes
Reduced AGENTS.md from 232 lines/17,791 bytes to 130 lines/8,278 bytes while retaining architecture, signal, secret, concurrency, verification, operational-entrypoint, and Backlog contracts. Routed maintainer history and campaign procedure to doc-0001/doc-0002. Root/dashboard Claude imports and Codex/Claude skill discovery paths were preserved; make skills-check and diff checks passed. Full gate remains the root integration check.
Integrated CodeRabbit review raised no task-specific issue. Wave integration make gate and dry-run inventories passed; no blueprint schema regeneration was required.
Final Summary
Landed in e98411b: reduced portable AGENTS.md contract with on-demand campaign routing while preserving architecture, safety, verification, concurrency, and Backlog rules across Claude and Codex discovery. Verified with rule audit, skills-check, CodeRabbit, make gate, and inventories.