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:
- If
task_plan.mdexists, readtask_plan.md,progress.md, andfindings.mdimmediately. - 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)"
Installs
37.4K
Repository
othmanadi/plann…th-filesGitHub Stars
25.4K
First Seen
Jan 20, 2026
Security Audits