Does this work on Windows?

Yes, the skill includes cross-platform support with logic for both Bash and PowerShell environments.

When should I use the Planning with Files skill?

It is best used for complex tasks requiring more than 5 tool calls, research-heavy projects, or any multi-step workflow where context persistence is critical.

Can I recover context after running /clear?

Yes, the skill includes a session catchup script that helps recover and sync context from previous sessions based on existing planning files and git diffs.

How does it handle errors?

It follows a 3-strike protocol: first diagnosing, then trying an alternative approach, and finally rethinking the plan before escalating to the user for guidance.

Where are the planning files stored?

While templates are stored in the skill directory, your active planning files (task_plan.md, findings.md, etc.) are always created in your current project's root directory.

Planning with Files

Name: Planning with Files
Author: udecode

byudecode

•

387

•

生产力与工作流

Implements a persistent, file-based planning system to manage complex multi-step tasks and maintain context across AI sessions.

Planning with Files transforms Claude's volatile context window into a reliable, disk-based memory system by using structured Markdown files to track project phases, research findings, and session logs. Inspired by the Manus workflow, it enforces best practices like the '2-action rule' for saving research and a '3-strike protocol' for robust error handling, making it indispensable for complex refactoring, research-heavy tasks, or any project requiring extensive tool use. The skill includes built-in session recovery to ensure continuity and goal alignment even after clearing history or restarting work.

主要功能

01Automatic session recovery and context syncing after /clear or session restarts

02Manus-style persistent task planning using task_plan.md, findings.md, and progress.md

03Structured templates for phase tracking, discovery logging, and session history

04Enforced 3-strike error protocol to prevent repetitive failures and guide debugging

05387 GitHub stars

06Pre-tool hooks that automatically display the current plan to maintain goal alignment

使用场景

01Maintaining continuity on long-running tasks that span multiple days or AI sessions

02Managing complex, multi-step code refactoring or large-scale feature implementations

03Conducting deep research projects where findings must persist across many tool calls

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add udecode/better-convex planning-with-files

For use in Claude.ai and ChatGPT

Download Skill