planning-with-files

Create and maintain task_plan.md, findings.md, and progress.md for persistent planning.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/KangOxford/auto-quant-research --skill planning-with-files-kangoxford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/KangOxford/auto-quant-research/tree/main/execution-layer/skills/planning-with-files
Command: npx skills add https://github.com/KangOxford/auto-quant-research --skill planning-with-files-kangoxford

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manus-style file-based planning reduces cognitive load by externalizing a long-running task's memory into persistent documents, enabling coordination across many tool calls and sessions and providing automatic recovery after resets.

Core Features & Use Cases

  • Creates and maintains task_plan.md, findings.md, and progress.md to persist goals, discoveries, and session logs.
  • Provides templates and scripts (init-session, check-complete, session-catchup) to bootstrap, monitor progress, and recover unsynced context.
  • Ideal for starting complex multi-phase projects, research tasks, or any workflow requiring 5+ tool interactions, with guardrails and a clear rollback path.

Quick Start

Create the planning files in your project directory to begin outlining goals, discovery notes, and progress tracking.

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 task planning state across multiple sessions for complex workflows?

To maintain task planning state across multiple sessions, you can externalize project memory into persistent markdown files like task_plan.md and progress.md, enabling coordination and automatic recovery after resets.

What is file-based workflow orchestration and when do I need it for multi-step tasks?

File-based workflow orchestration is the process of managing complex tasks through persistent documents rather than memory. You need it for multi-step tasks requiring five or more tool interactions to reduce cognitive load and enable session recovery.

How to track progress and recover unsynced context for long-running research tasks?

Track progress and recover unsynced context by using dedicated scripts like session-catchup and check-complete to initialize session logs, monitor phase tracking, and safely restore planning state from findings.md and progress.md files.

Can I use external markdown templates to orchestrate complex project phases safely?

Yes, you can use external markdown templates to orchestrate complex project phases safely. This approach provides auditable phase tracking with non-blocking hooks and a clear rollback path for your workflow.

What is the best way to externalize project memory for workflows needing 5 or more tool interactions?

The best way to externalize project memory for extensive workflows is creating a knowledge base with task_plan.md, findings.md, and progress.md, using scripts to bootstrap, monitor, and recover planning state.

Why does persistent task planning reduce cognitive load during multi-phase projects?

Persistent task planning reduces cognitive load because it externalizes long-running task memory into auditable documents, allowing you to coordinate multiple tool calls and resume work seamlessly after interruptions.