> For the complete documentation index, see [llms.txt](https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/exploring-clines-tools/plan-and-act-modes-a-guide-to-effective-ai-development.md).

# 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