What problem does it solve?
It prevents lost context and aimless execution on multi-step work by forcing the agent to keep goals, decisions, findings, and progress in persistent on-disk markdown files.
Core Features & Use Cases
- Isolated file-based planning: Creates isolated plan directories under .planning/<plan-id>/ with task_plan.md, findings.md, and progress.md for separate concurrent workflows.
- Context recovery after /clear: Detects prior-session unsynced context and prompts you to reconcile it with git diff and the planning files.
- Safety against prompt injection via plan content: Supports optional SHA-256 attestation; when enabled, plan content tampering blocks plan injection and warns you.
- Operational guardrails for tool use: Uses hooks to read the active plan before decisions and to treat plan contents as structured data (not instructions).
Quick Start
Tell the agent to initialize a plan, then proceed with a multi-step request by writing and updating task_plan.md, findings.md, and progress.md as work progresses.