[Перевод] Awesome Claude Code: AI-помощник для PHP-архитектора

Компоненты Claude Code для PHP: аудит (архитектура, DDD, безопасность, производительность, PSR, шаблоны проектирования, Docker, CI/CD, тесты, документация), 3-уровневая проверка кода, автоматическое исправление ошибок, генераторы, объяснение кода, рефакторинг. Более 300 компонентов. Более 50 агентов. Более 200 навыков.

Введение: Новая эра разработки PHP-приложений с использованием искусственного интеллекта.

AI-ассистенты для программирования фундаментально изменили то, как мы пишем софт. То, что начиналось как простое автодополнение, превратилось в интеллектуальные системы, которые понимают контекст, предлагают архитектурные паттерны и даже находят тонкие баги в коде.

Я лично протестировал Cursor, Windsurf, Antigravity и Claude Code, и могу сказать, что каждый из них по-своему силён, но именно Claude Code лучше всего вписывается в рабочий процесс в терминале и автоматизацию задач. Однако “из коробки” Claude Code — это инструмент общего назначения. Он не знает, что вы строите приложение по Domain-Driven Design, что ваша команда следует определённым стандартам PSR, или что в архитектуре вам нужны circuit breakers.

Я хочу поделиться своей работой над Awesome Claude Code — плагином для Composer, который превращает Claude Code в специализированного ассистента по PHP-архитектуре. После месяцев разработки DDD/CQRS-приложений и постоянного ощущения, что Claude Code не понимает мои паттерны достаточно хорошо, я решил создать набор инструментов, который инкапсулирует эти знания.

Проблема

Каждый PHP-разработчик знает эту боль: вы создаёте новую фичу, и внезапно вам нужен Aggregate Root с событиями, интерфейс Repository, DTO, обработчики Command/Query и тесты. Часы уходят на написание тех же паттернов, которые вы писали десятки раз до этого.

Или, может быть, вы делаете ревью PR. Вы листаете сотни строк, выискивая SQL-инъекции, N+1 запросы, нарушения DDD и пробелы в тестах. Это утомительно, чревато ошибками и отнимает время от реальной разработки.

А что насчёт того legacy-кода, который вам достался? Вы подозреваете, что архитектура «поплыла» везде, но ручной аудит тысяч файлов — это отдельный проект.

Это решённые проблемы. Вы не должны решать их вручную.

Решение

Awesome Claude Code — это Composer-плагин, который превращает Claude Code CLI в мощный инструмент для PHP-разработки. Установите один раз — и получите 300+ специализированных компонентов (команды, агенты, скиллы), которые глубоко понимают PHP-архитектуру: DDD, CQRS, Clean Architecture, Event Sourcing, CI/CD, Docker и многое другое.

Требования:

• PHP 8.5+

• Composer 2.0+

• Claude Code CLI

Установка:

composer require dykyi-roman/awesome-claude-code

Обновления:

# Принудительное обновление до последней версии (создает резервную копию) ./vendor/bin/acc upgrade

Использования:

Это всё. Плагин автоматически копирует команды, агентов и скиллы в директорию .claude/ вашего проекта. Никакой конфигурации.

Интеллектуальная оркестрация

Ключевая особенность ACC — умная система подбора агентов и скиллов. Когда вы вызываете команду, система автоматически определяет, какие специалисты нужны для задачи:

USER COMMAND COORDINATOR AGENTS KNOWLEDGE GENERATORS ──────────── ─────────── ────── ───────── ────────── /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-*

Как это работает:

1. Команда принимает ваш запрос и определяет контекст

2. Координатор анализирует задачу и выбирает нужных агентов

3. Специализированные агенты выполняют работу, используя релевантные скиллы

4. Knowledge Base предоставляет глубокую экспертизу для каждой области

5. Generator Skills предлагают рефакторинг и генерируют код для исправления найденных проблем

Каждый агент имеет доступ только к тем скиллам, которые ему нужны. Security-ревьюер использует 14 OWASP-скиллов, DDD-аудитор — скиллы по доменному дизайну с делегированием к специализированным генераторам. Это не просто набор инструментов — это экосистема экспертов, каждый из которых специализируется на своей области.

Пример цепочки для /acc-audit-architecture:

architecture-auditor (координатор) │ ├──→ structural-auditor ────→ ddd-knowledge │ clean-arch-knowledge │ hexagonal-knowledge │ solid-knowledge │ grasp-knowledge │ + 6 analyzers │ ├──→ behavioral-auditor ────→ cqrs-knowledge │ event-sourcing-knowledge │ eda-knowledge │ + 14 pattern skills │ ├──→ integration-auditor ───→ saga-knowledge │ outbox-knowledge │ stability-knowledge │ adr-knowledge │ └──→ pattern-generator ─────→ 5 sub-generators → 30+ generator skills

Один запрос /acc-audit-architecture активирует несколько агентов и десятки скиллов, каждый из которых отвечает за свою область экспертизы.

Три типа скиллов

