gsd-milestone-summary

Generate a 7-section milestone summary report from project artifacts.

1|Updated Sep 6, 2015
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill gsd-milestone-summary-deerawan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/deerawan/dotfiles/tree/main/claude/skills/gsd-milestone-summary
Command: npx skills add https://github.com/deerawan/dotfiles --skill gsd-milestone-summary-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of onboarding and reviewing a finished project when you only have scattered milestone artifacts across roadmap, requirements, context, and verification documents.

Core Features & Use Cases

  • Milestone version resolution: Determines the correct milestone version from the optional argument, STATE.md, or archived milestone files.
  • Structured one-doc overview: Reads available artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, plus research and retrospective when present) and produces a human-friendly summary.
  • Team-ready output: Writes the result to .planning/reports/MILESTONE_SUMMARY-v{version}.md and presents it inline with an option to continue with interactive Q&A.

Quick Start

Ask the skill to generate the latest milestone brief by running it with no version argument.

Frequently Asked Questions about gsd-milestone-summary

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

FAQPage Schema
How do I create a milestone summary from scattered project documentation?

To create a milestone summary, the skill consolidates scattered project artifacts like roadmap, requirements, context, and verification documents into a single structured 7-section report for review and onboarding.

How do I generate a project brief for onboarding without specifying a version?

You can generate a project brief by running the skill with no version argument. It resolves the correct milestone version automatically from STATE.md or archived milestone files to produce the summary.

What is the best way to consolidate roadmap and requirements documents for phase review?

The best way to consolidate roadmap and requirements documents is using a milestone summary tool that reads phase artifacts and outputs a human-friendly overview report directly to your planning directory.

Can I update STATE.md automatically when generating milestone documentation?

Yes, generating milestone documentation updates STATE.md automatically. The skill writes the structured project brief to a reports directory and modifies the state file as part of its core processing logic.

Does milestone summary generation support interactive Q&A for project review?

Yes, milestone summary generation supports interactive Q&A. After writing the consolidated milestone report inline, the skill provides an option to continue with an interactive question and answer session for further review.

What do I need to generate a milestone summary for a specific project version?

You need available milestone artifacts such as ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, and VERIFICATION documents. You can optionally specify a target version, or the skill resolves it from STATE.md and archived files.