| name | planning-with-files |
| description | Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls. |
| license | MIT |
Planning with Files
Work like Manus: Use persistent markdown files as your "working memory on disk."
Core Principle
Context Window = RAM (volatile, limited)
Filesystem = Disk (persistent, unlimited)
→ Anything important gets written to disk.
Quick Start
Before ANY complex task, create these three files:
- task_plan.md — Track phases and progress
- findings.md — Store research and discoveries
- progress.md — Session log and test results
See references/ for starting templates.
File Purposes
| File | Purpose | When to Update |
|---|
task_plan.md | Phases, progress, decisions | After each phase |
findings.md | Research, discoveries | After ANY discovery |
progress.md | Session log, test results | Throughout session |
Critical Rules
1. Create Plan First
Never start a complex task without task_plan.md. Non-negotiable.
2. The 2-Action Rule