gpd-insert-phase

Insert urgent tasks by adding decimal phases between existing roadmap phases. This preserves the original sequence by creating intermediate phases like 2.1, updating ROADMAP.md, and synchronizing project state automatically.

Decimal phase insertion works by generating a slug, creating a new directory at .gpd/phases/{N.M-slug}/, and recording an (INSERTED) marker in ROADMAP.md. It uses gpd state commands to ensure full state synchronization and decision traceability.

Add an urgent phase when mid-project discoveries require immediate attention, such as addressing a missing limiting case, resolving a numerical instability, or incorporating a new literature finding without disrupting the established sequence.

Yes, decimal phase insertion is designed for managing numerical instability issues. It slots the urgent work between existing phases, automatically calculating the correct decimal position and creating the necessary directory structure.

The best way to handle urgent task insertion in a GPD roadmap is automating the entire workflow. It calculates the phase position, updates ROADMAP.md with an (INSERTED) marker, creates the phase directory, and synchronizes state via gpd state commands.

ROADMAP.md is updated with an (INSERTED) marker next to the new decimal phase. The state synchronization ensures the roadmap reflects the urgent addition while maintaining the original phase numbering and sequence.