# create-phase

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/plan/create-phase.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/create-phase

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/create-phase.md` — Call it with /create-phase. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/create-phase.md` — Call it with /prompts:create-phase. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/create-phase.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/create-phase.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/plan/create-phase.md

## When to use it
- 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
- \`/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.

## Similar
- [gsd-execute-phase](https://affpapa.org/en/nevibecode/skills/gsd-execute-phase.md) — skill · 595 installs
- [gsd-plan-phase](https://affpapa.org/en/nevibecode/skills/gsd-plan-phase.md) — skill · 594 installs
- [multi-phase-camera](https://affpapa.org/en/nevibecode/rules/multi-phase-camera.md) — rule · ★ 78316 repo stars
- [TDD Refactor Phase - Improve Quality & Security](https://affpapa.org/en/nevibecode/agents/tdd-refactor-phase-improve-quality-security.md) — subagent · ★ 41430 repo stars
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/en/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — subagent · ★ 41430 repo stars
- [gsd-phase-researcher](https://affpapa.org/en/nevibecode/agents/gsd-phase-researcher.md) — subagent · ★ 3785 repo stars

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
