Awesome Claude Code — PHP Architecture Toolkit

The most comprehensive Claude Code extension for PHP developers. Current version: v3.2.0 Audit, Generate & Document: DDD, CQRS, Event Sourcing, Clean/Hexagonal Architecture, Design Patterns, PSR, Tests …

Quick Start

/plugin marketplace add dykyi-roman/awesome-claude-code
/plugin install acc@awesome-claude-code

Then in Claude Code:

/acc:code-review                    # Review current branch
/acc:bug-fix "NullPointerException" # Diagnose and fix bug
/acc:explain GET /api/orders        # Explain HTTP route
/acc:audit-architecture ./src       # Full architecture audit
/acc:generate-documentation         # Write documentation
/acc:generate-test                  # Write test

Demo

Features

Code Review (3-Level Analysis)

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

Multi-level automated code review with 9 specialized reviewers:

# Code Review Report

**Mode:** BRANCH
**Branch:** `feature/payment` → `main`
**Files Reviewed:** 12 (+456/-23 lines)
**Review Level:** HIGH

## Review Findings

### 🔴 Critical (1)
| ID | Category | Location | Issue |
|----|----------|----------|-------|
| CR-001 | Security | PaymentService.php:45 | SQL injection via string concatenation |

### 🟠 Major (3)
| ID | Category | Location | Issue |
|----|----------|----------|-------|
| 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 |

### 🟡 Minor (5)
| ID | Category | Location | Issue |
|----|----------|----------|-------|
| CR-005 | Style | UserService.php:23 | Method exceeds 30 lines |
| ... | ... | ... | ... |

## Task Match Analysis
**Expected Task:** implement Stripe payment processing
**Match Score:** 85%

## Verdict
❌ **REQUEST CHANGES** — 1 critical, 3 major issues found

**Required Actions:**
1. Fix SQL injection in PaymentService.php:45
2. Add null check in Order.php:89
3. Move domain logic from Application to Domain layer

Bug Fix System

Automated bug diagnosis, fix generation, and regression testing:

/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

Bug Categories: logic errors, null pointers, boundary issues, race conditions, resource leaks, exception handling, type issues, SQL injection, infinite loops

Architecture Audit Engine

Comprehensive analysis across 10+ architecture patterns:

• Structural: DDD, Clean Architecture, Hexagonal, Layered, SOLID, GRASP
• Behavioral: CQRS, Event Sourcing, Event-Driven Architecture, Strategy, State
• Integration: Saga, Outbox, Anti-Corruption Layer
• Stability: Circuit Breaker, Retry, Rate Limiter, Bulkhead

Code Generation

50+ generators for DDD/CQRS components with tests:

• 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 Component Generation

/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, ddd-auditor

Generates:

• commands/validate-order.md — Custom slash command

Knowledge Bases

53 knowledge skills covering:

• Architecture: DDD, CQRS, Clean, Hexagonal, Layered, Event Sourcing, EDA, Microservices
• Principles: SOLID, GRASP, PSR-1/4/12
• Patterns: Saga, Outbox, Stability, ADR
• System Design: Consistency, Observability, Access Control, Scalability, Replication, 12-Factor
• API & Messaging: REST design, Message Queues, Caching Strategies
• Frameworks: Symfony, Laravel, Yii, CodeIgniter, No-Framework
• Documentation: Mermaid, C4 Model, ADR templates
• Docker: 12 Docker knowledge skills (core, multistage, security, production, etc.)

Developer Safeguards

The plugin installs one hook — a php -l syntax check on Write/Edit. On top of that, docs/hooks.md is a library of 21 ready-to-copy hook recipes you paste into your own .claude/settings.json:

• DDD guards: readonly classes, immutable Value Objects, aggregate protection
• Security: no debug output, no hardcoded paths, no global state
• Quality: strict_types required, PSR-12 formatting, syntax validation

Component Flow

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
                                    │                             microservices-knowledge create-use-case
                                    │
                                    ├──→ principles-auditor ────→ solid-knowledge ──────→ analyze-solid-violations
                                    │                             grasp-knowledge         detect-code-smells
                                    │
                                    ├──→ 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
                                              ├──→ messaging-generator ───→ saga, outbox, correlation, broker
                                              └──→ api-infrastructure-generator → ADR, versioning, health

/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

See Component Flow for the complete dependency graph.

Why Use This?

Documentation

Use Cases

Supported Patterns

Architecture:

• Domain-Driven Design (DDD) — Aggregates, Entities, Value Objects, Domain Events, Repositories
• CQRS — Command/Query separation, Handlers, Buses
• Clean Architecture — Use Cases, Boundaries, Dependency Inversion
• Hexagonal Architecture — Ports & Adapters, Primary/Secondary adapters
• Event Sourcing — Event stores, Projections, Snapshots
• Event-Driven Architecture — Messaging, Pub/Sub, Event handlers

Integration:

• Saga Pattern — Orchestration, Choreography, Compensation
• Outbox Pattern — Transactional messaging, Reliable delivery
• Anti-Corruption Layer — External system isolation, Translation

Stability:

• Circuit Breaker, Retry, Rate Limiter, Bulkhead

System Design:

• Idempotency Handler, Structured Logger, Access Control (RBAC/ABAC)
• Distributed Lock, Read-Write Proxy, Metrics Collector

Standards:

• PSR-3, 6, 7, 11, 13, 14, 15, 16, 17, 18, 20 implementations

Requirements

• PHP 8.4+ — for generated code (strict typing, readonly classes)
• Claude Code CLI — Installation guide

Installation (v2.x — Composer)

Note: v2.x is no longer maintained. Use the marketplace version (v3.0.0+) for the latest features and automatic updates.

If you need to use the legacy Composer-based version (v2.14.0):

composer require --dev dykyi-roman/awesome-claude-code:^2.14

After installation, register the Composer plugin:

./vendor/bin/acc install

This copies commands, agents, and skills into your .claude/ directory. Commands use dash syntax: /acc-audit-architecture, /acc-code-review, etc.

v2.x Requirements

• PHP 8.4+
• Composer 2.0+
• Claude Code CLI

v2.x Updates

composer update dykyi-roman/awesome-claude-code
./vendor/bin/acc upgrade

Migration from v2.x to v3.0.0

v3.0.0 is a breaking change — the plugin moved from Composer to the Claude Code Marketplace. Follow these steps to upgrade:

Step 1: Remove the Composer package

composer remove dykyi-roman/awesome-claude-code

Step 2: Clean up old components

Remove all v2.x files that were copied to .claude/:

rm -rf .claude/commands/acc-* .claude/agents/acc-* .claude/skills/acc-*

Warning: If you customized any acc-* files, back them up first. Your .claude/settings.json and .claude/rules/ are not affected.

Step 3: Install from the marketplace

/plugin marketplace add dykyi-roman/awesome-claude-code
/plugin install acc@awesome-claude-code

Step 4: Update command references

All commands changed from dash (-) to colon (:) syntax:

# Before (v2.x)
/acc-code-review feature/auth high
/acc-audit-architecture ./src
/acc-generate-ddd entity Order

# After (v3.0.0)
/acc:code-review feature/auth high
/acc:audit-architecture ./src
/acc:generate-ddd entity Order

If you have scripts or documentation referencing old command names, update them.

What changed

FAQ

Troubleshooting

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

The MIT License (MIT). Please see License File for more information.