# architecture-patterns

Скилл для проектирования бэкенда: раскладывает код по слоям Clean Architecture, портам и адаптерам, подсказывает тактические приёмы DDD.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 493 установки · ★ 236
- Автор: secondsky
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/architecture-patterns/skills/architecture-patterns/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/secondsky-architecture-patterns

## Что делает

Скилл даёт агенту набор шаблонов для бэкенда: Clean Architecture, гексагональная архитектура и Domain-Driven Design. Внутри — разбор слоёв (entities, use cases, adapters, infrastructure), директории `app/domain`, `app/use_cases`, `app/adapters`, `app/infrastructure` и примеры кода на Python: сущность `User` без зависимостей от фреймворка, порт `IUserRepository` на `ABC`, реализация `PostgresUserRepository` через asyncpg.

Гексагональная часть показывает доменный сервис `OrderService`, который принимает порты оплаты и уведомлений, и два адаптера к ним — рабочий и мок для тестов. Такой расклад пригодится, когда монолит уже тяжело менять: зависимости идут внутрь, бизнес-логика не знает про базу и HTTP.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill architecture-patterns -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill architecture-patterns -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill architecture-patterns -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install secondsky/claude-skills architecture-patterns
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill architecture-patterns -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/secondsky/claude-skills --path plugins/architecture-patterns/skills/architecture-patterns
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill architecture-patterns -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/architecture-patterns/skills/architecture-patterns/SKILL.md

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

## Примеры запросов агенту
- спроектируй структуру каталогов для нового бэкенда по Clean Architecture
- отрефактори этот модуль: вынеси доступ к Postgres за порт и добавь адаптер
- разбей этот монолит на bounded contexts и покажи карту контекстов

## Похожие
- [architecture-advisor](https://affpapa.org/nevibecode/skills/architecture-advisor.md) — скилл · 2800 установок
- [clean-architecture](https://affpapa.org/nevibecode/skills/giuseppe-trisciuoglio-clean-architecture.md) — скилл · 4000 установок
- [plan](https://affpapa.org/nevibecode/skills/plan.md) — скилл · 2800 установок
- [Python Backend Architecture Review](https://affpapa.org/nevibecode/skills/python-backend-architecture-review.md) — скилл · 503 установки
- [architecture-review](https://affpapa.org/nevibecode/skills/decebals-architecture-review.md) — скилл · 338 установок
- [V3 DDD Architecture](https://affpapa.org/nevibecode/skills/v3-ddd-architecture.md) — скилл · 1100 установок

## Другие версии с тем же именем
- [architecture-patterns · wshobson](https://affpapa.org/nevibecode/skills/architecture-patterns.md) — 24144 установки
- [architecture-patterns · sickn33](https://affpapa.org/nevibecode/skills/sickn33-architecture-patterns.md) — 906 установок

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

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

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