create-milestoneslisted

Create, advance, and complete milestones for a project whose foundation work is done. Drives the 10-phase TDD methodology (Define Contract, Write Tests RED, Create Fixtures, Run Tests RED, Update Interfaces, Implement Core, Update Wrappers, Run Tests GREEN, Integrate, Quality/Docs). Authors milestone + impl-log pairs via `docs new` and atomically archives them via `docs archive --cascade` on completion. Triggers on "create a milestone", "start M1", "next milestone", "begin implementation", "advance the project". Use after `project-foundation` has set up the docs tree.
ArtRichards/create-milestones · ★ 0 · Testing & QA · score 70

Install: claude install-skill ArtRichards/create-milestones

# create-milestones Drive milestone-level TDD work on a project whose foundation artifacts already exist as docs-managed Markdown files. Each milestone is a pair of docs (`<slug>.md` + `<slug>-impl.md`) progressing through ten TDD phases, archived together with `docs archive --cascade` on completion. Requires [`docs-cli`](https://github.com/ArtRichards/docs-cli) **v1.2.0 (M7+)** for the `Lifecycle:` field rename and **v1.3.0 (M8+)** for `docs new --body-from -|<path>`. Ask the user to upgrade if the host's `docs` binary is older. ## When this applies - The user wants to create a new milestone for an existing project. - The user wants to resume work on an in-flight milestone. - The user wants to complete and archive a milestone. - The user wants to track features or bug fixes within a milestone. Do **not** apply when: - The project has no docs tree yet, or the Definition of Ready is still `draft` — redirect to the `project-foundation` skill. - The user wants a one-off TDD phase on something unrelated to a milestone — walk the phases by hand without invoking this skill. ## Substance lives in references/ This SKILL.md is intentionally short. The full procedure lives in: - [`references/milestone-playbook.md`](references/milestone-playbook.md) — bootstrap, create, advance, complete, archive (with a worked example). - [`references/tdd-phases.md`](references/tdd-phases.md) — the 10-phase reference with per-phase docs-CLI touchpoints. **Read both before driving an