skills.rest
MichaelsEngineering
MichaelsEngineeringCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gpd-insert-phase

Insert urgent research work as decimal phases between existing roadmap phases.

Updated Mar 18, 2026
Search Tags:#project management#roadmap#research planning#milestone#phase insertion#gpd#decimal numbering
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-insert-phase-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-insert-phase
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-insert-phase
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-insert-phase-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When urgent research tasks surface mid-milestone, renumbering an entire project roadmap is disruptive and error-prone. This Skill inserts the new work as a decimal phase (e.g., 72.1) between existing integer phases, preserving the planned sequence while accommodating the insertion. ## Core Features & Use Cases - Decimal Phase Insertion: Delegates to the gpd CLI to calculate the next decimal number, generate a slug, create the phase directory, and update ROADMAP.md with an (INSERTED) marker. - State Synchronization: Records the insertion decision via gpd state commands so STATE.md and state.json stay in sync without manual edits. - Use Case: A reviewer flags a missing limiting case before Phase 73 can proceed. Run the insertion after Phase 72 to create Phase 72.1 for the urgent convergence study without renumbering later phases. ## Quick Start Ask the assistant to insert an urgent phase after phase 72 with a description such as "Regularize UV divergence in self-energy".

Frequently Asked Questions about gpd-insert-phase

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

FAQPage Schema
How do I insert an urgent phase into a project roadmap without renumbering?▼

Provide the integer phase number to insert after plus a description. The gpd CLI calculates the next decimal number (e.g., 72.1), creates the phase directory, and adds the entry to ROADMAP.md with an (INSERTED) marker.

How to add unplanned research work mid-milestone in gpd?▼

Use the insert-phase workflow for urgent work discovered during execution, such as a missing limiting case or numerical instability. For planned work at the end of a milestone, use the add-phase command instead.

Can I insert a phase before Phase 1 in the roadmap?▼

No. Inserting before Phase 1 is rejected because a decimal 0.1 phase makes no sense in the numbering scheme. The first argument must be an existing integer phase number.

Why does phase insertion fail with a roadmap error?▼

Insertion fails when no roadmap exists at .gpd/ROADMAP.md or when the target phase number is not found. The init step checks roadmap_exists and stops with an error before any changes are made.

Does inserting a phase also create its plan?▼

No. The insertion only creates the phase directory and roadmap entry with status Not planned yet. Planning is a separate step handled by the plan-phase command afterward.

Related Skills

Explore More Education & Research Skills→
MichaelsEngineeringMichaelsEngineering

gpd-insert-phase

Insert urgent research work as decimal phases between existing roadmap phases.

Community
Intermediate
coco-researchcoco-research
264

gsd-insert-phase

Insert urgent tasks between integer phases using decimal numbering.

Community
Intermediate
aslaiiaslaii

gsd-insert-phase

Insert a decimal phase after a specified phase number in roadmaps.

Community
Advanced
aydadevelopaydadevelop

gsd-insert-phase

Insert urgent work as decimal phases into project roadmaps.

Official
Intermediate