Where are the planning files stored?

Templates are kept in the skill directory, but your active planning files (task_plan.md, findings.md, and progress.md) are always created in your current project root to ensure they stay with your code.

What is the '2-Action Rule' in this skill?

The 2-Action Rule is a protocol that requires Claude to save key findings to text files after every two browser, view, or search operations. This prevents visual or transient information from being lost as the context window shifts.

How does the 3-Strike Error Protocol work?

It forces a systematic rethink after failures: first diagnose and fix, then try an alternative method, then perform a broader rethink. If all three fail, Claude escalates to the user with a detailed log of attempts.

When should I manually invoke /planning-with-files?

While it auto-activates for complex tasks, you should manually invoke it when starting a new research project, building a new feature from scratch, or any task you anticipate will take more than five tool calls.

Planning with Files

Name: Planning with Files
Author: claudiodearaujo

byclaudiodearaujo

•

Productivity & Workflow

Implements a persistent, file-based planning system for complex multi-step tasks to prevent context loss and improve reliability.

This skill provides a structured methodology inspired by the Manus agent, utilizing local Markdown files as a 'working memory' for Claude. By maintaining a task plan, finding log, and progress tracker directly in your project directory, it ensures that critical decisions, research results, and error resolutions are preserved even during long-running sessions or complex refactors. It is particularly effective for research-heavy projects or any task requiring more than five tool calls, ensuring the model always knows exactly where it is and where it is going.

Key Features

01The 2-Action Rule to capture research and visual data before context window decay.

02Pre-tool hooks that surface the current plan status to keep goals in focus.

03Automatic generation of persistent task_plan.md, findings.md, and progress.md files.

04Integrated 3-Strike Error Protocol for systematic diagnosis and resolution of failures.

05Manus-style 'disk' persistence for recovering state across long development sessions.

061 GitHub stars

Use Cases

01Executing complex multi-step refactoring or feature implementations.

02Managing long-running development tasks that exceed standard context window limits.

03Performing deep research tasks across multiple documentation sources or websites.

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