tools-only Welcome to planning-with-files
Work like Manus — the AI agent company Meta acquired for $2 billion.
This is a Claude Code skill that transforms your workflow to use persistent markdown files for planning, progress tracking, and knowledge storage.
What This Project Does
Instead of relying on volatile context windows, planning-with-files teaches Claude to use files as memory:
task_plan.md- Your roadmap (phases, progress, decisions)findings.md- Research and discoveriesprogress.md- Session logs and test results
When context fills up, you don't lose work. Everything important is on disk.
Why It Exists
After 50+ tool calls, Claude forgets your original goals. This skill solves that by:
- Re-reading the plan before major decisions (hooks)
- Storing findings in files instead of context
- Logging errors to prevent repetition
- Verifying completion before stopping
Inspired By
Manus AI pioneered this pattern and went from launch to $100M+ revenue in 8 months. Their secret? Context engineering through persistent files.
Community ❤️
This project grew from one developer's experiment to 9,600+ stars and 10+ contributors in weeks.
Thank you to everyone who:
- ⭐ Starred the repo
- 🔀 Forked and built on this work
- 🐛 Reported issues and tested fixes
- 💡 Suggested features and improvements
- 🛠️ Contributed code, docs, and examples
Special Thanks
- @kaichen - Converted to Claude Code plugin, made it accessible to thousands
- @fuahyo - Created beginner-friendly walkthrough and examples
- @lasmarois - Built session recovery feature, saved countless hours
- @aimasteracc - Added Windows support and Kilocode integration
- @wqh17101 - Inspired Anthropic patterns integration
And many more! See CONTRIBUTORS.md
Growing Together
What started as a simple 3-file pattern is now:
- 5 IDE integrations (Claude Code, Cursor, Kilocode, OpenCode, Codex)
- Session recovery after
/clear - Git checkpoint workflows
- Windows PowerShell support
- Community forks and derivatives
None of this would exist without you.
Get Involved
- 💬 Discussions - Share your experience
- 🐛 Issues - Report bugs or request features
- 🔀 Pull Requests - Contribute improvements
- ⭐ Star if this helps you work smarter
Quick Links
Built with appreciation for the open source community.
Ahmad Othman Ammar Adi