gsd-add-phase

Add an integer phase to the current milestone in a roadmap.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/coco-research/coco --skill gsd-add-phase-coco-research
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/coco-research/coco/tree/main/systems/gsd/skills/gsd-add-phase
Command: npx skills add https://github.com/coco-research/coco --skill gsd-add-phase-coco-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual overhead of extending a roadmap by adding the next phase in the correct order and keeping milestone state aligned.

Core Features & Use Cases

  • Calculates the next integer phase number for the current milestone.
  • Generates a clean slug from the phase description and creates the new phase directory.
  • Updates the roadmap structure and records the change in STATE.md for evolution tracking.
  • Use it when you need to expand an active milestone with a newly planned phase without breaking roadmap consistency.

Quick Start

Ask the assistant to add a new phase to the current milestone using your phase description.

Frequently Asked Questions about gsd-add-phase

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

FAQPage Schema
How do I add a new phase to a roadmap milestone without breaking the sequential numbering?▼

Adding a roadmap phase requires calculating the next sequential integer, generating a slug from the phase description, creating the directory, and updating STATE.md for evolution tracking to keep milestone structure aligned.

What is the process for generating slugs and directories when extending a roadmap?▼

Slug generation derives a clean identifier from the phase description, then directory creation physically establishes the new phase folder within the milestone, ensuring the roadmap structure remains organized.

Can I use this to append a phase to any milestone in my project roadmap?▼

This appends a new integer phase to the end of the current milestone in a roadmap. It specifically targets the active milestone context to calculate the next phase number and update the structure.

Why does adding a roadmap phase require updating STATE.md?▼

STATE.md evolution tracking records the roadmap structural change when a phase is inserted. This ensures the milestone state remains aligned and provides a traceable history of roadmap modifications.

Do I need to manually calculate the next phase number when planning a new milestone phase?▼

No manual calculation is needed. The workflow automatically determines the next sequential integer phase number for the current milestone, handles roadmap entry insertion, and maintains the correct phase order.