planning-with-files

Sponsors & supporters

---

Contributors

Code, documentation, and issue contributors. Select a portrait to open a GitHub profile or archived credit. Full credits.

Forks & Extensions

Fork	Author	What They Built
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
openclaw-github-repo-commander	@wd041216-bit	7-stage GitHub repo audit, optimization, and cleanup workflow for OpenClaw
planning-with-sysspec	@tianshan	Spec-first extension adding structured module specifications, spec deltas and validation matrices (source)

Used in the Wild

Project	What It Is
lincolnwan/Planning-with-files-copilot-agent	Entire Copilot agent repo built around the planning-with-files skill
cooragent/ClarityFinance	AI finance agent framework, Planning-with-Files approach directly credited
oeftimie/vv-claude-harness	Claude Code harness built on Manus-style persistent markdown planning
jessepwj/CCteam-creator	Multi-agent team orchestration skill using file-based planning
smallnest/langgraphgo: Manus Agent	Go implementation of the planning-with-files pattern with persistent task plans, research notes and output files (source)
a5c-ai/babysitter	SDK planning, execution, session-recovery and verification processes adapted from planning-with-files (source)

Skill Registries & Hubs

Registry	What It Is
buzhangsan/skill-manager	Bilingual (EN/中文) Claude Code skill hub; planning-with-files installable one-click

Bundled snapshots & adaptations

Project	Verified relationship
benchflow-ai/skillsbench	Bundles planning-with-files v2.1.2 in its organize-messy-files benchmark task (snapshot)
sickn33/agentic-awesome-skills	Cross-agent skill collection shipping an adapted planning-with-files copy, originally imported at v2.1.2 (import)

Built something? Open an issue to get listed!

Full list of everyone who made this project better: CONTRIBUTORS.md.

Quick Install

npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

All install methods: docs/installation.md.

---

Before and after /clear

Every coding agent loses its working memory when the context window resets. The plan does not have to die with it.

Built for long-running agent tasks

[!IMPORTANT] Most harnesses ship a to-do list that lives inside the context window. planning-with-files ships a plan that lives on disk, is re-injected every turn, is hash-attested, and can hold the agent's stop until the plan reports complete.

That is the difference between an agent that forgets after /clear, compaction or a crash and one that resumes at the current phase. In the project's own measurements the plan on disk turned a 13.3-turn re-orientation into 5.0 turns, and the skill won 3 of 3 blind A/B comparisons (numbers and limits). Every mechanism below is a file on disk plus a hook, so it works the same on hour ten as on turn one.

The 3-file pattern

Context Window = RAM (volatile, limited)
Filesystem = Disk (persistent, unlimited)

→ Anything important gets written to disk.

The skill keeps your plan, findings, and progress in your project:

your-project/
├── task_plan.md   ← phases + checkboxes; the resume point after /clear
├── findings.md    ← research notes and decisions, appended as you go
└── progress.md    ← session log and test results

Parallel tasks get isolated directories instead: .planning/YYYY-MM-DD-slug/ with the same three files, selected via .active_plan (v2.36.0+). Plain markdown, gitignored by default, no runtime state anywhere else.

This is the beginning of the README. Read the rest at the original. Read the full README ↗