
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-codeInstalls 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.mdwith sections for reversibility and decision history, plus a worked example inreferences/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- Foundation Persona817
- Measure Instrumentation Spec816
- Iterate Retrospective813
- Measure Experiment Results811
- Utility Mermaid Diagrams810
- Discover Stakeholder Summary804
- Foundation Okr Writer804
- Develop Spike Summary797
- Iterate Pivot Decision792
- Iterate Lessons Log790
- Utility Slideshow Creator788
- Foundation Lean Canvas785
- Iterate Refinement Notes777
- Utility Pm Skill Builder775
- Foundation Meeting Agenda772
- Foundation Stakeholder Update766
- Foundation Meeting Recap760
- Utility Pm Skill Validate760
- Foundation Meeting Synthesize759
- Utility Pm Skill Iterate758
- Foundation Meeting Brief756
- Utility Update Pm Skills755
- Measure Okr Grader748
- Define Prioritization Framework717
Recommended
More Design & UI/UX1
api-design-revieweralirezarezvani/claude-skillsComprehensive REST API design review with automated linting, breaking-change detection, and design scorecards. Catches inconsistent conventions, missing version816skills.sh installs
2
reference-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
3
designsubframeapp/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
4
atomic-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
6
video-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