planning-with-files

SKILL.md

File-based task organization and progress tracking for complex multi-step projects.

Creates and maintains three persistent markdown files (task_plan.md, findings.md, progress.md) to preserve context across sessions and tool calls

Automatically detects active plans on startup and prompts context recovery; supports session restoration after /clear via catchup script

Enforces structured workflow: plan phases upfront, log discoveries and errors immediately, update progress after each action, and re-read plan before major decisions

Includes hooks that display task plan before tool use and prompt progress updates after writes, plus templates and helper scripts for initialization and completion verification

Planning with Files

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

FIRST: Restore Context (v2.2.0)

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

If task_plan.md exists, read task_plan.md, progress.md, and findings.md immediately.

Then check for unsynced context from a previous session:

# Linux/macOS — auto-detects skill directory (plugin env or default install path)
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files}"
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)"