planning-with-files

name	planning-with-files
description	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.
metadata	{"version":"3.12.0"}

Hermes note: lifecycle automation for this skill is provided by the Hermes adapter plugin in .hermes/plugins/planning-with-files/.

Planning with Files

Work like Manus: Use persistent markdown files as your "working memory on disk."

FIRST: Restore Project State

Before doing anything else, check if planning files exist and read them:

1. If task_plan.md exists, read task_plan.md, progress.md, and findings.md immediately.
2. Run git diff --stat to see code changes that may not yet be recorded in the planning files.

Automatic recovery stops there. The following optional command reads same-project local session records and emits aggregate counts only:

# Linux/macOS — auto-detects skill directory (Hermes env or default install path)
SKILL_DIR="${HERMES_HOME:-/.hermes}/skills/planning-with-files"
$( -v python3 ||  -v python)  --metadata