by OthmanAdi
Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.
# Add to your Claude Code skills
git clone https://github.com/OthmanAdi/planning-with-filesWork like Manus — the AI agent company Meta acquired for $2 billion.
To everyone who starred, forked, and shared this skill — thank you. This project blew up in less than 24 hours, and the support from the community has been incredible.
If this skill helps you work smarter, that's all I wanted.
| Fork | Author | Features |
|------|--------|----------|
| devis | @st01cs | Interview-first workflow, /devis:intv and /devis:impl commands, guaranteed activation |
| multi-manus-planning | @kmichels | Multi-project support, SessionStart git sync |
| plan-cascade | @Taoidle | Multi-level task orchestration, parallel execution, multi-agent collaboration |
| agentfund-skill | @RioTheGreat-ai | Crowdfunding for AI agents with milestone-based escrow on Base |
| | | 7-stage GitHub repo audit, optimization, and cleanup workflow for OpenClaw |
No comments yet. Be the first to share your thoughts!
Built something? Open an issue to get listed!
See the full list of everyone who made this project better in CONTRIBUTORS.md.
| Version | Highlights |
|---------|------------|
| v2.33.0 | Multi-language expansion: Arabic, German, and Spanish skill variants added (thanks to community contributors!) |
| v2.32.0 | Codex session catchup rewrite (thanks @ebrevdo!), Loaditout A-grade security badge, Stop hook Git Bash fix |
| v2.31.0 | Codex hooks.json integration with full lifecycle hooks (thanks @Leon-Algo!) |
| v2.30.1 | Fix: Codex script executable bits restored (thanks @Leon-Algo!) |
| v2.30.0 | CLAUDE_SKILL_DIR variable, IDE configs moved to per-IDE branches, plugin.json bumped from 2.23.0 |
| v2.29.0 | Analytics workflow template: --template analytics flag for data exploration sessions (thanks @mvanhorn!) |
| v2.28.0 | Traditional Chinese (zh-TW) skill variant (thanks @waynelee2048!) |
| v2.26.2 | Fix: --- in hook commands broke YAML frontmatter parsing, hooks now register correctly |
| v2.26.1 | Fix: session catchup after /clear, path sanitization on Windows + content injection (thanks @tony-stark-eth!) |
| v2.26.0 | IDE audit: Factory hooks, Copilot errorOccurred hook, Gemini hooks, bug fixes |
| v2.18.2 | Mastra Code hooks fix (hooks.json + docs accuracy) |
| v2.18.1 | Copilot garbled characters complete fix |
| v2.18.0 | BoxLite sandbox runtime integration |
| v2.17.0 | Mastra Code support + all IDE SKILL.md spec fixes |
| v2.16.1 | Copilot garbled characters fix: PS1 UTF-8 encoding + bash ensure_ascii (thanks @Hexiaopi!) |
| v2.16.0 | GitHub Copilot hooks support (thanks @lincolnwan!) |
| v2.27.0 | Kiro Agent Skill layout (thanks @EListenX!) |
| v2.15.1 | Session catchup false-positive fix (thanks @gydx6!) |
| v2.15.0 | /plan:status command, OpenCode compatibility fix |
| v2.14.0 | Pi Agent support, OpenClaw docs update, Codex path fix |
| v2.11.0 | /plan command for easier autocomplete |
| v2.10.0 | Kiro steering files support |
| v2.7.0 | Gemini CLI support |
| v2.2.0 | Session recovery, Windows PowerShell, OS-aware hooks |
🧪 Experimental: Isolated parallel planning (
.planning/{uuid}/folders) is being tested onexperimental/isolated-planning. Try it and share feedback!
When your context fills up and you run /clear, this skill automatically recovers your previous session.
How it works:
~/.claude/projects/ for Claude Code, ~/.codex/sessions/ for Codex)Pro tip: Disable auto-compact to maximize context before clearing:
{ "autoCompact": false }
These IDEs have dedicated hook configurations that automatically re-read your plan before tool use, remind you to update progress, and verify completion before stopping:
| IDE | Installation Guide | Integration | |-----|-------------------|-------------| | Claude Code | Installation | Plugin + SKILL.md + Hooks | | Cursor | Cursor Setup | Skills + hooks.json | | GitHub Copilot | Copilot Setup | Hooks (incl. errorOccurred) | | Mastra Code | Mastra Setup | Skills + Hooks | | Gemini CLI | Gemini Setup | Skills + Hooks | | Kiro | Kiro Setup | Agent Skills | | Codex | Codex Setup | Skills + Hooks | | CodeBuddy | CodeBuddy Setup | Skills + Hooks | | FactoryAI Droid | Factory Setup | Skills + Hooks | | OpenCode | OpenCode Setup | Skills + Custom session storage |
These IDEs implement the Agent Skills open specification. Install with npx skills add — the installer places the skill in each IDE's discovery path automatically:
| IDE | Installation Guide | Skill Discovery Path |
|-----|-------------------|---------------------|
| Continue | Continue Setup | .continue/skills/ + .prompt files |
| Pi Agent | Pi Agent Setup | .pi/skills/ (npm package) |
| OpenClaw | OpenClaw Setup | .openclaw/skills/ (docs) |
| Antigravity | Antigravity Setup | .agent/skills/ (docs) |
| Kilocode | Kilocode Setup | .kilocode/skills/ (docs) |
| AdaL CLI (Sylph AI) | AdaL Setup | .adal/skills/ (docs) |
Note: If your IDE uses the legacy Rules system instead of Skills, see the
legacy-rules-supportbranch.
| Runtime | Status | Guide | Notes | |---------|--------|-------|-------| | BoxLite | ✅ Documented | BoxLite Setup | Run Claude Code + planning-with-files inside hardware-isolated micro-VMs |
Note: BoxLite is a sandbox runtime, not an IDE. Skills load via ClaudeBox — BoxLite’s official Claude Code integration layer.
A Claude Code plugin that transforms your workflow to use persistent markdown files for planning, progress tracking, and knowledge storage — the exact pattern that made Manus worth billions.