{"repo":"OthmanAdi/planning-with-files","free":true,"listed":false,"github":"https://github.com/OthmanAdi/planning-with-files","clone":"git clone https://github.com/OthmanAdi/planning-with-files.git","description":"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.","language":"Shell","stars":26231,"topics":["claude","claude-code","claude-skills","manus","agent-skills","planning","autonomous-agents","codex","cursor","multi-agent-systems"],"license":"MIT","category":"ai-agents","readme_excerpt":"Planning with Files Your agent's context window dies. The plan does not. Persistent file-based planning for AI coding agents and long-running agent tasks: the skill keeps task plan.md , findings.md , and progress.md on disk and re-injects them every turn, so the plan survives context loss, /clear , crashes, and compaction. Manus-style working memory on disk, with an opt-in completion gate. Installs across 60+ agents via the Agent Skills standard. Before/After · The 3 Files · Install · Benchmarks · Platforms · FAQ · Full install guide --- 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. Without planning files The agent re-reads the repo, asks you to restate the goal, and rediscovers work it already finished. --- With planning-with-files The transcript is illustrative; the ===BEGIN PLAN DATA=== block is the skill's real injection format, written into context by the UserPromptSubmit hook from task plan.md on disk. In the project's internal recovery benchmark, a fresh session with the files on disk resumed in 5.0 turns on average against 13.3 for a raw agent (internal v1, author-run; method and limits in docs/evals.md). At a glance --- ---: Plan files 3 Agents covered 60+ Pass rate (with skill) 96.7% Test suite 417 green Survives /clear yes The Problem Claude Code and most AI agents suffer from: - Volatile memory : the TodoWrite list disappears on context reset - Goal drift : after 50+ tool ","default_branch":null,"files":null,"tree":[],"storefront":"/r/OthmanAdi","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/OthmanAdi/planning-with-files/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}