planning-with-files

Automate complex task planning using persistent Markdown files as working memory.

288|42|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/shuyu-labs/WebCode --skill planning-with-files-shuyu-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/shuyu-labs/WebCode/tree/main/skills/claude/planning-with-files
Command: npx skills add https://github.com/shuyu-labs/WebCode --skill planning-with-files-shuyu-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complex, multi-step tasks often suffer from memory gaps, scattered notes, and difficulty maintaining a single source of truth. This Skill introduces Manus-style persistent Markdown files to serve as external memory, enabling you to track goals, phases, and decisions across the execution cycle.

Core Features & Use Cases

  • 3-file pattern: task_plan.md, notes.md, and a deliverable file to store plan, findings, and final output.
  • Loop-based workflow: Stepwise task execution with read/write of the plan to refresh goals before decisions.
  • Knowledge storage & retrieval: Centralized notes and deliverables to support planning, research, and delivery.
  • Use Case: Manage a multi-week research project by updating task_plan.md after each phase and saving findings to notes.md.

Quick Start

Create task_plan.md with a clear goal and four phases, then capture findings in notes.md and generate your deliverable.md when ready.

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 multi-step project planning across iterations without losing context?

Multi-step project planning can be tracked using persistent Markdown files as external memory. This approach uses a strict 3-file pattern to store goals, phases, and decisions on disk, maintaining a single source of truth across long-running tasks.

What is the best way to manage long-running research tasks and maintain a single source of truth?

The best way to manage long-running research tasks is using a loop-based workflow with persistent on-disk memory. You update a task plan file after each phase and save findings to a notes file, ensuring centralized knowledge storage and retrieval.

How to organize task execution with Markdown files for complex initiatives?

Organize complex task execution by creating a task_plan.md with a clear goal and four phases. Capture ongoing findings in notes.md during the loop-based workflow, then generate a deliverable.md file when the project is ready for final output.

Can I use this persistent file workflow for multi-week research projects?

Yes, you can use this persistent file workflow for multi-week research projects. It automates complex task planning by applying a loop-based workflow that reads and writes to Markdown files, ensuring decisions and goals are tracked across iterations.

Why does updating a task plan file help with complex task execution?

Updating a task plan file helps with complex task execution by serving as external memory to refresh goals before decisions. This loop-based workflow prevents memory gaps and scattered notes, allowing you to track phases and log errors explicitly.

When do I need external memory files for project management?

You need external memory files for project management when handling complex, multi-step tasks that suffer from memory gaps and scattered notes. Persistent Markdown files act as a working memory on disk to track decisions across iterations.