create-phase — Claude Code command: what it does, how to install
The create-phase command clarifies a development phase through Q&A, then creates an HTML wireframe with the decisions needed for implementation in Claude Code plan mode.
no license ★ 406 updated 2026-11-01
.claude/commands/create-phase.mdWhat create-phase does
create-phase interviews you about a development phase, including its goal, boundaries, and behavior that could otherwise remain unclear. It records the outcome in phase.html, using low-fidelity wireframes for visible behavior and brief notes for requirements a sketch cannot convey. When you ask it to inspect the project, it delegates that exploration to the built-in Explore subagent.
The file goes under /docs/phases/ in a directory named for the phase and its next available number. It is a standalone HTML document with inline styles, intended to be read in Claude Code plan mode. No external dependencies or build step are involved, so the deliverable stays a plain, low-fidelity sketch rather than a finished visual design.
Pass a phase name as the command argument. If you leave it out, the command asks for one. It gathers answers in focused rounds and asks you to confirm a consequential choice instead of silently making it.
What it helps with
- Clarify a phase goal and its scope
- Resolve open requirements through focused questions
- Map interface states in a wireframe
- Record rules and transitions in notes or matrices
- Create an HTML brief for implementation in Claude Code plan mode
Example prompts for the agent
/create-phase user-auth— ask me about the requirements and draft the phase wireframe./create-phase dashboard-ui— clarify the scope and map the interface states./create-phase— ask for the phase name, then gather the requirements.
How to install create-phase
Manually: put the files in place
.claude/commands/create-phase.mdCall it with /create-phase. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/create-phase.mdCall it with /prompts:create-phase. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/create-phase.prompt.mdManually: put the files in place
.gemini/commands/create-phase.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about create-phase
How do I install create-phase in Claude Code?
Save the command file as .claude/commands/create-phase.md. Then invoke it with /create-phase.
What does create-phase do?
It works through phase requirements with you and captures the decisions in a standalone phase.html containing wireframes and supporting notes.
Do I need to provide a phase name?
Pass the name as an argument, such as /create-phase user-auth. If you omit it, the command asks what to call the phase.