spec

name	spec
description	Phase 1 planning — read docs, read source, write implementation plan
argument-hint	<task-description>
user-invocable	true
allowed-tools	["Read","Glob","Grep","Bash"]

Phase 1: Spec (Plan)

Before writing any code, produce a plan for the requested change.

1. Read the relevant documentation in documentation/.
2. Read every source file you intend to modify.
3. Write a concise plan:
   • What changes and why.
   • Which files are affected.
   • Any risks or open questions.
4. Document key design decisions and their rationale. If there are multiple viable approaches, state which one you chose and why. This prevents oscillating between approaches during implementation.
5. Present the plan and wait for human approval before proceeding.

Do NOT skip to implementation. A good plan lets you one-shot Phase 2.

User request: $ARGUMENTS