> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogniagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plan mode and Build mode

> Have your AI coworker research and propose an approach before it changes anything — then switch it loose to do the work.

Agree the approach before the work starts. It's the cheapest way to avoid a confidently wrong afternoon.

## The two modes

**Plan mode** — your coworker can look but not touch. It researches, reads files, works out what's involved, and comes back with a proposed approach. Nothing is changed, nothing is sent.

**Build mode** — the full toolset. This is the normal way a coworker works.

Switch with `/plan` and `/build`. The current mode shows as a chip under the message box, so you always know which one you're in.

<Frame caption="Plan mode is on — your coworker will research and propose, not act.">
  <img src="https://mintcdn.com/glorium/JBtd_griZWPnHu68/images/cowork/chat/overview/01-composer.webp?fit=max&auto=format&n=JBtd_griZWPnHu68&q=85&s=7040f35a45bf0055e13ef6f6bf81c886" alt="The message box with the Plan chip active alongside the effort and model chips" width="1280" height="268" data-path="images/cowork/chat/overview/01-composer.webp" />
</Frame>

## Why plan first

Your coworker is fast, which is exactly the problem on a job where the wrong approach is expensive. Plan mode puts a checkpoint between "I understand the task" and "I've done it".

It's also the fastest way to find out you were misunderstood. A plan takes seconds to read; an afternoon's work takes an afternoon to undo.

## When you'd use it

* Anything touching live customer data
* A job you can't easily undo — sending, deleting, publishing
* Work you're going to be judged on
* A task you've described badly and know it
* The first time you give a coworker an unfamiliar kind of job
* Anything expensive, so you're not paying for the wrong thing twice

## How it goes

<Steps>
  <Step title="Ask in Plan mode">
    Type `/plan`, then describe the job. Your coworker researches without changing anything.
  </Step>

  <Step title="Read what it proposes">
    Steps, and usually the assumptions it's making. The assumptions are the interesting part — that's where a misunderstanding shows.
  </Step>

  <Step title="Correct it">
    "Skip step 3" or "the file is the second one, not the first". Still nothing has happened.
  </Step>

  <Step title="Switch to Build">
    `/build`, and it does the work you agreed.
  </Step>
</Steps>

## Good to know

<Tip>
  **Read the assumptions, not just the steps.** The steps usually look fine. The line that says "I'll treat blank rows as zero" is the one that matters.
</Tip>

<Note>
  Plan mode is genuinely read-only, not a promise to behave. It's a safe way to point a coworker at something sensitive.
</Note>

<Tip>
  You don't need it for everyday work. Reserve it for jobs that are expensive, irreversible, or badly described.
</Tip>

## Common questions

<AccordionGroup>
  <Accordion title="Does the plan get followed exactly?" icon="route">
    It's the agreed approach, not a script. If reality differs — a file isn't what it expected — your coworker adapts and tells you, rather than following a plan that's stopped making sense.
  </Accordion>

  <Accordion title="Can I go back to Plan mode mid-task?" icon="arrows-rotate">
    Yes. Switch back at any point, which is useful when a task turns out bigger than expected.
  </Accordion>

  <Accordion title="Does planning cost extra?" icon="coins">
    A little, and it routinely saves more by preventing work you'd have thrown away.
  </Accordion>

  <Accordion title="How is this different from Thorough review?" icon="code-branch">
    Plan mode checks the approach **before**. [Thorough review](/cowork/chat/thorough-review) checks the result **after**. On genuinely important work, use both.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Thorough review" icon="magnifying-glass-chart" href="/cowork/chat/thorough-review">
    The check at the other end.
  </Card>

  <Card title="Approvals" icon="hand" href="/cowork/control/approvals">
    What pauses for you anyway.
  </Card>

  <Card title="Slash commands" icon="terminal" href="/cowork/chat/slash-commands">
    How to switch.
  </Card>

  <Card title="Watching progress" icon="chart-line" href="/cowork/chat/watching-progress">
    Following the plan as it runs.
  </Card>
</CardGroup>
