develop-design-rationale
OfficialDocument design decisions to guide future work.
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 requiredComponents
💻 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.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.