planning-with-files

What problem does it solve? Long tasks with many tool calls cause AI agents to lose track of goals, repeat failed actions, and forget discoveries when context resets. This Skill stores plans, findings, and progress in persistent markdown files so work survives context loss and session breaks. ## Core Features & Use Cases - Three-File Planning Pattern: Creates task_plan.md for phases and decisions, findings.md for research, and progress.md for session logs. - Session Recovery: Detects unsynced context from previous sessions via a catchup script and restores state after /clear. - Lifecycle Hooks: Automatically re-reads the plan before tool calls, prompts progress updates after edits, and checks phase completion on stop. - Use Case: When asked to research a topic and produce a report, the Skill creates a phased plan, logs every finding and error to disk, and lets the agent resume seamlessly even after the conversation is cleared. ## Quick Start Ask the AI to plan out and organize your multi-step project using file-based planning before starting any work.