develop-design-rationale

Installation
SKILL.md

Design Rationale

A design rationale document captures the "why" behind design decisions.the context, constraints, alternatives considered, and reasoning that led to a particular solution. While designs themselves show what was built, rationale documents preserve institutional knowledge about why it was built that way.

When to Use

  • When making significant UX decisions that affect user experience
  • Before design reviews to prepare stakeholder discussions
  • When multiple valid approaches exist and the choice needs justification
  • To onboard new team members to existing design decisions
  • When revisiting past decisions to understand original reasoning
  • During design system evolution to document pattern choices

Instructions

When asked to document design rationale, follow these steps:

  1. State the Decision Begin with a clear, one-sentence summary of what design decision was made. This becomes the title and reference point for the document.
Related skills
Installs
102
GitHub Stars
211
First Seen
Mar 25, 2026