gsd-milestone-summary

Generate milestone summary reports from project artifacts into Markdown.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-milestone-summary-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-milestone-summary
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-milestone-summary-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically distills milestone artifacts into a single, onboarding-friendly summary so new team members quickly understand project scope, progress, and decisions.

Core Features & Use Cases

  • Reads milestone artifacts (ROADMAP, PROJECT, STATE, RETROSPECTIVE, CONTEXT, VERIFICATION) and archived milestones to generate a structured overview.
  • Produces sections including Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started for fast comprehension.
  • Use Case: Onboarding new engineers or product managers by giving them a single, comprehensive briefing document.

Quick Start

Initiate the milestone-summary workflow to read available artifacts and write the report to .planning/reports/MILESTONE_SUMMARY-v{version}.md

Frequently Asked Questions about gsd-milestone-summary

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

FAQPage Schema
How do I generate a project milestone summary for onboarding new engineers?

Generate a milestone summary by reading project artifacts like ROADMAP and CONTEXT to produce a structured overview document. The output is written to a designated reports directory to accelerate team onboarding and project reviews.

What is the best way to consolidate milestone artifacts into a single briefing document?

Consolidate milestone artifacts by composing a multi-section report covering Overview, Architecture, Phases, Decisions, and Tech Debt. This distills scattered project files into a single, human-friendly briefing for fast comprehension.

How does automated milestone documentation handle archived project phases?

Automated milestone documentation reads archived milestones alongside current REQUIREMENTS and VERIFICATION files. It extracts historical decisions and phase data to ensure the generated summary reflects the complete project trajectory.

Can I use project roadmaps and state files to create a technical debt overview?

Yes, project roadmaps and state files are read to create a technical debt overview. The process extracts debt-related information from milestone artifacts and includes it as a dedicated section in the final summary report.

Does generating an onboarding summary require specific file formats or directory structures?

Generating an onboarding summary requires designated milestone artifacts such as ROADMAP, SUMMARY, and CONTEXT files. The workflow reads these specific formats and writes the resulting report to a designated planning reports directory.

Why does my milestone summary workflow update the project state file?

The milestone summary workflow updates the project state file to track the generation of the latest report version. This ensures project tracking files reflect the newest onboarding documentation output and maintain accurate milestone records.