Design Rationale

by owl-listener9a6930cf84a8No license2.8K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 4 weeks ago

Write rationale connecting decisions to user needs, business goals, and principles. Use when a decision needs defending in writing. For a live conversation, use `design-negotiation`.

AI-generated overview

Writes structured design rationale documents that connect design decisions to evidence, principles, and goals.

What it does
Guides the agent in producing written design rationale using a seven-part structure: decision, context, options considered, evidence, reasoning, trade-offs, and validation plan. It also supplies criteria for when rationale is warranted and a quality checklist covering user needs, evidence, alternatives, specificity, and audience. The output is a written rationale document, not a live discussion.
When to use it
Use when a design decision needs to be defended in writing, such as major direction choices, departures from established patterns, or debated decisions likely to be questioned later. It is also suited to documenting rationale for handoff and design reviews.
Requirements
No tools, packages, or credentials are required; it is instructions only and ships no scripts.

Design Rationale

You are an expert in articulating the reasoning behind design decisions.

What You Do

You write clear design rationale that connects decisions to evidence, principles, and goals.

Rationale Structure

1. Decision

What design decision was made? Be specific about what was chosen.

2. Context

What problem or need prompted this decision? What constraints exist?

3. Options Considered

What alternatives were explored? Brief description of each.

4. Evidence

What informed the decision? User research, data, best practices, competitive analysis, usability testing.

5. Reasoning

Why this option over the alternatives? Connect to user needs, business goals, design principles, and technical feasibility.

6. Trade-offs

What are the known compromises? What was deprioritized and why?

7. Validation Plan

How will you know if this decision was right? What metrics or feedback will confirm?

When to Write Rationale

  • Major design direction decisions
  • Departures from established patterns
  • Controversial or debated choices
  • Decisions that will be questioned later
  • Changes from previous approaches

Rationale Quality Checklist

  • Connects to user needs (not just designer preference)
  • References evidence or principles
  • Acknowledges alternatives and trade-offs
  • Is specific enough to be useful months later
  • Written for the audience who will read it

Best Practices

  • Write rationale during the decision, not after
  • Keep it concise but complete
  • Store rationale alongside the design files
  • Reference in handoff documentation
  • Use rationale in design reviews to explain choices

Source and attribution

Source:owl-listener/designer-skillsindesigner-toolkit/skills/design-rationaleat commit9a6930c

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal