gsd-plan-milestone-gaps

Group milestone audit gaps into phases and update ROADMAP.md.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-plan-milestone-gaps-dobrinz123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-plan-milestone-gaps
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/skills/gsd-plan-milestone-gaps
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-plan-milestone-gaps-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious and error-prone process of turning milestone audit findings into concrete, tracked phases in your project roadmap so teams don't miss required fixes.

Core Features & Use Cases

  • Audit ingestion: Reads the most recent .planning/v*-MILESTONE-AUDIT.md to collect identified gaps.
  • Phase grouping and prioritization: Groups related gaps into logical fix phases and applies prioritization gates before making changes.
  • Roadmap updates with confirmation: Creates phase entries in ROADMAP.md while preserving workflow gates and asking for user confirmation to avoid accidental edits.
  • Use case: After running a milestone audit, automatically generate a set of prioritized roadmap phases to close all security, QA, and delivery gaps without manually adding each phase.

Quick Start

Run gsd-plan-milestone-gaps to read the latest milestone audit, group gaps into fix phases, and append confirmed entries to ROADMAP.md.

Frequently Asked Questions about gsd-plan-milestone-gaps

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

FAQPage Schema
How do I turn milestone audit findings into roadmap phases automatically?

To turn milestone audit findings into roadmap phases, this Skill reads the latest .planning/v*-MILESTONE-AUDIT.md file, groups related gaps logically, and proposes phase entries for your ROADMAP.md. It applies prioritization gates and requests user confirmation before appending any confirmed phases to prevent accidental edits.

What is the best way to update a project roadmap after a milestone audit?

The best way to update a project roadmap after a milestone audit is to group identified gaps into logical fix phases and append them to ROADMAP.md. This Skill preserves existing workflow gates and requires user confirmation before modifying the roadmap to ensure accurate project planning.

Can I automatically group security and QA gaps from an audit file into project phases?

Yes, you can automatically group security, QA, and delivery gaps from an audit file into project phases. The Skill ingests the most recent MILESTONE-AUDIT.md, logically clusters related issues, and proposes structured roadmap entries to close those gaps without manually adding each phase.

Does the roadmap update process require manual confirmation before editing?

Yes, the roadmap update process requires manual confirmation before editing. The Skill applies prioritization gates to grouped gaps and asks for user confirmation to avoid accidental edits, ensuring you maintain control over the phases added to your ROADMAP.md file.

When do I need to generate fix phases from a milestone audit file?

You need to generate fix phases from a milestone audit file when your audit identifies security, QA, or delivery gaps that require tracked remediation. This Skill reads the v*-MILESTONE-AUDIT.md output and translates those gaps into structured entries for your project planning workflow.

Will this Skill preserve existing workflow gates when appending new phases to the roadmap?

Yes, this Skill will preserve existing workflow gates when appending new phases to the roadmap. It reads the MILESTONE-AUDIT.md, groups the gaps, and carefully updates ROADMAP.md with confirmed phase entries while maintaining all previously established project planning gates.