Migrate SYSTEM and AGENTS-{WORKFLOW,CI,CODEX,RUNTIME} into docs owners,
retarget consumers, rewrite the split gate, and craft-densify AGENTS,
README, PRODUCT, and GOALS under the documentation authority graph.
Co-authored-by: Cursor <cursoragent@cursor.com>
Audit of root files found five drift classes, each verified against the
executable source before fixing:
- AGENTS.md claimed Codex twins are never regenerated; regen-all.sh /
codex-sync.sh auto-refresh parity twins (bespoke/pointer stay manual,
per AGENTS-CODEX.md). Fixed both the registries line and the project
structure map.
- AGENTS-WORKFLOW.md referenced the missing docs/QUICKSTART.md and carried
a near-verbatim duplicate Session Completion checklist; deduped to the
canonical Landing the Plane section.
- AGENTS-RUNTIME.md listed sync-skill-counts.sh targets that the script
does not touch (README.md, docs/SKILLS.md, docs/ARCHITECTURE.md,
using-agentops/SKILL.md); replaced with the script's real surface.
- PROGRAM.md: hooks/** (directory no longer exists) removed from mutable
scope; ao autodev commands annotated + fixed with -tags legacy (the
command surface is archived behind the legacy build tag — verified
'autodev validate' returns valid:true with the tag); BEADS_DIR=$PWD/_beads
corrected to $(ao beads dir); 'tracked in bd' -> br.
- MEMORY.md: removed empty Last Session header; updated the bd-era Tracker
Skew entry to the br reality; marked the ao codex ensure-start/stop
pattern superseded (deprecated shims per AGENTS-RUNTIME.md).
boshu