# Plan & Act Modes: A Guide to Effective AI Development

### Overview <a href="#overview" id="overview"></a>

Plan & Act modes represent Cline's approach to structured AI development, emphasizing thoughtful planning before implementation. This dual-mode system helps developers create more maintainable, accurate code while reducing iteration time.

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252F57kWWhS00R3J8jmI1A4m%252FplanningThenActing.gif%3Falt%3Dmedia%26token%3De8ece65e-a816-4979-a9ac-c91225b249f6\&width=768\&dpr=4\&quality=100\&sign=6f3bee8b\&sv=2)Use Plan to gather context before using Act to implement the plan

#### Understanding the Modes <a href="#understanding-the-modes" id="understanding-the-modes"></a>

**Plan Mode**

* Optimized for context gathering and strategy
* Cannot make changes to your codebase
* Focused on understanding requirements and creating implementation plans
* Enables full file reading for comprehensive project understanding

**Act Mode**

* Streamlined for implementation based on established plans
* Has access to all of Cline's building capabilities
* Maintains context from the planning phase
* Can execute changes to your codebase

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252FuDl4zDpzNJ6AwYSRVuAy%252Fimage.png%3Falt%3Dmedia%26token%3Dd2077d73-95bb-4f99-9ffd-d8e7dd55042d\&width=768\&dpr=4\&quality=100\&sign=5b3f49d4\&sv=2)

#### Workflow Guide <a href="#workflow-guide" id="workflow-guide"></a>

**1. Start with Plan Mode**

Begin every significant development task in Plan mode:

In this mode:

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252FC1Li73kfKVJTpd48z7Tt%252Fimage.png%3Falt%3Dmedia%26token%3D6c10e280-8938-40fe-88d1-c4db5bc1f317\&width=768\&dpr=4\&quality=100\&sign=b724e045\&sv=2)

* Share your requirements
* Let Cline analyze relevant files
* Engage in dialogue to clarify objectives
* Develop implementation strategy

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252FN8nLIkhtYbPDg2fYFdCT%252Fimage.png%3Falt%3Dmedia%26token%3D89c246bf-b0f8-40c4-9d12-a9b44447f21c\&width=768\&dpr=4\&quality=100\&sign=43e03e47\&sv=2)

**2. Switch to Act Mode**

Once you have a clear plan, switch to Act mode:

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252F7sRnK0ayXUQVlGwrsRJR%252Fswitching-to-act.gif%3Falt%3Dmedia%26token%3D4271de6a-8bc9-4e0d-8ce5-acdc9864c41f\&width=768\&dpr=4\&quality=100\&sign=a12c880e\&sv=2)

Act mode allows Cline to:

* Execute against the agreed plan
* Make changes to your codebase
* Maintain context from planning phase

**3. Iterate as Needed**

Complex projects often require multiple plan-act cycles:

* Return to Plan mode when encountering unexpected complexity
* Use Act mode for implementing solutions
* Maintain development momentum while ensuring quality

#### Best Practices <a href="#best-practices" id="best-practices"></a>

**Planning Phase**

1. Be comprehensive with requirements
2. Share relevant context upfront
3. Point Cline to relevant files if he hasn't read them
4. Validate approach before implementation

**Implementation Phase**

1. Follow the established plan
2. Monitor progress against objectives
3. Track changes and their impact
4. Document significant decisions

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252FQx9i07AVwn9GxWkGSKTL%252Fimage.png%3Falt%3Dmedia%26token%3D1b11b40f-3e09-48e6-8b92-5badd81196ad\&width=768\&dpr=4\&quality=100\&sign=4cbe9a3c\&sv=2)

#### Power User Tips <a href="#power-user-tips" id="power-user-tips"></a>

**Enhancing Planning**

* Use Plan mode to explore edge cases before implementation
* Switch back to Plan when encountering unexpected complexity
* Leverage file reading to validate assumptions early
* Have Cline write markdown files of the plan for future reference

#### Common Patterns <a href="#common-patterns" id="common-patterns"></a>

**When to Use Plan Mode**

* Starting new features
* Debugging complex issues
* Architectural decisions
* Requirements analysis

**When to Use Act Mode**

* Implementing agreed solutions
* Making routine changes
* Following established patterns
* Executing test cases

![](https://docs.cline.bot/~gitbook/image?url=https%3A%2F%2F3321249260-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff8Oh1Lcy6yWYq1caYESV%252Fuploads%252FLS3LgtDuYNpNsFt6F7aY%252Fimage.png%3Falt%3Dmedia%26token%3Dae2c7e0c-ea17-4e84-800d-dd3693d2f27d\&width=768\&dpr=4\&quality=100\&sign=ffa0ff3\&sv=2)

#### Contributing <a href="#contributing" id="contributing"></a>

Share your experiences and improvements:

* Join our [Discord community](https://discord.gg/cline)
* Participate in discussions
* Submit feature requests
* Report issues

***

Remember: The time invested in planning pays dividends in implementation quality and maintenance efficiency


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/exploring-clines-tools/plan-and-act-modes-a-guide-to-effective-ai-development.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.