gsd-add-phase

To automate roadmap phase management, you provide a concise description of the next milestone phase. The system calculates the next sequential integer phase, generates a slug, creates the directory, and updates the roadmap structure and STATE.md simultaneously.

State tracking works by updating STATE.md to record the roadmap evolution whenever a new phase is added. This ensures the repository history stays consistent and accurately reflects the current milestone phase structure.

The best way to generate a phase directory and slug is to supply a clear phase description. The system parses and validates the description, automatically generating the slug and creating the corresponding directory in sync with the roadmap update.

No, you do not need to manually calculate the next phase number. The system automatically determines the next sequential integer phase number by ignoring decimals and appending the new phase entry to the end of the current milestone.

Yes, you can update the roadmap structure and STATE.md simultaneously. When adding a new phase, the workflow inserts the entry into the roadmap and evolves STATE.md in sync to eliminate manual repository state updates.

Updating STATE.md is required to maintain consistent repository state tracking. It records the roadmap evolution history each time a new milestone phase directory is created, ensuring your team has an accurate log of structural changes.