gsd-phase

Manage CRUD operations for roadmap phases in ROADMAP.md via routed commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-phase-beibei-clic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-phase
Source: https://github.com/BeiBei-Clic/ai-skills/tree/main/gsd-phase
Command: npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-phase-beibei-clic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a roadmap grows, updating milestones and phase numbers becomes slow and error-prone—especially when you need to add urgent work, remove obsolete tasks, or revise phase details.

Core Features & Use Cases

  • Add phases (default): Append a new integer phase to the current milestone using the add-phase workflow.
  • Insert urgent phases: Add a decimal phase (e.g., 72.1) after a specified existing phase to preserve ordering via the insert-phase workflow.
  • Remove and renumber: Delete a future phase and automatically renumber subsequent phases via the remove-phase workflow.
  • Edit phases in place: Update fields of an existing phase without rebuilding the roadmap via the edit-phase workflow.
  • Use case: You’re planning a release and realize a critical task must land between two existing phases; you insert it as 72.1 and keep everything consistent without manual renumbering.

Quick Start

Run gsd-phase with --insert to add an urgent decimal phase after a chosen phase number.

Frequently Asked Questions about gsd-phase

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

FAQPage Schema
How do I add an urgent task between existing roadmap phases without renumbering everything?

Insert an urgent task between existing roadmap phases by using the insert workflow to add a decimal phase (e.g., 72.1) after a specified integer phase, preserving the original ordering without manual renumbering.

How do I manage roadmap phases in a markdown file?

Manage roadmap phases in a markdown file by running a single routed command that parses arguments to add, insert, remove, or edit phase entries directly within ROADMAP.md.

Can I automatically renumber subsequent phases after removing a milestone?

Yes, removing a future phase automatically triggers safe renumbering of all subsequent phases, ensuring the remaining roadmap milestones stay sequential and consistent.

What is the best way to update an existing phase field in a project roadmap?

Update an existing phase field in a project roadmap by using the edit workflow to modify entry details in-place, avoiding the need to rebuild the entire roadmap structure.

Do I need any external dependencies to track project phases with this workflow?

No external dependencies are required to track project phases, as the workflow operates entirely by parsing user arguments and routing them to built-in phase management commands.

Roadmap phase editing not working when trying to insert a new milestone?

If roadmap phase editing fails during insertion, ensure the leading flag is correctly provided in the arguments so the command can route execution to the insert-phase workflow with validation gates preserved.