gh-glittercowboy-taches-cc-resources/skills/create-plans/templates/milestone.md

Milestone Entry Template

Add this entry to .planning/MILESTONES.md when completing a milestone:

## v[X.Y] [Name] (Shipped: YYYY-MM-DD)

**Delivered:** [One sentence describing what shipped]

**Phases completed:** [X-Y] ([Z] plans total)

**Key accomplishments:**
- [Major achievement 1]
- [Major achievement 2]
- [Major achievement 3]
- [Major achievement 4]

**Stats:**
- [X] files created/modified
- [Y] lines of code (primary language)
- [Z] phases, [N] plans, [M] tasks
- [D] days from start to ship (or milestone to milestone)

**Git range:** `feat(XX-XX)` → `feat(YY-YY)`

**What's next:** [Brief description of next milestone goals, or "Project complete"]

---

If MILESTONES.md doesn't exist, create it with header:

# Project Milestones: [Project Name]

[Entries in reverse chronological order - newest first]

**When to create milestones:** - Initial v1.0 MVP shipped - Major version releases (v2.0, v3.0) - Significant feature milestones (v1.1, v1.2) - Before archiving planning (capture what was shipped)

Don't create milestones for:

• Individual phase completions (normal workflow)
• Work in progress (wait until shipped)
• Minor bug fixes that don't constitute a release

Stats to include:

• Count modified files: git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1
• Count LOC: find . -name "*.swift" -o -name "*.ts" | xargs wc -l (or relevant extension)
• Phase/plan/task counts from ROADMAP
• Timeline from first phase commit to last phase commit

Git range format:

• First commit of milestone → last commit of milestone
• Example: feat(01-01) → feat(04-01) for phases 1-4

```markdown # Project Milestones: WeatherBar

v1.1 Security & Polish (Shipped: 2025-12-10)

Delivered: Security hardening with Keychain integration and comprehensive error handling

Phases completed: 5-6 (3 plans total)

Key accomplishments:

• Migrated API key storage from plaintext to macOS Keychain
• Implemented comprehensive error handling for network failures
• Added Sentry crash reporting integration
• Fixed memory leak in auto-refresh timer

Stats:

• 23 files modified
• 650 lines of Swift added
• 2 phases, 3 plans, 12 tasks
• 8 days from v1.0 to v1.1

Git range: feat(05-01) → feat(06-02)

What's next: v2.0 SwiftUI redesign with widget support

---

v1.0 MVP (Shipped: 2025-11-25)

Delivered: Menu bar weather app with current conditions and 3-day forecast

Phases completed: 1-4 (7 plans total)

Key accomplishments:

• Menu bar app with popover UI (AppKit)
• OpenWeather API integration with auto-refresh
• Current weather display with conditions icon
• 3-day forecast list with high/low temperatures
• Code signed and notarized for distribution

Stats:

• 47 files created
• 2,450 lines of Swift
• 4 phases, 7 plans, 28 tasks
• 12 days from start to ship

Git range: feat(01-01) → feat(04-01)

What's next: Security audit and hardening for v1.1

</example>