planning-with-files

Installation
Summary

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
SKILL.md
Contains Hooks

This skill uses Claude hooks which can execute code automatically in response to events. Review carefully before installing.

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:

  1. If task_plan.md exists, read task_plan.md, progress.md, and findings.md immediately.
  2. Then check for unsynced context from a previous session:
# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"
Related skills

More from othmanadi/planning-with-files

Installs
25.6K
GitHub Stars
21.6K
First Seen
Jan 20, 2026