Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/create-phase.md
Open on GitHub

What 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.md

Call it with /create-phase. For all projects use ~/.claude/commands/

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.

Similar slash commands

Slash commands catalog →
gsd-execute-phase open-gsd gsd-execute-phase — a skill for Claude Code and other platforms that executes development plans within a phase. It runs tasks in parallel waves based on dependency analysis. CX Codex +1 595installs gsd-plan-phase open-gsd The gsd-plan-phase Claude Code skill creates a detailed phase plan in PLAN.md and checks it. Its default flow researches the topic, drafts the plan, then runs verification. CX Codex +1 594installs multi-phase-camera calesthio multi-phase-camera — a rule for animated web scenes: the camera moves through 2-3 zoom phases (pull-back, focus, push) with continuous micro-drift on top. For when a single linear zoom feels mechanical. CX Codex +1 ★ 78,316repo stars TDD Refactor Phase - Improve Quality & Security official github TDD Refactor Phase - Improve Quality & Security is a GitHub Copilot subagent that refines code after tests pass and checks it against a GitHub issue. It asks for plan approval before editing. CX Codex +1 ★ 41,430repo stars TDD Red Phase - Write Failing Tests First official github The TDD Red Phase - Write Failing Tests First subagent pulls GitHub issue context from branch names and creates failing tests for acceptance criteria before code is written. It enforces the red stage of TDD. CX Codex +1 ★ 41,430repo stars gsd-phase-researcher davepoon gsd-phase-researcher researches a phase before planning and writes findings to RESEARCH.md for gsd-planner. Start it through /gsd:plan-phase or /gsd:research-phase. CX Codex ★ 3,785repo stars

From the same set26

The whole set →
comparator comparator runs blind comparisons between two AI outputs against the original prompt. Identifies the stronger result without knowing which skill produced each file. CX Codex ★ 406repo stars code-review code-review — a subagent for Claude Code that reviews a pull request through gh and posts a comment listing confirmed bugs. Skips closed, draft, or already-reviewed PRs without prompting. CX Codex ★ 406repo stars change-core-self change-core-self asks you about the project, works out a fitting identity for the agent from scratch, and stores it as a rule file loaded on every session. CX Codex +1 ★ 406repo stars grader grader assesses agent execution transcripts and generated files against expectations, flags superficial passes, and critiques test assertions. CX Codex ★ 406repo stars visual The visual command turns a discussion into a self-contained HTML document with diagrams, wireframes and matrices the agent implements from in plan mode. CX Codex +1 ★ 406repo stars oneshotapp oneshotapp builds a functioning app from a brief idea in Claude Code without human intervention. It logs architecture choices and verifies implementation slices on the fly. CX Codex +1 ★ 406repo stars analyzer analyzer examines blind skill comparisons to explain the winner’s advantage and suggest changes to the losing skill. Run it after the comparator finishes. CX Codex ★ 406repo stars free-will free-will makes the agent stop at a costly fork, lay out real options, test each against evidence and pick one on purpose. CX Codex +1 ★ 406repo stars

Project sponsors

Companies that keep this analytics open