planning-with-files

planning-with-files is an open-source workflow skill for Claude Code and compatible agents, published by OthmanAdi. Its author describes it as: “Manus-style persistent file-based planning for AI coding agents: keeps task_plan.md, findings.md, and progress.md on disk so work survives context loss and /clear. Use when asked to plan out, break down, or organize a…”. The project has 26k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add OthmanAdi/planning-with-files`.

What planning-with-files does

Work like Manus: Use persistent markdown files as your "working memory on disk."

Installation

Add planning-with-files to your agent with:

/plugin marketplace add OthmanAdi/planning-with-files

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for planning-with-files is organised into these sections:

• FIRST: Restore Context (v2.2.0)
• Important: Where Files Go
• Quick Start
• The Core Pattern
• File Purposes
• Critical Rules
• 1. Create Plan First
• 2. The 2-Action Rule
• 3. Read Before Decide
• 4. Update After Act
• 5. Log ALL Errors
• 6. Never Repeat Failures

When to use it

Reach for planning-with-files when you want workflow help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in OthmanAdi/planning-with-files, an established project with 26,231 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does planning-with-files do?

Manus-style persistent file-based planning for AI coding agents: keeps task_plan.md, findings.md, and progress.md on disk so work survives context loss and /clear. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring 5+ tool calls. Supports automatic session recovery after /clear.

How do I install planning-with-files?

Run /plugin marketplace add OthmanAdi/planning-with-files in your agent, then reload your skills. Review the source at https://github.com/OthmanAdi/planning-with-files before installing.

Is planning-with-files free to use?

Yes. planning-with-files is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does planning-with-files come from?

planning-with-files ships inside OthmanAdi/planning-with-files, a repository that contains 8 catalogued skills in total. The repository's 26,231 GitHub stars apply to that whole collection, not to this skill on its own.