planning-with-files

Manage multi-step tasks through persistent markdown planning files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, python, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing complex, multi-step tasks by providing a structured, persistent method for planning, tracking progress, and storing findings, preventing information loss and ensuring task completion.

Core Features & Use Cases

  • Manus-style Planning: Implements a robust file-based planning system using task_plan.md, findings.md, and progress.md.
  • Session Recovery: Automatically attempts to recover context from previous sessions to prevent data loss.
  • Structured Workflow: Guides users through complex tasks with clear phases, decision logging, and error tracking.
  • Use Case: Ideal for starting research projects, building software, or any task requiring more than five tool calls, ensuring all steps and discoveries are meticulously recorded.

Quick Start

Before starting any complex task, create task_plan.md, findings.md, and progress.md in your project directory.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I manage complex multi-step tasks to prevent information loss?

You can manage complex multi-step tasks using a file-based planning system with persistent markdown files. This approach structures workflow through task_plan.md, findings.md, and progress.md to meticulously record steps and prevent data loss.

What is the best way to recover context from previous workflow sessions?

Recovering context from previous workflow sessions is handled automatically through session catch-up scripts. These scripts read persistent markdown files to restore your task state and prevent data loss during session recovery.

Do I need Python to implement file-based task planning?

Yes, you need Python installed to use this file-based task planning system. Python is specifically required to run the session catch-up scripts and shell utilities that manage the markdown task tracking files.

When should I use markdown files for task management and progress tracking?

You should use markdown files for task management when handling complex tasks requiring more than five tool calls. This file-based approach ensures all execution steps, decisions, and findings are meticulously recorded for structured workflow.

How do I set up a structured workflow for research projects using markdown?

To set up a structured workflow for research projects, create task_plan.md, findings.md, and progress.md in your project directory before starting. This establishes a persistent file-based planning system to track decisions and log progress.