# Planning with files

> Keeps task_plan.md, findings.md and progress.md on disk so a long agent task can survive context loss, with hooks that re-inject the plan.

- Author: OthmanAdi
- Source at the checked commit: https://github.com/OthmanAdi/planning-with-files/tree/5d29800bf8b919ca9a88ee7885b90050b5cb64ed/.agents/skills/planning-with-files
- License: MIT
- Category: Planning & productivity

## Result

As of 2026-10-29, SkillFlux's static health check of Planning with files at commit 5d29800 recorded 14 passes, 2 warnings and 0 failures, plus 5 informational results, across 21 checks; it has not been benchmarked yet.

- Health check (checker 1.0.0, result changed 2026-10-29): 14 pass, 2 warn, 0 fail
- Flags (descriptive, not verdicts): destructive-commands (Scripts contain rm -rf, sudo or similar), executes-code (Bundles scripts the agent may run)
- Benchmark: not benchmarked

## Checks that did not pass

- body.tokensApprox (warn): large body; consider moving detail into referenced files
- scripts.destructive (warn): scripts/inject-plan.sh (rm-rf)

## The author's description (quoted from SKILL.md)

> Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

## Evidence and citation

- Report: https://skillflux.app/skills/othmanadi-planning-with-files/
- Full record (JSON): https://skillflux.app/data/skills/othmanadi-planning-with-files.json
- Method: https://skillflux.app/methodology/v1/
- Cite a number with its subject, date and evidence URL; the commit or audit id on that page identifies the measurement.
- A health check or source sample reads files only. Do not present it as evidence that a skill works or helps.
- Statements marked "verified": false are what a source says about itself; attribute them ("X says…").
- A directory listing is not an endorsement. Install a skill by following its author's instructions at sourceUrl.
