planning-with-files

Persist planning data to markdown files for session recovery and phase tracking.

1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/pianzhu/my-claude-skills --skill planning-with-files-pianzhu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/pianzhu/my-claude-skills/tree/main/skill-en/planning-with-files
Command: npx skills add https://github.com/pianzhu/my-claude-skills --skill planning-with-files-pianzhu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill provides a Manus-style file-based planning approach by persisting task context in markdown files, ensuring continuity across breaks and long tool-call sessions.

Core Features & Use Cases

  • Persistent planning files: task_plan.md, findings.md, and progress.md in your project root.
  • Session recovery and continuity: recover context after interruptions or /clear, preserving state across sessions.
  • Phase tracking and decision logging: keep a living plan that guides decisions and tracks progress.

Quick Start

Create task_plan.md, findings.md, and progress.md in your project root using the provided templates, or bootstrap them with the included init-session scripts. Then start a new planning session by updating the plan in task_plan.md and documenting findings in findings.md as you go; before major decisions, re-read the plan to refresh goals.

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 planning context across long multi-tool sessions?▼

You can persist task planning context across long multi-tool sessions by writing structured markdown files like task_plan.md, findings.md, and progress.md to disk, ensuring continuity and session recovery.

What is the best way to recover planning state after an interruption or session clear?▼

Recovering planning state after an interruption involves re-reading persistent markdown planning files from your project root, which preserves phase tracking and decision logs across breaks or a cleared session.

How do I track complex multi-phase task progress using markdown templates?▼

Track complex multi-phase task progress using markdown templates by updating task_plan.md for goals, logging discoveries in findings.md, and recording milestones in progress.md to maintain a living plan.

Do I need any external dependencies to use file-based planning for task management?▼

No external dependencies are required to use file-based planning for task management, as the system relies entirely on standard markdown files and included init-session scripts with no external packages.

Can I bootstrap planning files automatically for a new research project?▼

Yes, you can bootstrap planning files automatically for a new research project by running the included init-session scripts, which generate the required task_plan.md, findings.md, and progress.md templates in your project root.

When should I use on-disk markdown planning instead of relying on session memory?▼

Use on-disk markdown planning instead of session memory for multi-phase tasks and research projects requiring long runs, where losing context during extended tool-call sessions or interruptions would disrupt decision tracking.