awesome-claude-code

# Awesome Claude Code

> Claude Code marketplace plugin for PHP with DDD, CQRS, Clean Architecture generators, and documentation tools.

## Quick Facts

- 26 commands, 68 agents, 283 skills, 1 installed hook (+21 copy-paste recipes in docs/hooks.md)
- PHP 8.4+, PSR-12, readonly classes
- DDD/CQRS/Hexagonal patterns
- Testing, Documentation generation and audit
- MCP servers support (Database, GitHub, etc.)

## Installation

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

## Key Commands

| Command | Purpose |
|---------|---------|
| `/acc:audit-architecture <path>` | Multi-pattern architecture audit |
| `/acc:audit-ddd <path>` | DDD compliance analysis |
| `/acc:audit-psr <path>` | PSR compliance audit |
| `/acc:audit-documentation <path>` | Audit documentation quality |
| `/acc:audit-claude-components` | Audit .claude folder structure |
| `/acc:generate-documentation <path>` | Generate documentation |
| `/acc:generate-claude-component` | Create commands/agents/skills |
| `/acc:commit` | Auto-generate commit message |
| `/acc:generate-test <path>` | Generate tests for file/folder |
| `/acc:audit-test <path>` | Audit test quality |
| `/acc:code-review [branch] [level]` | Multi-level code review |
| `/acc:bug-fix <target>` | Automated bug diagnosis and fix |
| `/acc:explain <path> [mode]` | Explain code: structure, logic, data flows |

## Agents

| Agent | Purpose |
|-------|---------|
| `architecture-auditor` | Multi-pattern architecture auditor |
| `ddd-auditor` | DDD compliance auditor |
| `ddd-generator` | DDD domain layer generator |
| `cqrs-generator` | CQRS/ES component generator |
| `pattern-generator` | Design pattern generator |
| `psr-generator` | PSR implementation generator |
| `documentation-writer` | Technical documentation writer |
| `documentation-auditor` | Documentation quality auditor |
| `diagram-designer` | Mermaid diagram designer |
| `test-auditor` | Test quality auditor |
| `test-generator` | Test generator |
| `bug-fix-coordinator` | Bug diagnosis -> fix -> test workflow |
| `bug-fixer` | Safe minimal bug fix generator |
| `explain-coordinator` | Code explanation (5 modes) |
| `codebase-navigator` | Structure scanning and pattern detection |
| `business-logic-analyst` | Business rules and process extraction |
| `data-flow-analyst` | Request lifecycle and data flow tracing |
| `principles-auditor` | SOLID/GRASP principles auditor |
| `resource-reviewer` | Memory, connections, serialization, I/O reviewer |
| `scalability-reviewer` | Scalability readiness and database scaling reviewer |

## Skills by Category

### Knowledge (53)
- Architecture: DDD, CQRS, Clean, Hexagonal, Layered, EDA, Event Sourcing, Microservices
- Patterns: Saga, Outbox, Stability (Circuit Breaker, Retry, Rate Limiter, Bulkhead), ADR
- System Design: Consistency Patterns, Observability, Access Control, Scalability, Replication/Sharding, Cloud Native (12-Factor)
- API: REST design (Richardson Maturity, RFC 7807), content negotiation
- Messaging: Broker comparison (RabbitMQ, Kafka, SQS, Redis Streams), delivery guarantees
- Caching: Strategies (Cache-Aside, Read-Through, Write-Through, Write-Behind), Redis patterns
- Principles: SOLID, GRASP
- Standards: PSR-1/4/12, PSR overview
- Documentation: types, diagrams, QA
- Testing: principles, pyramid, DDD testing
- Bug Fix: categories, symptoms, fix patterns
- CI/CD: pipeline, tools, deployment
- Docker: core, multistage, base-images, php-extensions, compose, networking, security, buildkit, production, troubleshooting, orchestration, scanning
- Frameworks: Symfony, Laravel, Yii, CodeIgniter, No-Framework (pure PHP)
- Task Progress: coordinator tracking guidelines

