Skip to content
Back to search

awesome-claude-code

MarketplaceWorks with Claude CodeGitHub

PHP Architecture Toolkit for Claude Code (DDD, CQRS, Event Sourcing, Hexagonal, Clean Architecture, SOLID, GRASP, PSR, Design Patterns, Testing, Documentation, Code Review)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dykyi-roman-awesome-claude-code/badge.svg)](/listings/dykyi-roman-awesome-claude-code)

HTML

<a href="/listings/dykyi-roman-awesome-claude-code"><img src="/api/listings/dykyi-roman-awesome-claude-code/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 35 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "awesome-claude-code",
  3. "owner": {
  4. "name": "Roman Dykyi",
  5. "email": "dykyi.roman@gmail.com"
  6. },
  7. "metadata": {
  8. "description": "PHP Architecture Toolkit — DDD, CQRS, Clean Architecture, Design Patterns, PSR"
  9. },
  10. "plugins": [
  11. {
  12. "name": "acc",
  13. "source": "./",
  14. "description": "The most comprehensive Claude Code extension for PHP developers. 26 commands, 68 agents, 283 skills.",
  15. "version": "3.3.0",
  16. "author": {
  17. "name": "Roman Dykyi",
  18. "email": "dykyi.roman@gmail.com"
  19. },
  20. "homepage": "https://github.com/dykyi-roman/awesome-claude-code",
  21. "license": "MIT",
  22. "keywords": [
  23. "php",
  24. "ddd",
  25. "cqrs",
  26. "clean-architecture",
  27. "design-patterns",
  28. "psr",
  29. "docker",
  30. "ci-cd"
  31. ],
  32. "category": "development-workflows"
  33. }
  34. ]
  35. }
