Home

Jump to bottom

Ahmad Othman Ammar Adi. edited this page Jan 17, 2026 · 1 revision

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 discoveries
progress.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