Planning with Files
Keeps your agent's plan in a file on disk so it survives long tasks and context resets.
Install
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
npx skills add OthmanAdi/planning-with-files -a claude-code
npx skills add OthmanAdi/planning-with-files -a claude-code -g
Or copy the skill folder into .claude/skills/ (project) or ~/.claude/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a codex
npx skills add OthmanAdi/planning-with-files -a codex -g
Or copy the skill folder into .agents/skills/ (project) or ~/.agents/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a cursor
npx skills add OthmanAdi/planning-with-files -a cursor -g
Or copy the skill folder into .agents/skills/ (project) or ~/.cursor/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a gemini-cli
npx skills add OthmanAdi/planning-with-files -a gemini-cli -g
Or copy the skill folder into .agents/skills/ (project) or ~/.gemini/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a github-copilot
npx skills add OthmanAdi/planning-with-files -a github-copilot -g
Or copy the skill folder into .agents/skills/ (project) or ~/.copilot/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a opencode
npx skills add OthmanAdi/planning-with-files -a opencode -g
Or copy the skill folder into .agents/skills/ (project) or ~/.config/opencode/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a antigravity
npx skills add OthmanAdi/planning-with-files -a antigravity -g
Or copy the skill folder into .agents/skills/ (project) or ~/.gemini/config/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a droid
npx skills add OthmanAdi/planning-with-files -a droid -g
Or copy the skill folder into .agents/skills/ (project) or ~/.factory/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a kiro-cli
npx skills add OthmanAdi/planning-with-files -a kiro-cli -g
Or copy the skill folder into .kiro/skills/ (project) or ~/.kiro/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a openclaw
npx skills add OthmanAdi/planning-with-files -a openclaw -g
Or copy the skill folder into skills/ (project) or ~/.openclaw/skills/ (all projects).
npx skills add OthmanAdi/planning-with-files -a hermes-agent
npx skills add OthmanAdi/planning-with-files -a hermes-agent -g
Or copy the skill folder into .hermes/skills/ (project) or ~/.hermes/skills/ (all projects).
When to use
Use it on multi-step tasks that run past one context window, where the agent keeps losing track of what it already did.
Planning with Files keeps an agent's plan on disk so it survives long tasks. The skill maintains task_plan.md, findings.md and progress.md, and lifecycle hooks inject the relevant planning context on each turn. A plan on disk lasts through /clear, crashes and compaction, so the agent can't quietly forget or ignore it. Automatic recovery reads project files only, and reading local agent session records needs an explicit catch-up mode.
It installs across 60+ agents through the Agent Skills standard, with native plugins for Claude Code, Codex CLI, Qoder CLI, Pi, Hermes Agent and OpenCode. The author reports three out of three blind A/B comparisons in its favor, which is a self-reported test.
Related skills
-
rea
Lets your agent reverse engineer an app from the outside, down to native binaries, and then build its own version.
-
superpowers
A set of development habits for your agent: test first, debug systematically, and plan before you code.
-
skills
The skills Matt Pocock uses in his own day-to-day engineering work.
-
ECC
A ready-made setup for coding agents that adds skills, persistent memory and security checks.