# software-architecture

Скилл software-architecture для Claude Code разбирает код по слоям через SOLID и Clean Architecture, показывая, где класс берёт на себя лишнюю ответственность.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 150 установок · ★ 9 у репозитория
- Автор: Bbeierle12
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Bbeierle12/Skill-MCP-Claude/tree/HEAD/skills/software-architecture/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/bbeierle12-software-architecture

## Что делает

Скилл задаёт агенту рамку для разбора. Каждый принцип SOLID показан парой «плохо/хорошо» на TypeScript: класс `User`, который сам пишет в базу, шлёт письма и печатает отчёт, разъезжается на сущность, репозиторий и два сервиса. Дальше Open/Closed, подстановка Лисков, разделение интерфейсов и инверсия зависимостей — тоже с кодом до и после.

Clean Architecture разложена на четыре слоя: фреймворки, адаптеры интерфейсов, приложение и домен. Зависимости идут только внутрь. В примерах есть сущность `User` с методом `changeName`, value object `Email` с проверкой формата, сценарий `CreateUserUseCase` с хешированием пароля и отправкой приветственного письма, контроллер и репозиторий на Prisma.

Код везде на TypeScript, а сохранение в примере идёт через Prisma. На другом стеке агенту придётся переносить формы классов самому, так что готового шаблона под Python или Go здесь нет.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Bbeierle12/Skill-MCP-Claude skills/software-architecture
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Bbeierle12/Skill-MCP-Claude --path skills/software-architecture
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a opencode
```

### Claude.ai

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

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

## Когда брать
- разложить класс, который и сохраняет, и шлёт письма, на слои
- заменить `if` по типу фигуры на интерфейс с методом `area()`
- вынести сценарий создания пользователя в отдельный use case
- убрать из контроллера прямые вызовы Prisma
- поймать наследника, который ломает контракт базового класса

## Примеры запросов агенту
- Разбери `OrderService` по SOLID и покажи, где нарушен принцип единственной ответственности.
- Спроектируй слои для нового сервиса: домен, сценарии, адаптеры и репозиторий.
- Убери вызовы Prisma из `UserController` в репозиторий.

## Похожие
- [clean-architecture](https://affpapa.org/nevibecode/skills/clean-architecture.md) — скилл · 8000 установок
- [design-patterns-implementation](https://affpapa.org/nevibecode/skills/design-patterns-implementation.md) — скилл · 601 установка
- [architecture-patterns](https://affpapa.org/nevibecode/skills/orchestkit-architecture-patterns.md) — скилл · 236 установок
- [code-architecture](https://affpapa.org/nevibecode/skills/code-architecture.md) — скилл · 169 установок
- [software-design-principles](https://affpapa.org/nevibecode/skills/software-design-principles.md) — скилл · ★ 38 у репозитория
- [nestjs-oop-design-patterns](https://affpapa.org/nevibecode/skills/nestjs-oop-design-patterns.md) — скилл · 560 установок

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

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

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