
planning-with-files
Markdown planning skill that keeps a coding agent's plan and progress in your project
- Pricing
- Open source
- Platforms
- CLI
- GitHub stars
- 28.1K
- Last commit
- 6 days ago
- Language
- Shell
- License
- MIT
About planning-with-files
planning-with-files is an open-source AI tool for files and documents. It is available on CLI.
Planning with Files is an open-source skill for coding agents that stores the goal, findings and progress in three plain Markdown files inside your project. Because the state lives on disk, a new session can pick up the next step after the conversation context is reset.
Depending on the host agent, integrations can surface planning context at lifecycle points and an optional gated mode can block a stop or request another pass, with retry and stall limits. Parallel tasks can each be pinned to their own plan or worktree.
Its completion checks read recorded state only; tests and review remain responsible for judging whether the code is correct.
What it does
- Three-file plan
- Keeps goal, findings and progress as Markdown files.
- Session recovery
- Lets a new session resume from the saved next step.
- Lifecycle hooks
- Surfaces planning context where the host agent supports it.
- Gated completion
- Optionally blocks stopping while phases remain unfinished.
- Per-task plans
- Pins parallel work to separate plans or worktrees.
Good for
- Resume coding work after a context reset
- Track decisions and verification status in a repo
- Stop an agent from declaring unfinished work done
- Separate plans for parallel agent tasks
Pricing
Open source
Open source (MIT)
Prices change. Check gilded-laurel-c7nj.here.now before you buy.
planning-with-files FAQ
What format are the files?
Plain Markdown, readable by you and your agents.
Does it verify code is correct?
No, completion checks read recorded state; tests and review establish correctness.
Is planning-with-files free?
Yes. planning-with-files is open source, so you can use and self-host it for free.
What are the best alternatives to planning-with-files?
The closest alternatives to planning-with-files are Praxy AI, ChatPDF, ChatDOC, MajorGen and to teach.