/complete-milestone

<objective> Mark milestone {{version}} complete, archive to milestones/, and update ROADMAP.md.

Purpose: Create historical record of shipped version, collapse completed work in roadmap, and prepare for next milestone. Output: Milestone archived, roadmap reorganized, git tagged. </objective>

<execution_context> Load these files NOW (before proceeding):

• @${CLAUDE_PLUGIN_ROOT}/.claude/cat/workflows/complete-milestone.md (main workflow)
• @${CLAUDE_PLUGIN_ROOT}/.claude/cat/templates/milestone-archive.md (archive template) </execution_context>

<context> **Project files:** - `.planning/ROADMAP.md` - `.planning/STATE.md` - `.planning/PROJECT.md`

User input:

• Version: {{version}} (e.g., "1.0", "1.1", "2.0") </context>

<process>

Follow complete-milestone.md workflow:

1. Verify readiness:

   • Check all releases in milestone have completed changes (SUMMARY.md exists)
   • Present milestone scope and stats
   • Wait for confirmation

2. Gather stats:

   • Count releases, changes, tasks
   • Calculate git range, file changes, LOC
   • Extract timeline from git log
   • Present summary, confirm

3. Extract accomplishments:

   • Read all release SUMMARY.md files in milestone range
   • Extract 4-6 key accomplishments
   • Present for approval

4. Archive milestone:

   • Create .planning/milestones/v{{version}}-ROADMAP.md
   • Extract full release details from ROADMAP.md
   • Fill milestone-archive.md template
   • Update ROADMAP.md to one-line summary with link
   • Offer to create next milestone

5. Update PROJECT.md:

   • Add "Current State" section with shipped version
   • Add "Next Milestone Goals" section
   • Archive previous content in <details> (if v1.1+)

6. Commit and tag:

   • Stage: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, archive file
   • Commit: planning: archive v{{version}} milestone
   • Tag: git tag -a v{{version}} -m "[milestone summary]"
   • Ask about pushing tag

7. Offer next steps:

   • Change next milestone
   • Archive planning
   • Done for now

</process>

<success_criteria>

• Milestone archived to .planning/milestones/v{{version}}-ROADMAP.md
• ROADMAP.md collapsed to one-line entry
• PROJECT.md updated with current state
• Git tag v{{version}} created
• Commit successful
• User knows next steps </success_criteria>

<critical_rules>

• Load workflow first: Read complete-milestone.md before executing
• Verify completion: All releases must have SUMMARY.md files
• User confirmation: Wait for approval at verification gates
• Archive before collapsing: Always create archive file before updating ROADMAP.md
• One-line summary: Collapsed milestone in ROADMAP.md should be single line with link
• Context efficiency: Archive keeps ROADMAP.md constant size </critical_rules>