# plan

Turns a task description into a step-by-step implementation plan saved under specs/. Useful when a feature needs thinking through before any code.

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

## What it does

Give the command a task in its argument and it writes a markdown plan into `specs/`. The wording gets parsed first; then the command reads the codebase on its own, no subagents, to pick up existing patterns and structure. It also sorts the request by kind and by scale, which decides what the document contains.

Every plan carries the task description, the goal, the files that matter, ordered steps and acceptance criteria. Features and bigger jobs gain a problem statement, a solution approach, phases and a testing strategy. Validation commands close the file. Names are kebab-case, taken from the topic.

Skip the argument and it stops, asking for one. The command ships as `.claude/commands/claude-code-hooks-mastery-plan.md`; invocation follows the filename, so renaming it to `plan.md` gives a short `/plan`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/claude-code-hooks-mastery-plan.md` — The built-in /plan overrides a file with the same name, so the file is renamed. Call it with /claude-code-hooks-mastery-plan. For all projects use ~/.claude/commands/

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/plan.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/disler/claude-code-hooks-mastery/tree/HEAD/.claude/commands/plan.md

## When to use it
- turn a rough feature request into ordered steps
- write acceptance criteria before coding starts
- list the files the change will touch
- attach validation commands to the plan
- keep the plan in the repo next to the code

## Example prompts
- \`/claude-code-hooks-mastery-plan` Add CSV export to the orders page
- \`/claude-code-hooks-mastery-plan` Move the API layer onto the new client
- \`/claude-code-hooks-mastery-plan` Fix the race when saving profile settings

## Similar
- [quick-plan](https://affpapa.org/en/nevibecode/commands/quick-plan.md) — command · ★ 1573 repo stars
- [plan-goal](https://affpapa.org/en/nevibecode/commands/plan-goal.md) — command · ★ 28179 repo stars
- [update-docs](https://affpapa.org/en/nevibecode/commands/update-docs.md) — command · 3861 installs
- [plan-review](https://affpapa.org/en/nevibecode/skills/plan-review.md) — skill · ★ 8928 repo stars
- [planning-and-task-breakdown](https://affpapa.org/en/nevibecode/skills/planning-and-task-breakdown.md) — skill · 80700 installs
- [alan-plan](https://affpapa.org/en/nevibecode/skills/alan-plan.md) — skill · 1800 installs

## Other versions with the same name
- [plan · othmanadi](https://affpapa.org/en/nevibecode/commands/othmanadi-plan.md) — ★ 28179 repo stars
- [plan · othmanadi](https://affpapa.org/en/nevibecode/commands/plan.md) — ★ 28179 repo stars
- [plan · worldflowai](https://affpapa.org/en/nevibecode/commands/affaan-mustafa-plan.md) — ★ 6739 repo stars
- [plan · cloudai-x](https://affpapa.org/en/nevibecode/commands/cloudai-x-plan.md) — ★ 1424 repo stars
- [plan · trailofbits](https://affpapa.org/en/nevibecode/commands/plan-2.md) — ★ 540 repo stars

From the same set: [disler/claude-code-hooks-mastery](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-mastery.md) — 25 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
