Technical Planning

Create technical overviews and Architecture Decision Records (ADRs) that document HOW a feature is built — architecture, integration, and decisions.

Workflow

1. Read the spec — Load the spec from the argument path. If no path is provided, ask the user for the spec location.
2. Analyze architecture — Evaluate the analysis questions below against the spec.
3. Create technical overview — Write specs/feature-name/tech.md using assets/tech.md.
4. Determine if ADR(s) are needed — Apply the decision criteria below. Skip if no ADR is warranted.
5. Create ADR(s) — Write docs/adr/NNN-title.md using assets/adr-template.md. Scan existing ADRs for the highest number, increment by one, and pad to 3 digits.

Architectural Analysis

Evaluate these questions for every technical plan: