skills.rest
dobrinz123
dobrinz123COMMUNITY
Explore all skills by this author →
GitHub

gsd-milestone-summary

Generate milestone summaries from .planning artifacts into seven-section reports.

Updated Apr 9, 2026
Search Tags:#planning#documentation#onboarding#verification#roadmap#milestone#project-summary
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-milestone-summary-dobrinz123
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/skills/gsd-milestone-summary
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-milestone-summary-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often have milestone artifacts scattered across ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, and RETROSPECTIVE files, making it time-consuming for new members or stakeholders to understand what was built and why. This Skill consolidates those artifacts into a single, readable milestone summary that surfaces the architecture, decisions, requirements, tech debt, and next steps.

Core Features & Use Cases

  • Artifact aggregation: Reads current and archived .planning files and per-phase SUMMARY/VERIFICATION/CONTEXT to gather source material.
  • Version resolution & reporting: Determines milestone version from arguments, STATE.md, or archive scan and writes a standardized MILESTONE_SUMMARY to .planning/reports/.
  • Structured output & handoff: Produces seven sections (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started), presents the summary inline, offers interactive Q&A, and updates project STATE for traceability.
  • Use Case: Rapidly onboard a new engineer or prepare a stakeholder review with one authoritative document derived from milestone artifacts.

Quick Start

Generate a milestone summary for the latest completed milestone and save 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 milestone summary for onboarding from scattered planning files?▼

Generate a milestone summary by reading archived and current .planning files, resolving the milestone version, and assembling seven structured sections into a single onboarding-friendly document. The summary is written to .planning/reports and presented inline for immediate review.

What files do I need to consolidate for a comprehensive project milestone review?▼

A comprehensive milestone review consolidates ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, and RETROSPECTIVE files. It aggregates current and archived .planning artifacts to surface architecture, decisions, requirements, tech debt, and next steps.

Can I automate roadmap documentation for new team members from existing artifacts?▼

Yes, you can automate roadmap documentation by having the Skill read per-phase SUMMARY, VERIFICATION, and CONTEXT files. It produces a standardized MILESTONE_SUMMARY report and updates project STATE.md for traceability, enabling rapid onboarding.

What sections are included in a structured milestone summary for stakeholder handoff?▼

A structured milestone summary includes seven sections: Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started. These sections provide a complete view of what was built and why for stakeholder review.

Does milestone version resolution work without explicitly specifying the version number?▼

Milestone version resolution works without explicit specification by checking provided arguments, reading STATE.md, or scanning the archive. This ensures the correct milestone artifacts are aggregated even when the version is not directly supplied.

How do I handle retrospective and verification documentation when preparing a milestone report?▼

Handle retrospective and verification documentation by reading per-phase VERIFICATION and RETROSPECTIVE files alongside current .planning artifacts. The Skill aggregates these into the Tech Debt and Requirements sections of the final milestone report.

Related Skills

Explore More Product & Management Skills→
FerroxLabsFerroxLabs
21

ferrox-milestone-summary

Generates milestone summaries from planning and verification artifacts for onboarding and review.

Community
Advanced
hadpadrahulhadpadrahul

gsd-milestone-summary

Generate a structured MILESTONE_SUMMARY document from project artifacts.

Community
Advanced
u9401066u9401066

roadmap-updater

Update ROADMAP.md statuses from commits during git workflows.

Community
Basic
tinner-deinnotinner-deinno

gsd-milestone-summary

Compile milestone artifacts into a structured summary report.

Community
Intermediate