product-on-purpose avatar

Develop Design Rationale

Structured record of the reasoning behind UX decisions: context, alternatives, trade-offs, and follow-ups.

skills.sh installs
817
GitHub stars
813
last updated
Aug 21, 2026

Install

$ npx -y skills add product-on-purpose/pm-skills --skill develop-design-rationale --agent claude-code

Installs into .claude/skills of the current project.

What it does

  • Covers the rationale workflow: decision statement, context, options considered, evaluation criteria, reasoning, trade-offs, and follow-up items
  • Includes a template in references/TEMPLATE.md with sections for reversibility and decision history, plus a worked example in references/EXAMPLE.md
  • Requires at least two or three alternatives documented fairly, with explicit evaluation criteria before the chosen option is justified
  • Designed for significant UX decisions, design reviews, onboarding, and design system changes, not for architecture or trivially reversible choices

Sponsors

Files

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

When NOT to Use

Details

Repository
github.com/product-on-purpose/pm-skills
Category
Design & UI/UX
First seen
Jun 3, 2026

More from product-on-purpose/pm-skills

All 68
1alirezarezvani avatarapi-design-revieweralirezarezvani/claude-skillsComprehensive REST API design review with automated linting, breaking-change detection, and design scorecards. Catches inconsistent conventions, missing version816skills.sh installs
2diodeinc avatarreference-designdiodeinc/pcbGrow a component package into a high-quality, sourceable reusable design in Zener. Use when translating a datasheet, application note, or eval design into circu799skills.sh installs
3subframeapp avatardesignsubframeapp/subframeDesign and edit anything in Subframe — pages, components, snippets, design documents, the theme. Also handles deletion of those resources except theme. Always l798skills.sh installs
4thebushidocollective avataratomic-design-fundamentalsthebushidocollective/hanUse when applying Atomic Design methodology to organize UI components into quarks, atoms, molecules, organisms, templates, and pages. Core principles and hierar786skills.sh installs
5sickn33 avatarweb-design-guidelinessickn33/antigravity-awesome-skillsweb design guidelines766skills.sh installs
6eachlabs avatarvideo-color-gradingeachlabs/skillsApply professional color grading and correction to videos using each::sense AI. Create cinematic looks, film emulations, color corrections, and stylized grades 732skills.sh installs