01
It starts by itself
every 10 minutes. Runs in Claude Code /loop.
- ↻ every 10 minutes
/plan-loop 10m
othmanadi · 47K installsPlanning with Files skill
Runs by itself, every 10 minutes.
Long tasks finish, nothing forgotten.
Install the Planning with Files skill and make it a habit: follow https://gethabit.dev/skills/othmanadi/planning-with-files.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
47K installs28K starsMIT licenceSource on GitHub ↗
Planning with Files
by othmanadi · 47K installs
The skill
Planning with files keeps an agent's plan, findings and progress in markdown files on disk, so long multi-step tasks survive context loss and compaction.
Only when you ask.
The habit
Long tasks finish, nothing forgotten.
↻ Runs by itselfevery 10 minutes
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops when check-complete.sh reports all phases complete, or after 3 failed attempts on one error.
- 01
Restore plan state
The agent resolves the plan folder with scripts/resolve-plan-dir.sh and reads the three planning files.
- 02
Check code changes
It runs git diff --stat to spot work not yet written to the plan.
- 03
Work the phase
It works on the in_progress phase and saves findings to findings.md after every two lookups.
- 04
Log errors
It writes each error to the plan and never repeats the same failed action.
- 05
Update progress
It marks finished phases complete and adds a progress.md entry.
- 06
Check completion
It runs scripts/check-complete.sh to see if all phases are done.
- 07
Escalate after three
After three failed attempts on one error, it explains what it tried and asks you for guidance.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only intask_plan.md, findings.md, progress.md, .planning/**
- Talks tono outside service
- Sendsnothing
- Your OKIt asks you before anything goes out.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Planning with Files skill helps.
Use it when
- ✓ A task needs more than 5 tool calls
- ✓ Work must survive compaction or a restart
- ✓ Several agents share one task
Skip it when
- – A simple question or quick lookup
- – A single-file edit
Planning with Files skill, answered.
Do I need the plugin for /plan-loop?
The plugin install adds /plan-loop and /plan-goal. A skill-only install can follow the manual fallback with Claude Code's own /loop.
Can two tasks run at once?
Yes. Give each task its own PLAN_ID from scripts/init-session.sh, or use separate worktrees.
Does it read my old sessions?
Only if you ask. session-catchup.py --metadata gives counts; --replay needs your explicit approval.
How do I install the Planning with Files skill?
Copy the prompt at the top into your agent. It installs the skill from OthmanAdi/planning-with-files and sets up the habit. Or run npx skills add OthmanAdi/planning-with-files --skill planning-with-files.
Is the Planning with Files skill free?
Yes. It is published under MIT. Habit is free too.
Planning with Files. Now as a habit.
Install the Planning with Files skill and make it a habit: follow https://gethabit.dev/skills/othmanadi/planning-with-files.md
All othmanadi skills →More planning skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by othmanadi, published under MIT. Habit links to the original and never changes it. Is this your skill?