ship-milestonelisted
Install: claude install-skill ArtRichards/ship-milestone
# ship-milestone
Drive one milestone through the full 10-phase TDD lifecycle —
contract, tests, fixtures, RED baseline, implementation, GREEN,
integration, quality, and a post-implementation simplify pass —
and finish with the work committed on a reviewable branch stack.
Assumes a project set up with the docs-cli + skills ecosystem
(see `project-foundation` / `create-milestones`). If the target
milestone's task plan and log do not exist yet, **Step 0** creates
them following the `create-milestones` conventions before the TDD
steps begin.
## Requirements
Required tooling:
- [`docs-cli`](https://github.com/ArtRichards/docs-cli) **v1.2.0
(M7+)** for the `Lifecycle:` controlled-vocab field and expanded
role vocab; **v1.3.0 (M8+)** for `docs new --body-from -|<path>`.
Companion skills (sub-agents invoke them by name):
- `create-milestones` — read by Step 0's milestone-creation agent
for conventions when scaffolding a missing task plan.
- `docs` (the docs-cli skill) — used by every sub-agent for doc
lifecycle and validation.
- `sync-and-commit` — called by each implementation agent at the
end of its step (after fresh-eyes review feedback is applied).
- `simplify` — called by the Step 3 simplify agent.
- `code-review` (built-in) — optional, available to fresh-eyes
review agents.
If a companion skill is missing, the sub-agent must fall back to
the manual equivalent and note it in the milestone log.
## Substance lives in references/
This SKILL.md is intentionally