01
It starts by itself
multi-step task starts. Runs in Claude Code.
- ↻ multi-step task starts
UserPromptSubmit hook for tasks with 5+ tool calls
othmanadi · 18K installsPlanning with Files (Chinese) skill
Runs by itself, when a long task starts.
Long jobs never lose their goal.
Install the Planning with Files (Chinese) skill and make it a habit: follow https://gethabit.dev/skills/othmanadi/planning-with-files-zh.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
18K installs28K starsMIT licenceSource on GitHub ↗
Planning with Files (Chinese)
by othmanadi · 18K installs
The skill
Keeps a plan, notes and progress in files for long jobs.
Only when you ask.
Time saved
Long jobs never lose their goal. You pick up where you stopped. Time saved.
↻ Runs by itselfwhen a long task starts
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 all phases are complete, or after 3 failed attempts on one step it stops and asks you.
- 01
Restore state
The agent resolves the plan directory with scripts/resolve-plan-dir.sh, reads the three files and runs git diff --stat.
- 02
Create the plan
For a new task it runs scripts/init-session.sh and creates only the missing files from the templates.
- 03
Save findings
After every 2 view or search actions it writes key findings to findings.md, never web content to task_plan.md.
- 04
Reread before deciding
Before a big decision it reads the plan again to keep the goal in view.
- 05
Update after each phase
It marks the phase complete, logs errors and notes changed files.
- 06
Three-failure rule
It changes approach after each failure and asks you for guidance after 3 failed attempts.
- 07
Check completion
It runs scripts/check-complete.sh before it ends the session.
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 (Chinese) skill helps.
Use it when
- ✓ A task needs more than 5 tool calls
- ✓ You run research across many sources
- ✓ You resume work after an interruption
Skip it when
- – You ask a simple question
- – You edit a single file
Planning with Files (Chinese) skill, answered.
Does it read my old chat sessions?
Only when you ask. session-catchup.py runs with --metadata or --replay only on an explicit request.
Does it upload anything?
No. The skill has no network upload path.
How do I install the Planning with Files (Chinese) 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-zh.
Is the Planning with Files (Chinese) skill free?
Yes. It is published under MIT. Habit is free too.
Planning with Files (Chinese). Now as a habit.
Install the Planning with Files (Chinese) skill and make it a habit: follow https://gethabit.dev/skills/othmanadi/planning-with-files-zh.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?