gsd-add-phase

Add a sequential phase to a project roadmap and update ROADMAP.md.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-add-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-phase
Source: https://github.com/optivent/gsd-kimi-cli/tree/main/skills/gsd-add-phase
Command: npx skills add https://github.com/optivent/gsd-kimi-cli --skill gsd-add-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates extending a project's roadmap by adding a new phase, creating the phase directory, and updating ROADMAP.md to reflect the new work.

Core Features & Use Cases

  • Validates that the phase number is new and sequential.
  • Verifies ROADMAP.md exists and updates STATE.md with the new phase count.
  • Creates the phase directory at .planning/phases/<NN>/ with a .gitkeep placeholder.

Quick Start

Run the skill with a phase number and title, e.g., /skill:gsd-add-phase 4 "User Authentication" "Implement login, signup, password reset".

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 project roadmap?

To add a new phase to a project roadmap, the skill creates a phase directory under .planning/phases, updates ROADMAP.md with the new entry, and increments the phase count in STATE.md.

What happens to STATE.md when extending a project plan with a new phase?

When extending a project plan with a new phase, STATE.md is automatically updated with the new phase count to ensure the project's state management remains accurate and sequential.

How does project planning automation ensure phase numbers are sequential?

Project planning automation validates that the phase number is new and sequential before creating the phase directory, preventing duplicate or out-of-order phases in your roadmap.

Do I need a ROADMAP.md file before adding a phase directory?

Yes, you need an existing ROADMAP.md file before adding a phase directory, because the skill verifies its presence and updates it to reflect the newly added project phase.

What's the best way to automate creating a phase directory with a placeholder file?

The best way to automate creating a phase directory with a placeholder file is using this skill, which creates the directory at .planning/phases/<NN>/ and adds a .gitkeep file automatically.