planning-with-files

OthmanAdi/planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.

Install

GitHub: OthmanAdi/planning-with-files
Website: gilded-laurel-c7nj.here.now
Stars: ★ 27.6k
License: MIT
Language: Python
Last push: Oct 24, 2026
Topics: autonomous-agents · codex · coding-agent

Good for

Keep the plan, research notes and progress of a long task on disk in task_plan.md, findings.md and progress.md
Resume at the current phase after /clear, context compaction or a crash
Give parallel tasks their own directories under .planning/
Use the completion gate to keep the agent from stopping before the plan reports complete

Getting started

Run npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
For the Traditional Chinese version, install --skill planning-with-files-zht instead
Start a long task and let the agent create the three plan files; hooks re-inject the plan each turn
After /clear, the agent reads task_plan.md and continues where it left off

Before you install

The plan files are plain Markdown and gitignored by default. Automatic recovery reads only project files; reading local agent session records needs an explicit catchup mode.

Summarized by AI from the project docs; check the official docs before relying on it.

Similar tools

delegate-skillsCommunity skills · ★ 2.5k
Delegate a coding task to a separate coding agent CLI, review the diff, land the commit yourself — one per implementer.
reaCommunity skills · ★ 386k
Reverse engineer anything with agents, from app behavior down to native binaries.
agent-skillsCommunity skills · ★ 111k
Production-grade engineering skills for AI coding agents.
taste-skillCommunity skills · ★ 103k
Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
archifyCommunity skills · ★ 89.3k
Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.