README

Самое полное расширение Claude Code для PHP-разработчиков. Аудит, Генерация и Документирование: DDD, CQRS, Event Sourcing, Clean/Hexagonal Architecture, Design Patterns, PSR, Tests ...

Быстрый старт

composer require backvista/awesome-claude-code

Затем в Claude Code:

/acc-code-review                    # Ревью текущей ветки
/acc-bug-fix "NullPointerException" # Диагностика и исправление бага
/acc-explain GET /api/orders        # Объяснить HTTP-маршрут
/acc-audit-architecture ./src       # Полный аудит архитектуры
/acc-generate-documentation         # Написать документацию
/acc-generate-test                  # Написать тест

Компоненты автоматически копируются в директорию .claude/ вашего проекта. Существующие файлы никогда не перезаписываются.

Обновление компонентов

Для принудительного обновления до последней версии (перезаписывает существующие файлы):

# Полное обновление с автоматическим резервным копированием
./vendor/bin/acc upgrade

# Обновление без резервного копирования
./vendor/bin/acc upgrade --no-backup

# Обновление только конкретного компонента
./vendor/bin/acc upgrade --component=commands

Резервные копии сохраняются в .claude.backup.YYYY-MM-DD-HHMMSS/.

Демо

Возможности

Code Review (3-уровневый анализ)

/acc-code-review feature/payment high -- implement Stripe payment processing

Многоуровневое автоматизированное ревью кода с 9 специализированными ревьюерами:

Уровень	Ревьюеры	Что проверяется
LOW	PSR Auditor, Test Auditor	Стандарты кодирования, качество тестов
MEDIUM	+ Bug Hunter, Readability Reviewer	Логические ошибки, null pointer, именование, сложность
HIGH	+ Security, Performance, Testability, DDD, Architecture	OWASP Top 10, N+1 запросы, утечки памяти, соответствие DDD

# Отчёт Code Review

**Режим:** BRANCH
**Ветка:** `feature/payment` → `main`
**Файлов проверено:** 12 (+456/-23 строк)
**Уровень проверки:** HIGH

## Результаты проверки

### 🔴 Критические (1)
| ID | Категория | Расположение | Проблема |
|----|----------|----------|-------|
| CR-001 | Security | PaymentService.php:45 | SQL-инъекция через конкатенацию строк |

### 🟠 Важные (3)
| ID | Категория | Расположение | Проблема |
|----|----------|----------|-------|
| CR-002 | Bug | Order.php:89 | Null pointer при пустых элементах |
| CR-003 | Performance | CartRepository.php:34 | N+1 запрос в цикле |
| CR-004 | DDD | PaymentService.php:12 | Доменная логика в слое Application |

### 🟡 Незначительные (5)
| ID | Категория | Расположение | Проблема |
|----|----------|----------|-------|
| CR-005 | Style | UserService.php:23 | Метод превышает 30 строк |
| ... | ... | ... | ... |

## Анализ соответствия задаче
**Ожидаемая задача:** implement Stripe payment processing
**Соответствие:** 85%

## Вердикт
❌ **ТРЕБУЮТСЯ ИЗМЕНЕНИЯ** — найдено 1 критических, 3 важных проблемы

**Необходимые действия:**
1. Исправить SQL-инъекцию в PaymentService.php:45
2. Добавить проверку на null в Order.php:89
3. Переместить доменную логику из слоя Application в слой Domain

Система исправления багов

Автоматическая диагностика багов, генерация исправлений и регрессионное тестирование:

/acc-bug-fix "NullPointerException in OrderService::process()"
/acc-bug-fix src/Domain/Order.php:45 "off-by-one error"
/acc-bug-fix @storage/logs/error.log -- focus on validation

Фаза	Агент	Что делает
Diagnose	acc-bug-hunter	Классифицирует баг (9 типов), находит первопричину
Fix	acc-bug-fixer	Генерирует минимальное, безопасное исправление с 11 навыками
Test	acc-test-generator	Создаёт регрессионный тест
Verify	coordinator	Применяет исправление, запускает тесты, отчитывается о результатах

Категории багов: логические ошибки, null pointer, граничные условия, состояния гонки, утечки ресурсов, обработка исключений, проблемы типов, SQL-инъекции, бесконечные циклы

Движок аудита архитектуры

Комплексный анализ по 10+ архитектурным паттернам:

Структурные: DDD, Clean Architecture, Hexagonal, Layered, SOLID, GRASP
Поведенческие: CQRS, Event Sourcing, Event-Driven Architecture, Strategy, State
Интеграционные: Saga, Outbox, Anti-Corruption Layer
Стабильности: Circuit Breaker, Retry, Rate Limiter, Bulkhead

Генерация кода

50+ генераторов для компонентов DDD/CQRS с тестами:

