/plan

Enter plan mode to design your approach before coding. Claude proposes an execution plan for review before any implementation starts.

Syntax

/plan [description]

Example

/plan refactor the auth module to use JWT

Not what you're looking for? Ask Melo

About

Switches Claude Code into plan mode where it researches the codebase and produces a reviewable plan. Pass an optional description to enter plan mode and immediately start with that task, e.g. /plan fix the auth bug. While a task is already running, /plan is temporarily unavailable.

When to use

▸Before making a large multi-file change
▸When requirements are unclear and you want Claude to ask questions first
▸Architectural decisions that need human review before code is written
▸Reducing risk on complex refactors

planning plan-mode architecture pre-coding

Related Slash Commands

diagnostics

/checkup

Audit and clean up your Claude Code setup: unused skills, MCPs, and plugins, CLAUDE.md dedup and splitting, slow hooks, auto mode, and permission pre-approval. Confirms before making changes.

configuration

/effort

Set the model effort level: low, medium, high, xhigh, max, or ultracode. Takes effect immediately without waiting for the current response.

integrations

/claude-api

Load Claude API reference, migrate deprecated model IDs, or onboard Claude Managed Agents (schedules + vaults).

planning

/goal

Set a persistent goal — Claude keeps working across turns until the condition is met. View, pause, resume, or clear with subcommands.

code-review

/simplify

Review changed code for cleanup opportunities and apply the fixes. Four review agents run in parallel covering reuse, simplification, efficiency, and abstraction level.