plan

name	plan
description	Write a strategy doc before starting multi-step, multi-file, or unclear work. Use when asked to "plan out", "figure out the approach", or before any task needing more than one step.

Skip entirely for trivial one-step work (single edit, single command, single read).

Pick a short kebab-case <slug> for the task (e.g. auth-refactor, fix-retry-bug) and reuse the same slug for any execution-state list under /tmp/mi-<slug>/tasks.md so plan and tasks move together. If a plan already exists for the task, reuse the same slug rather than starting a new one (ls -d /tmp/mi-*/ 2>/dev/null to check).

Create the directory and write the plan file with one command:

mkdir -p /tmp/mi-<slug> && cat > /tmp/mi-<slug>/plan.md <<'EOF'
# Goal
...
# Approach
- ...
# Risks / Open Questions
- ...
EOF

Slug collisions: When multiple concurrent mi sessions may run simultaneously (e.g. parallel subagents each starting their own plan), append a timestamp or random suffix to avoid clobbering each other's files: auth-refactor-$(date +%s). Single-session sequential work does not need this.

Write /tmp/mi-<slug>/plan.md with three sections, nothing else:

# Goal
<one line: what "done" looks like>

# Approach
- <ordered bullets: the strategy, not every keystroke>
- <keep it to 3-6 bullets>

# Risks / Open Questions
- <unknowns, assumptions, things that could bite>
- <omit section if genuinely none>

This is strategy, not a task list. No checkboxes, no status fields — execution state belongs in /tmp/mi-<slug>/tasks.md, not here. To track step-by-step progress alongside this plan, call skill("tasks") and follow its body.

Re-read /tmp/mi-<slug>/plan.md before each major step. If reality diverges from the plan, revise the file before continuing — do not let it rot.

Revise (don't append) when direction changes. The doc should always reflect current intent, not history.