planninglisted

# AI Maestro Planning Skill ## The Problem This Solves: EXECUTION This skill solves the **execution problem** - losing focus during complex tasks: | Problem | Symptom | This Skill Fixes It | |---------|---------|---------------------| | Goal drift | Forgot original objective after 50 tool calls | Re-read plan before decisions | | Lost progress | Can't remember what phase I'm in | Phase tracking in task_plan.md | | Repeated errors | Make same mistake twice | Error log prevents repetition | | Session loss | Can't resume after /clear | Planning files persist on disk | **Note:** This is different from the Memory skill (which solves recall of past conversations). Planning solves staying focused NOW. --- ## Core Principle ``` Context Window = RAM (volatile, limited, fast) Filesystem = Disk (persistent, unlimited, explicit read required) Anything important gets written to disk. ``` --- ## Output Directory Planning output files (`task_plan.md`, `findings.md`, `progress.md`) should be written to: 1. The directory specified by the `AIMAESTRO_PLANNING_DIR` environment variable (if set) 2. Otherwise, `docs_dev/` in the current project root 3. Create the directory if it does not exist Do NOT write planning files to the project root — use `docs_dev/` to avoid cluttering the project. --- ## The 3-File Pattern Create these files in `docs_dev/` (not the project root or the skill directory): | File | Purpose | Update When | |------|---------|-------------| | `task_plan.md` | G