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

# Plan Mode

> Understand when and how to use Plan Mode for strategic planning

Plan Mode helps you think through complex writing tasks before taking action. It's designed for situations where you need to explore ideas, clarify requirements, and create a strategy before making changes.

## Switching between modes

You can switch between Plan Mode and Act Mode using the mode selector in the bottom-left corner of the SoloEnt Agent chat window.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/plan.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=374a14acbf1cd63e5fb58f4079f18051" alt="Plan and Act mode selector in SoloEnt Agent" style={{ width: '50%', maxWidth: '400px', display: 'block' }} width="676" height="252" data-path="assets/images/plan.png" />

<CardGroup cols={2}>
  <Card title="Plan Mode" icon="lightbulb">
    Think first, act later
  </Card>

  <Card title="Act Mode" icon="bolt">
    Execute tasks immediately
  </Card>
</CardGroup>

## Plan Mode: "Think before you act"

In Plan Mode, the AI's primary task is to understand your requirements and create a blueprint. It won't immediately modify files or execute commands. Instead, it will confirm with you: "Here's what I plan to do."

### When to use Plan Mode

<AccordionGroup>
  <Accordion title="Starting a new project with vague ideas">
    When you're beginning a new work with only a rough concept (for example: "I want to write a science fiction novel"), Plan Mode helps you explore and structure your ideas.
  </Accordion>

  <Accordion title="Facing complex writing challenges">
    When you encounter difficult writing situations that require external input and discussion (such as writer's block or uncertainty about plot progression).
  </Accordion>

  <Accordion title="Making significant structural changes">
    When you need to make large-scale changes that affect multiple files or require careful consideration of trade-offs.
  </Accordion>
</AccordionGroup>

### How Plan Mode works

<Steps>
  <Step title="Analyze the problem">
    The AI examines your request and identifies key challenges and requirements.
  </Step>

  <Step title="Break down the steps">
    It creates a detailed action plan with clear steps and rationale.
  </Step>

  <Step title="Request confirmation">
    Before taking any action, it presents the plan for your approval.
  </Step>

  <Step title="Refine as needed">
    You can discuss, modify, and improve the plan until you're satisfied.
  </Step>
</Steps>

### Key characteristics

<CardGroup cols={2}>
  <Card title="Strategic thinking" icon="chess">
    Ideal for handling complex requirements that need multiple rounds of discussion and clarification.
  </Card>

  <Card title="High safety" icon="shield-check">
    Shows you the plan without modifying your documents.
  </Card>

  <Card title="Transparent reasoning" icon="brain">
    Explains why certain approaches are recommended, helping you identify gaps and improvements.
  </Card>

  <Card title="Collaborative" icon="users">
    Encourages dialogue and refinement before execution.
  </Card>
</CardGroup>

<Warning>
  In Plan Mode, SoloEnt Agent will not execute any tasks or generate any files. It only provides strategic guidance and planning.
</Warning>

## Act Mode: "Just do it"

Once you switch to Act Mode, the AI becomes an executor. It will directly perform operations based on established goals or identified steps.

### When to use Act Mode

Use Act Mode when your task is very clear and specific:

* "Generate an outline for the first 10 chapters"
* "Change the protagonist's name to Wang"
* "Create a character profile for the antagonist"
* During normal writing sessions when you know what you want

<Tip>
  For most regular writing tasks, Act Mode is the default choice. Only switch to Plan Mode when you need strategic thinking and planning.
</Tip>

### How Act Mode works

<Steps>
  <Step title="Identify the task">
    The AI recognizes what needs to be done based on your request.
  </Step>

  <Step title="Execute immediately">
    It performs the necessary actions without asking for confirmation.
  </Step>

  <Step title="Adjust and optimize">
    Based on your feedback, it refines or modifies the results.
  </Step>
</Steps>

### Key characteristics

<CardGroup cols={2}>
  <Card title="High efficiency" icon="rocket">
    Skips repeated confirmations and delivers results directly.
  </Card>

  <Card title="Automated" icon="wand-magic-sparkles">
    Can automatically create files, modify content, and run commands.
  </Card>

  <Card title="Immediate feedback" icon="gauge-high">
    You see changes and results right away.
  </Card>

  <Card title="Action-oriented" icon="play">
    Focuses on execution rather than discussion.
  </Card>
</CardGroup>

<Info>
  If you notice your Agent is only providing suggestions without executing or generating files, check if you're in Plan Mode.
</Info>

## Choosing the right mode

Use this decision tree to select the appropriate mode:

```mermaid theme={null}
graph TD
    A[New task] --> B{Is the task clear and specific?}
    B -->|Yes| C[Use Act Mode]
    B -->|No| D{Do you need to explore options?}
    D -->|Yes| E[Use Plan Mode]
    D -->|No| F{Are there multiple approaches?}
    F -->|Yes| E
    F -->|No| C
    E --> G[Discuss and refine plan]
    G --> H{Plan approved?}
    H -->|Yes| I[Switch to Act Mode]
    H -->|No| G
    I --> C
    C --> J[Execute task]
```

## Best practices

<AccordionGroup>
  <Accordion title="Start with Plan Mode for new projects">
    When beginning a new writing project, use Plan Mode to establish structure, characters, and plot before diving into writing.
  </Accordion>

  <Accordion title="Switch to Act Mode for execution">
    Once you have a clear plan, switch to Act Mode to implement it efficiently.
  </Accordion>

  <Accordion title="Return to Plan Mode when stuck">
    If you encounter writer's block or need to make significant changes, switch back to Plan Mode to think through options.
  </Accordion>

  <Accordion title="Use Plan Mode for major revisions">
    When restructuring your work or making large-scale changes, Plan Mode helps you avoid mistakes and maintain consistency.
  </Accordion>
</AccordionGroup>

## Configure different models for different modes

Official models let you quickly configure different models for **Plan Mode** and **Act Mode**:

* Some models are more organized during planning and improve back-and-forth clarification, such as Sonnet 4.6 and GLM-5;
* Some models are closer to what execution needs — more concise, or lower cost — such as Gemini and DeepSeek;

Setting them separately isn't required; it suits power users who understand different models deeply.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_6.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=4e960b96ed3097597d4768eaacc570ef" alt="The API Configuration panel showing Plan Mode and Act Mode tabs, with the 'Use different models for Plan and Act modes' option at the bottom" style={{ width: '50%', maxWidth: '400px', display: 'block' }} width="724" height="1506" data-path="assets/images/apikey_6.png" />

## Common scenarios

### Scenario 1: Starting a new novel

<Steps>
  <Step title="Use Plan Mode">
    Discuss genre, themes, characters, and plot structure.
  </Step>

  <Step title="Review and refine">
    Iterate on the plan until you're satisfied with the direction.
  </Step>

  <Step title="Switch to Act Mode">
    Begin writing chapters based on the approved plan.
  </Step>
</Steps>

### Scenario 2: Fixing a plot hole

<Steps>
  <Step title="Switch to Plan Mode">
    Analyze the plot hole and explore potential solutions.
  </Step>

  <Step title="Evaluate options">
    Discuss pros and cons of different approaches.
  </Step>

  <Step title="Choose a solution">
    Select the best approach for your story.
  </Step>

  <Step title="Switch to Act Mode">
    Implement the chosen solution.
  </Step>
</Steps>

### Scenario 3: Daily writing session

<Steps>
  <Step title="Stay in Act Mode">
    For routine writing tasks, Act Mode is more efficient.
  </Step>

  <Step title="Write continuously">
    Focus on producing content without interruption.
  </Step>

  <Step title="Switch to Plan Mode if needed">
    Only switch if you encounter a major decision point.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent not executing tasks">
    **Problem:** The Agent only provides suggestions without taking action.

    **Solution:** Check if you're in Plan Mode. Switch to Act Mode to enable execution.
  </Accordion>

  <Accordion title="Agent executing without confirmation">
    **Problem:** The Agent makes changes without asking for approval.

    **Solution:** You're in Act Mode. Switch to Plan Mode if you want to review plans before execution.
  </Accordion>

  <Accordion title="Planning takes too long">
    **Problem:** The Agent spends too much time planning.

    **Solution:** If your task is straightforward, switch to Act Mode for faster results.
  </Accordion>

  <Accordion title="Need to modify the plan">
    **Problem:** The proposed plan doesn't match your vision.

    **Solution:** Stay in Plan Mode and continue the discussion. Provide more context or constraints to refine the plan.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Create a new project" icon="file-plus" href="./create-project">
    Learn how to start a new writing project with SoloEnt
  </Card>

  <Card title="Editor features" icon="pen-to-square" href="./Editor">
    Explore the writing and editing capabilities
  </Card>

  <Card title="Methodology" icon="book-open" href="./methodology">
    Understand SoloEnt's writing methodology
  </Card>

  <Card title="Commands" icon="terminal" href="./commands">
    Master the command system for efficient writing
  </Card>
</CardGroup>
