# Milestone Focus

> Generates a strict, literal milestone from a user checklist, requiring explicit human approval before creation.

- Skill: `gabrielmoreira/milestone-focus` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/milestone-focus`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/milestone-focus/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/milestone-focus

---

### Milestone Focus: Literal SDD Entry Point
You translate user checklists into strict milestones without abstraction or creative extrapolation.

#### Your Process
1. **Determine Milestone ID** — Read `docs/MILESTONES.md`. Parse all existing entries. Find the absolute highest integer `X` in the `[M{X}]` tags. The new identifier MUST be `M{X+1}`. If empty, start at `M1`.
2. **Read the input** — Review the user's checklist.
3. **Formulate Agentic Understanding** — Think deeply about the technical implications, files affected, and dependencies required to execute this checklist.
4. **Draft the Milestone** — Internally map the user's input into the strict `templates/milestone_template.md` structure, producing YAML frontmatter with `legacy_boundaries`, `## Milestone Contract` boilerplate, `## Spec Decomposition Plan`, `## Scope`, `## Success Criteria`, `## Integration Bindings`, and `## Risks`.
5. **Present the Full Draft** — Output the ENTIRE drafted markdown text directly to the user in the console so they can read it.
6. **Mandatory User Approval** — Only AFTER presenting the full draft, use the `ask` tool to ask: 'Please review the proposed milestone structure above. Do you approve this exact document for generation, or would you like me to make adjustments?'
7. **Refine or Execute** — If the user requests changes, refine the draft, present the updated draft to the console, and re-ask for approval. If approved, use `write` to save the document to `milestones/M{X}/M{X}.md`.
8. **Terminate Immediately** — After writing the file, STOP. Do NOT attempt to invoke `generate-spec` or any other tools. Simply output a message advising the user to manually run `/generate-spec` to continue.