planning-with-files

Manage complex multi-phase tasks by initializing task_plan.md, findings.md, and progress.md in your project directory. This system tracks phases, captures discoveries, and updates session progress to prevent context loss across software development, research, and documentation projects.

Track project progress in markdown files by using a phase-driven workflow that monitors status as pending, in_progress, or complete. Automated hooks and scripts update progress.md, ensuring durable context and seamless session recovery for multi-phase projects.

Prevent context loss during long planning sessions by persisting artifacts as files on disk. Creating task_plan.md and progress.md captures goals and session state, enabling seamless recovery and guiding attention back to the plan before decisions.

File-based planning templates can be used for research and documentation projects. The system applies to any multi-phase project, providing templates and lifecycle scripts to initialize planning files, track phases, and capture findings in your project directory.

No specific dependencies are required to initialize a file-based planning workflow. You can quickly start by creating an initial task_plan.md in your project root, leveraging provided templates and scripts to begin planning and decision-making with durable context.

A phase-driven workflow tracks task status in markdown by structuring work into phases and recording status as pending, in_progress, or complete. Automated hooks and scripts update these states within task_plan.md to maintain accurate project tracking.