planning-with-files

github:OthmanAdi/planning-with-files · first committed 2026-01-27 · source · badge

Implements Manus-style file-based planning to organize and track progress on complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring 5+ tool calls. Supports automatic session recovery after /clear.

Skill Health 100 (freshness and quality) estimated by backskills

Listed, not yet scored. This skill has no public model test yet. It is in the scoring queue; submitted skills go first, then the most-installed.

Freshness 100 · Quality 100 · Efficacy not yet tested

Version history

95 commits to this file on GitHub (newest first).

2026-10-30 · commit bafd623 · feat: add bounded agent-readable plan inventory
2026-10-30 · commit a13b6be · release: v3.27.0 add agent-readable plan inventory
2026-10-28 · commit 5d29800 · release: v3.26.0 add opt-in subagent isolation and repair hooks
2026-10-24 · commit 7e134c7 · fix: validate initialized plan structure without changing stop behavior
2026-10-24 · commit dcdfb27 · release: v3.25.2 validate plan creation and repair harness hooks
2026-10-23 · commit 99402ce · release: v3.25.1 status validity and optional eval
2026-10-20 · commit de837a9 · release: v3.25.0 isolate Hermes plan selection
2026-10-17 · commit d363544 · release: v3.24.3 verify Pi plan snapshot attestation
2026-10-17 · commit 4e76b40 · release: v3.24.2 suppress repeated Pi plan reminders
2026-10-16 · commit 6b30f32 · release: v3.24.1 validate hidden adapters and correct contributor guides
2026-10-10 · commit 7056ed2 · release: v3.24.0
2026-10-06 · commit 41f60ae · release: v3.23.0
2026-10-01 · commit dab9d16 · release: v3.22.0
2026-09-27 · commit 51c1caa · release: v3.21.0
2026-09-25 · commit 4d24d9a · release: v3.20.8
2026-09-23 · commit 3b7690e · release: v3.20.7
2026-09-23 · commit 3827d3c · release: v3.20.6
2026-09-21 · commit b81c488 · release: v3.20.5
2026-09-19 · commit 726da18 · release: v3.20.4
2026-09-19 · commit 57fe376 · release: v3.20.3
2026-09-19 · commit f01a88a · release: v3.20.2
2026-09-18 · commit faf1a15 · release: v3.20.1
2026-09-17 · commit 2fbbd77 · release: v3.20.0
2026-09-17 · commit 7a0a020 · release: v3.19.0
2026-09-16 · commit 746f57a · release: v3.18.3
2026-09-16 · commit f12e714 · release: v3.18.2
2026-09-15 · commit 7c11cb7 · release: v3.18.1
2026-09-13 · commit 10d4a58 · release: v3.18.0
2026-09-13 · commit ae7e3ae · fix: make plan listing safe and useful across install surfaces
2026-09-09 · commit f67e2bb · release: v3.17.2
2026-09-08 · commit 5046267 · release: v3.17.1
2026-09-07 · commit 0d21b6c · release: v3.17.0
2026-09-05 · commit 8dd1e3f · release: v3.16.1 verified session and hook repairs
2026-09-05 · commit 91b152c · fix: bind parallel sessions and repair standalone hook delivery
2026-09-02 · commit 0fb6759 · release: v3.16.0
2026-09-02 · commit 601df17 · release: v3.15.0
2026-09-02 · commit a3e7b8b · release: v3.14.0
2026-09-02 · commit 64837c7 · release: v3.13.0
2026-08-31 · commit 2d98d31 · release: v3.12.1
2026-08-30 · commit d5d35e6 · release: v3.12.0
2026-08-30 · commit 7e55a06 · fix(security): expose planning behavior and template guidance
2026-08-22 · commit 9e94390 · release: v3.11.2
2026-08-21 · commit 39d75d8 · release: v3.11.1
2026-08-20 · commit de6749b · release: v3.11.0
2026-08-19 · commit 09740f7 · release: v3.10.2
2026-08-14 · commit 9b7d0a0 · release: v3.10.1
2026-08-09 · commit 40bef77 · release: v3.10.0 (a second session can no longer erase your plan in silence)
2026-08-01 · commit 0e2b00c · release: v3.9.0 (plan resolution binds to a root, refusals are never silent)
2026-08-01 · commit be867c6 · fix: dispatch every hook-bearing SKILL.md variant to the versioned script
2026-07-24 · commit b04ffd9 · release: v3.8.2 (session recovery finds dotted, spaced and emoji project paths)
2026-07-21 · commit 117dfae · release: v3.8.1 (Pi resolution anchored and hardened, Next Step reaches created plans)
2026-07-21 · commit b49ea48 · feat: make the Stop hook and session recovery fire everywhere, add long-run injection controls
2026-07-18 · commit eb91302 · release: v3.7.0 (Agent Skills standard layout in-tree, plan-doctor in every mirror)
2026-07-18 · commit bb292cb · release: v3.6.0 (silent hook loss on native-coreutils Windows fixed, /plan-doctor, install matrix)
2026-07-14 · commit f90780c · release: v3.5.1 (Codex WSL bash resolver skip, Windows Python discovery, Pi interactive-tool fix)
2026-07-13 · commit f13118c · release: v3.5.0 (Codex Windows hooks, Pi nag fix, plan lifecycle docs)
2026-07-12 · commit e8ce66f · release: v3.4.1 (Codex hooks run on Windows, closes #201)
2026-07-06 · commit d71b3be · release: v3.4.0 (PLANNING_DISABLED=1 opt-out for one-shot sessions, closes #195)
2026-07-06 · commit 34d4a7e · release: v3.3.0 (Pi extension /plan-execute approval gate, PR #193 merged, closes #190)
2026-07-03 · commit 8459756 · release: v3.2.0 (v3 health audit: session-catchup + inject-plan Windows fixes, 0/0-phases guard, analytics templates, 2 PRs merged)
2026-06-16 · commit 8f5a3c2 · release: v3.1.3 (hotfix: quote SKILL.md description, fix invalid YAML frontmatter from v3.1.2)
2026-06-16 · commit 1f7aa0b · release: v3.1.2 (session-catchup PLUGIN_ROOT fallback + .hermes parity + skill description refresh)
2026-06-16 · commit bbedaad · fix: session-catchup command fails when PLUGIN_ROOT is unset (fixes #185)
2026-06-14 · commit c020bdd · release: v3.1.1 (Codex verification command checks canonical hooks flag)
2026-06-13 · commit 4ef88df · release: v3.1.0 (Codex stop non-blocking + Codex PreCompact parity + Pi tests + SHA-cache docs)
2026-06-09 · commit 03ef8be · release: v3.0.0 (autonomous + gated modes, run ledger, completion gate, legacy byte-identical default)
2026-05-26 · commit 577a1c5 · release: v2.43.0 (CONTRIBUTING.md + OpenCode docs fix + .continue/.gemini/.kiro variant sync)
2026-05-25 · commit 2e46091 · release: v2.42.0 (POSIX init-session portability + plugin-vs-skill install transparency + Topic Handoff docs)
2026-05-24 · commit 1146688 · release: v2.41.0 (Windows exec-bit skip + attestation-locking docs)
2026-05-22 · commit 755276c · release: v2.40.1 (Pi adapter SKILL.md sync + npm scope correction)
2026-05-21 · commit 3e35f42 · release: v2.40.0 (slug-mode resolution fix + perf cache + KV-cache hygiene + Pi false-positive fix)
2026-05-21 · commit 27ef36c · release: v2.39.0 (Pi full hook parity extension + Codex hooks flag fix)
2026-05-16 · commit d27008f · fix: v2.38.1 swap plan-injection delimiter from --- to === to avoid YAML doc-separator collision
2026-05-14 · commit 2d08913 · release: v2.38.0 (Claude Code turn-loop integration + OpenCode SQLite fix)
2026-05-05 · commit 6cd6254 · release: v2.37.0 (hash attestation + parity-locked version bumper)
2026-05-01 · commit a3e52a1 · fix: v2.36.3 propagate resolve-plan-dir + set-active-plan to canonical skill
2026-05-01 · commit fadbf1f · fix: v2.36.2 sync canonical skill scripts to top-level (PR #149 by @voidborne-d)
2026-05-01 · commit f7e8919 · fix: v2.36.1 security hardening (Gen Agent Trust Hub FAIL + Snyk WARN)
2026-05-01 · commit 9bf31fc · release: v2.36.0 (parallel plan isolation + Codex session isolation + Hermes docs)
2026-04-21 · commit 41a8b15 · release: v2.35.0 (Hermes adapter + NLPM audit fixes)
2026-04-17 · commit ae2e389 · fix: Stop hook broken on Windows Git Bash (closes #133)
2026-04-15 · commit 9f158bf · fix: SkillCheck critical — >5 → 5+ in description, comma → space in allowed-tools; restructure README badges with credibility row first, ver
2026-04-15 · commit 6aa4276 · release: v2.34.0 — Codex hooks restored, spring cleaning, contributors updated
2026-04-08 · commit 3523380 · feat: Add Arabic, German, and Spanish language support + enhance Chinese variants
2026-04-08 · commit 9fe2978 · feat: Add Arabic, German, and Spanish language support + enhance Chinese variants
2026-04-08 · commit e60c8e1 · release: v2.32.0 — Codex session catchup, Loaditout badge, Stop hook fix, version sync
2026-04-08 · commit 6d8b30e · fix: Stop hook Git Bash compatibility + Loaditout security badge (#123, #125)
2026-03-20 · commit 3ff59de · fix: replace --- with === in hook commands to prevent YAML frontmatter breakage
2026-03-20 · commit 9aee747 · fix: session catchup after /clear — path sanitization + content injection (#106)
2026-03-15 · commit 09ee8e4 · fix: session catchup, progress tracking, and post-completion workflow (v2.23.0)
2026-03-05 · commit ee02cc5 · security: remove WebFetch/WebSearch from allowed-tools, add Security Boundary (v2.21.0)
2026-02-27 · commit f2f0547 · fix: Stop hook fails on Windows — multiline YAML command not parsed by Git Bash
2026-02-25 · commit 8104801 · fix(skill-metadata): apply PR #83 spec fixes to Group A IDEs
2026-02-05 · commit 7082c7f · fix: update codebuddy paths and codex usage docs
2026-01-27 · commit f973f64 · Add CodeBuddy integration with planning-with-files skill (#60)

Archived snapshots

archived 2026-11-01T09:01:14+00:00 · sha256 1b7a8602a174