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 ...
/plugin marketplace add dykyi-roman/awesome-claude-code
/plugin install acc@awesome-claude-codeThen 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
/acc:code-review feature/payment high -- implement Stripe payment processingMulti-level automated code review with 9 specialized reviewers:
| Level | Reviewers | What's Checked |
|---|---|---|
| LOW | PSR Auditor, Test Auditor | Coding standards, test quality |
| MEDIUM | + Bug Hunter, Readability Reviewer | Logic errors, null pointers, naming, complexity |
| HIGH | + Security, Performance, Resources, Scalability, Testability, DDD, Architecture | OWASP Top 10, N+1 queries, memory leaks, connection pools, scalability readiness, DDD compliance |
# 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
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| Phase | Agent | What It Does |
|---|---|---|
| Diagnose | bug-hunter | Categorizes bug (9 types), finds root cause |
| Fix | bug-fixer | Generates minimal, safe fix with 11 skills |
| Test | test-generator | Creates regression test |
| Verify | coordinator | Applies fix, runs tests, reports results |
Bug Categories: logic errors, null pointers, boundary issues, race conditions, resource leaks, exception handling, type issues, SQL injection, infinite loops
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
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)
/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-auditorGenerates:
commands/validate-order.md— Custom slash command
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.)
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
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.
| Without | With Awesome Claude Code |
|---|---|
| Manual boilerplate code | One command generates complete component with tests |
| Architecture drift over time | Automated compliance audits catch violations early |
| Inconsistent patterns across team | Standardized DDD/CQRS templates ensure consistency |
| Hours reviewing PRs manually | 3-level automated review catches bugs, security issues |
| Learning DDD/CQRS from scratch | Built-in knowledge bases explain patterns in context |
| Document | Description |
|---|---|
| Commands | 26 slash commands with examples |
| Agents | 68 specialized subagents |
| Skills | 283 skills (knowledge, generators, analyzers) |
| Hooks | 1 installed + 21 copy-paste recipes |
| Component Flow | Architecture and dependency graph |
| MCP | MCP server configuration |
| Quick Reference | Paths, formats, best practices |
| Scenario | Command | Result |
|---|---|---|
| Fix a bug | /acc:bug-fix "NullPointerException" |
Diagnosis + fix + regression test |
| Review PR before merge | /acc:code-review feature/auth high |
Security, performance, DDD compliance report |
| Audit legacy codebase | /acc:audit-architecture ./src |
Pattern detection + compliance score |
| Security audit | /acc:audit-security ./src |
OWASP Top 10 + PHP-specific vulnerabilities |
| Performance audit | /acc:audit-performance ./src |
N+1 queries, memory issues, caching gaps |
| Design patterns audit | /acc:audit-patterns ./src |
Stability, behavioral, creational patterns |
| Generate PSR component | /acc:generate-psr psr-15 Auth |
PSR-compliant implementation with tests |
| Generate design pattern | /acc:generate-patterns strategy Pay |
Pattern implementation with DI configuration |
| Explain code | /acc:explain src/Domain/Order/ |
Structure, business logic, data flows |
| Onboard to project | /acc:explain . |
Project guide with glossary and diagrams |
| Audit Docker config | /acc:audit-docker ./ |
Dockerfile, Compose, security, performance |
| Generate Docker stack | /acc:generate-docker full |
Dockerfile + Compose + Nginx + entrypoint |
| Refactor code | /acc:refactor ./src/OrderService |
Analysis + prioritized roadmap + generators |
| Create Claude command | /acc:generate-claude-component |
Create command, agent, skills |
| Audit test quality | /acc:audit-test ./tests |
Coverage gaps, test smells, recommendations |
| Generate documentation | /acc:generate-documentation ./src |
README + ARCHITECTURE.md + diagrams |
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
- PHP 8.4+ — for generated code (strict typing, readonly classes)
- Claude Code CLI — Installation guide
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.14After installation, register the Composer plugin:
./vendor/bin/acc installThis copies commands, agents, and skills into your .claude/ directory. Commands use dash syntax: /acc-audit-architecture, /acc-code-review, etc.
- PHP 8.4+
- Composer 2.0+
- Claude Code CLI
composer update dykyi-roman/awesome-claude-code
./vendor/bin/acc upgradev3.0.0 is a breaking change — the plugin moved from Composer to the Claude Code Marketplace. Follow these steps to upgrade:
composer remove dykyi-roman/awesome-claude-codeRemove 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.jsonand.claude/rules/are not affected.
/plugin marketplace add dykyi-roman/awesome-claude-code
/plugin install acc@awesome-claude-codeAll 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 OrderIf you have scripts or documentation referencing old command names, update them.
| Aspect | v2.x (Composer plugin) | v3.0.0 (Marketplace plugin) |
|---|---|---|
| Install method | composer require |
/plugin marketplace add + /plugin install |
| Command syntax | /acc-command (dash) |
/acc:command (colon) |
| Component paths | .claude/commands/acc-*.md |
commands/*.md (managed by plugin system) |
| PHP/Composer dependency | Required Composer 2.0+ | No PHP/Composer dependency for the plugin itself |
| Updates | composer update + ./vendor/bin/acc upgrade |
Automatic via marketplace |
| Component location | Copied to .claude/ by Composer plugin |
Managed by Claude Code plugin system |
| Customization | Edit files in .claude/ directly |
Fork the plugin or override locally |
How does installation work?
The marketplace plugin is managed by Claude Code's native plugin system. When you run /plugin install acc@awesome-claude-code, Claude Code registers the plugin's commands, agents, and skills. Updates are delivered automatically through the marketplace -- no manual steps required.
Can I customize generated code?
Yes! Skills use templates stored in the references/ folder within each skill directory. You can modify these templates to match your project's coding style, naming conventions, or add custom functionality.
Which PHP versions are supported?
Generated code targets PHP 8.4+ and uses modern features like readonly classes, constructor property promotion, and strict typing. The skills themselves work with Claude Code on any platform.
How do I add my own commands/skills?
Use the /acc:generate-claude-component wizard to create new components interactively. It guides you through creating commands, agents, or skills with proper formatting and structure.
What if I want to update to a newer version?
Marketplace plugins update automatically. When a new version is published, Claude Code picks up the latest components on next use. No manual upgrade steps are needed.
Can I use only specific skills?
Yes. After installation, you can remove unwanted components. Each component (command, agent, skill) works independently.
Skill not loading
Symptom: Agent doesn't use expected skill.
Solutions:
- Check
skills:list in agent frontmatter (agents/agent-name.md) - Verify skill exists in
skills/skill-name/SKILL.md - Check skill name matches exactly (case-sensitive, with hyphens)
# In agent file:
---
skills:
- ddd-knowledge # Must match skill folder name
---Agent not invoked by command
Symptom: Command runs but doesn't use the expected agent.
Solutions:
- Verify command uses
Tasktool with correctsubagent_type - Check agent file exists in
agents/ - Ensure agent name in command matches agent filename (without
.md)
# In command file:
Use the Task tool with subagent_type="acc:ddd-auditor"Hooks not triggering
Symptom: Code changes don't trigger validation hooks.
Solutions:
- Verify
.claude/settings.jsonexists and is valid JSON - Check hook patterns match your file paths
- Ensure Claude Code has permission to execute hooks
- Run
make validate-claudeto check configuration
Generated code has wrong namespace
Symptom: Generated classes have incorrect PSR-4 namespace.
Solutions:
- Check your
composer.jsonautoload configuration - Specify target path when generating:
/acc:generate-claude-componentprompts for location - Edit generated files to match your project structure
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
The MIT License (MIT). Please see License File for more information.