planning-with-files-zh

To plan complex multi-step projects using markdown files, this workflow creates and maintains task_plan.md, findings.md, and progress.md to decompose tasks and track progress across sessions. It uses templates and scripted helpers to guide the planning process.

File-based task planning is a method that uses persistent markdown documents to organize, track, and recover context for complex tasks. You need it when your project requires decomposition, involves multiple tool calls, or needs systematic progress tracking.

Yes, you can recover your project planning context after clearing the session because the workflow maintains persistent files like progress.md and task_plan.md. It supports automatic session recovery by reading these files to restore previous state.

To track progress for multi-step research tasks across sessions, the workflow writes updates to progress.md and logs details to findings.md. It automatically reads task_plan.md before tool calls to ensure the current plan and context are visible.

Yes, file-based project management works for tasks needing more than five tool calls by providing a structured template to manage extended workflows. It decomposes large tasks into manageable steps and guards the execution process using scripted helpers.

A limitation of using markdown files for task planning is that it requires creating three specific files in your project root directory to function properly. You must manually initialize and maintain these documents for the context injection and recovery hooks to work.