maestro-milestone-complete

What problem does it solve?

This Skill automates the finalization of a milestone by validating audits and phase completion, creating a safe archive of all phase artifacts, extracting and deduplicating learnings, and updating the project state so teams can move to the next milestone without manual bookkeeping.

Core Features & Use Cases

• Audit & Completion Validation: Checks milestone audit reports and verifies every phase index.json status before allowing archival, with an explicit --force bypass for emergency overrides.
• Safe Archival: Copies roadmap snapshots, phase directories, and audit reports into .workflow/milestones/{milestone}/ prior to any cleanup, preserving historical state.
• Knowledge Consolidation: Aggregates reflection logs into .workflow/specs/learnings.md with duplication checks to capture strategy adjustments, patterns, and pitfalls.
• State Management & Cleanup: Advances current_milestone, resets current_phase and counters in .workflow/state.json, preserves accumulated context, removes archived phase directories, and optionally commits the changes to git.
• Use Case: Close a release milestone, produce an auditable archive for stakeholders, and carry forward decisions into planning for the next milestone.

Quick Start

Archive milestone v1.0 and prepare the project for the next milestone by validating audits, copying phase artifacts into .workflow/milestones/v1.0, extracting learnings to specs/learnings.md, and updating .workflow/state.json.