gsd-milestone-summary

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

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-milestone-summary-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-milestone-summary
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-milestone-summary-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) and produces a concise milestone overview for team onboarding and review.

Core Features & Use Cases

  • Reads and consolidates milestone artifacts to create a single source of truth for new team members.
  • Supports archived milestones across versions and all related documents for thorough reviews.
  • Outputs a formatted MILESTONE_SUMMARY to .planning/reports/ and updates STATE.md for traceability.

Quick Start

Run the milestone-summary workflow for version vX.Y.Z to generate a new MILESTONE_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, run the workflow for a specific version to read ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION artifacts. It outputs a formatted MILESTONE_SUMMARY-v{version}.md to .planning/reports and updates STATE.md.

What is a milestone summary and what does it include?

A milestone summary is a human-friendly overview consolidating project artifacts for onboarding and review. It includes seven sections: Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, and Getting Started.

Can I create project review reports for archived milestone versions?

Yes, you can generate project review reports for archived milestones across versions. The workflow reads all related documents for any specified version to enable rapid knowledge transfer and structured project reviews.

What is the best way to consolidate project artifacts for new team members?

The best way to consolidate project artifacts is to use an automated workflow that reads ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION files to produce a single source of truth for new team members.

Do I need specific artifact files to generate project documentation?

Yes, you need milestone artifacts like ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION files. The workflow reads these specific documents to orchestrate end-to-end milestone summary generation.

Where does the generated milestone overview report get saved?

The generated milestone overview report is saved as MILESTONE_SUMMARY-v{version}.md in the .planning/reports directory. The workflow also updates STATE.md to maintain project traceability.