What is the benefit of file-based planning for AI?

It acts as 'RAM on disk,' providing a persistent source of truth that prevents Claude from losing context, forgetting goals, or repeating mistakes during long, complex tasks.

What is the 3-strike error protocol?

It is a built-in logic that forces the AI to diagnose, try an alternative method, and finally rethink the entire approach if a specific action fails three times.

When should I use the planning-with-files skill?

It is recommended for any task involving more than five tool calls, multi-step research projects, or building new features from scratch.

Does this skill work after running the /clear command?

Yes, it includes a session-catchup script designed to recover context and sync the AI's state from the persistent files after a session clear.

Where are the planning files stored?

The task_plan.md, findings.md, and progress.md files are created directly in your active project's root directory for easy access and persistence.

File-Based Task Planner

Name: File-Based Task Planner
Author: Treytucker05

byTreytucker05

•

Productivity & Workflow

Implements a persistent, Manus-style file-based planning system for complex multi-step AI coding tasks.

File-Based Task Planner brings structured execution to Claude Code by using the local filesystem as a persistent memory layer. It prevents context loss during complex operations by maintaining dedicated markdown files for task phases, research findings, and session progress. This skill is essential for long-running research projects, architectural changes, or any task requiring more than five tool calls, ensuring the AI remains oriented and avoids repeating past failures through a structured error protocol and automatic session recovery after context clears.

Key Features

01Standardized templates for planning, findings, and progress tracking

02Manus-style file-based 'working memory' persistence

03Structured 3-strike error protocol to prevent repetitive failures

04Pre-tool hooks for automatic task plan visibility

051 GitHub stars

06Automated session recovery and context catch-up logic

Use Cases

01Executing complex multi-step software architectural migrations

02Conducting deep research and documentation of unfamiliar codebases

03Managing long-running coding sessions that span multiple tool calls and workspace clears

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add treytucker05/pt-study-sop planning-with-files

For use in Claude.ai and ChatGPT

Download Skill