README.md · README · 522 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Awesome Claude Code — PHP Architecture Toolkit
  2. [![Claude Code Marketplace](https://img.shields.io/badge/Marketplace-awesome--claude--code-blueviolet?style=flat-square)](https://marketplace.claude.ai/plugin/dykyi-roman/awesome-claude-code)
  3. [![PHP 8.4](https://img.shields.io/badge/PHP-8.4-blue?style=flat-square)](https://php.net)
  4. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Extension-purple?style=flat-square)](https://claude.ai/code)
  5. [![DDD](https://img.shields.io/badge/DDD-Ready-green?style=flat-square)](https://en.wikipedia.org/wiki/Domain-driven_design)
  6. [![CQRS](https://img.shields.io/badge/CQRS-Ready-orange?style=flat-square)](https://martinfowler.com/bliki/CQRS.html)
  7. [![License](https://img.shields.io/github/license/dykyi-roman/awesome-claude-code?style=flat-square)](https://github.com/dykyi-roman/awesome-claude-code/blob/master/LICENSE)
  8. [![Total Downloads](https://img.shields.io/packagist/dt/dykyi-roman/awesome-claude-code.svg?style=flat-square)](https://packagist.org/packages/dykyi-roman/awesome-claude-code)
  9. [![GitHub Stars](https://img.shields.io/github/stars/dykyi-roman/awesome-claude-code?style=flat-square)](https://github.com/dykyi-roman/awesome-claude-code)
  10. [![Last Commit](https://img.shields.io/github/last-commit/dykyi-roman/awesome-claude-code?style=flat-square)](https://github.com/dykyi-roman/awesome-claude-code)
  11. > **The most comprehensive Claude Code extension for PHP developers.** Current version: **v3.2.0**
  12. > Audit, Generate & Document: DDD, CQRS, Event Sourcing, Clean/Hexagonal Architecture, Design Patterns, PSR, Tests ...
  13. ![Awesome Claude Code — PHP Architecture Toolkit](docs/img.png)
  14. ## Quick Start
  15. ```bash
  16. /plugin marketplace add dykyi-roman/awesome-claude-code
  17. /plugin install acc@awesome-claude-code
  18. ```
  19. Then in Claude Code:
  20. ```bash
  21. /acc:code-review # Review current branch
  22. /acc:bug-fix "NullPointerException" # Diagnose and fix bug
  23. /acc:explain GET /api/orders # Explain HTTP route
  24. /acc:audit-architecture ./src # Full architecture audit
  25. /acc:generate-documentation # Write documentation
  26. /acc:generate-test # Write test
  27. ```
  28. ## Demo
  29. ![Demo](docs/demo.gif)
  30. ## Features
  31. ### Code Review (3-Level Analysis)
  32. ```bash
  33. /acc:code-review feature/payment high -- implement Stripe payment processing
  34. ```
  35. Multi-level automated code review with **9 specialized reviewers**:
  36. | Level | Reviewers | What's Checked |
  37. |-------|-----------|----------------|
  38. | **LOW** | PSR Auditor, Test Auditor | Coding standards, test quality |
  39. | **MEDIUM** | + Bug Hunter, Readability Reviewer | Logic errors, null pointers, naming, complexity |
  40. | **HIGH** | + Security, Performance, Resources, Scalability, Testability, DDD, Architecture | OWASP Top 10, N+1 queries, memory leaks, connection pools, scalability readiness, DDD compliance |
  41. ```
  42. # Code Review Report
  43. **Mode:** BRANCH
  44. **Branch:** `feature/payment` → `main`
  45. **Files Reviewed:** 12 (+456/-23 lines)
  46. **Review Level:** HIGH
  47. ## Review Findings
  48. ### 🔴 Critical (1)
  49. | ID | Category | Location | Issue |
  50. |----|----------|----------|-------|
  51. | CR-001 | Security | PaymentService.php:45 | SQL injection via string concatenation |
  52. ### 🟠 Major (3)
  53. | ID | Category | Location | Issue |
  54. |----|----------|----------|-------|
  55. | CR-002 | Bug | Order.php:89 | Null pointer when items empty |
  56. | CR-003 | Performance | CartRepository.php:34 | N+1 query in loop |
  57. | CR-004 | DDD | PaymentService.php:12 | Domain logic in Application layer |
  58. ### 🟡 Minor (5)
  59. | ID | Category | Location | Issue |
  60. |----|----------|----------|-------|
  61. | CR-005 | Style | UserService.php:23 | Method exceeds 30 lines |
  62. | ... | ... | ... | ... |
  63. ## Task Match Analysis
  64. **Expected Task:** implement Stripe payment processing
  65. **Match Score:** 85%
  66. ## Verdict
  67. ❌ **REQUEST CHANGES** — 1 critical, 3 major issues found
  68. **Required Actions:**
  69. 1. Fix SQL injection in PaymentService.php:45
  70. 2. Add null check in Order.php:89
  71. 3. Move domain logic from Application to Domain layer
  72. ```
  73. ### Bug Fix System
  74. Automated bug diagnosis, fix generation, and regression testing:
  75. ```bash
  76. /acc:bug-fix "NullPointerException in OrderService::process()"
  77. /acc:bug-fix src/Domain/Order.php:45 "off-by-one error"
  78. /acc:bug-fix @storage/logs/error.log -- focus on validation
  79. ```
  80. | Phase | Agent | What It Does |
  81. |-------|-------|--------------|
  82. | **Diagnose** | bug-hunter | Categorizes bug (9 types), finds root cause |
  83. | **Fix** | bug-fixer | Generates minimal, safe fix with 11 skills |
  84. | **Test** | test-generator | Creates regression test |
  85. | **Verify** | coordinator | Applies fix, runs tests, reports results |
  86. **Bug Categories:** logic errors, null pointers, boundary issues, race conditions, resource leaks, exception handling, type issues, SQL injection, infinite loops
  87. ### Architecture Audit Engine
  88. Comprehensive analysis across **10+ architecture patterns**:
  89. - **Structural**: DDD, Clean Architecture, Hexagonal, Layered, SOLID, GRASP
  90. - **Behavioral**: CQRS, Event Sourcing, Event-Driven Architecture, Strategy, State
  91. - **Integration**: Saga, Outbox, Anti-Corruption Layer
  92. - **Stability**: Circuit Breaker, Retry, Rate Limiter, Bulkhead
  93. ### Code Generation
  94. **50+ generators** for DDD/CQRS components with tests:
  95. - DDD: Entity, ValueObject, Aggregate, Repository, DomainEvent, DomainService, Specification, Factory
  96. - CQRS: Command, Query, Handler, UseCase, ReadModel
  97. - Patterns: Strategy, State, Decorator, Builder, ObjectPool, CircuitBreaker, Saga, Outbox
  98. - PSR: Logger (PSR-3), Cache (PSR-6/16), HTTP (PSR-7/15/17/18), Container (PSR-11), Clock (PSR-20)
  99. ### Claude Component Generation
  100. ```bash
  101. /acc:generate-claude-component
  102. > What would you like to create? command
  103. > Command name? validate-order
  104. > What should it do? Validate Order aggregate invariants
  105. > Should it use agents? Yes, ddd-auditor
  106. ```
  107. Generates:
  108. - `commands/validate-order.md` — Custom slash command
  109. ### Knowledge Bases
  110. **53 knowledge skills** covering:
  111. - Architecture: DDD, CQRS, Clean, Hexagonal, Layered, Event Sourcing, EDA, Microservices
  112. - Principles: SOLID, GRASP, PSR-1/4/12
  113. - Patterns: Saga, Outbox, Stability, ADR
  114. - System Design: Consistency, Observability, Access Control, Scalability, Replication, 12-Factor
  115. - API & Messaging: REST design, Message Queues, Caching Strategies
  116. - Frameworks: Symfony, Laravel, Yii, CodeIgniter, No-Framework
  117. - Documentation: Mermaid, C4 Model, ADR templates
  118. - Docker: 12 Docker knowledge skills (core, multistage, security, production, etc.)
  119. ### Developer Safeguards
  120. The plugin installs **one** hook — a `php -l` syntax check on Write/Edit. On top of that,
  121. [docs/hooks.md](docs/hooks.md) is a library of **21 ready-to-copy hook recipes** you paste into your
  122. own `.claude/settings.json`:
  123. - DDD guards: readonly classes, immutable Value Objects, aggregate protection
  124. - Security: no debug output, no hardcoded paths, no global state
  125. - Quality: strict_types required, PSR-12 formatting, syntax validation
  126. ## Component Flow
  127. ```
  128. COMMAND ───────→ COORDINATOR ───────→ AGENTS ───────→ KNOWLEDGE SKILLS ──────→ GENERATORS SKILLS
  129. /acc:code-review ──→ code-review-coordinator
  130. │
  131. ├─ LOW ──────→ psr-auditor ─────────→ psr-knowledge ─────────→ create-psr-*
  132. │ test-auditor ────────→ testing-knowledge ────→ create-test-*
  133. │
  134. ├─ MEDIUM ───→ bug-hunter ──────────→ bug-fix-knowledge ────→ generate-bug-fix
  135. │ readability-reviewer → code-smells-analyzer
  136. │
  137. └─ HIGH ─────→ security-reviewer ───→ owasp-skills ─────────→ create-validator
  138. performance-reviewer → optimization-skills
  139. ddd-auditor ─────────→ ddd-knowledge ────────→ create-entity,
  140. │ create-value-object,
  141. │ create-aggregate...
  142. architecture-auditor → arch-knowledge ───────→ create-*, pattern-*
  143. /acc:audit-architecture ──→ architecture-auditor (coordinator)
  144. │
  145. ├──→ structural-auditor ────→ ddd-knowledge ────────→ create-entity
  146. │ clean-arch-knowledge create-value-object
  147. │ hexagonal-knowledge create-repository
  148. │ microservices-knowledge create-use-case
  149. │
  150. ├──→ principles-auditor ────→ solid-knowledge ──────→ analyze-solid-violations
  151. │ grasp-knowledge detect-code-smells
  152. │
  153. ├──→ behavioral-auditor ────→ cqrs-knowledge ───────→ create-command
  154. │ event-sourcing-knowledge create-query
  155. │ eda-knowledge create-saga
  156. │
  157. ├──→ integration-auditor ───→ saga-knowledge ───────→ create-outbox
  158. │ outbox-knowledge create-circuit-breaker
  159. │ stability-knowledge create-retry
  160. │
  161. └──→ pattern-generator ─────→ (coordinates generators)
  162. ├──→ stability-generator ──→ circuit-breaker, retry, rate-limiter
  163. ├──→ behavioral-generator ─→ strategy, state, decorator, visitor, memento
  164. ├──→ gof-structural-generator → adapter, facade, proxy, composite
  165. ├──→ creational-generator ─→ builder, factory, object-pool
  166. ├──→ messaging-generator ───→ saga, outbox, correlation, broker
  167. └──→ api-infrastructure-generator → ADR, versioning, health
  168. /acc:bug-fix ─────────────→ bug-fix-coordinator
  169. │
  170. ├──→ bug-hunter ────────────→ detection-skills ─────→ (9 analyzers)
  171. ├──→ bug-fixer ─────────────→ fix-knowledge ────────→ generate-bug-fix
  172. └──→ test-generator ────────→ testing-knowledge ────→ create-unit-test
  173. create-regression-test
  174. /acc:generate-test ──────────→ test-generator ─────────────→ testing-knowledge ────→ create-unit-test
  175. create-integration-test
  176. create-mock-repository
  177. /acc:generate-documentation ─→ documentation-writer ───────→ doc-knowledge ────────→ readme-template
  178. │ architecture-template
  179. └──→ diagram-designer ──────→ diagram-knowledge ───→ mermaid-template
  180. c4-template
  181. /acc:audit-docker ────────→ docker-coordinator
  182. │
  183. ├──→ docker-architect ────────→ multistage-knowledge ──→ create-dockerfile
  184. ├──→ docker-security ─────────→ security-knowledge ───→ check-security
  185. ├──→ docker-performance ──────→ buildkit-knowledge ───→ optimize-build
  186. ├──→ docker-compose ──────────→ compose-knowledge ────→ check-compose
  187. ├──→ docker-production ───────→ production-knowledge ─→ check-readiness
  188. └──→ docker-debugger ─────────→ troubleshoot-knowledge
  189. /acc:generate-docker ────→ docker-coordinator
  190. │
  191. ├──→ docker-architect ────────→ create-dockerfile-production
  192. ├──→ docker-compose ──────────→ create-compose-dev, create-compose-prod
  193. ├──→ docker-image-builder ───→ create-php-config, create-entrypoint
  194. └──→ docker-production ──────→ create-nginx, create-healthcheck
  195. /acc:ci-fix ──────────────→ ci-coordinator
  196. │
  197. ├──→ ci-debugger ───────────→ analyze-ci-logs, ci-pipeline-knowledge
  198. └──→ ci-fixer ──────────────→ generate-ci-fix, ci-tools-knowledge
  199. ```
  200. See [Component Flow](docs/component-flow.md) for the complete dependency graph.
  201. ## Why Use This?
  202. | Without | With Awesome Claude Code |
  203. |---------|--------------------------|
  204. | Manual boilerplate code | One command generates complete component with tests |
  205. | Architecture drift over time | Automated compliance audits catch violations early |
  206. | Inconsistent patterns across team | Standardized DDD/CQRS templates ensure consistency |
  207. | Hours reviewing PRs manually | 3-level automated review catches bugs, security issues |
  208. | Learning DDD/CQRS from scratch | Built-in knowledge bases explain patterns in context |
  209. ## Documentation
  210. | Document | Description |
  211. |--------------------------------------------|-----------------------------------------------|
  212. | [Commands](docs/commands.md) | 26 slash commands with examples |
  213. | [Agents](docs/agents.md) | 68 specialized subagents |
  214. | [Skills](docs/skills.md) | 283 skills (knowledge, generators, analyzers) |
  215. | [Hooks](docs/hooks.md) | 1 installed + 21 copy-paste recipes |
  216. | [Component Flow](docs/component-flow.md) | Architecture and dependency graph |
  217. | [MCP](docs/mcp.md) | MCP server configuration |
  218. | [Quick Reference](docs/quick-reference.md) | Paths, formats, best practices |
  219. ## Use Cases
  220. | Scenario | Command | Result |
  221. |------------------------|--------------------------------------|----------------------------------------------|
  222. | Fix a bug | `/acc:bug-fix "NullPointerException"` | Diagnosis + fix + regression test |
  223. | Review PR before merge | `/acc:code-review feature/auth high` | Security, performance, DDD compliance report |
  224. | Audit legacy codebase | `/acc:audit-architecture ./src` | Pattern detection + compliance score |
  225. | Security audit | `/acc:audit-security ./src` | OWASP Top 10 + PHP-specific vulnerabilities |
  226. | Performance audit | `/acc:audit-performance ./src` | N+1 queries, memory issues, caching gaps |
  227. | Design patterns audit | `/acc:audit-patterns ./src` | Stability, behavioral, creational patterns |
  228. | Generate PSR component | `/acc:generate-psr psr-15 Auth` | PSR-compliant implementation with tests |
  229. | Generate design pattern| `/acc:generate-patterns strategy Pay` | Pattern implementation with DI configuration |
  230. | Explain code | `/acc:explain src/Domain/Order/` | Structure, business logic, data flows |
  231. | Onboard to project | `/acc:explain .` | Project guide with glossary and diagrams |
  232. | Audit Docker config | `/acc:audit-docker ./` | Dockerfile, Compose, security, performance |
  233. | Generate Docker stack | `/acc:generate-docker full` | Dockerfile + Compose + Nginx + entrypoint |
  234. | Refactor code | `/acc:refactor ./src/OrderService` | Analysis + prioritized roadmap + generators |
  235. | Create Claude command | `/acc:generate-claude-component` | Create command, agent, skills |
  236. | Audit test quality | `/acc:audit-test ./tests` | Coverage gaps, test smells, recommendations |
  237. | Generate documentation | `/acc:generate-documentation ./src` | README + ARCHITECTURE.md + diagrams |
  238. ## Supported Patterns
  239. **Architecture:**
  240. - Domain-Driven Design (DDD) — Aggregates, Entities, Value Objects, Domain Events, Repositories
  241. - CQRS — Command/Query separation, Handlers, Buses
  242. - Clean Architecture — Use Cases, Boundaries, Dependency Inversion
  243. - Hexagonal Architecture — Ports & Adapters, Primary/Secondary adapters
  244. - Event Sourcing — Event stores, Projections, Snapshots
  245. - Event-Driven Architecture — Messaging, Pub/Sub, Event handlers
  246. **Integration:**
  247. - Saga Pattern — Orchestration, Choreography, Compensation
  248. - Outbox Pattern — Transactional messaging, Reliable delivery
  249. - Anti-Corruption Layer — External system isolation, Translation
  250. **Stability:**
  251. - Circuit Breaker, Retry, Rate Limiter, Bulkhead
  252. **System Design:**
  253. - Idempotency Handler, Structured Logger, Access Control (RBAC/ABAC)
  254. - Distributed Lock, Read-Write Proxy, Metrics Collector
  255. **Standards:**
  256. - PSR-3, 6, 7, 11, 13, 14, 15, 16, 17, 18, 20 implementations
  257. ## Requirements
  258. - **PHP 8.4+** — for generated code (strict typing, readonly classes)
  259. - **Claude Code CLI** — [Installation guide](https://docs.anthropic.com/en/docs/claude-code)
  260. ## Installation (v2.x — Composer)
  261. > **Note:** v2.x is no longer maintained. Use the [marketplace version](#quick-start) (v3.0.0+) for the latest features and automatic updates.
  262. If you need to use the legacy Composer-based version (v2.14.0):
  263. ```bash
  264. composer require --dev dykyi-roman/awesome-claude-code:^2.14
  265. ```
  266. After installation, register the Composer plugin:
  267. ```bash
  268. ./vendor/bin/acc install
  269. ```
  270. This copies commands, agents, and skills into your `.claude/` directory. Commands use dash syntax: `/acc-audit-architecture`, `/acc-code-review`, etc.
  271. ### v2.x Requirements
  272. - PHP 8.4+
  273. - Composer 2.0+
  274. - Claude Code CLI
  275. ### v2.x Updates
  276. ```bash
  277. composer update dykyi-roman/awesome-claude-code
  278. ./vendor/bin/acc upgrade
  279. ```
  280. ## Migration from v2.x to v3.0.0
  281. v3.0.0 is a **breaking change** — the plugin moved from Composer to the Claude Code Marketplace. Follow these steps to upgrade:
  282. ### Step 1: Remove the Composer package
  283. ```bash
  284. composer remove dykyi-roman/awesome-claude-code
  285. ```
  286. ### Step 2: Clean up old components
  287. Remove all v2.x files that were copied to `.claude/`:
  288. ```bash
  289. rm -rf .claude/commands/acc-* .claude/agents/acc-* .claude/skills/acc-*
  290. ```
  291. > **Warning:** If you customized any `acc-*` files, back them up first. Your `.claude/settings.json` and `.claude/rules/` are not affected.
  292. ### Step 3: Install from the marketplace
  293. ```bash
  294. /plugin marketplace add dykyi-roman/awesome-claude-code
  295. /plugin install acc@awesome-claude-code
  296. ```
  297. ### Step 4: Update command references
  298. All commands changed from dash (`-`) to colon (`:`) syntax:
  299. ```bash
  300. # Before (v2.x)
  301. /acc-code-review feature/auth high
  302. /acc-audit-architecture ./src
  303. /acc-generate-ddd entity Order
  304. # After (v3.0.0)
  305. /acc:code-review feature/auth high
  306. /acc:audit-architecture ./src
  307. /acc:generate-ddd entity Order
  308. ```
  309. If you have scripts or documentation referencing old command names, update them.
  310. ### What changed
  311. | Aspect | v2.x (Composer plugin) | v3.0.0 (Marketplace plugin) |
  312. |--------|------------------------|-----------------------------|
  313. | **Install method** | `composer require` | `/plugin marketplace add` + `/plugin install` |
  314. | **Command syntax** | `/acc-command` (dash) | `/acc:command` (colon) |
  315. | **Component paths** | `.claude/commands/acc-*.md` | `commands/*.md` (managed by plugin system) |
  316. | **PHP/Composer dependency** | Required Composer 2.0+ | No PHP/Composer dependency for the plugin itself |
  317. | **Updates** | `composer update` + `./vendor/bin/acc upgrade` | Automatic via marketplace |
  318. | **Component location** | Copied to `.claude/` by Composer plugin | Managed by Claude Code plugin system |
  319. | **Customization** | Edit files in `.claude/` directly | Fork the plugin or override locally |
  320. ## FAQ
  321. <details>
  322. <summary><strong>How does installation work?</strong></summary>
  323. 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.
  324. </details>
  325. <details>
  326. <summary><strong>Can I customize generated code?</strong></summary>
  327. 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.
  328. </details>
  329. <details>
  330. <summary><strong>Which PHP versions are supported?</strong></summary>
  331. 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.
  332. </details>
  333. <details>
  334. <summary><strong>How do I add my own commands/skills?</strong></summary>
  335. 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.
  336. </details>
  337. <details>
  338. <summary><strong>What if I want to update to a newer version?</strong></summary>
  339. 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.
  340. </details>
  341. <details>
  342. <summary><strong>Can I use only specific skills?</strong></summary>
  343. Yes. After installation, you can remove unwanted components. Each component (command, agent, skill) works independently.
  344. </details>
  345. ## Troubleshooting
  346. <details>
  347. <summary><strong>Skill not loading</strong></summary>
  348. **Symptom:** Agent doesn't use expected skill.
  349. **Solutions:**
  350. 1. Check `skills:` list in agent frontmatter (`agents/agent-name.md`)
  351. 2. Verify skill exists in `skills/skill-name/SKILL.md`
  352. 3. Check skill name matches exactly (case-sensitive, with hyphens)
  353. ```yaml
  354. # In agent file:
  355. ---
  356. skills:
  357. - ddd-knowledge # Must match skill folder name
  358. ---
  359. ```
  360. </details>
  361. <details>
  362. <summary><strong>Agent not invoked by command</strong></summary>
  363. **Symptom:** Command runs but doesn't use the expected agent.
  364. **Solutions:**
  365. 1. Verify command uses `Task` tool with correct `subagent_type`
  366. 2. Check agent file exists in `agents/`
  367. 3. Ensure agent name in command matches agent filename (without `.md`)
  368. ```markdown
  369. # In command file:
  370. Use the Task tool with subagent_type="acc:ddd-auditor"
  371. ```
  372. </details>
  373. <details>
  374. <summary><strong>Hooks not triggering</strong></summary>
  375. **Symptom:** Code changes don't trigger validation hooks.
  376. **Solutions:**
  377. 1. Verify `.claude/settings.json` exists and is valid JSON
  378. 2. Check hook patterns match your file paths
  379. 3. Ensure Claude Code has permission to execute hooks
  380. 4. Run `make validate-claude` to check configuration
  381. </details>
  382. <details>
  383. <summary><strong>Generated code has wrong namespace</strong></summary>
  384. **Symptom:** Generated classes have incorrect PSR-4 namespace.
  385. **Solutions:**
  386. 1. Check your `composer.json` autoload configuration
  387. 2. Specify target path when generating: `/acc:generate-claude-component` prompts for location
  388. 3. Edit generated files to match your project structure
  389. </details>
  390. ## Contributing
  391. Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  392. ## License
  393. The MIT License (MIT). Please see [License File](LICENSE) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.