Per-milestone plan files handed straight to dev agents

[A]

A plan stops being one document. Each milestone becomes its own directory under plans/{slug}/milestones/, holding a milestone file named after it — the authoritative work contract a develop worker is handed by path, never as pasted text.

What changes

• Scaffold renders tree keys — booping scaffold renders a tree's filename keys through the same Jinja env and --set globals as seed bodies, with the filesystem-safety check re-run on the rendered name.
• Milestone contract in config — core.groom_playbook.milestone_scaffold seeds milestones/M{nn}-{kebab}/M{nn}-{kebab}.md (frontmatter id, title, sp, status, plan; headings ## Tasks, ## Definition of Done, ## Verify). The shared core.plans.milestones key gives the glob and the columns index.md's table projects. Naming the file after its directory keeps a bare Obsidian wikilink resolvable and leaves room for sidecars.
• Groom writes milestone files — draft-plan seeds each milestone and writes its body in place, then generates index.md's ## Milestones table with booping query. All five plan templates describe the new shape.
• Milestone status is run state — a milestone state machine on develop, artifact milestones/{instance}/{instance}.md, pending → in-progress → done with blocked off in-progress. Every edge runs the new refresh-milestone-table hook, which rewrites the index table and re-sums the plan's sp. develop-loop moves into a one-step milestones subgraph, which is what makes the {instance} artifact legal.
• Develop delegates paths, not bodies — one fixed briefing block naming the milestone files as contract, index.md as context, and a feedback.md sidecar as prior-attempt findings. The worker runs its own ## Verify and makes the repo commit; the runner validates that commit's diff against the DoD, keeps the bookkeeping, records failed attempts in feedback.md and routes fixes to a fresh core.develop_playbook.fallback_agent.
• Downstream — retro, code-review and the lesson-check partial follow the milestone files; booping playbook-state strips a matched instance segment cleanly, so instances key the same in filename and directory positions; fixture plans, public docs, README and CLAUDE.md all move to the new shape.

Note

This branch is cut above feat/scaffold-seeded-plans, so the PR also carries that unmerged sprint. .claude-plugin/plugin.json still reads 1.0.0 — the version bump belongs to the release cut, not here.

🤖 Generated with Claude Code