What it does
The skill stores plans and shared state in Markdown files, adds deterministic completion gates, and supports many coding agents.
Planning with Files
A file-based planning skill for long-running agent tasks that must survive context loss, restarts, and collaboration.
Last reviewed: 2026-07-19
OthmanAdi/planning-with-files
Repository facts
Turn product intent into requirements, architecture, scoped tasks, and acceptance criteria.
- GitHub Stars
- 25.5K
- License
- MIT
- Default branch
- master
- Last pushed
- 2026-07-18
- Repository status
- Active
- Snapshot
- 2026-07-19
Best fit
Complex tasks where progress, decisions, and completion evidence must persist outside the chat window.
Capabilities
- Persist plans, findings, decisions, and task state on disk.
- Resume after context clearing and share state among multiple agents.
Use cases
- Run a multi-day migration without losing completed work or open questions.
- Coordinate several agents through a shared plan and completion gate.
Source
OthmanAdi/planning-with-files
Open GitHub repoSource & review
Review notes: Details checked against the public repository README and project links.
Related in this category
Turn product intent into requirements, architecture, scoped tasks, and acceptance criteria.
Grill Me
Matt Pocock's viral /grill-me skill: one-question-at-a-time interviews that stress-test a plan before any code is written.
GitHub Spec Kit
GitHub's toolkit for turning product intent into specifications, plans, and implementation tasks.
OpenSpec
Turns product intent into specs, tasks, and implementation guidance for AI coding assistants.