planning-with-files

Create and maintain task_plan.md, findings.md, and progress.md for file-based planning.

178|24|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill planning-with-files-zhanlincui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/planning-with-files
Command: npx skills add https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection --skill planning-with-files-zhanlincui

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables Manus-style file-based planning by creating and maintaining task_plan.md, findings.md, and progress.md to act as persistent working memory for complex tasks.

Core Features & Use Cases

  • Persistent planning memory: Stores goals, discoveries, and session logs in dedicated markdown files.
  • Templates-driven setup: Uses templates in templates/ to bootstrap planning files for new projects.
  • Long-running tasks & research: Ideal for multi-phase tasks or research projects that span many tool calls.
  • Use Case: When starting a complex project, initialize task_plan.md to outline phases, then log findings in findings.md and track progress in progress.md, re-reading the plan before major decisions.

Quick Start

  • Review the templates in templates/ and inspect scripts/init-session.sh for setup guidance.
  • Run scripts/init-session.sh [project-name] to create task_plan.md, findings.md, and progress.md in your working directory.
  • Create or update task_plan.md in your project to define phases and goals, then use findings.md and progress.md to log discoveries and progress, re-reading the plan before major decisions.

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 planning memory for long-running multi-phase tasks?

To maintain planning memory for multi-phase tasks, you can use file-based planning to create task_plan.md, findings.md, and progress.md. These files act as persistent memory to keep goals and discoveries aligned across long sessions.

What is the best way to track research progress across many tool calls?

The best way to track research progress across many tool calls is by logging discoveries in a dedicated findings.md file and updating progress.md. Re-reading these files ensures your research stays aligned with the original task plan.

How do I initialize planning files for a new complex project?

To initialize planning files for a new complex project, run the setup script with your project name. This bootstrap process uses predefined templates to automatically generate task_plan.md, findings.md, and progress.md in your working directory.

Does file-based planning work without external dependencies?

Yes, file-based planning works without external dependencies because it relies entirely on local markdown files for persistent memory. It uses built-in templates and optional scripts to automate setup without requiring external libraries.

When should I use persistent markdown files for task planning?

You should use persistent markdown files for task planning when working on multi-phase tasks or research projects that span many tool calls. This approach prevents context loss and keeps your planning aligned during extended work sessions.

What is persistent working memory in file-based task planning?

Persistent working memory in file-based task planning is a method of storing goals, discoveries, and session logs in markdown files. It ensures that complex task planning remains accessible and aligned without relying on volatile session context.