Build With AI

Claude Code Plan Mode: Why I Never Let Claude Build Before I Approve the Plan

The cheapest place to fix a mistake is a plan nobody has built yet. How I use plan mode, and the skill that checks every plan for me.

By · 8 min read

Cover: Specs + Claude, episode 2. Plan first, then build. A Claude Code window with plan mode on: "Plan ready: 4 files, 1 risk, 1 check. Approve before I change anything?"

What is plan mode in Claude Code? A mode where Claude reads, researches and writes a plan, but can't change anything until you approve it.

It's the single habit that saved me the most rework.

This post covers how to turn it on, what to check before you say yes, and a planning skill you can copy.

This is episode 2 of Specs + Claude, a weekly series on building real products with Claude when you're not a developer (why specs beat vibe coding). Episode 1 covered the brief. This one covers what happens right after it.

The problem: Claude is fast at solving the wrong problem

Give Claude Code a task and it starts working immediately.

That's its strength. It's also the risk.

If it misread what you wanted, you find out after it has changed ten files. Now you're reviewing code you can't read, for a problem you didn't ask it to solve.

Anthropic's own guidance says it directly: "Letting Claude jump straight to coding can produce code that solves the wrong problem." (Claude Code best practices)

A plan fixes that. A plan is written in plain English. You can review a plan even if you can't read a line of code.

The method: explore, plan, approve, build

Four steps, in this order.

  1. Explore. Claude reads the files, pages and documents involved. Nothing changes.
  2. Plan. Claude writes down what it will change, in which files, and how it will check the result.
  3. Approve. You read the plan, push back, and say yes only when it matches what you want.
  4. Build. Claude does the work, following the plan you approved.

Plan mode enforces steps 1 to 3. In plan mode, Claude "reads files, runs shell commands to explore, and writes a plan, but does not edit your source."

How to turn plan mode on

You don't need the terminal for this. Pick whichever matches how you use Claude Code:

When the plan is ready, Claude asks how to continue. You can approve it, approve it but check each change yourself, or say "No, keep planning" and tell it what to fix.

In the terminal, Ctrl+G opens the plan in a text editor so you can rewrite any part of it before you approve.

The 6 questions I ask before I approve any plan

A plan that sounds confident isn't necessarily a good plan.

These six questions catch most problems, and none of them need technical knowledge:

  1. Does it solve the goal I wrote? Not a nearby goal. Mine.
  2. What will it change? Every file, page or setting. If the list surprises me, I ask why.
  3. What's the riskiest assumption? And how would we find out early that it's wrong?
  4. What could break that works today? And how will we check it still works?
  5. What's out of scope? Anything not in the plan shouldn't be touched.
  6. How will we know it's done? A check Claude can run, not "it should work".

If Claude can't answer one of them clearly, the plan isn't ready. That's not a failure. That's plan mode doing its job.

For big plans, I go one step further and ask other AIs to attack the plan before Claude builds it. That's next week's episode.

Skills: write your planning habit down once

Asking the same six questions every time gets old.

The book

Plan it. Approve it. Then build it.

Build Your AI Platform teaches non-technical founders to build real products with specs and Claude. Chapter 1 is free.

  • 29 chapters, five levels, step by step
  • Three complete builds, start to finish
  • Templates, checklists and a prompt kit
  • Chapter 1 is free to read, in full
Read Chapter 1 free →

That's what skills are for. A skill is a short instruction file Claude reads when it needs it, or when you call it by name with a slash: `/plan-review`.

Anthropic describes them as the place for "repeated instructions, checklists, or multi-step procedures." And they cost almost nothing until they're used, because Claude only loads a skill's full text when it's needed.

A real example from building SiteNeuro

SiteNeuro runs on a handful of these. Two of them shape almost every task:

Neither of them is clever. They're my habits, written down once, so I don't have to remember them on a busy day.

The planning skill: copy this

Ask Claude to save it as `.claude/skills/plan-review/SKILL.md` in your project. Then type `/plan-review` followed by your brief, ideally in plan mode.

A planning skill (SKILL.md)
---
name: plan-review
description: Turn a brief into a plan I can approve. Use before any change that touches more than one file or page.
---

Here is my brief: $ARGUMENTS

Read what you need first. Change nothing yet.

Then answer, in plain words:
1. The goal, in one sentence. If you can't, ask me.
2. Every file, page or setting you will change, and why.
3. The riskiest assumption, and how we find out early if it's wrong.
4. What could break that works today, and how we'll check it doesn't.
5. What is out of scope.
6. The check that proves it's done.

Then give me the plan in under 300 words.
Ask me anything unclear, one question at a time.
Don't change anything until I approve.

It pairs with the task brief template from episode 1: the brief says what you want, the skill turns it into a plan you can check.

When to skip the plan

Anthropic's rule of thumb is a good one: "If you could describe the diff in one sentence, skip the plan."

Change a phone number, fix a typo, rename a button: just ask.

Plan when:

New tool spotlight: approve the plan, then start fresh

A long planning conversation fills Claude's memory with ideas you rejected along the way.

Claude Code has a setting for that: clear the context when you approve a plan. Turn it on, and approving gets a new first option: accept the plan and start the build with only the plan in mind, not the whole debate that produced it.

Anthropic recommends the same pattern for big features: write the spec, "then start a fresh session to execute it." The setting just does it for you.

The 3 planning mistakes I see most

  1. Approving a plan you didn't read. If you approve on autopilot, plan mode is just a delay.
  2. Planning in your head. "I know what I want" isn't a plan. If it isn't written, Claude can't check against it, and neither can you.
  3. Never saying "keep planning". The first plan is a draft. Pushing back once usually makes it much better. (More on the mistakes that cost me the most time.)

Straight answers

What is plan mode in Claude Code?
A mode where Claude reads files and researches the task, then writes a plan, but can't edit anything until you approve the plan. It separates thinking from doing.
How do I turn on plan mode in Claude Code?
In the desktop app, on the web or on your phone, choose Plan in the mode menu. In the terminal, press Shift+Tab until the status bar shows plan mode, or start a single message with /plan.
What's the difference between plan mode and auto mode?
Plan mode blocks changes until you approve a plan. Auto mode lets Claude work without asking you at each step, with a safety check that blocks risky actions. A common pattern is to plan in plan mode, then approve the plan and let Claude build in auto mode.
Can I edit the plan Claude writes?
Yes. Choose "No, keep planning" and tell Claude what to change, or in the terminal press Ctrl+G to edit the plan directly in a text editor.
What is a Claude Code skill?
A short instruction file, saved as SKILL.md, that Claude loads when it's relevant or when you call it with a slash command. Skills are for checklists and procedures you repeat, like reviewing a plan before you approve it.
Do I need plan mode for small changes?
No. If you could describe the change in one sentence, ask for it directly. Plan mode is worth it when a change touches several files, you're unsure of the approach, or a mistake would be expensive. Next Saturday, episode 3: the multi-model review. How I have other AIs attack a plan before Claude builds it, and how Claude decides which criticism to keep.
What is SiteNeuro?The AI growth platform for small businesses and entrepreneurs, starting with a website.See the sites it builds and the marketing it runs, in the showcase →Rated Excellent on Trustpilot

Building an AI platform?

I built SiteNeuro as a non-developer, with Claude and written specs: 1,000+ websites built so far.

If you're turning an idea into an AI product, I can help you shape the business case, set up Claude and your specs, and plan a first build that doesn't loop.