planning-with-files

Organize complex tasks using persistent Markdown files for planning, notes, and deliverables.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize complex tasks using Manus-style persistent markdown files to keep goals, research, and outputs in sync.

Core Features & Use Cases

  • 3-file pattern: task_plan.md, notes.md, and [deliverable].md to track goals, research, and outputs.
  • Persistent memory on disk: store working context as files to keep memory lean during long-running tasks.
  • Structured workflows: repeatable loops for planning, researching, synthesizing, and delivering results across multi-step projects.
  • Use Case: start a complex task by creating a plan, collecting notes, and generating a deliverable without losing context.

Quick Start

Before starting any complex task, create a task_plan.md with a clear goal and a set of phases. Then iterate by researching, writing notes, updating the plan, and delivering the final deliverable.

Frequently Asked Questions about planning-with-files

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

FAQPage Schema
How do I organize complex multi-phase project tasks using markdown files?

Organize complex project tasks using markdown files by applying a three-file pattern: task_plan.md for goals and phases, notes.md for research, and a deliverable file for final outputs, keeping everything synchronized.

What is the best way to maintain context and minimize memory buildup during long-running tasks?

The best way to maintain context and minimize memory buildup during long-running tasks is file-based persistence, storing working context on disk using markdown files rather than keeping it active in memory.

How do I start a workflow that tracks project planning, research, and deliverables together?

Start a workflow tracking planning, research, and deliverables by creating a task_plan.md with a clear goal and phases, then iterate through researching, writing notes, updating the plan, and delivering the final output.

Does this persistent file workflow work for multi-phase research tasks and long-running initiatives?

Yes, this persistent file workflow is designed for multi-phase research tasks and long-running initiatives, applying a read-before-decide workflow to keep planning, notes, and deliverables synchronized across all steps.

When should I use a three-file markdown pattern for project management instead of standard task tracking?

Use a three-file markdown pattern for project management when complex tasks require structured, repeatable loops for planning, researching, and synthesizing, and when minimizing context buildup is critical for long-running initiatives.