AGENTS/.pi/gsd/workflows/add-phase.md

Context (pre-injected by WXP)

Init:

Phases added:

If no description was provided (check `` is empty):

ERROR: Phase description required
Usage: /gsd-add-phase <description>
       /gsd-add-phase <desc1> + <desc2> + ...
Example: /gsd-add-phase Add authentication system

Exit.

The `batch-result` JSON above was already executed by WXP before this message reached you. Parse it:

• If it contains an error field → report the error and exit.
• Otherwise extract phases[] — each has phase_number, padded, name, slug, directory.

Do NOT run pi-gsd-tools phase add again, do NOT inspect .planning/phases/ or ROADMAP.md — everything is already done.

Present a completion summary:

Added <count> phase(s):

<for each phase in phases[]>
• Phase <phase_number>: <name>
  Directory: <directory>
</for>

Roadmap updated: .planning/ROADMAP.md
State updated:   .planning/STATE.md

---

## ▶ Next Up

**Phase <last phase_number>: <last name>**

`/gsd-plan-phase <last phase_number>`

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- `/gsd-add-phase <description>` — add another phase
- `/gsd-plan-phase <N>` — plan any of the new phases

<success_criteria>

• pi-gsd-tools phase add-batch executed by WXP (not by the agent)
• Phase directories created under .planning/phases/
• ROADMAP.md updated with all new phase entries
• STATE.md Roadmap Evolution updated (handled inside add-batch)
• Agent presented the pre-injected result — no filesystem exploration </success_criteria>