DDD: Entity, ValueObject, Aggregate, Repository, DomainEvent, DomainService, Specification, Factory
CQRS: Command, Query, Handler, UseCase, ReadModel
Patterns: Strategy, State, Decorator, Builder, ObjectPool, CircuitBreaker, Saga, Outbox
PSR: Logger (PSR-3), Cache (PSR-6/16), HTTP (PSR-7/15/17/18), Container (PSR-11), Clock (PSR-20)

Генерация компонентов Claude

/acc-generate-claude-component
> What would you like to create? command
> Command name? validate-order
> What should it do? Validate Order aggregate invariants
> Should it use agents? Yes, acc-ddd-auditor

Генерирует:

.claude/commands/validate-order.md — Пользовательская slash-команда

Базы знаний

21 навык глубокой экспертизы охватывающий:

Архитектура: DDD, CQRS, Clean, Hexagonal, Layered, Event Sourcing, EDA
Принципы: SOLID, GRASP, PSR-1/4/12
Паттерны: Saga, Outbox, Stability, ADR
Документация: Mermaid, C4 Model, ADR templates

Защита для разработчиков

21 хук защищающий качество кода в реальном времени:

DDD-защита: readonly классы, неизменяемые Value Object, защита агрегатов
Безопасность: без отладочного вывода, без жёстко закодированных путей, без глобального состояния
Качество: обязательный strict_types, форматирование PSR-12, валидация синтаксиса

Поток компонентов

COMMAND ───────→ COORDINATOR ───────→ AGENTS ───────→ KNOWLEDGE SKILLS ──────→ GENERATORS SKILLS

/acc-code-review ──→ code-review-coordinator
                            │
                            ├─ LOW ──────→ psr-auditor ─────────→ psr-knowledge ─────────→ create-psr-*
                            │              test-auditor ────────→ testing-knowledge ────→ create-test-*
                            │
                            ├─ MEDIUM ───→ bug-hunter ──────────→ bug-fix-knowledge ────→ generate-bug-fix
                            │              readability-reviewer → code-smells-analyzer
                            │
                            └─ HIGH ─────→ security-reviewer ───→ owasp-skills ─────────→ create-validator
                                           performance-reviewer → optimization-skills
                                           ddd-auditor ─────────→ ddd-knowledge ────────→ create-entity,
                                           │                                               create-value-object,
                                           │                                               create-aggregate...
                                           architecture-auditor → arch-knowledge ───────→ create-*, pattern-*

/acc-audit-architecture ──→ architecture-auditor (coordinator)
                                    │
                                    ├──→ structural-auditor ────→ ddd-knowledge ────────→ create-entity
                                    │                             clean-arch-knowledge    create-value-object
                                    │                             hexagonal-knowledge     create-repository
                                    │                             solid-knowledge         create-use-case
                                    │
                                    ├──→ behavioral-auditor ────→ cqrs-knowledge ───────→ create-command
                                    │                             event-sourcing-knowledge create-query
                                    │                             eda-knowledge           create-saga
                                    │
                                    ├──→ integration-auditor ───→ saga-knowledge ───────→ create-outbox
                                    │                             outbox-knowledge        create-circuit-breaker
                                    │                             stability-knowledge     create-retry
                                    │
                                    └──→ pattern-generator ─────→ (coordinates generators)
                                              ├──→ stability-generator ──→ circuit-breaker, retry, rate-limiter
                                              ├──→ behavioral-generator ─→ strategy, state, decorator, visitor, memento
                                              ├──→ gof-structural-generator → adapter, facade, proxy, composite
                                              ├──→ creational-generator ─→ builder, factory, object-pool
                                              └──→ integration-generator → saga, outbox, acl

/acc-bug-fix ─────────────→ bug-fix-coordinator
                                    │
                                    ├──→ bug-hunter ────────────→ detection-skills ─────→ (9 analyzers)
                                    ├──→ bug-fixer ─────────────→ fix-knowledge ────────→ generate-bug-fix
                                    └──→ test-generator ────────→ testing-knowledge ────→ create-unit-test
                                                                                           create-regression-test

/acc-generate-test ──────────→ test-generator ─────────────→ testing-knowledge ────→ create-unit-test
                                                                                   create-integration-test
                                                                                   create-mock-repository

/acc-generate-documentation ─→ documentation-writer ───────→ doc-knowledge ────────→ readme-template
                                    │                                               architecture-template
                                    └──→ diagram-designer ──────→ diagram-knowledge ───→ mermaid-template
                                                                                          c4-template