Скиллы — это фокусированные базы знаний и генераторы кода. Каждый скилл делает одну вещь хорошо:

• Knowledge - Паттерны, антипаттерны, PHP-специфичные гайдлайны

• Analyzer - Детектирование конкретных проблем

• Generator - Генерация кода из шаблонов

Такое разделение следует Single Responsibility Principle. Каждый компонент имеет чёткую цель, что делает систему поддерживаемой и расширяемой.

Knowledge skills содержат глубокую экспертизу: когда использовать паттерн, когда избегать, какие есть подводные камни. Это как иметь под рукой книги Эванса, Вернона и Фаулера.

Analyzer skills находят конкретные проблемы: N+1 запросы, SQL-инъекции, code smells, нарушения SOLID. Каждый анализатор знает свою область и даёт actionable-рекомендации.

Generator skills создают production-ready код: Value Objects с валидацией, Circuit Breaker с правильными состояниями, PSR-совместимые реализации. Шаблоны проверены на реальных проектах.

Ключевые возможности

Система Code Review — 3 уровня анализа

Команда /acc-code-review пропускает ваш PR через до 9 специализированных ревьюеров:

• Low Level - Соответствие PSR-12, качество тестов

• Medium level - Low Level + Логические ошибки, null pointer, нейминг, сложность

• High level - Medium level + OWASP Top 10, N+1 запросы, утечки памяти, соответствие DDD, полная архитектура

Пример:

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

Результат:

# Code Review Report **Branch:** `feature/payment` → `main` **Files Reviewed:** 12 (+456/-23 lines) ## 🔴 Critical (1) | ID | Category | Location | Issue | |----|----------|----------|-------| | CR-001 | Security | PaymentService.php:45 | SQL injection via string concatenation | ## 🟠 Major (3) | CR-002 | Bug | Order.php:89 | Null pointer when items empty | | CR-003 | Performance | CartRepository.php:34 | N+1 query in loop | | CR-004 | DDD | PaymentService.php:12 | Domain logic in Application layer | **Task Match:** 85% | **Verdict:** ❌ REQUEST CHANGES

Система также вычисляет «task match score» — насколько код соответствует заявленной задаче. Идеально для отлова scope creep.

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

Нашли баг? Не просто исправляйте его — пусть система диагностирует, исправит и предотвратит регрессию:

/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

Процесс:

• Диагностика - Категоризирует баг (9 типов), находит корневую причину

• Исправление - Генерирует минимальный, безопасный фикс с набором специализированных скиллов

• Тест - Создаёт регрессионный тест

• Верификация - Применяет фикс, запускает тесты, сообщает результаты

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

  Движок архитектурного аудита — 10+ паттернов

  Команда /acc-audit-architecture анализирует вашу кодовую базу на соответствие отраслевым стандартам:

  Структурные:

  • DDD (Aggregates, Value Objects, Domain Events, Repositories)

  • Clean Architecture (Use Cases, Boundaries)

  • Hexagonal Architecture (Ports & Adapters)

  • Layered Architecture

  • Принципы SOLID и GRASP

  Поведенческие:

  • CQRS (разделение Command/Query)

  • Event Sourcing (Event stores, Projections)

  • Event-Driven Architecture

  • GoF Behavioral: Strategy, State, Template Method, Visitor, Iterator, Memento, Chain of Responsibility, Decorator, Null Object

  GoF Структурные:

  • Adapter, Facade, Proxy, Composite, Bridge, Flyweight

  Интеграционные и стабильности:

  • Saga Pattern (Оркестрация, Компенсация)

  • Outbox Pattern (Транзакционные сообщения)

  • Circuit Breaker, Retry, Rate Limiter, Bulkhead

  Каждый аудит выдаёт actionable-рекомендации с конкретными местами в файлах.

  Отдельные аудиты

  Запуск целевых аудитов без полного архитектурного анализа:

Система рефакторинга — управляемый процесс

Рефакторинг кода с анализом и рекомендациями по паттернам:

/acc-refactor ./src/Domain/Order.php /acc-refactor ./src/Services/ -- apply Strategy pattern

Координатор анализирует качество кода, предлагает улучшения и генерирует рекомендации.

Система объяснения кода — 5 режимов

Команда /acc-explain понимает вашу кодовую базу и объясняет её на нужном уровне:

/acc-explain src/Domain/Order/Order.php # Quick — один файл /acc-explain src/Domain/Order/ # Deep — анализ модуля с диаграммами /acc-explain . # Onboarding — полный гид по проекту /acc-explain GET /api/orders # Route — резолв HTTP-маршрута в обработчик /acc-explain src/Payment business # Business — нетехнический обзор /acc-explain src/Domain qa -- как рассчитываются скидки? # QA — точечный ответ

Система автоматически определяет нужный режим: файл → quick, директория → deep, . → onboarding, HTTP-маршрут или консольная команда → quick. Четыре специализированных агента выполняют работу:

CI/CD система — Setup, Fix, Optimize

