# system-design

Скилл system-design задаёт правила чистой архитектуры и DDD для агента. Помогает проектировать модули и пресекает создание самодельных велосипедов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 218 установок · ★ 50 у репозитория
- Автор: qodex-ai
- Лицензия: LicenseRef-Proprietary · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/system-design/SKILL.md
- Обновлён: 2026-01-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/qodex-ai-system-design

## Что делает

Скилл инструктирует помощника проектировать программы по канонам Clean Architecture и предметно-ориентированного проектирования (DDD). Правила запрещают смешивать интерфейс с прикладными сценариями и писать запросы к базе прямо внутри контроллеров. Вместо универсальных папок `utils` и сброса разрозненных функций в `helpers.js` агент обязан давать классам и модулям предметные имена вроде `OrderCalculator`.

В основу заложен подход library-first. Перед написанием своего кода модель обязана искать готовые пакеты в npm или сторонние сервисы, например готовые инструменты повторных вызовов вместо рукотворных таймеров. Свой код разрешается писать только для специфичной логики предметной области или критичных по скорости участков.

Инструкции ограничивают размер сущностей: функции длиннее 80 строк дробятся, а файлы свыше 200 строк разносятся по отдельным модулям. Вложенность условий ограничена тремя уровнями. Лицензия у скилла проприетарная.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/system-design
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/system-design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill system-design -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Спроектируй сервис оформления заказов по правилам предметно-ориентированной архитектуры.
- Проверь модуль авторизации и убери лишний самописный код в пользу npm-пакетов.
- Разбей контроллер платежей на отдельные доменные сущности и юзкейсы.

## Похожие
- [architect-review](https://affpapa.org/nevibecode/skills/rmyndharis-architect-review.md) — скилл · 154 установки
- [comprehensive-review-architect-review](https://affpapa.org/nevibecode/agents/comprehensive-review-architect-review.md) — субагент · ★ 42780 у репозитория
- [design-code-architecture](https://affpapa.org/nevibecode/skills/design-code-architecture.md) — скилл · 2700 установок
- [system-design-generator](https://affpapa.org/nevibecode/skills/system-design-generator.md) — скилл · 284 установки
- [system-design-from-scratch](https://affpapa.org/nevibecode/skills/system-design-from-scratch.md) — скилл · ★ 541 у репозитория
- [architecture-patterns](https://affpapa.org/nevibecode/skills/architecture-patterns.md) — скилл · 24144 установки

## Другие версии с тем же именем
- [system-design · anthropics](https://affpapa.org/nevibecode/skills/system-design.md) — 7900 установок
- [system-design · wondelai](https://affpapa.org/nevibecode/skills/wondelai-system-design.md) — 6800 установок
- [system-design · jwynia](https://affpapa.org/nevibecode/skills/jwynia-system-design.md) — 661 установка

Из того же набора: [qodex-ai/ai-agent-skills](https://affpapa.org/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 карточки

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