gsd-plan-milestone-gaps

Convert milestone audit gaps into prioritized ROADMAP.md phases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many milestone audits produce long lists of gaps but lack structured follow-through to close them; converting audit findings into prioritized, trackable roadmap phases is repetitive and error-prone when done manually. This Skill automates reading the most recent milestone audit, grouping related gaps into logical phases, and preparing roadmap entries so teams can focus on execution rather than manual project housekeeping.

Core Features & Use Cases

  • Audit ingestion: Locates and reads the most recent .planning/*-MILESTONE-AUDIT.md audit file to extract identified gaps.
  • Phase grouping and prioritization: Groups related gaps into coherent phases and applies prioritization rules while preserving existing planning context.
  • Roadmap updates with gates: Creates phase entries in ROADMAP.md, preserves workflow gates, prompts for user confirmation, and offers to plan each phase end-to-end.
  • Use Case: After performing a milestone audit, run this Skill to batch-create fix phases for release planning and avoid adding phases one gap at a time.

Quick Start

Run the skill to generate proposed roadmap phases from the latest MILESTONE-AUDIT.md and update ROADMAP.md after confirming the suggested groups.

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 convert milestone audit gaps into roadmap phases?

Converting milestone audit gaps into roadmap phases requires reading the latest audit file, grouping related gaps into logical phases, applying prioritization rules, and updating ROADMAP.md with confirmation gates. This automates the transition from audit findings to trackable planning tasks.

What is the best way to prioritize project gaps from a milestone audit?

Prioritizing project gaps from a milestone audit involves grouping related findings into coherent phases and applying structured prioritization rules. This preserves existing planning context while preparing batch roadmap entries for release planning.

How do I batch create fix phases in ROADMAP.md from an audit file?

Batch creating fix phases in ROADMAP.md involves locating the most recent .planning/*-MILESTONE-AUDIT.md file, extracting identified gaps, and grouping them into phase entries. The process preserves workflow gates and prompts for user confirmation before updating.

Can I automate project planning tasks directly from milestone audit findings?

Automating project planning tasks from milestone audit findings is possible by ingesting the latest audit file, applying grouping and prioritization logic, and performing atomic updates to ROADMAP.md. This requires read access to the audit files and user confirmation gates.

Does updating a roadmap from a milestone audit preserve existing workflow gates?

Updating a roadmap from a milestone audit preserves existing workflow gates by applying atomic updates to ROADMAP.md. The process groups related gaps into phases, prompts for user confirmation, and maintains the established planning context throughout the update.

When do I need to group audit gaps into phases for release planning?

Grouping audit gaps into phases for release planning is needed when a milestone audit produces a long list of gaps requiring structured follow-through. This prevents the error-prone manual process of adding roadmap phases one gap at a time.