planning-with-files

Plan multi-phase tasks using persistent markdown files with session recovery.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manus-style on-disk planning uses persistent markdown files to capture goals, decisions, and context for long-running, multi-step tasks, preventing loss of attention during complex work.

Core Features & Use Cases

  • Persistent planning files: task_plan.md, findings.md, progress.md to capture goals, research, and session logs.
  • Phase-driven workflow: structured phases with status tracking and recovery hooks for seamless resumption.
  • Optional extensibility: scripts/references/assets support automation, knowledge, and assets for projects.

Quick Start

Create a new planning session by initializing task_plan.md, findings.md, and progress.md, then follow the plan while updating phases 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 maintain task planning context for multi-step workflows across sessions?

You can maintain task planning context across sessions by using persistent markdown files like task_plan.md, findings.md, and progress.md to capture goals, research, and session logs on disk.

What is the best way to recover progress when resuming a complex research project?

The best way to recover progress is through structured phase tracking and recovery hooks that read progress.md, allowing seamless resumption of complex research projects from the last logged state.

How do I structure a multi-phase task plan using markdown files?

You structure a multi-phase task plan by initializing task_plan.md for goals, findings.md for research, and progress.md for session logs, enforcing structured phases and logging throughout execution.

Can I add custom scripts and references to a markdown-based planning workflow?

Yes, you can add custom scripts, references, and assets to support automation and knowledge within your planning workflow, extending the core markdown files for project execution.

When do I need persistent on-disk memory for task planning?

You need persistent on-disk memory for task planning when working on long-running, multi-phase tasks requiring many tool calls, preventing loss of attention and context during complex work.