skills.rest
catlog22
catlog22COMMUNITY
Explore all skills by this author →
GitHub

maestro-milestone-complete

Archive completed milestones and update project state in repository workflows.

511|63|Updated Mar 17, 2026
Search Tags:#automation#workflow#audit#archive#state-management#learnings#milestone
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-milestone-complete
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maestro-milestone-complete
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/maestro-milestone-complete
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-milestone-complete

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about maestro-milestone-complete

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

FAQPage Schema
How do I automate project milestone archival and update workflow state?▼

Automating project milestone archival involves validating audit reports, verifying phase completion, copying artifacts into a milestone directory, extracting learnings, and updating the state file.

What is the best way to consolidate reflection logs into a single learnings file?▼

The best way to consolidate reflection logs is to aggregate them into a markdown file, applying duplication checks to capture strategy adjustments, patterns, and pitfalls without manual bookkeeping.

Can I archive a milestone if the audit report validation fails?▼

Yes, you can archive a milestone if audit validation fails by specifying an explicit --force bypass, which allows emergency overrides to proceed with the archival and state update process.

How does state management work when closing a milestone phase?▼

State management when closing a milestone advances the current milestone pointer, resets the current phase and counters in the state file, preserves accumulated context, and removes archived phase directories.

Does the milestone archival process automatically commit changes to git?▼

The milestone archival process optionally commits changes to git after safely copying roadmap snapshots, phase directories, and audit reports into the workflow archive folder for historical preservation.

Related Skills

Explore More Software Engineering Skills→
hadpadrahulhadpadrahul

gsd-complete-milestone

Audit, archive, and update project state for completed milestones.

Community
Advanced
yusaduymazyusaduymaz

gsd-new-milestone

Start a new milestone cycle and update planning artifacts for existing projects.

Community
Advanced
DuySeuDuySeu
1

gsd-add-phase

Adds an integer phase to the current milestone in the project roadmap.

Community
Advanced
Sh3rd3nSh3rd3n
3

quick

Execute atomic one-off tasks with commit tracking and quality gates.

Community
Intermediate