Why use file-based planning instead of just talking to Claude?

Claude's internal context window is volatile and limited; files provide 'disk' memory that persists across sessions, accidental clears, and context refreshes.

Does this skill work after running the /clear command?

Yes, it includes a specialized session-catchup script designed to recover context and state from your planning files immediately after a session clear.

What is the 3-Strike Error Protocol?

It is a systematic logic where Claude is forced to change its strategy after failures rather than repeating the same failing action, eventually escalating to the user if a solution isn't found.

Where are the planning files stored?

The files (task_plan.md, findings.md, and progress.md) are stored directly in your active project's root directory, making them part of your codebase and version control.

When is it best to use the planning-with-files skill?

It is highly recommended for any task requiring more than five tool calls, research-heavy projects, or any development work spanning multiple phases.

Persistent Task Planning

Name: Persistent Task Planning
Author: jd-opensource

byjd-opensource

•

146

•

Productivity & Workflow

Implements a structured, file-based methodology to manage context and progress for complex multi-step coding tasks.

Persistent Task Planning equips Claude with a dedicated 'working memory' on disk by utilizing standardized markdown files such as task_plan.md, findings.md, and progress.md. Inspired by the Manus workflow, it ensures that project goals, research discoveries, and error logs survive session clears and context window limits. This skill is essential for long-running research, complex refactoring, or any project requiring more than five tool calls, providing a reliable framework for session recovery, systematic problem-solving, and state management.

Key Features

01Standardized file-based planning using task_plan.md, findings.md, and progress.md

02Automatic session recovery and context catch-up after /clear or interruptions

03Integrated 3-Strike Error Protocol to prevent repetitive failures and promote alternative logic

04146 GitHub stars

05Pre-tool and post-tool hooks that automatically display and prompt plan updates

06The 2-Action Rule for immediate persistence of multimodal or web research data

Use Cases

01Managing long-running development projects that require consistent state tracking and error logging

02Conducting deep research and documentation tasks where information must be preserved across sessions

03Executing complex multi-step refactorings that span dozens of tool calls and multiple files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jd-opensource/joysafeter planning-with-files

For use in Claude.ai and ChatGPT

Key Features

01Standardized file-based planning using task_plan.md, findings.md, and progress.md

02Automatic session recovery and context catch-up after /clear or interruptions

03Integrated 3-Strike Error Protocol to prevent repetitive failures and promote alternative logic

04146 GitHub stars

05Pre-tool and post-tool hooks that automatically display and prompt plan updates

06The 2-Action Rule for immediate persistence of multimodal or web research data

Use Cases

01Managing long-running development projects that require consistent state tracking and error logging

02Conducting deep research and documentation tasks where information must be preserved across sessions

03Executing complex multi-step refactorings that span dozens of tool calls and multiple files