# design-rationale

Помогает написать письменное обоснование дизайн-решения: что выбрали, почему и какие были альтернативы. Пригодится перед ревью или хендоффом.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2100 установок · ★ 3103
- Автор: Owl-Listener
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Owl-Listener/designer-skills/tree/HEAD/designer-toolkit/skills/design-rationale/SKILL.md
- Обновлён: 2026-09-05
- HTML: https://affpapa.org/nevibecode/skills/design-rationale

## Что делает

Скилл задаёт структуру из семи блоков: решение, контекст, рассмотренные варианты, доказательства, логика выбора, компромиссы и план проверки. Агент проходит по ним и собирает текст, который связывает выбор с потребностями пользователей, целями бизнеса и принципами дизайна.

Отдельный чек-лист качества требует, чтобы обоснование опиралось на исследование или данные, а не на вкус дизайнера, и упоминало отвергнутые альтернативы. Есть список случаев, когда писать стоит: смена крупного направления, отход от привычных паттернов, спорные решения, изменения относительно прошлых подходов.

Скилл советует писать обоснование в момент принятия решения, а не задним числом, хранить его рядом с файлами дизайна и ссылаться на него в документации по передаче. Для живого спора с коллегами он не подходит — там нужен `design-negotiation`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-rationale -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/design-rationale/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/design-rationale/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-rationale -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/design-rationale/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-rationale -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/design-rationale/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Owl-Listener/designer-skills design-rationale
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/design-rationale/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-rationale -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Owl-Listener/designer-skills --path designer-toolkit/skills/design-rationale
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/design-rationale/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Owl-Listener/designer-skills --skill design-rationale -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Owl-Listener/designer-skills/tree/HEAD/designer-toolkit/skills/design-rationale/SKILL.md

## Когда брать
- защитить дизайн-решение перед командой и стейкхолдерами
- зафиксировать, какие альтернативы рассматривали и почему отказались
- объяснить отход от устоявшегося паттерна
- подготовить раздел с обоснованием для хендоффа
- вернуться к решению через месяцы и вспомнить контекст

## Примеры запросов агенту
- Напиши обоснование решения перейти на новую навигацию: контекст, варианты, доказательства, компромиссы
- Собери rationale для смены паттерна авторизации, добавь план проверки метриками
- Оформи обоснование спорного решения по сетке, чтобы его можно было приложить к ревью

## Похожие
- [develop-design-rationale](https://affpapa.org/nevibecode/skills/develop-design-rationale.md) — скилл · 744 установки
- [presentation-design](https://affpapa.org/nevibecode/skills/aaronvanston-presentation-design.md) — скилл · 798 установок
- [presentation-design-enhancer](https://affpapa.org/nevibecode/skills/presentation-design-enhancer.md) — скилл · 573 установки
- [brand-style-guide](https://affpapa.org/nevibecode/skills/brand-style-guide.md) — скилл · 388 установок
- [frontend-design](https://affpapa.org/nevibecode/skills/cline-frontend-design.md) — скилл · 7300 установок
- [design-brief](https://affpapa.org/nevibecode/skills/design-brief.md) — скилл · 5300 установок

Из того же набора: [owl-listener/designer-skills](https://affpapa.org/nevibecode/by/owl-listener/designer-skills.md) — 111 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md