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.