Why should I use file-based planning instead of standard chat?

Standard chat context is volatile and limited. Using files creates a 'disk' for Claude's memory, ensuring that goals and findings remain accessible even during long, complex sessions.

Where are the task_plan.md and findings.md files stored?

All planning files are created directly in your current project directory, not the skill folder, so they stay organized alongside your source code.

What is the 3-Strike Error Protocol?

It is a robust failure handling system: Attempt 1 is diagnosis, Attempt 2 is an alternative method, and Attempt 3 is a strategic rethink before escalating to the user.

How does this skill prevent AI hallucinations or repetition?

By forcing a 'Read Before Decide' rule and logging every error in a persistent file, the skill ensures Claude is always aware of what has already been tried and what the current status is.

Planning with Files

Name: Planning with Files
Author: claudiodearaujo

byclaudiodearaujo

•

Productivity & Workflow

Implements a Manus-style file-based state management system to handle complex, multi-step tasks without losing context.

Planning with Files provides a structured framework for managing high-complexity tasks by using the filesystem as a persistent working memory. By maintaining dedicated files for task planning, research findings, and progress logging, it prevents critical information from being lost as Claude's context window shifts. This skill is essential for developers and researchers performing operations that require more than five tool calls, ensuring every decision is guided by a roadmap and every error is documented to prevent repetitive failures.

Key Features

012-Action Rule integration to capture multimodal findings immediately

02Persistent state management via task_plan.md, findings.md, and progress.md

03Session initialization and completion verification scripts

04Standardized 3-Strike Error Protocol for systematic troubleshooting

051 GitHub stars

06Automated hooks that display plan status before and after tool usage

Use Cases

01Maintaining project state across long AI sessions to prevent repetitive errors

02Managing research-heavy tasks that require synthesizing data from multiple sources

03Executing complex multi-step refactoring or feature development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro planning-with-files

For use in Claude.ai and ChatGPT

Download Skill