/write-rationale

description: Write design rationale for a set of decisions, linking each to user needs, business goals, and principles.
argument-hint: "[design decision or feature to write rationale for]"

/write-rationale

Write design rationale for decisions.

Steps

1. **Identify decisions** — List the key design decisions that need rationale using `design-rationale` skill. 2. **Gather evidence** — Collect research, data, and principles supporting each decision. 3. **Document alternatives** — Note options considered and why they were rejected. 4. **Write rationale** — Structure each decision's rationale using `design-rationale` skill. 5. **Review copy** — Ensure rationale language is clear using `ux-writing` skill. 6. **Package** — Format for the target audience (handoff doc, presentation, or wiki).

Output

Design rationale document with each decision documented: context, options, evidence, reasoning, and trade-offs. Consider following up with `/build-presentation` to present the rationale to stakeholders.