planning-with-files

Maintain an on-disk planning system with three persistent Markdown files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeps complex tasks organized by maintaining a Manus-style, on-disk planning system with three persistent Markdown files.

Core Features & Use Cases

  • Manus-style on-disk planning: uses task_plan.md, findings.md, and progress.md to persist planning state across sessions.
  • Suitable for multi-step tasks and research projects that involve many tool calls and decision points.
  • Provides templates, hooks, and a structured workflow to improve focus, traceability, and collaboration.

Quick Start

Create task_plan.md, findings.md, and progress.md in your project directory and begin by outlining Phase 1 in the plan.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I track complex project phases using Markdown files?

Tracking complex project phases with Markdown files involves creating persistent task_plan.md, findings.md, and progress.md documents to log multi-step task workflows, record intermediate research results, and explicitly update statuses as phases advance.

What is on-disk memory for task organization and how does it work?

On-disk memory for task organization maintains planning state across sessions using local Markdown files. It works by writing project outlines, research findings, and progress logs directly to disk, ensuring long-running projects remain organized and traceable over time.

How do I set up an on-disk planning system for a multi-step research task?

To set up an on-disk planning system, create task_plan.md, findings.md, and progress.md in your project directory. Begin by outlining Phase 1 in the plan, then update the three files as tool interactions and research phases advance.

Can I use Markdown task management for long-running projects with multiple tool interactions?

Yes, Markdown task management is suitable for long-running projects with multiple tool interactions. A structured Markdown planning system maintains explicit progress tracking and focus across complex workflows, decision points, and extended research sessions.

Do I need any dependencies to maintain Markdown planning files for project organization?

No dependencies are required to maintain Markdown planning files. The project organization system operates independently using standard scripts to manage templates, hooks, and the structured workflow for your task_plan.md, findings.md, and progress.md documents.

What's the best way to persist planning state across sessions for complex workflows?

The best way to persist planning state across sessions is a Manus-style on-disk system using three persistent Markdown files. This approach ensures complex workflows, phase-by-phase planning, and explicit progress tracking survive session interruptions.