# python-clean-architecture

Плагин python-clean-architecture внедряет принципы чистой архитектуры в проекты на Python и FastAPI. Он проверяет слои приложения, находит сильную связанность и генерирует каркасы сервисов.

- плагин · `type=plugin` · Claude Code · ★ 11 у репозитория
- Автор: MKToronto
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/MKToronto/python-clean-architecture
- Обновлён: 2026-06-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 2 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/python-clean-architecture

## Что делает

Инструмент выстраивает архитектуру проектов на Python и FastAPI. Он проверяет разделение на слои и следит за изоляцией роутеров от базы данных. Вместо тяжёлого наследования плагин предлагает интерфейсы `Protocol` и вызовы `Callable`. Для ревизии кода предусмотрена команда `/review-architecture`, которая находит нарушения границ слоёв и сильное зацепление компонентов.

Для ускорения работы плагин разворачивает проект через `/scaffold-api` и добавляет сущности вызовом `/add-endpoint`. Обучающий режим `/learn-architecture` объясняет паттерны на примере готового API и сопоставляет их с вашим кодом. При этом режим обучения только анализирует проект и не изменяет файлы.

Команда `/scaffold-tests` генерирует тесты строго с заглушками `DataInterfaceStub`. Поэтому проверку с реальной базой данных инструмент не создаёт.

## Установка

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

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
В чате агента (не в терминале):
```text
/plugin install python-clean-architecture@claude-community
```

## Когда брать
- развернуть каркас проекта FastAPI с чистой слоистой архитектурой
- найти нарушения границ между роутерами, операциями и базой данных
- разбить разросшийся класс на независимые компоненты через /extract-god-class
- сгенерировать изолированные тесты операций с заглушками DataInterfaceStub
- заменить тяжёлые иерархии классов на протоколы и функциональные вызовы

## Примеры запросов агенту
- Разверни новый проект FastAPI с чистой архитектурой
- /review-architecture src/
- /add-endpoint booking

## Похожие
- [clean-architecture](https://affpapa.org/nevibecode/skills/clean-architecture-3.md) — скилл · ★ 372 у репозитория
- [architecture-patterns](https://affpapa.org/nevibecode/skills/orchestkit-architecture-patterns.md) — скилл · 236 установок
- [Python Backend Architecture Review](https://affpapa.org/nevibecode/skills/python-backend-architecture-review.md) — скилл · 528 установок
- [python-refactor-expert](https://affpapa.org/nevibecode/agents/python-refactor-expert.md) — субагент · ★ 372 у репозитория
- [go-backend-clean-architecture](https://affpapa.org/nevibecode/skills/go-backend-clean-architecture.md) — скилл · 105 установок
- [python-testing-strategies](https://affpapa.org/nevibecode/skills/python-testing-strategies.md) — скилл · ★ 111 у репозитория

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

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