legion:milestone-tracker

Manage milestone lifecycle and validate Phorminance and Plan documents for automated Grading.

72|8|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/9thLevelSoftware/legion --skill legion-milestone-tracker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: legion:milestone-tracker
Source: https://github.com/9thLevelSoftware/legion/tree/main/skills/milestone-tracker
Command: npx skills add https://github.com/9thLevelSoftware/legion --skill legion-milestone-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates and enforces milestone lifecycle management so teams can accurately determine when a milestone is complete, generate consistent completion summaries, and archive phase artifacts without manual file juggling or inconsistent reporting.

Core Features & Use Cases

  • Milestone Definition & Validation: Auto-propose milestone groupings from ROADMAP.md phases, validate ranges for gaps/overlaps, and write a standardized ## Milestones section.
  • Completion Checks & Summaries: Verify all phases and plans are complete, aggregate quantitative metrics (plans, requirements, file counts), and produce .planning/milestones/MILESTONE-{N}.md summaries.
  • Archiving & State Updates: Move phase directories to .planning/archive/milestone-{N}/, update ROADMAP.md and STATE.md to reflect Archived status, and handle partial archives and permission errors.
  • Use Case: When preparing a release, run the milestone completion flow to confirm all phase work is finished, generate metrics-backed summaries for stakeholders, and archive completed phase artifacts.

Quick Start

Ask the milestone tracker to complete and archive Milestone 2 by validating its phases, generating the milestone summary, and moving its phase directories to the archive.

Frequently Asked Questions about legion:milestone-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate milestone completion from roadmap phases before a release?▼

Milestone completion validation checks ROADMAP.md phases and plan statuses to confirm all work is finished. It aggregates metrics like requirements and file counts, then generates a summary in .planning/milestones/MILESTONE-{N}.md for release preparation.

What is the best way to archive completed project phase directories automatically?▼

Archiving completed phase directories involves moving them to .planning/archive/milestone-{N}/ and updating ROADMAP.md and STATE.md to reflect the Archived status. The process handles partial archives and reports any permission failures encountered during file movement.

How do I group roadmap phases into milestones and check for gaps or overlaps?▼

Milestone grouping proposes combinations from ROADMAP.md phases and validates ranges to identify gaps or overlaps. It writes a standardized ## Milestones section back into ROADMAP.md, ensuring logical progression without missing or duplicated phase coverage.

Can I generate milestone summaries that include quantitative metrics for stakeholders?▼

Milestone summaries aggregate quantitative metrics including plans, requirements, and file counts. The generated .planning/milestones/MILESTONE-{N}.md file provides stakeholders with a consistent, metrics-backed view of completed milestone work.

Why does milestone archiving fail with permission errors when moving phase directories?▼

Permission errors during milestone archiving occur when the process lacks write access to move phase directories into .planning/archive/milestone-{N}/. The system reports these validation errors and permission failures directly, allowing manual correction of access rights.

Does milestone tracking require updating STATE.md and ROADMAP.md simultaneously?▼

Milestone tracking requires updating both STATE.md and ROADMAP.md to accurately reflect Archived status. This ensures project state remains consistent across files after phase directories are successfully moved to the archive.