gsd-add-phase

Add sequential integer phases to project milestones and update roadmap structures.

60|23|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/tomascortereal/claude-code-setup --skill gsd-add-phase-tomascortereal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/tomascortereal/claude-code-setup/tree/main/skills/gsd-add-phase
Command: npx skills add https://github.com/tomascortereal/claude-code-setup --skill gsd-add-phase-tomascortereal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the tedious manual process of adding new phases to project roadmaps, ensuring consistent numbering and automatic structure updates.

Core Features & Use Cases

  • Automated Phase Creation: Automatically calculates next sequential phase numbers and generates descriptive slugs
  • Roadmap Integration: Updates roadmap structures and tracks evolution in STATE.md files
  • Use Case: Product managers can quickly expand development milestones without manually editing multiple files or tracking phase numbers

Quick Start

Use the gsd-add-phase skill to add a new phase called "User Testing" to the current milestone.

Frequently Asked Questions about gsd-add-phase

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

FAQPage Schema
How do I automate adding sequential phases to a project roadmap?

To add roadmap phases automatically, the system calculates the next sequential integer and updates project state tracking files. This eliminates manual editing by handling argument parsing, directory creation, and state management integration.

What is the best way to ensure consistent numbering when expanding development milestones?

The best way to maintain consistent milestone numbering is using automated sequential calculation. The system determines the next integer phase number and generates descriptive slugs, preventing manual tracking errors across roadmap files.

Does adding a new phase to a milestone automatically update the STATE.md tracking file?

Yes, adding a new phase automatically updates the STATE.md tracking file. The workflow ensures roadmap evolution is tracked within the state management system, keeping project management files synchronized without manual edits.

Do I need the GSD framework to automate project roadmap phase creation?

Yes, the GSD framework is required for automated roadmap phase creation. The skill integrates with the GSD framework and its roadmap state management system to calculate sequential phases and update directory structures.

Can I use this automation to add multiple development milestones without manually editing files?

Yes, you can expand development milestones without manually editing files. The automation parses arguments, creates directories, and tracks phase evolution, allowing rapid roadmap expansion by skipping manual file edits.

Why does manual phase tracking cause errors in project management roadmaps?

Manual phase tracking causes errors by requiring multiple file edits and sequential number tracking by hand. Automating next phase number calculation and structure updates eliminates tedious manual processes and ensures roadmap consistency.