Are the planning files stored in the skill directory or my project?

The templates and scripts are stored in the skill directory, but all active planning files are created directly in your current project root for easy access and persistence.

Can I recover my work after using the /clear command?

Yes, the skill includes a session catch-up script that reads your planning files to restore Claude's understanding of the project's current state.

What is the '3-Strike' error protocol?

It is a built-in logic that forces the AI to change its strategy after three failed attempts at a specific task, preventing it from repeating the same error indefinitely.

What files does this skill create in my project?

The skill initializes three primary files: task_plan.md for phase tracking, findings.md for research storage, and progress.md for session logging.

When is it best to use the Planning with Files skill?

It is highly recommended for any multi-step task requiring more than 5 tool calls, complex research, or when building a project from scratch.

Planning with Files

Name: Planning with Files
Author: Shawn-Guo-CN

byShawn-Guo-CN

0•

Productivity & Workflow

Implements Manus-style file-based planning to organize, track, and recover context for complex multi-step projects.

Planning with Files transforms Claude's workflow by using the local filesystem as a persistent 'working memory' to overcome context window limitations. By maintaining standardized files such as task_plan.md, findings.md, and progress.md, the skill ensures that project goals, research discoveries, and error logs are never lost during long-running tasks. It is specifically designed for complex engineering or research projects where session recovery, structured error handling, and rigorous progress tracking are essential for success.

Key Features

010 GitHub stars

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

033-Strike Error Protocol to prevent circular reasoning and repetitive failures

04Standardized templates for task tracking, research findings, and session logs

05Manus-style file-based planning for persistent project state on disk

06Real-time progress monitoring via pre/post-tool execution hooks

Use Cases

01Managing multi-step software development projects requiring high tool usage

02Recovering state in long-running sessions where context window limits are reached

03Conducting deep research tasks that require preserving findings across phases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shawn-guo-cn/agentfoundry-plugin-marketplace planning-with-files

For use in Claude.ai and ChatGPT

Download Skill