planning-with-files

Persist multi-step task planning state in markdown files for session recovery.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Planning complex tasks by maintaining persistent planning artifacts on disk to keep goals and context intact across sessions.

Core Features & Use Cases

  • Creates and maintains planning artifacts (task_plan.md, findings.md, progress.md) to coordinate phases, discoveries, and session history.
  • Supports automatic session recovery and multi-phase task tracking across many tool calls.
  • Designed for long-running research projects, complex workflows, and multi-tool operations that exceed five steps.

Quick Start

Create task_plan.md, findings.md, and progress.md in your project directory, then outline your first phase.

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 a long-running project?

You can maintain task planning state by persisting context in disk-based markdown files. This approach creates task_plan.md, findings.md, and progress.md to coordinate phases and ensure session recovery for long-running research projects.

What is file-based working memory for complex multi-step workflows?

File-based working memory is the practice of storing planning artifacts on disk to keep goals and context intact. It manages complex tasks by tracking phases and discoveries in markdown files across many tool calls.

How to recover an interrupted multi-tool workflow using markdown files?

To recover an interrupted workflow, use supporting scripts that restore session history from progress.md. This automatic recovery mechanism reads your persisted planning state and resumes the multi-phase task tracking.

When do I need persistent planning artifacts for task automation?

You need persistent planning artifacts when executing multi-tool operations that exceed five steps. Complex workflows and long-running research projects require on-disk memory to prevent context loss across sessions.

Does this approach to task planning work without external dependencies?

Yes, this file-based planning approach works without external dependencies. It relies solely on creating and maintaining markdown files in your project directory to manage complex tasks and support recovery.