Planning With Files

Contributors

Code, documentation, and issue contributors. Select a portrait to open a GitHub profile or archived credit. Full credits.

🌍 Built with Planning with Files

Forks & Extensions

Used in the Wild

Skill Registries & Hubs

Bundled snapshots & adaptations

*Built something? Open an issue to get listed!*

Full list of everyone who made this project better: CONTRIBUTORS.md.

  Planning with Files   

  The planning skill your agent cannot ignore.
  Not a prompt it might follow. A hook that fires every turn, a plan on disk that survives /clear, and 3 out of 3 blind A/B wins to show it works.

  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. Activated lifecycle hooks inject selected project planning context, so the plan survives context loss, /clear, crashes, and compaction. Automatic recovery reads project files only. Reading same-project local agent session records for aggregate counts or bounded replay requires an explicit catchup mode. Installs across 60+ agents via the Agent Skills standard, with native plugins for Claude Code, Codex CLI, Qoder CLI, Pi, Hermes Agent, OpenCode and DeepSeek Harness.

  See it survive /clear ·
  Install ·
  Long-running tasks ·
  First-class hosts

  Open the Commands, Multi-agent runs, Benchmarks & more section below for the reference · Full install guide

Quick Install

All install methods: docs/installation.md.

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.

Built for long-running agent tasks

Most harnesses ship a to-do list that lives inside the context…