develop-design-rationale

Official

Document design decisions to guide future work.

Authorproduct-on-purpose
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Design decisions are often poorly documented, leading to misinterpretations, repeated debates, and loss of crucial context. This Skill provides a structured way to capture the rationale behind design choices so future teams understand the "why" behind decisions.

Core Features & Use Cases

  • Structured decision records: Capture context, alternatives considered, evaluation criteria, and trade-offs in a single, reusable artifact.
  • Governance and onboarding support: Use in design reviews, architecture discussions, and design-system governance to accelerate alignment.
  • Audit-ready documentation: Maintain a traceable history for knowledge transfer, compliance, and future reference.

Quick Start

Create a design rationale document for a recent UX decision, including the problem statement, explored options, the chosen approach, assessment criteria, and next steps. Attach the rationale to the design review and reference it from the design-system repository.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: develop-design-rationale
Download link: https://github.com/product-on-purpose/pm-skills/archive/main.zip#develop-design-rationale

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.