Skip to main content
Plan mode helps you think, explore, and decide before any code is written. Use it to ask questions, debug issues, compare approaches, or create a structured plan when you are ready to build.
Screenshot showing Plan mode interface in Noah
Choose a modeNoah has two modes:
  • Plan mode → think through the problem, explore options, and decide on an approach
  • Agent mode → implement changes and verify the outcome
Plan mode is for decision-making. Agent mode is for execution.The two modes are designed to work together, and you can switch between them at any time.

​
Overview

Plan mode is Noah’s planning and reasoning mode, designed for moments when thinking, exploration, or clarity is more valuable than immediate execution. It can reason across multiple steps and inspect files, logs, or other relevant project context as needed. In Plan mode, you can explore ideas, investigate issues, and reason about changes before any code is written. Noah often asks clarifying questions to better understand your goals and constraints. When there is a clear implementation to propose, Noah creates a formal plan that you can inspect, edit, and refine. Plan mode never modifies your code. Every message in Plan mode deducts one credit.

​
What Plan Mode Is For

You can use Plan mode to:
  • Explore product or feature ideas before committing to a direction
  • Ask questions about your codebase or existing behavior
  • Investigate bugs, errors, or confusing behavior safely before making code changes
  • Compare multiple approaches and understand tradeoffs
  • Design architecture or smart contract schemas
  • Understand the impact of potential changes before making them
Many Plan mode conversations are exploratory and end with clarity or direction. When a conversation does lead to a concrete change, Plan mode provides a safe way to review and refine the proposed approach before anything is implemented.

​
How to Use Plan Mode

You can use Plan mode in two ways:
  • Start in Plan mode when beginning a new project or exploring an idea
  • Switch to Plan mode at any point during development to pause execution and think
Plan mode is intentionally interactive. Noah may ask clarifying questions to understand requirements, constraints, or tradeoffs before proposing a plan.

​
Activate Plan Mode

Click Plan next to the message input, then describe what you want to explore or decide. Be specific about what you want 
Add wallet authentication with auto-connect.
Users should stay connected for the session. Use Solana wallet adapter.
Use it for exploration 
What's the best way to implement real-time token price tracking in this project?
Walk me through the options and their tradeoffs.
Use it for debugging 
Users report the wallet connect button doesn't work on mobile.
Help me figure out why.
Request detailed breakdowns 
Break down the implementation of a token staking feature.
What components, smart contract functions, and API endpoints will I need?
Ask for reviews and improvements 
Review my current smart contract setup.
What security improvements should I make?

​
When Plan Mode Creates a Plan

Plan mode does not always produce a structured implementation plan. A plan is created only when there is a clear implementation to propose. If a plan is generated, it appears in a dedicated Plan view as a readable, structured document. You can open it in full screen to review the entire approach before anything is implemented. A plan typically includes:
  • A high-level overview of the approach
  • Key decisions, assumptions, and constraints
  • Components, data models, and smart contract functions
  • Step-by-step implementation sequencing
  • Optional diagrams such as schemas, flows, or architecture
From the Plan view, you can:
  • Edit the plan directly as markdown to add constraints, remove steps, or rewrite sections
  • Approve the plan when you are satisfied with the approach
You can ask questions in the chat, and Noah will update the plan accordingly. When you approve a plan:
  • Noah switches to Agent mode
  • Implementation begins based strictly on the approved plan
You can return to Plan mode at any time to generate a new plan based on the current state of your project.

​
Plans and Persistence

When you approve a plan, the latest approved version is saved to your project. This represents the current plan that Agent mode will implement, and you can inspect it like any other project file. Previous plans are not lost. They remain available in your chat history and can be reopened in the Plan view for reference or comparison, even though only the most recent approved plan is active. This allows you to:
  • Iterate on ideas over time
  • Compare different approaches
  • Re-plan safely as requirements evolve
  • Help new collaborators understand the reasoning behind implementations

​
FAQ

No. Plan mode never modifies your code. It is purely for thinking, exploring, and planning. Code changes only happen in Agent mode after you approve a plan.
Every message in Plan mode deducts one credit from your account.
Yes. You can switch between the two modes at any time. Use Plan mode when you need to think or explore, and Agent mode when you’re ready to implement.
Noah automatically switches to Agent mode and begins implementing the changes described in your approved plan.
Yes. You can ask questions or request changes in the chat input before approving.