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.