Lesson 462 of 2116
Plan Mode And ExitPlanMode
Plan mode forces Claude Code to think before it edits. Used right, it prevents whole categories of agent mistakes — but the discipline only works if you actually read the plan.
Lesson map
What this lesson covers
Learning path
The main moves in order
- 1Why plan mode exists
- 2plan mode
- 3ExitPlanMode
- 4approval gate
Concept cluster
Terms to connect while reading
Section 1
Why plan mode exists
Most agent regrets come from the same shape of mistake: the agent did something irreversible without telling the human first. Plan mode flips the default — the agent must produce a written plan, get approval via ExitPlanMode, and only then start editing. It costs you a few seconds of reading time. It saves you hours of recovery.
What plan mode produces
- 1A summary of the goal in the agent's own words (so you can spot misunderstandings)
- 2A list of files it intends to read
- 3A list of changes it intends to make, with rough scope
- 4Any commands it expects to run
- 5Open questions it wants you to answer before starting
When to use plan mode
- Multi-file refactors where the blast radius is unclear
- Anything touching production config, credentials, or shared infrastructure
- Greenfield work where the architecture is the whole task
- Tasks where you're new to the codebase and want the agent to articulate before acting
- Whenever the cost of being wrong is real money or real time
When plan mode is overkill
Compare the options
| Use plan mode | Skip plan mode |
|---|---|
| Refactor across 10+ files | Fix a typo |
| Touching auth or billing code | Updating a README |
| Generating a new module | Renaming a single variable |
| Anything that runs in CI | Local debugging session |
| First time with this agent in this repo | Trusted, narrow task |
Apply: plan-first ritual
- 1For your next non-trivial task, open the session in plan mode
- 2Read the plan word for word; flag anything that surprised you
- 3Approve, partial-approve, or ask for revision — never silent-approve
- 4After completion, compare the diff to the plan
- 5Note any drift; tighten the next plan accordingly
Key terms in this lesson
The big idea: plan mode is cheap insurance against irreversible mistakes — but only if you actually read the plan.
End-of-lesson quiz
Check what stuck
15 questions · Score saves to your progress.
Tutor
Curious about “Plan Mode And ExitPlanMode”?
Ask anything about this lesson. I’ll answer using just what you’re reading — short, friendly, grounded.
Progress saved locally in this browser. Sign in to sync across devices.
Related lessons
Keep going
Creators · 9 min
What Perplexity Is: Search-Augmented LLM, Not A Chatbot
Perplexity is built around the idea that every answer should cite its sources. Treating it like ChatGPT misses the point — and the reliability gap that comes with it.
Creators · 10 min
Spaces: Building Team Knowledge Bases In Perplexity
Spaces are Perplexity's project containers — system prompts, files, and shared chat history. They turn the search engine into a research workspace.
Creators · 10 min
Comet Browser: What It Does That Atlas And Operator Don't
Comet is Perplexity's full browser with a research-native sidebar and an action-capable agent. It plays differently than ChatGPT Atlas or Operator — and the differences matter.