gpd-plan-milestone-gaps

Generate phased plans from milestone audit gaps and update ROADMAP.md.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-plan-milestone-gaps-michaelsengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-plan-milestone-gaps
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-plan-milestone-gaps
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-plan-milestone-gaps-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts findings from a milestone audit into a structured plan by grouping gaps into logical phases, enabling a clear roadmap update and auditable task execution.

Core Features & Use Cases

  • Parse the most recent milestone audit to extract gaps categorized as requirements, consistency, and completeness.
  • Cluster related gaps into 2-4 task-focused phases and update ROADMAP.md with phase entries.
  • Create phase directories under .gpd/phases for reviewer confirmation and execution linking.

Quick Start

Run the plan-milestone-gaps workflow to generate phase plans from the latest milestone audit and update the ROADMAP.

Frequently Asked Questions about gpd-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 a phased project roadmap?

To convert milestone audit gaps into a phased project roadmap, this Skill reads your latest milestone audit file, clusters gaps into 2-4 task-focused phases, and updates your ROADMAP.md with entries. It groups gaps by requirements, consistency, and completeness for clear execution.

What is the best way to structure research milestone gaps for reviewer execution?

The best way to structure research milestone gaps for reviewer execution is by creating dedicated phase directories under .gpd/phases. This workflow generates auditable task groupings from the milestone audit, enabling reviewers to confirm and link phase execution easily.

How do I update a GPD roadmap after completing a milestone audit?

You can update a GPD roadmap after completing a milestone audit by running this workflow to parse the v*-MILESTONE-AUDIT.md file. It automatically clusters extracted gaps into logical phases and writes these phase entries directly into your ROADMAP.md file.

Do I need a specific file format to generate phased plans from a milestone audit?

Yes, you need the v*-MILESTONE-AUDIT.md file format to generate phased plans. The workflow parses this specific markdown audit file to extract requirements, consistency, and completeness gaps before grouping them into phases within your .gpd project structure.

Can I group audit findings into phases automatically for project management?

You can group audit findings into phases automatically for project management by running this workflow. It reads the latest milestone audit, clusters related gaps into 2-4 task-focused phases, and creates corresponding directories for structured researcher review.