Overview
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."
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
Installation
Add planning-with-files to your agent with:
/plugin marketplace add OthmanAdi/planning-with-filesReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- GitHub Copilot — declared in the repository topics
License
planning-with-files is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in OthmanAdi/planning-with-files, an established project with 26,231 GitHub stars
- Works with Claude Code, Codex, Cursor, GitHub Copilot
- Actively maintained — repository updated in the last 90 days
Author
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.
- Which agents does planning-with-files work with?
- planning-with-files lists Claude Code, Codex, Cursor, and GitHub Copilot — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- 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.