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-разработчик знает эту боль ^[1]: вы создаёте новую фичу, и внезапно вам нужен 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 ^[2]

Обновления:

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

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

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

Это всё. Плагин автоматически копирует команды, агентов и скиллы в директорию .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-* ^[2]

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

Команда принимает ваш запрос и определяет контекст
Координатор анализирует задачу и выбирает нужных агентов
Специализированные агенты выполняют работу, используя релевантные скиллы
Knowledge Base предоставляет глубокую экспертизу для каждой области
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 ^[2]

Один запрос /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 + Логические ошибки ^[3], null pointer, нейминг, сложность
High level – Medium level + OWASP Top 10, N+1 запросы, утечки памяти ^[4], соответствие DDD, полная архитектура

Пример:

/acc-code-review feature/payment high -- implement Stripe payment processing ^[2]

Результат:

# 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 ^[2]

Система также вычисляет «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 ^[2]

Процесс:

Диагностика – Категоризирует баг (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 ^[2]

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

Система объяснения кода — 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 — точечный ответ ^[2]

Система автоматически определяет нужный режим: файл → 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 ^[2]

Архитекторы пайплайнов понимают специфику 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-конфигурации ^[2]

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

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 ^[2]

Система знает специфику 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 ^[2]

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

PHPStan/Psalm ошибки уровня типов
Падающие тесты (анализ + фикс + регрессионный тест)
Code style нарушения (PSR-12, PHP CS Fixer)
Несовместимые зависимости в composer.json
Security vulnerabilities в пакетах

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

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

Генерирует:

.claude/commands/validate-order.md ^[5] — Пользовательская 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 ^[6]

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

Commands ^[7] — slash-команды
Agents ^[8] — специализированные субагенты
Skills ^[9] — скилы (knowledge, generators, analyzers)
Hooks ^[10] — PHP/DDD хуки
MCP ^[11] — конфигурация MCP серверов
Quick Reference ^[12] — Пути, форматы, лучшие практики

Лицензия: MIT

Автор: dykyi_roman

Источник ^[13]

Сайт-источник BrainTools: https://www.braintools.ru

Путь до страницы источника: https://www.braintools.ru/article/25362

URLs in this post:

[1] боль: http://www.braintools.ru/article/9901

[2] Image: https://sourcecraft.dev/

[3] ошибки: http://www.braintools.ru/article/4192

[4] памяти: http://www.braintools.ru/article/4140

[5] validate-order.md: http://validate-order.md

[6] dykyi-roman/awesome-claude-code: https://github.com/dykyi-roman/awesome-claude-code

[7] Commands: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/commands.md

[8] Agents: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/agents.md

[9] Skills: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/skills.md

[10] Hooks: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/hooks.md

[11] MCP: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/mcp.md

[12] Quick Reference: https://github.com/dykyi-roman/awesome-claude-code/blob/master/docs/quick-reference.md

[13] Источник: https://habr.com/ru/articles/994090/?utm_source=habrahabr&utm_medium=rss&utm_campaign=994090

Нажмите здесь для печати.