gsd-milestone-summary

Generate a structured milestone summary from milestone artifacts and update STATE.md.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-milestone-summary-poom5741
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/Poom5741/eggo-world-pb/tree/main/.qwen/skills/gsd-milestone-summary
Command: npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-milestone-summary-poom5741

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a structured milestone summary from milestone artifacts to onboard new team members and enable project reviews.

Core Features & Use Cases

  • Reads milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) and archived versions, producing a comprehensive overview including Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started.
  • Writes the Milestone Summary to .planning/reports/MILESTONE_SUMMARY-v{version}.md and surfaces it inline for quick review, with optional interactive Q&A.
  • Automatically updates STATE.md as part of the workflow to reflect the latest milestone status.

Quick Start

Invoke the milestone-summary skill with an optional version parameter to generate and save the milestone summary document.

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 milestone summary for project onboarding and reviews?

Generate a milestone summary by reading milestone artifacts like ROADMAP, REQUIREMENTS, and CONTEXT to produce MILESTONE_SUMMARY-v{version}.md. This structured overview covers architecture, phases, decisions, requirements, tech debt, and getting started sections.

What milestone artifacts are needed to produce a structured project summary?

Milestone artifacts required include ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION files, along with archived versions. The skill reads these artifacts to extract architecture, phases, decisions, requirements, and tech debt information for the final overview.

How does generating a milestone summary update project state documentation?

Generating a milestone summary automatically updates STATE.md to reflect the latest milestone status. This ensures project tracking remains synchronized with the newly created MILESTONE_SUMMARY-v{version}.md report located in the .planning/reports directory.

Can I generate a milestone summary for a specific archived project version?

Yes, you can generate a summary for a specific archived version by invoking the milestone summary skill with an optional version parameter. The skill locates the requested version, reads all related artifacts, and outputs MILESTONE_SUMMARY-v{version}.md.

What is the best way to onboard new team members using existing milestone documentation?

The best way to onboard members is generating a milestone summary from existing project artifacts. This creates a comprehensive overview covering architecture, phases, decisions, requirements, tech debt, and getting started sections, surfacing inline for quick review.

Where is the milestone summary report saved after processing project artifacts?

The milestone summary report is saved as MILESTONE_SUMMARY-v{version}.md inside the .planning/reports directory. It is also surfaced inline for quick review and supports optional interactive Q&A to help new team members explore project details.