planning-with-files: skill pack for Hermes Agent

Persistent file-based planning skill that keeps task plans on disk and survives /clear and compaction

What planning-with-files does

The skill keeps three markdown files in your project: task_plan.md for phases and checkboxes, findings.md for research notes and decisions, and progress.md for a session log and test results. Lifecycle hooks inject selected planning context every turn, so the plan survives context loss, /clear, crashes and compaction. Parallel tasks get isolated directories under .planning/YYYY-MM-DD-slug/, selected through .active_plan (v2.36.0+).

On first-class hosts it runs as a native plugin with per-turn plan injection, progress reminders, a completion gate, /pwf commands and model-callable tools. The README names Claude Code, Codex CLI, Pi, Hermes Agent, OpenCode and DeepSeek Harness, and says other platforms get the skill through the Agent Skills standard. The project reports that the on-disk plan cut a 13.3-turn re-orientation to 5.0 turns and won 3 of 3 blind A/B comparisons; these are its own measurements, with limits documented in the README.

Key features

Three plan files on disk: task_plan.md, findings.md and progress.md
Per-turn plan re-injection through lifecycle hooks
Recovery after /clear, compaction and crashes
Completion gate that holds the agent's stop until the plan reports complete
Isolated .planning directories for parallel tasks
Native plugin on first-class hosts including Hermes Agent

When to use it

Long Hermes Agent tasks that must survive context resets
Resuming work at the current phase after /clear
Running parallel tasks with separate plan directories

Who it is for: Developers running long, multi-step agent tasks who lose progress when the context window resets.

How it fits with Hermes Agent

Hermes Agent is named as a first-class host with a native plugin, and the repository is tagged hermes-plugin and hermes-skill.

How to install planning-with-files

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

FAQ

What is planning-with-files?

planning-with-files is a skill that stores an agent's task plan, findings and progress in markdown files on disk. Hooks re-inject the plan each turn, so work continues after /clear, compaction or a crash.

Does planning-with-files work with Hermes Agent?

Yes. The README lists Hermes Agent among the first-class hosts with a native plugin, and the repository carries the hermes-plugin and hermes-skill topics.

How do I install planning-with-files?

The Quick Install command is npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g. The README points to docs/installation.md for all other install methods.