/acc-audit-docker ────────→ docker-coordinator
                                    │
                                    ├──→ docker-architect ────────→ multistage-knowledge ──→ create-dockerfile
                                    ├──→ docker-security ─────────→ security-knowledge ───→ check-security
                                    ├──→ docker-performance ──────→ buildkit-knowledge ───→ optimize-build
                                    ├──→ docker-compose ──────────→ compose-knowledge ────→ check-compose
                                    ├──→ docker-production ───────→ production-knowledge ─→ check-readiness
                                    └──→ docker-debugger ─────────→ troubleshoot-knowledge

/acc-generate-docker ────→ docker-coordinator
                                    │
                                    ├──→ docker-architect ────────→ create-dockerfile-production
                                    ├──→ docker-compose ──────────→ create-compose-dev, create-compose-prod
                                    ├──→ docker-image-builder ───→ create-php-config, create-entrypoint
                                    └──→ docker-production ──────→ create-nginx, create-healthcheck

/acc-ci-fix ──────────────→ ci-coordinator
                                    │
                                    ├──→ ci-debugger ───────────→ analyze-ci-logs, ci-pipeline-knowledge
                                    └──→ ci-fixer ──────────────→ generate-ci-fix, ci-tools-knowledge

См. Component Flow для полного графа зависимостей.

Почему использовать это?

Без	С Awesome Claude Code
Ручное написание шаблонного кода	Одна команда генерирует полный компонент с тестами
Дрейф архитектуры со временем	Автоматические аудиты соответствия выявляют нарушения рано
Несогласованные паттерны в команде	Стандартизированные шаблоны DDD/CQRS обеспечивают согласованность
Часы на ручное ревью PR	3-уровневое автоматическое ревью находит баги, проблемы безопасности
Изучение DDD/CQRS с нуля	Встроенные базы знаний объясняют паттерны в контексте

Документация

Документ	Описание
Commands	26 slash-команд с примерами
Agents	57 специализированных субагентов
Skills	242 навыка (знания, генераторы, анализаторы)
Hooks	21 PHP/DDD хук
Component Flow	Архитектура и граф зависимостей
MCP	Конфигурация MCP-сервера
Quick Reference	Пути, форматы, лучшие практики

Сценарии использования

Сценарий	Команда	Результат
Исправить баг	`/acc-bug-fix "NullPointerException"`	Диагностика + исправление + регрессионный тест
Ревью PR перед слиянием	`/acc-code-review feature/auth high`	Отчёт по безопасности, производительности, соответствию DDD
Аудит legacy кодовой базы	`/acc-audit-architecture ./src`	Определение паттернов + оценка соответствия
Аудит безопасности	`/acc-audit-security ./src`	OWASP Top 10 + уязвимости специфичные для PHP
Аудит производительности	`/acc-audit-performance ./src`	N+1 запросы, проблемы с памятью, пробелы в кешировании
Аудит паттернов проектирования	`/acc-audit-patterns ./src`	Паттерны стабильности, поведенческие, порождающие
Генерация PSR-компонента	`/acc-generate-psr psr-15 Auth`	PSR-совместимая реализация с тестами
Генерация паттерна проектирования	`/acc-generate-patterns strategy Pay`	Реализация паттерна с DI-конфигурацией
Объяснить код	`/acc-explain src/Domain/Order/`	Структура, бизнес-логика, потоки данных
Онбординг в проект	`/acc-explain .`	Руководство по проекту с глоссарием и диаграммами
Аудит Docker-конфигурации	`/acc-audit-docker ./`	Dockerfile, Compose, безопасность, производительность
Генерация Docker-стека	`/acc-generate-docker full`	Dockerfile + Compose + Nginx + entrypoint
Рефакторинг кода	`/acc-refactor ./src/OrderService`	Анализ + приоритетная дорожная карта + генераторы
Создание Claude-команды	`/acc-generate-claude-component`	Создать команду, агента, навыки
Аудит качества тестов	`/acc-audit-test ./tests`	Пробелы в покрытии, запахи тестов, рекомендации
Генерация документации	`/acc-generate-documentation ./src`	README + ARCHITECTURE.md + диаграммы

Поддерживаемые паттерны

Архитектура:

Domain-Driven Design (DDD) — Агрегаты, Сущности, Value Objects, Domain Events, Репозитории
CQRS — Разделение Command/Query, Handlers, Buses
Clean Architecture — Use Cases, Boundaries, Dependency Inversion
Hexagonal Architecture — Ports & Adapters, Первичные/Вторичные адаптеры
Event Sourcing — Хранилища событий, Проекции, Снимки
Event-Driven Architecture — Сообщения, Pub/Sub, Обработчики событий

Интеграционные:

Saga Pattern — Оркестрация, Хореография, Компенсация
Outbox Pattern — Транзакционные сообщения, Надёжная доставка
Anti-Corruption Layer — Изоляция внешних систем, Трансляция

Стабильности:

Circuit Breaker, Retry, Rate Limiter, Bulkhead

