design-rationale

Document design decisions with context, options, evidence, and trade-offs.

2.0k|325|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Owl-Listener/designer-skills --skill design-rationale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-rationale
Source: https://github.com/Owl-Listener/designer-skills/tree/main/designer-toolkit/skills/design-rationale
Command: npx skills add https://github.com/Owl-Listener/designer-skills --skill design-rationale

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Articulate the reasoning behind key design decisions in a way that is traceable, justified, and aligned with user needs and business goals.

Core Features & Use Cases

  • Structured decision documentation: capture decision, context, options, evidence, and trade-offs in a single place.
  • Decision traceability: link decisions to user research, design principles, and product goals for future handoffs.
  • Templates & consistency: provide reusable templates to standardize rationale across teams and projects.

Quick Start

Provide a design rationale for a major feature decision, including context, alternatives considered, supporting evidence, and the expected impact.

Frequently Asked Questions about design-rationale

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is design rationale documentation and when do I need it?

Design rationale documentation captures the reasoning behind key design decisions to ensure traceability. You need it during major direction changes, feature handoffs, and product system updates to justify choices with evidence.

How do I document design decisions with evidence and trade-offs?

To document design decisions with evidence, capture the decision context, options considered, supporting evidence, trade-offs, validation, and alignment with user needs and business goals in a structured format.

What should be included in a design rationale document for feature handoffs?

A design rationale document for feature handoffs must include decision context, alternatives considered, supporting evidence, trade-offs, and expected impact to ensure downstream teams understand the reasoning.

Does this design rationale approach work for major product system updates?

Yes, documenting design rationale works for major product system updates by linking decisions to user research, design principles, and product goals, ensuring full traceability across complex system changes.

What is the best way to standardize design decision documentation across teams?

The best way to standardize design decision documentation across teams is using reusable templates that consistently capture context, options, evidence, and trade-offs for every major design choice.

Why does my design handoff lack decision traceability?

Your design handoff lacks decision traceability because it does not link decisions to user research, design principles, and product goals, making the reasoning behind choices invisible to downstream teams.