gsd-insert-phase

Insert a phase into ROADMAP.md and renumber subsequent phases.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-insert-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-insert-phase
Source: https://github.com/optivent/gsd-kimi-cli/tree/main/skills/gsd-insert-phase
Command: npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-insert-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inserts a new phase at a chosen position in the project roadmap, enabling teams to insert work without breaking the surrounding phase order.

Core Features & Use Cases

  • Insertion at a specific position in the roadmap with automatic renumbering of subsequent phases.
  • Validation of the insertion point and integration with ROADMAP.md to keep a consistent project structure.
  • Use Case: Adjust a plan when priorities change and you need to insert a design phase between existing planning and execution.

Quick Start

Run /skill:gsd-insert-phase <position> "Phase Title" "Brief description" to insert a new phase at the specified position.

Frequently Asked Questions about gsd-insert-phase

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

FAQPage Schema
How do I insert a new phase into a project roadmap without breaking the phase ordering?

To insert a new phase without breaking the roadmap ordering, specify a target position, phase title, and description. The system validates the insertion point and automatically renumbers all subsequent phases to maintain sequence consistency.

How does phase renumbering work when adjusting milestones in project management?

Phase renumbering works by automatically shifting the sequence numbers of all subsequent phases after a new phase is inserted. This ensures your roadmap milestones and state references remain consistent without manual updates.

What is the best way to add a design phase between existing planning and execution phases?

The best way to add a design phase between existing planning and execution phases is to specify the exact insertion position in your roadmap. The system handles the integration and renumbers the following execution phases automatically.

Can I insert a phase at any position in the ROADMAP.md file?

Yes, you can insert a phase at any specified position in the ROADMAP.md file. The system applies validation to the insertion point and updates state references to ensure your project structure remains consistent.

Does inserting a project phase require manual updates to subsequent milestones?

No, inserting a project phase does not require manual updates to subsequent milestones. The system automatically validates the insertion position and applies renumbering logic to all downstream phases.

When should I use an automated phase insertion tool for roadmap planning?

You should use an automated phase insertion tool when priorities change during roadmap planning and you need to add work between existing phases. It prevents manual renumbering errors and maintains milestone consistency.