design-rationale — скилл для Claude Code: обоснование дизайн-решений
Помогает написать письменное обоснование дизайн-решения: что выбрали, почему и какие были альтернативы. Пригодится перед ревью или хендоффом.
npx skills add Owl-Listener/designer-skills --skill design-rationale -a claude-codeЧто делает design-rationale
Скилл задаёт структуру из семи блоков: решение, контекст, рассмотренные варианты, доказательства, логика выбора, компромиссы и план проверки. Агент проходит по ним и собирает текст, который связывает выбор с потребностями пользователей, целями бизнеса и принципами дизайна.
Отдельный чек-лист качества требует, чтобы обоснование опиралось на исследование или данные, а не на вкус дизайнера, и упоминало отвергнутые альтернативы. Есть список случаев, когда писать стоит: смена крупного направления, отход от привычных паттернов, спорные решения, изменения относительно прошлых подходов.
Скилл советует писать обоснование в момент принятия решения, а не задним числом, хранить его рядом с файлами дизайна и ссылаться на него в документации по передаче. Для живого спора с коллегами он не подходит — там нужен design-negotiation.
Какие задачи решает
- защитить дизайн-решение перед командой и стейкхолдерами
- зафиксировать, какие альтернативы рассматривали и почему отказались
- объяснить отход от устоявшегося паттерна
- подготовить раздел с обоснованием для хендоффа
- вернуться к решению через месяцы и вспомнить контекст
Примеры запросов агенту
- Напиши обоснование решения перейти на новую навигацию: контекст, варианты, доказательства, компромиссы
- Собери rationale для смены паттерна авторизации, добавь план проверки метриками
- Оформи обоснование спорного решения по сетке, чтобы его можно было приложить к ревью
Как установить design-rationale
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill design-rationale -a claude-code2Вручную: положить файлы
~/.claude/skills/design-rationale/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/design-rationale/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill design-rationale -a codex2Вручную: положить файлы
.agents/skills/design-rationale/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill design-rationale -a cursor2Вручную: положить файлы
.cursor/skills/design-rationale/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills design-rationale2Вручную: положить файлы
.github/skills/design-rationale/SKILL.md1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill design-rationale -a gemini-cli2Командой платформы
gemini skills install https://github.com/Owl-Listener/designer-skills --path designer-toolkit/skills/design-rationaleВручную: положить файлы
.devin/skills/design-rationale/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill design-rationale -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о design-rationale
Как установить design-rationale в Claude?
Выполните npx skills add Owl-Listener/designer-skills --skill design-rationale -a claude-code. Скилл встанет в ~/.claude/skills/design-rationale/SKILL.md.
Что делает design-rationale?
Пишет письменное обоснование дизайн-решения по структуре из семи частей: решение, контекст, альтернативы, доказательства, логика, компромиссы и план проверки.
Чем design-rationale отличается от design-negotiation?
Первый нужен для письменного текста, который будут читать позже. Второй — для живого разговора, когда решение обсуждают вслух.
Исходный текст
SKILL.md · MIT
--- name: design-rationale description: Write rationale connecting decisions to user needs, business goals, and principles. Use when a decision needs defending in writing. For a live conversation, use `design-negotiation`. --- # Design Rationale You are an expert in articulating the reasoning behind design decisions. ## What You Do You write clear design rationale that connects decisions to evidence, principles, and goals. ## Rationale Structure ### 1. Decision What design decision was made? Be specific about what was chosen. ### 2. Context What problem or need prompted this decision? What constraints exist? ### 3. Options Considered What alternatives were explored? Brief description of each. ### 4. Evidence What informed the decision? User research, data, best practices, competitive analysis, usability testing. ### 5. Reasoning Why this option over the alternatives? Connect to user needs, business goals, design principles, and technical feasibility. ### 6. Trade-offs What are the known compromises? What was deprioritized and why? ### 7. Validation Plan How will you know if this decision was right? What metrics or feedback will confirm? ## When to Write Rationale - Major design direction decisions - Departures from established patterns - Controversial or debated choices - Decisions that will be questioned later - Changes from previous approaches ## Rationale Quality Checklist - Connects to user needs (not just designer preference) - References evidence or principles - Acknowledges alternatives and trade-offs - Is specific enough to be useful months later - Written for the audience who will read it ## Best Practices - Write rationale during the decision, not after - Keep it concise but complete - Store rationale alongside the design files - Reference in handoff documentation - Use rationale in design reviews to explain choices
© Owl-Listener · MIT · Owl-Listener/designer-skills