Стандарты:

Реализации PSR-3, 6, 7, 11, 13, 14, 15, 16, 17, 18, 20

Требования

PHP 8.2+ — для генерируемого кода (строгая типизация, readonly классы)
Composer 2.0+ — для установки пакета
Claude Code CLI — Руководство по установке

FAQ

Как работает автоматическая установка?

Composer-плагин подписывается на события POST_PACKAGE_INSTALL и POST_PACKAGE_UPDATE. Когда вы запускаете composer require, он автоматически копирует компоненты .claude/ (команды, агенты, навыки) в директорию вашего проекта. Существующие файлы никогда не перезаписываются для сохранения ваших настроек.

Могу ли я настроить генерируемый код?

Да! Навыки используют шаблоны, хранящиеся в папке references/ внутри каждой директории навыка. Вы можете модифицировать эти шаблоны под стиль кодирования вашего проекта, соглашения именования или добавить пользовательскую функциональность.

Какие версии PHP поддерживаются?

Генерируемый код нацелен на PHP 8.2+ и использует современные возможности, такие как readonly классы, property promotion в конструкторе и строгая типизация. Сами навыки работают с Claude Code на любой платформе.

Как добавить собственные команды/навыки?

Используйте мастер /acc-generate-claude-component для интерактивного создания новых компонентов. Он проведёт вас через создание команд, агентов или навыков с правильным форматированием и структурой.

Что делать, если хочу обновиться до новой версии?

Запустите composer update backvista/awesome-claude-code. Новые компоненты добавляются, но существующие файлы не перезаписываются.

Для принудительного обновления существующих файлов до последних версий:

# Полное обновление с автоматическим резервным копированием
./vendor/bin/acc upgrade

# Обновление только конкретного компонента
./vendor/bin/acc upgrade --component=skills

Резервные копии сохраняются в .claude.backup.YYYY-MM-DD-HHMMSS/.

Могу ли я использовать только определённые навыки?

Да. После установки вы можете удалить ненужные компоненты из директории .claude/. Каждый компонент (команда, агент, навык) работает независимо.

Устранение неполадок

Навык не загружается

Симптом: Агент не использует ожидаемый навык.

Решения:

Проверьте список skills: в frontmatter агента (.claude/agents/agent-name.md)
Убедитесь, что навык существует в .claude/skills/skill-name/SKILL.md
Проверьте точное соответствие имени навыка (с учётом регистра, с дефисами)

# В файле агента:
---
skills:
  - acc-ddd-knowledge  # Должно совпадать с именем папки навыка
---

Агент не вызывается командой

Симптом: Команда выполняется, но не использует ожидаемого агента.

Решения:

Убедитесь, что команда использует инструмент Task с правильным subagent_type
Проверьте, что файл агента существует в .claude/agents/
Убедитесь, что имя агента в команде совпадает с именем файла агента (без .md)

# В файле команды:
Используйте инструмент Task с subagent_type="acc-ddd-auditor"

Компоненты не скопированы после установки

Симптом: Папка .claude/ пуста или отсутствует после composer require.

Решения:

Запустите composer install снова (не просто require)
Проверьте, что Composer разрешает плагины: composer config allow-plugins.backvista/awesome-claude-code true
Убедитесь, что вы находитесь в корневой директории проекта
Проверьте права доступа к файлам директории .claude/

Хуки не срабатывают

Симптом: Изменения кода не запускают хуки валидации.

Решения:

Убедитесь, что .claude/settings.json существует и является валидным JSON
Проверьте, что паттерны хуков соответствуют вашим путям к файлам
Убедитесь, что Claude Code имеет разрешение на выполнение хуков
Запустите make validate-claude для проверки конфигурации

Сгенерированный код имеет неправильное пространство имён

Симптом: Сгенерированные классы имеют неправильное пространство имён PSR-4.

Решения:

Проверьте конфигурацию autoload в вашем composer.json
Укажите целевой путь при генерации: /acc-generate-claude-component запрашивает местоположение
Отредактируйте сгенерированные файлы под структуру вашего проекта

Вклад в проект

Вклад приветствуется! Пожалуйста, см. CONTRIBUTING.md для руководящих принципов.

Лицензия

Лицензия MIT (MIT). Пожалуйста, см. License File для дополнительной информации.

backvista / awesome-claude-code

Maintainers

Details

README

Быстрый старт

Обновление компонентов

Демо

Возможности

Code Review (3-уровневый анализ)

Система исправления багов

Движок аудита архитектуры

Генерация кода

Генерация компонентов Claude

Базы знаний

Защита для разработчиков

Поток компонентов

Почему использовать это?

Документация

Сценарии использования

Поддерживаемые паттерны

Требования

FAQ

Устранение неполадок

Вклад в проект

Лицензия