gsd-add-phase

Add a new phase to the current roadmap milestone with slug and state updates.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-add-phase-hadpadrahul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/hadpadrahul/school-erp/tree/main/.codex/skills/gsd-add-phase
Command: npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-add-phase-hadpadrahul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The workflow automates extending a roadmap by adding a new integer phase to the end of the current milestone, ensuring consistent numbering and accurate state promotion.

Core Features & Use Cases

  • Next-phase calculation: computes the next sequential phase number ignoring decimals.
  • Slug generation: creates a URL-friendly slug from the phase description.
  • Roadmap updates: creates the phase directory and updates ROADMAP.md and STATE.md accordingly.
  • Use Case: A product team needs to append a new "Beta" phase to the current milestone and reflect it across planning documents.

Quick Start

Provide a phase description and invoke the add-phase workflow to append it as the next phase in 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 add a new phase to the end of a milestone in a roadmap?

To add a new phase to a milestone in a roadmap, this workflow computes the next sequential integer phase number, generates a URL-friendly slug, creates the phase directory, and updates the STATE.md file automatically.

How does slug generation work when creating a new roadmap phase?

Slug generation creates a URL-friendly slug directly from the provided phase description, ensuring consistent directory naming and slug consistency across the roadmap when a new phase is appended.

What's the best way to ensure STATE.md synchronization when expanding roadmap milestones?

The best way to ensure STATE.md synchronization is using an automated workflow that updates the roadmap state file and ROADMAP.md simultaneously whenever a new phase directory is created.

Do I need to manually calculate the next phase number for my roadmap milestone?

No, you do not need to manually calculate the next phase number. The workflow computes the next sequential integer phase number automatically, ignoring decimals, to extend the current milestone accurately.

Can I append a phase to a roadmap milestone without breaking existing numbering?

Yes, you can append a phase without breaking existing numbering. The workflow ignores decimal phases, calculates the next sequential integer, and applies validation to ensure consistent roadmap state management.

Why does adding a phase to a roadmap require updating multiple files?

Adding a phase requires updating multiple files to maintain roadmap state accuracy. The workflow handles this by creating the phase directory and synchronizing both ROADMAP.md and STATE.md to reflect the new milestone expansion.