gpd-plan-milestone-gaps

Creates roadmap phases that close gaps identified by a research milestone audit.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --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/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-plan-milestone-gaps
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-plan-milestone-gaps-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After auditing a research milestone, you are left with a list of gaps—missing derivations, unchecked limiting cases, unvalidated numerical results—and no structured plan to fix them. This Skill reads the MILESTONE-AUDIT.md file, groups the gaps into logical phases, and updates ROADMAP.md so every gap has a dedicated closure phase without manual phase-by-phase creation. ## Core Features & Use Cases - Audit Gap Parsing: Loads the most recent .gpd/v*-MILESTONE-AUDIT.md file and extracts requirement, consistency, and completeness gaps from its YAML frontmatter. - Prioritized Phase Grouping: Clusters related gaps by physics topic, method, and dependency order into focused phases of 2-4 tasks, prioritized by must/should/nice severity. - Roadmap and Directory Updates: Adds new phase entries to ROADMAP.md, creates phase directories under .gpd/phases/, and commits the changes via the GPD CLI. - Use Case: A physics researcher finishes a milestone audit revealing an unchecked strong-coupling limit, inconsistent unit conventions, and a missing literature comparison. Running this Skill produces three new gap-closure phases in the roadmap, ready to be planned individually. ## Quick Start Ask the assistant to run the plan-milestone-gaps workflow to create phases closing all gaps from the latest milestone audit.

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 create phases to close milestone audit gaps?▼

Run the plan-milestone-gaps workflow after completing a milestone audit. It reads the most recent MILESTONE-AUDIT.md file, groups the identified gaps into logical phases, and adds them to ROADMAP.md automatically.

What kinds of research gaps does milestone gap planning handle?▼

It handles missing derivations, unchecked limiting cases, unvalidated numerical results, missing error analysis, incomplete literature comparisons, unsupported claims, internal inconsistencies, and dimensional or symmetry violations.

What happens if no milestone audit file exists?▼

The workflow stops with an error message telling you to run the audit-milestone command first. Gap closure phases cannot be created without a parsed audit file containing structured gaps.

How are audit gaps grouped into phases?▼

Gaps are clustered by shared physics topic, shared computational method, and dependency order, keeping each phase focused at 2-4 tasks. Priorities follow the must/should/nice levels from REQUIREMENTS.md, with nice-to-have gaps offered as optional.

Can I defer low-priority gaps to a later milestone?▼

Yes. Nice-to-have gaps are presented separately as deferred options, and you confirm whether to include them, adjust the plan, or defer all optional items before any phases are created.