gsd-milestone-summary

Generate structured milestone summaries from ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION artifacts.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rkz91/coco --skill gsd-milestone-summary-rkz91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/rkz91/coco/tree/main/systems/gsd/skills/gsd-milestone-summary
Command: npx skills add https://github.com/rkz91/coco --skill gsd-milestone-summary-rkz91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding and project reviews require quick, comprehensive context. This Skill reads milestone artifacts to generate a structured summary that makes complex projects understandable at a glance.

Core Features & Use Cases

  • Reads ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION artifacts to assemble a complete milestone picture.
  • Produces a human-friendly overview with sections such as Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started.
  • Writes the result to .planning/reports/MILESTONE_SUMMARY-v{version}.md and offers an optional interactive Q&A for follow-ups.
  • Keeps STATE.md in sync to reflect the latest milestone status.

Quick Start

Run the milestone-summary workflow against the latest milestone to generate the summary.

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?

To generate a milestone summary for project onboarding, run the milestone-summary workflow against your latest project milestone. It reads project artifacts and outputs a structured multi-section report to .planning/reports.

What project artifacts are needed to create a milestone summary?

Creating a milestone summary requires ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION artifacts. The tool reads these files to assemble a complete overview including architecture, phases, decisions, and tech debt.

Can I use this milestone summary tool with archived project milestones?

Yes, this milestone summary tool works with archived milestones. It reads both active and archived milestone artifacts to provide a clear, shareable overview for onboarding and project review purposes.

How does the milestone summary workflow update project state tracking?

The milestone summary workflow updates project state tracking by modifying STATE.md. It keeps the state file in sync to reflect the latest milestone status after generating the summary report.

What sections are included in a generated milestone summary report?

A generated milestone summary report includes Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started sections. It produces a human-friendly overview to make complex projects understandable at a glance.

Does the milestone summary workflow support interactive follow-up questions?

Yes, the milestone summary workflow offers an optional interactive Q&A session. After generating the summary and presenting an inline overview, users can ask follow-up questions for additional context.