designer-skills/designer-toolkit/commands/write-rationale.md

description	argument-hint
Write design rationale for a set of design decisions.	[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.