kata-add-phase

To append the next phase to a roadmap milestone, you can use a planning automation command that calculates the next sequential phase number and updates your existing planning documents automatically. This eliminates manual phase enumeration and document updates.

You need existing ROADMAP.md and STATE.md files within a .planning directory structure to automate roadmap phase management. The automation reads these files to determine the current milestone state and appends the new phase data accurately.

Automatic phase calculation works by reading the current milestone phases from your STATE.md and ROADMAP.md files, determining the highest existing phase number, and incrementing it by one to generate the next sequential phase directory and entry.

Yes, you can add a new roadmap phase using an issue file by passing the file path as an argument to the command. The automation uses the phase description from the issue to generate the corresponding directory and roadmap entries.

The best way to update ROADMAP.md and STATE.md when adding a milestone phase is using an automated phase management command, which ensures both documents are synchronized with the new phase number and directory structure without manual editing.

When you append a phase to the current milestone, the automation creates a new phase directory under .planning/phases/pending. This directory is generated based on the calculated next phase number and the provided phase description.