# design

Помогает продумать интерфейс, модуль, схему или тип до появления зависимого от них кода. Полезен, когда нужно заранее проверить форму вызова, границы ответственности и тестируемость.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 24
- Автор: rainmanjam
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/rainmanjam/poka-yoke/tree/HEAD/benchmarks/controls/clean-code/skills/design/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/design-2

## Что делает

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

При проектировании модулей скилл советует направлять зависимости к более стабильным частям, передавать их извне и оставлять публичный интерфейс небольшим. Он разбирает выбор имён, структуру схем и проверку дизайна коротким тестом до реализации. Если проверка чистой логики требует базы данных или сети, значит, логика переплетена с зависимостями; это стоит учесть при проектировании.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rainmanjam/poka-yoke --skill design -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rainmanjam/poka-yoke --skill design -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rainmanjam/poka-yoke --skill design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rainmanjam/poka-yoke design
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rainmanjam/poka-yoke --skill design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/rainmanjam/poka-yoke --path benchmarks/controls/clean-code/skills/design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rainmanjam/poka-yoke --skill design -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/rainmanjam/poka-yoke/tree/HEAD/benchmarks/controls/clean-code/skills/design/SKILL.md

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

## Примеры запросов агенту
- Спроектируй интерфейс функции расчёта отчёта и покажи сигнатуру с примером вызова.
- Проверь схему заказа: какие поля обязательны и какие стоит объединить в отдельный тип?
- Предложи границы модулей для бизнес-правил и работы с базой данных, затем опиши тест для проверки дизайна.

## Похожие
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [grill-me](https://affpapa.org/nevibecode/skills/grill-me.md) — скилл · 1424476 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка
- [grilling](https://affpapa.org/nevibecode/skills/grilling.md) — скилл · 979543 установки
- [codebase-design](https://affpapa.org/nevibecode/skills/codebase-design.md) — скилл · 850344 установки

## Другие версии с тем же именем
- [design · nextlevelbuilder](https://affpapa.org/nevibecode/skills/design.md) — 41800 установок
- [design · subframeapp](https://affpapa.org/nevibecode/skills/subframeapp-design.md) — 775 установок
- [design · rshankras](https://affpapa.org/nevibecode/skills/rshankras-design.md) — 677 установок
- [design · cognitedata](https://affpapa.org/nevibecode/skills/cognitedata-design.md) — 1900 установок
- [design · kirkchen](https://affpapa.org/nevibecode/skills/kirkchen-design.md) — 506 установок

Из того же набора: [rainmanjam/poka-yoke](https://affpapa.org/nevibecode/by/rainmanjam/poka-yoke.md) — 20 карточек

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

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