# review-a-design

Скилл review-a-design проверяет архитектурные предложения, спецификации и ADR на логическую состоятельность. Выявляет слабые места в аргументах и не переписывает текст за автора.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 252 установки · ★ 17 у репозитория
- Автор: Inkeep
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/inkeep/open-knowledge-skills/tree/HEAD/skills/starter-packs/software-lifecycle/review-a-design/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/review-a-design

## Что делает

Скилл проводит проверку состоятельности архитектуры, а не её полноты или фактов. Он не сверяет бенчмарки и не смотрит на наличие всех разделов по шаблону. Его задача — выяснить, решает ли документ реальную проблему и следует ли предложенная схема из заявленных ограничений.

Перед критикой агент обязан восстановить логику автора своими словами. Если аргументацию невозможно сформулировать кратко, скилл сразу сообщает об этом как об отдельной проблеме. Дальше документ проверяется через фокусные вопросы: проверяется реальность исходной проблемы, подгонка целей под готовый ответ, честность разбора альтернатив и жёсткость ограничений. Для работы со связанными ADR и постмортемами скиллу требуется настроенный MCP-сервер OpenKnowledge.

Инструмент формирует список замечаний со ссылками на доказательства и не вносит правки в markdown-файлы самостоятельно.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inkeep/open-knowledge-skills --skill review-a-design -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inkeep/open-knowledge-skills --skill review-a-design -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inkeep/open-knowledge-skills --skill review-a-design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install inkeep/open-knowledge-skills skills/starter-packs/software-lifecycle/review-a-design
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inkeep/open-knowledge-skills --skill review-a-design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/inkeep/open-knowledge-skills --path skills/starter-packs/software-lifecycle/review-a-design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add inkeep/open-knowledge-skills --skill review-a-design -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/inkeep/open-knowledge-skills/tree/HEAD/skills/starter-packs/software-lifecycle/review-a-design/SKILL.md

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

## Примеры запросов агенту
- Проверь дизайн системы из `proposals/0003-feature.md` на логическую состоятельность
- Оцени эту спецификацию: мы действительно решаем исходную проблему?
- Поищи слабые места в решении перед тем, как оформлять ADR

## Похожие
- [plan-review](https://affpapa.org/nevibecode/skills/plan-review.md) — скилл · ★ 8928 у репозитория
- [specify-solution](https://affpapa.org/nevibecode/skills/specify-solution.md) — скилл · ★ 587 у репозитория
- [adr-review](https://affpapa.org/nevibecode/skills/adr-review.md) — скилл · 747 установок
- [architecture-review](https://affpapa.org/nevibecode/skills/owainlewis-architecture-review.md) — скилл · 347 установок
- [review-architecture](https://affpapa.org/nevibecode/skills/review-architecture.md) — скилл · ★ 155 у репозитория
- [technical-design-doc-creator](https://affpapa.org/nevibecode/skills/technical-design-doc-creator.md) — скилл · 655 установок

Из того же набора: [inkeep/open-knowledge-skills](https://affpapa.org/nevibecode/by/inkeep/open-knowledge-skills.md) — 17 карточек

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

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