pi-planning-with-files
Persistent file-based planning for multi-step AI-agent work
by othmanadiFree
Description
Pi-planning-with-files is an agent skill for multi-step work that keeps the plan on disk. The idea is to use persistent markdown files as working memory: task_plan.md holds the plan, findings.md holds what has been learned, and progress.md records where things stand. Before continuing a task, the skill restores the project state by resolving which plan the task owns, using a helper script with a plan ID and a root setting, and then reads those three files from that one plan directory. The skill is designed so that a root-level plan does not override a named plan, and it stops and asks when more than one plan exists without an identifier. Lifecycle hooks can inject project context at set points. Because hooks can run code automatically in response to events, the listing carries a notice that you should review the hooks carefully before installing. It is listed on skills.sh by othmanadi, and the skill is free.…
Highlights
- Keeps the plan, findings and progress as markdown files on disk
- Restores project state before continuing a task
- Selects one plan directory when several exist
- Uses lifecycle hooks, which should be reviewed before installing
Ratings & Reviews
No ratings yet
Be the first to rate pi-planning-with-files.
People also visit
batch-grill-me
A relentless interview that asks every frontier question at once, round by round
pi-planning-with-files FAQ
What files does it keep?
task_plan.md for the plan, findings.md for what has been learned, and progress.md for status.
Why store the plan on disk?
So a multi-step task can be resumed from the files rather than from the conversation memory.
What do the hooks do?
They can inject selected project context at lifecycle events. The skill notes that hooks run code automatically, so review them before you install.
What if there are several plans?
The skill asks you to name the plan, and stops if the selector is rejected or no identifier is given.
How do I install it?
Run npx skills add https://github.com/othmanadi/planning-with-files --skill pi-planning-with-files in your terminal, after reviewing the hooks.
Is it free?
The listing shows the skill as free.
What are the best pi-planning-with-files alternatives?
Popular alternatives to pi-planning-with-files include batch-grill-me, obsidian and decision-mapping. See all pi-planning-with-files alternatives