CI/CD система обеспечивает полное управление пайплайнами через единого координатора:

/acc-ci-setup # Создать CI пайплайн с нуля /acc-ci-fix # Диагностика и исправление ошибок пайплайна /acc-ci-optimize # Оптимизация времени выполнения /acc-audit-ci # Комплексный аудит CI

Архитекторы пайплайнов понимают специфику PHP:

• Статический анализ: уровни PHPStan, строгость Psalm, слои DEPTRAC

• Тестирование: unit, integration, параллельное выполнение, покрытие

• Безопасность: composer audit, OWASP-проверки, сканирование секретов

• Docker: multi-stage builds, кэширование слоёв, PHP-расширения

Docker Expert System — 8 специализированных агентов

Полноценная экспертная система для Docker с координатором и узкопрофильными специалистами:

/acc-generate-docker # Генерация Docker-компонентов /acc-audit-docker # Комплексный аудит Docker-конфигурации

Архитектура системы:

docker-coordinator (координатор) │ ├──→ docker-architect-agent ────→ Multi-stage builds, организация стадий ├──→ docker-image-builder ─────→ Базовые образы, PHP-расширения ├──→ docker-compose-agent ─────→ Сервисы, сети, health checks ├──→ docker-performance-agent ──→ Время сборки, размер образов, кэширование ├──→ docker-security-agent ────→ Аудит безопасности, hardening ├──→ docker-production-agent ──→ Health checks, graceful shutdown, мониторинг ├──→ docker-debugger-agent ────→ Ошибки сборки, runtime-проблемы └──→ docker-agent (CI/CD) ─────→ Docker в пайплайнах CI

Система знает специфику PHP: правильные базовые образы, расширения для DDD-проектов (intl, opcache, redis), multi-stage builds, OPcache-оптимизация, PHP-FPM тюнинг. Поддерживает 40+ Docker-скиллов — от генерации Dockerfile и docker-compose до оптимизации размера образов и аудита безопасности контейнеров.

Процесс Docker-аудита:

• Архитектура - Анализ multi-stage, организация стадий

• Безопасность - Секреты, права, уязвимости

• Производительность - Размер образа, кэширование слоёв

• Production - Health checks, graceful shutdown, логирование

DevOps-команды

CI Fixes — автоматическое исправление ошибок пайплайна:

/acc-ci-fix # Проанализировать и исправить падающий CI /acc-ci-fix --pipeline=github-actions # Указать конкретный CI /acc-ci-fix @.github/workflows/ci.yml # Исправить конкретный workflow

Типичные проблемы, которые решает:

• PHPStan/Psalm ошибки уровня типов

• Падающие тесты (анализ + фикс + регрессионный тест)

• Code style нарушения (PSR-12, PHP CS Fixer)

• Несовместимые зависимости в composer.json

• Security vulnerabilities в пакетах

Генерация кода — 50+ компонентов

Генерация production-ready кода с тестами через специализированные генераторы (по рекомендациям /acc-audit-*).

Генерирует:

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

Доступные генераторы (через архитектурные аудиты):

• DDD - Entity, ValueObject, Aggregate, Repository, DomainEvent, DomainService, Specification, Factory

• CQRS - Command, Query, Handler, UseCase, ReadModel

• Паттерны - Strategy, State, Decorator, Builder, ObjectPool, CircuitBreaker, Saga, Outbox, Adapter, Facade, Proxy, Composite, Visitor, Memento

• PSR - Logger (PSR-3), Cache (PSR-6/16), HTTP (PSR-7/15/17/18), Container (PSR-11), Clock (PSR-20)

Сравнение с альтернативами

• PHPStan/Psalm — ACC добавляет архитектурные шаблоны, соответствие DDD, генерацию кода

• Rector — ACC специализируется на шаблонах DDD/CQRS, генерирует новый код

• Deptrac — ACC добавляет полный аудит архитектуры (DDD, Clean, Hexagonal), генерирует предложения по исправлению

• GitHub Copilot — ACC имеет более 300 компонентов, специфичных для PHP, глубоко понимает архитектуру

• Ручная настройка CI/CD — ACC генерирует оптимизированные конвейеры с учетом лучших практик PHP

ACC НЕ заменяет а дополняет эти инструменты. Используйте PHPStan для проверки типов, Rector для массового рефакторинга, И ACC для работы на уровне архитектуры.

Заключение

Awesome Claude Code превращает Claude Code из универсального AI-ассистента в специализированный инструментарий PHP-архитектора. Он автоматизирует повторяющиеся части software engineering — генерацию boilerplate, code review, архитектурные аудиты — при этом обучая вас паттернам по ходу работы.

GitHub: dykyi-roman/awesome-claude-code

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

• Commands — slash-команды

• Agents — специализированные субагенты

• Skills — скилы (knowledge, generators, analyzers)

• Hooks — PHP/DDD хуки

• MCP — конфигурация MCP серверов

• Quick Reference — Пути, форматы, лучшие практики

Лицензия: MIT