planning-with-files

You can maintain context for long-running tasks by using an on-disk memory system that creates and updates persistent Markdown files to track task plans, findings, and progress.

Organizing complex multi-phase research projects is best handled by creating dedicated task_plan.md, findings.md, and progress.md files to capture plans, knowledge, and step-by-step progress on disk.

To start planning complex tasks, create task_plan.md, findings.md, and progress.md files in your project directory, using the provided templates under references/ to guide your initial setup.

Yes, on-disk planning is specifically ideal for workflows requiring many tool calls, as the persistent Markdown files ensure state and knowledge are preserved between each execution step.

You need persistent Markdown files for task management when working on large tasks or research projects that require resuming sessions, tracking progress, and capturing knowledge over time.

Yes, on-disk planning works without external dependencies, providing a lightweight memory system that solely relies on maintaining task_plan.md, findings.md, and progress.md files.