When is the best time to use this skill?

It is best used for complex tasks requiring more than 5 tool calls, multi-file edits, or research-intensive projects where organization is critical.

How does this prevent AI 'context drift'?

By forcing the AI to read the plan before major decisions and write findings immediately to disk, it keeps high-level goals in the active context and prevents information loss.

Can I recover my progress after clearing a session?

Yes, the skill includes a session-catchup script that reads your project directory to synchronize the AI's state with the existing planning files.

What is the 3-Strike Error Protocol?

It is a built-in strategy where Claude first diagnoses a fix, then tries an alternative approach, and finally performs a broad rethink before escalating to the user.

What core files does this skill manage?

It manages three main files: task_plan.md for tracking phases and decisions, findings.md for research and discoveries, and progress.md for session logs and test results.

Planning with Files (Manus-style)

Name: Planning with Files (Manus-style)
Author: Shawn-Guo-CN

byShawn-Guo-CN

0•

Productivity & Workflow

Organizes complex developer workflows by maintaining persistent markdown files for task planning, progress tracking, and research findings.

This skill brings structured, 'Manus-style' project management to Claude by using the filesystem as persistent working memory. It automatically initializes and maintains three core files—task_plan.md, findings.md, and progress.md—to ensure that context, research data, and execution status are never lost during long-running tasks or session resets. Ideal for multi-step engineering projects, it enforces rigorous error handling through a 3-strike protocol and provides session recovery scripts to sync state across tool calls and restarts, preventing the AI from repeating failures or losing track of high-level goals.

Key Features

01Post-tool hooks that prompt status updates to keep project tracking accurate.

02Integrated 3-Strike Error Protocol for systematic debugging and problem-solving.

03Manus-style 'working memory on disk' to maintain context beyond the attention window.

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

050 GitHub stars

06Automatic session recovery and catchup scripts to synchronize state after /clear commands.

Use Cases

01Managing complex, multi-step backend refactoring that spans dozens of tool calls.

02Documenting research discoveries and technical debt during deep-dive investigations.

03Ensuring project continuity and state recovery when resuming work after a session break.

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