SkillsPlugins & marketplacesHooksSlash commands

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.

Stars
28,178
+7 days
—
Forks
2,323
Language
Shell
License
MIT
Last push
21 Nov 2026

Summary

Summary written by AI from the README; it may be imprecise.

This tool provides persistent file-based planning for AI coding agents across long-running tasks. It maintains three Markdown files—task_plan.md, findings.md, and progress.md—on disk to track tasks, decisions, and session logs. Lifecycle hooks re-inject the plan on every turn, allowing the agent to recover progress after compaction or /clear commands.

Use it when

  • When running long coding agent tasks that risk context rot, compaction, or crashes
  • When recovering agent progress and task status after using /clear in a session
  • Track multi-phase implementation plans and research notes directly on disk across turns

Install

plugin
/plugin marketplace add OthmanAdi/planning-with-files
plugin
/plugin install planning-with-files@planning-with-files
npm
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

Commands quoted from the repo's README. Read the README before running them.

Includes hooks that run shell commands on your machine. Read them before installing.

Stars over 90 days

Collecting: 2 of 90 days so far. The chart appears after 7 days.

Type to search the reference, templates and lessons.