planning-with-files

Coordinate long-running tasks with persistent markdown planning files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

planning-with-files solves the challenge of managing long-running, multi-step tasks by using persistent markdown files as a "working memory on disk" to maintain plans, findings, and progress across sessions.

Core Features & Use Cases

  • Creates and maintains task_plan.md, findings.md, and progress.md to document goals, research, and session logs.
  • Enables automatic session recovery after a reset (e.g., /clear) and keeps plan state in sync with tool activity.
  • Ideal for planning complex tasks that require many tool calls, audits, and iterative decision making, ensuring you can resume where you left off.

Quick Start

Initialize a new planning session by creating task_plan.md, findings.md, and progress.md in your project folder.

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 progress and findings across multiple sessions?

Automatic session recovery for long-running tasks works by maintaining persistent markdown files as working memory on disk. By continuously updating task_plan.md, findings.md, and progress.md through read and write hooks, the system keeps plan state synchronized with tool activity and allows seamless continuity after resets.

What is the best way to track multi-phase projects that require many tool calls?

You can plan complex multi-step tasks by initializing task_plan.md, findings.md, and progress.md directly in your project folder. This establishes a structured planning session that enforces plan-driven execution, coordinates tool calls, and automatically logs progress as work proceeds.

Can I use markdown files for session recovery after clearing my workspace?

Yes, markdown files support session recovery after a clear by acting as a persistent working memory on disk. Files like task_plan.md, findings.md, and progress.md store your goals and session logs, allowing you to automatically resume multi-phase projects without losing context.

Does file-based planning work for complex audits and iterative decision making?

File-based planning is ideal for complex audits and iterative decision making because it maintains task_plan.md, findings.md, and progress.md to document goals and research. This enforces plan-driven execution and keeps plan state in sync with tool activity throughout multi-phase projects.

When do I need persistent file-based memory for task planning?

You need persistent file-based memory for task planning when managing long-running, multi-step tasks that require multiple tool calls and iterative decisions. It enforces plan-driven execution and enables automatic session recovery, ensuring continuity across sessions by maintaining plans, findings, and progress.