Planning

In Planning, the agent creates a full implementation plan and presents it to you before writing a single line of code. Nothing executes until you approve the plan.

Use this for new features, large refactors, architectural changes, or anything where you want to understand the approach before committing.

How It Works

1. You give the agent a task
2. The agent analyzes your codebase and produces a detailed plan
3. The plan is saved as a Markdown file and shown to you
4. You review and approve (or reject) the plan
5. After approval, the agent executes step by step
6. Progress is tracked in a separate tasks file
7. On completion, the agent writes a walkthrough report

Artifact Files

All planning artifacts are saved to %USERPROFILE%\.zerosphere\plan/:

%USERPROFILE%\.zerosphere\plan/
├── {workspace}-{title}-{timestamp}.md           # Implementation plan
├── {workspace}-{title}-{timestamp}-tasks.md     # Task progress tracker
└── {workspace}-{title}-{timestamp}-walkthrough.md  # Completion report

These files are plain Markdown. You can open, edit, or share them freely.

Switching Modes

Click the mode selector in the agent panel. The change takes effect immediately for the next task.

When to Use Planning Mode