### Analyzers (107)
- Architecture: SOLID violations, code smells, coupling/cohesion, bounded contexts, immutability, leaky abstractions, encapsulation
- Testing: test coverage, test smells
- Bug Detection: logic errors, null pointers, boundary, race conditions, resource leaks, exceptions, types, infinite loops
- Security: input validation, output encoding, authentication, authorization, sensitive data, CSRF, crypto, dependencies, SQL injection, SSRF, command injection, deserialization, XXE, path traversal, insecure design, logging failures, secure headers, CORS, mass assignment, type juggling
- Performance: N+1, query efficiency, memory, caching, loops, lazy loading, batch processing, complexity, connection pool, serialization, index usage, async patterns, file I/O
- DDD: aggregate consistency, CQRS alignment, context communication
- Documentation: link validation, code examples verification, version consistency
- Stability: timeout strategy, cascading failures, fallback strategy
- System Design: idempotency, observability coverage, access control model, scalability readiness, distributed locks, database scaling, 12-factor compliance
- Creational: singleton anti-pattern, abstract factory audit
- Readability: naming, code style, method/class length, nesting, comments, magic values, consistency
- Testability: DI, pure functions, side effects, test quality
- CI/CD: CI config, CI logs, CI antipatterns
- Docker: build errors, runtime errors, image size, security, secrets, user permissions, compose config, production readiness, antipatterns, layer efficiency, PHP config, healthcheck
- Code Explainer: scan structure, identify entry points, detect architecture, resolve entry point, extract business rules, explain process, extract domain concepts, extract state machine, trace lifecycle, trace transformation, map async flows
- Log Analysis: discover project logs, analyze PHP logs (PSR-3/Monolog, Laravel, Symfony, error_log, FPM slow log)

### Generators (99)
- DDD: Value Objects, Entities, Aggregates, Domain Events, Repositories, Domain Services, Factories, Specifications, DTOs, Anti-Corruption Layer
- CQRS: Commands, Queries, Use Cases, Read Models
- Stability: Circuit Breaker, Retry, Rate Limiter, Bulkhead, Timeout
- Integration: Saga, Outbox, Correlation Context, Unit of Work, Message Broker Adapter, Idempotent Consumer, Dead Letter Queue
- System Design: Idempotency Handler, Structured Logger, Access Control, Distributed Lock, Read/Write Proxy, Metrics Collector
- Behavioral: Strategy, State, Decorator, Chain of Responsibility, Null Object, Policy, Template Method, Visitor, Iterator, Memento
- GoF Structural: Adapter, Facade, Proxy, Composite, Bridge, Flyweight
- Creational: Builder, Object Pool, DI Container, Mediator, Prototype
- ADR: Action, Responder
- PSR: 3, 6, 7, 11, 13, 14, 15, 16, 17, 18, 20
- Testing: Unit tests, Integration tests, Builders, Mocks, Test doubles
- Bug Fix: minimal safe fix generator
- CI/CD: GitHub Actions, GitLab CI, PHPStan, Psalm, DEPTRAC, Rector, CI fix
- Docker: Dockerfile (production, dev, CI), dockerignore, Compose (dev, production), PHP config, healthcheck, entrypoint, nginx, makefile, env template, supervisor
- Docker Optimizers: layers, build time, image size, PHP-FPM, Compose resources, OPcache, startup
- Deployment: deploy strategy, feature flags

### Templates (10)
- README, Architecture, ADR, API docs
- Getting Started, Troubleshooting
- Code Examples, Mermaid diagrams, Changelog
- Explain output template

## Project Structure

```
.claude-plugin/
├── marketplace.json
└── plugin.json
commands/        # 26 commands
agents/          # 68 agents
skills/          # 283 skills (knowledge + generators + analyzers)
hooks/
└── hooks.json   # PHP syntax check hook
```

## Documentation

- Main README: [README.md](README.md)
- Detailed docs: [docs/](docs/)
- Changelog: [CHANGELOG.md](CHANGELOG.md)

## Usage Examples

```bash
# Audit architecture
/acc:audit-architecture ./src

# Generate documentation
/acc:generate-documentation ./src

# Check documentation quality
/acc:audit-documentation ./docs

# Create new DDD component
/acc:generate-ddd vo Email

# Generate tests
/acc:generate-test ./src/Domain/Order/

# Audit test quality
/acc:audit-test ./tests

# Fix bug by description or file reference
/acc:bug-fix ./src/Domain/Order/Order.php:42
```

## Links

- GitHub: https://github.com/dykyi-roman/awesome-claude-code
- Author: https://github.com/dykyi-roman

## Version

v3.2.0 - System design skills (consistency, observability, access control, scalability, replication, cloud-native), observability-auditor agent