gsd-milestone-summary

Consolidate milestone artifacts into a structured MILESTONE_SUMMARY report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) and produces a structured milestone overview to help new team members understand what was built, how, and why.

Core Features & Use Cases

  • Read and consolidate milestone artifacts from the planning directory.
  • Generate a human-friendly MILESTONE_SUMMARY with versioning for archival milestones.
  • Support onboarding and project reviews with an optional interactive Q&A.
  • STATE.md is updated to reflect the latest milestone status.

Quick Start

Ask Claude to generate a milestone summary from the available planning artifacts.

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 new team member onboarding?

Generate a milestone summary by reading planning artifacts like ROADMAP, REQUIREMENTS, and CONTEXT to produce a structured overview for onboarding. The tool consolidates these files into a human-friendly report explaining what was built, how, and why.

What project management artifacts are consolidated during a project review?

Project review artifacts consolidated include ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, and RETROSPECTIVE files. The tool reads these milestone artifacts from the planning directory to generate a comprehensive structured overview.

How does milestone versioning work for archival project reviews?

Milestone versioning for archival reviews writes the generated summary to MILESTONE_SUMMARY-v{version}.md. This versioned file is saved in the reports directory, ensuring historical project milestones remain accessible and organized.

Does generating a milestone overview update the project state file?

Generating a milestone overview updates STATE.md to reflect the latest milestone status. This ensures the project's state tracking remains synchronized with the newly generated milestone summary and archival versions.

Can I use milestone summaries for interactive project reviews?

Milestone summaries support project reviews with an optional interactive Q&A feature. This allows new team members to query the consolidated milestone artifacts directly, facilitating a deeper understanding of project context and requirements.

What is the best way to consolidate planning files for a structured milestone overview?

The best way to consolidate planning files is to automatically read and merge ROADMAP, REQUIREMENTS, and CONTEXT artifacts into a single structured overview. This approach ensures new team members understand the built features and their rationale.