OthmanAdi/planning-with-files

▲ 188 stars today★ 26,932⑂ 2,241

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

agent-skillsautonomous-agentsclaudeclaude-codeclaude-code-skillsclaude-skillscodexcoding-agentcontext-engineeringcontext-rotcursorgithub-copilot
Open on GitHub ↗Homepage ↗

About OthmanAdi/planning-with-files

OthmanAdi/planning-with-files is an open-source project on GitHub, mainly written in Shell. Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction It currently holds 26,932 stars and 2,241 forks with 8 open issues, and was last pushed on 2026-09-16 (repository created 2026-01-03).

Project Overview

AI Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository OthmanAdi/planning-with-files · default branch master · size 13938 KB · watchers 117 · source: GitHub REST API and repository README

README

Contributors

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

https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@MannXo https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@winxtxrgit https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@EmadMokhtar https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@MbappeWU https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Vyzygota https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@littleblacklb https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Amiirhosseini https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@AvitalAviv https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@DorianZheng https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@dubes394 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@dylanpulver https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Enard52 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@JianweiWangs https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@lazyst https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@loarland https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@luyanfeng https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@marcmuon https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mfehlhaber https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mixian939 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@msuadOf https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mtuwei https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@nazeshinjite https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@sean3808 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@shouldnotappearcalm https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@st01cs https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@tingles2233 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Whxuan0701 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@wqh17101 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@kaichen https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@fuahyo https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@lasmarois https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@aimasteracc https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@SaladDay https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@murphyXu https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ZWkang https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@EListenX https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@lincolnwan https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ciberponk https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ttttmr https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mvanhorn https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ebrevdo https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@bailob https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@as992949791 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@shuoxuekeji https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Jinzy https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@SomSamantray https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mmychu https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ericshunhinglee-cloud https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ShaunLinTW https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@TayfurYldz https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@kuei51307-hub https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Dphoshoba https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@sunznx https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@hzura https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@wangxiaodong1021 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@sortakool https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@lowmiaq-gmail https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@webwww123 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@killianMei https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@GlitterKill https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@seathatflowsinourveins https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@fd44fdg https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@jschmied https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@yolo0731 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@ziyu4huang https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@kcinzgg https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@mahdiit https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Dikshj https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@2023Anita https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@GongYuanCaiJi https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Fat-Jan https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@shunfeng8421 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Skulli485 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@carterusedulm2-maker https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@gauravvojha https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@CleanDev-Fix https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@bmyury https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@oaabahussain https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@gavinlinasd https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@xiaolai https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@githubYiheng https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@09ashishkapoor https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@shawnli1874 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Leon-Algo https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@YSAA1 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@kevinaimonster https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@wd041216-bit https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@popey https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@jonthebeef https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@codelyc https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Guozihong https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@fahmyelraie https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@olgasafonova https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@AZLabsAI https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@raykuo998 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@gydx6 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@waynelee2048 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@tobrun https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@markocupic024 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@tt-a1i https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Emin017 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@TomXPRIME https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@DLI1996 https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Stephen-abc https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@igorcosta https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Yigtwxx https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@RioTheGreat-ai https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@kmichels https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@voidborne-d https://github.com/OthmanAdi/planning-with-files/blob/HEAD/@Kiddo4993

🌍 Built with Planning with Files

Forks & Extensions

| Fork | Author | What They Built | |------|--------|-----------------| | devis | @st01cs | Interview-first workflow, /devis:intv and /devis:impl commands, guaranteed activation | | multi-manus-planning | @kmichels | Multi-project support, SessionStart git sync | | plan-cascade | @Taoidle | Multi-level task orchestration, parallel execution, multi-agent collaboration | | agentfund-skill | @RioTheGreat-ai | Crowdfunding for AI agents with milestone-based escrow on Base | | openclaw-github-repo-commander | @wd041216-bit | 7-stage GitHub repo audit, optimization, and cleanup workflow for OpenClaw | | planning-with-sysspec | @tianshan | Spec-first extension adding structured module specifications, spec deltas and validation matrices (source) |

Used in the Wild

| Project | What It Is | |---------|-----------| | lincolnwan/Planning-with-files-copilot-agent | Entire Copilot agent repo built around the planning-with-files skill | | cooragent/ClarityFinance | AI finance agent framework, Planning-with-Files approach directly credited | | oeftimie/vv-claude-harness | Claude Code harness built on Manus-style persistent markdown planning | | jessepwj/CCteam-creator | Multi-agent team orchestration skill using file-based planning | | smallnest/langgraphgo: Manus Agent | Go implementation of the planning-with-files pattern with persistent task plans, research notes and output files (source) | | a5c-ai/babysitter | SDK planning, execution, session-recovery and verification processes adapted from planning-with-files (source) |

Skill Registries & Hubs

| Registry | What It Is | |----------|-----------| | buzhangsan/skill-manager | Bilingual (EN/中文) Claude Code skill hub; planning-with-files installable one-click |

Bundled snapshots & adaptations

| Project | Verified relationship | |---------|-----------------------| | benchflow-ai/skillsbench | Bundles planning-with-files v2.1.2 in its organize-messy-files benchmark task (snapshot) | | sickn33/agentic-awesome-skills | Cross-agent skill collection shipping an adapted planning-with-files copy, originally imported at v2.1.2 (import) |

Built something? Open an issue to get listed!

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

https://github.com/OthmanAdi/planning-with-files/blob/HEAD/PWF: Every task. Every step. Three planning files on a brass-inlaid base beneath an engraved arch

Planning with Files   https://github.com/OthmanAdi/planning-with-files/blob/HEAD/Trendshift: #1 Repository of the Day across all languages

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.

https://github.com/OthmanAdi/planning-with-files/blob/HEAD/Stars https://github.com/OthmanAdi/planning-with-files/blob/HEAD/Latest release

GitHub Stars & Activity

26,932Stars
2,241Forks
8Open issues
ShellLanguage

GitHub Popularity

GitHub stars26,932
Forks2,241
Open issues8
Primary languageShell
LicenseMIT
Stars gained today188
Created2026-01-03
Last pushed2026-09-16

Trending History

Weekly boardrank #64 · ▲ 188 stars

Related AI Projects

1

obra / superpowers

Shell★ 309,942⑂ 27,571▲ 663 stars
→
2

mattpocock / skills

Shell★ 308,196⑂ 25,934▲ 882 stars
→
3

msitarzewski / agency-agents

Shell★ 165,662⑂ 26,818▲ 334 stars
→
4

Donchitos / Claude-Code-Game-Studios

Shell★ 31,026⑂ 4,252▲ 1,347 stars
→
5

a2aproject / A2A

Shell★ 26,361⑂ 2,687▲ 15 stars
→
6

nyldn / claude-octopus

Shell★ 4,346⑂ 412▲ 7 stars
→
7

expo / skills

Shell★ 3,980⑂ 252▲ 201 stars
→
8

anthropics / skills

Python★ 185,808⑂ 21,939▲ 756 stars
→

More AI Rankings