insert-phase

Insert urgent phases into ROADMAP.md and STATE.md using decimal numbering.

Updated Jan 12, 2026

Search Tags:#planning #project management #task management #roadmap #agile #urgent tasks

Ready to run

npx skills add https://github.com/sidunrealde/ArchVis --skill insert-phase

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: insert-phase
Source: https://github.com/sidunrealde/ArchVis/tree/main/.github/skills/insert-phase
Command: npx skills add https://github.com/sidunrealde/ArchVis --skill insert-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows for the urgent insertion of new tasks or phases into an existing roadmap without disrupting the overall sequence or requiring extensive re-planning.

Core Features & Use Cases

Decimal Phase Insertion: Inserts new phases using decimal numbering (e.g., 72.1, 72.2) to maintain logical order.
Automated Renumbering Avoidance: Prevents the need to renumber all subsequent phases when urgent work arises.
Roadmap and State Updates: Automatically updates the ROADMAP.md and STATE.md files to reflect the new phase.
Use Case: A critical bug is discovered during milestone 72. This Skill can insert a new phase like "72.1 Fix critical auth bug" to address it immediately while keeping the original plan for phase 73 intact.

Quick Start

Insert a new phase after phase 72 with the description "Fix critical auth bug".

Frequently Asked Questions about insert-phase

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

FAQPage Schema

How do I insert urgent tasks into an existing project roadmap without renumbering everything?▼

Decimal phase numbering inserts urgent work as sub-phases like 72.1 to maintain sequence. It updates ROADMAP.md and STATE.md directly, avoiding the need to renumber subsequent phases.

What is decimal phase numbering in agile project management?▼

Decimal phase numbering is a method to insert urgent tasks mid-milestone using numbers like 72.1. It maintains logical order in the roadmap without disrupting the original sequence of subsequent phases.

How do I add a critical bug fix to a roadmap mid-milestone?▼

To add a critical bug fix mid-milestone, insert a new decimal phase into the roadmap. This updates ROADMAP.md and STATE.md to accommodate the urgent work while keeping the original milestone plan intact.

Do I need gsd-tools to insert urgent phases into a roadmap?▼

Yes, gsd-tools is required as it provides the core phase insertion logic. The Skill parses arguments for the phase number and description to update the roadmap and state files correctly.

What's the best way to handle urgent work that interrupts an agile roadmap sequence?▼

The best way to handle urgent work is to insert a decimal-numbered phase mid-milestone. This prevents extensive re-planning by adding the urgent task directly without altering later milestones.