planning-with-files

Maintain task_plan.md, findings.md, and progress.md to orchestrate long-running tasks.

299|56|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/jd-opensource/JoySafeter --skill planning-with-files-jd-opensource
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files
Source: https://github.com/jd-opensource/JoySafeter/tree/main/skills/planning-with-files
Command: npx skills add https://github.com/jd-opensource/JoySafeter --skill planning-with-files-jd-opensource

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Planning and executing long-running, multi-phase tasks by keeping a persistent memory of goals, decisions, and progress to prevent context drift across many tool interactions.

Core Features & Use Cases

  • Create and maintain task_plan.md to track phases, decisions, and status.
  • Automatically generate and update findings.md and progress.md to record discoveries and session history.
  • Recover context across sessions and support re-use of planning templates via a standardized 3-file pattern.

Quick Start

Initialize planning files and begin guiding a complex task with task_plan.md, findings.md, and progress.md.

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 persistent memory for long-running multi-step tasks across sessions?

You can maintain persistent memory for long-running tasks by writing context to external planning files like task_plan.md, findings.md, and progress.md. This standardized 3-file pattern prevents context drift across many tool interactions and sessions.

What's the best way to recover context for complex automation tasks after a session interruption?

Recover context for complex automation tasks by reading the automatically generated progress.md and findings.md files. These files record discoveries and session history, allowing you to resume interrupted multi-phase workflows seamlessly.

How does planning with external files prevent context drift in multi-phase research?

Planning with external files prevents context drift by enforcing the creation of task_plan.md to track phases, decisions, and status. This persistent memory structure anchors long-running research workflows against shifting contexts during extensive tool calls.

Can I use scripts and reference assets within my task planning workflow?

Yes, you can use scripts, references, and assets within your task planning workflow. The planning structure supports scripts/ references/ assets/ directories and defines hooks for PreToolUse and PostToolUse to orchestrate complex automation tasks.

When do I need persistent planning files for multi-step development?

You need persistent planning files for multi-step development when tasks require many tool calls and session continuity. If your workflow involves complex automation, research, or multi-phase execution, maintaining task_plan.md prevents losing track of decisions and progress.