planning-with-files

Persist task plans, findings, and progress in Markdown files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cvenwu/AiFlow --skill planning-with-files-cvenwu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/cvenwu/AiFlow/tree/main/skills/planning-with-files
Command: npx skills add https://github.com/cvenwu/AiFlow --skill planning-with-files-cvenwu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires orjson, and includes scripts (resource) components.

What problem does it solve?

Manus-style file-based planning keeps long-running tasks coherent by persisting goals, findings, and progress in three Markdown files, enabling seamless recovery across sessions.

Core Features & Use Cases

  • Persistent planning: uses task_plan.md, findings.md, and progress.md to structure goals, research, and session logs.
  • Phase-driven workflow: tracks 5+ phases with statuses and easy resumption.
  • Templates & automation: includes templates and scripts to initialize, update, and recover planning state.

Quick Start

Initialize planning files for a project using the included init-session script, then begin Phase 1 and update task_plan.md as you progress.

Frequently Asked Questions about planning-with-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist task plans and recovery state for long-running projects across sessions?

Persistent task planning stores goals, findings, and progress in Markdown files like task_plan.md, findings.md, and progress.md, enabling seamless recovery and auditability for long-running multi-step workflows across sessions.

What's the best way to manage multi-phase project workflows with on-disk files?

Managing multi-phase project workflows with on-disk files involves tracking over five phases using structured Markdown templates and scripts to initialize, update, and recover planning state for easy resumption.

Can I use Markdown templates to automate task management for complex research tasks?

Yes, Markdown templates automate task management for complex research tasks by providing structured files for goals and session logs, with optional automation hooks that read the plan before tool use and log progress.

Do I need a local project directory to set up file-based planning?

Yes, file-based planning requires a local project directory to store and update the persistent on-disk plan, utilizing included templates and scripts to initialize the planning state before beginning the first phase.

When should I use file-based task planning instead of standard task-management tools?

File-based task planning is ideal for long-running, multi-step projects, research tasks, and multi-tool workflows where recovery across sessions is essential and auditability of progress logs is required.

Why does file-based planning use three separate Markdown files instead of one?

File-based planning separates concerns across three Markdown files: task_plan.md structures goals, findings.md captures research, and progress.md logs sessions, ensuring coherent state management and easy resumption.