Updated 3w ago
by aligundogdu
symfony-hexagonal-skill
Claude Code plugin that enforces hexagonal architecture (ports & adapters) in Symfony projects — with 10 auto-triggered skills, 2 review agents, and progressive refactoring support for existing codebases.
35 GitHub stars (35)
Steady at 35 stars — no new stars in the 37 days since Sep 30.
- 10 skills (10 skills found in its SKILL.md files)
- 4 forks (4 forks)
- 3w ago last update (Last updated 3w ago)
Install
Skills CLI
npx skills add aligundogdu/symfony-hexagonal-skill
Asks which skills and agents to install. Just one: npx skills add aligundogdu/symfony-hexagonal-skill --skill symfony-api-response — add -g for every project.
Claude Code
git clone https://github.com/aligundogdu/symfony-hexagonal-skillcp -r "symfony-hexagonal-skill/skills/symfony-api-response" ~/.claude/skills/
Copies the symfony-api-response skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add aligundogdu/symfony-hexagonal-skill
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
symfony-api-response
Symfony REST API response standard {result, error, extra, status}: thin controllers, #[MapRequestPayload] / #[MapQueryString] request DTOs, ApiResponseTrait, exception subscriber that unwraps Messenger HandlerFailedException, validation error format, debug mode. Use when: API, endpoint, controller, response, error handling, JSON, REST, API response, exception subscriber, HTTP, request DTO
skills/symfony-api-response/ on GitHub (opens in a new tab)SKILL.md -
symfony-cqrs-handlers
Symfony CQRS with Messenger: commands, queries, handlers, command.bus / query.bus / event.bus configuration, typed bus wrappers, HandlerFailedException unwrapping, read ports and pagination, use cases. Works on Symfony 6.4, 7.x, 8.x. Use when: command, query, handler, CQRS, bus, use case, command handler, query handler, message bus, HandleTrait, HandledStamp
skills/symfony-cqrs-handlers/ on GitHub (opens in a new tab)SKILL.md -
symfony-doctrine-persistence
Doctrine persistence for Symfony hexagonal architecture (ORM 2.x/3.x, DBAL 3/4, DoctrineBundle 2/3): repository adapters, XML mapping in Infrastructure, embeddables, enums, custom DBAL types, native lazy objects, migrations, transactions, read models with DBAL QueryBuilder, strict no-native-SQL rule. Use when: doctrine, repository, persistence, database, mapping, migration, ORM, entity manager, D…
skills/symfony-doctrine-persistence/ on GitHub (opens in a new tab)SKILL.md -
symfony-domain-modeling
Symfony DDD domain modeling in pure PHP: entities, aggregates, value objects, domain events, domain exceptions, ID generation ports, PHP 8.2-8.5 modeling features (readonly, private(set), clone with). Use when: entity, value object, domain event, aggregate, domain exception, domain model, domain logic, business rule, invariant, enum status
skills/symfony-domain-modeling/ on GitHub (opens in a new tab)SKILL.md -
symfony-hexagonal-architecture
Symfony hexagonal architecture (ports & adapters) setup for Symfony 6.4 LTS, 7.4 LTS and 8.x: project structure, module scaffolding, layer responsibilities, dependency rules, version compatibility, progressive refactoring of legacy code. Use when: architecture, module, layer, hexagonal, scaffold, project structure, directory structure, new project, new module, bounded context, deptrac, Symfony ve…
skills/symfony-hexagonal-architecture/ on GitHub (opens in a new tab)SKILL.md -
symfony-messenger-async
Symfony Messenger async processing and Symfony Scheduler instead of cron: transports, routing (#[AsMessage] 7.2+), retry with backoff and jitter, failure transport, idempotency keys, DeduplicateStamp (7.3+), workers, supervisor, scheduled commands with stateful/locked schedules. Use when: messenger, async, queue, retry, scheduler, background job, worker, transport, message queue, cron, scheduled…
skills/symfony-messenger-async/ on GitHub (opens in a new tab)SKILL.md -
symfony-ports-adapters
Symfony ports and adapters: port interfaces in Domain, adapter implementations in Infrastructure, dependency injection, autowiring, services.yaml aliases, #[AsAlias], environment-specific and decorated adapters, in-memory test adapters. Use when: port, adapter, interface, repository interface, DI, autowiring, dependency injection, services.yaml, binding, decorator, AsAlias
skills/symfony-ports-adapters/ on GitHub (opens in a new tab)SKILL.md -
symfony-security-voters
Symfony security in hexagonal architecture: #[IsGranted] on every endpoint, role hierarchy, resource voters with subject loading, voter vote reasons (7.3+), security user adapter, user provider, JSON 401/403. Works on Symfony 6.4, 7.x, 8.x. Use when: security, voter, role, authorization, access control, permission, IsGranted, role hierarchy, RBAC, firewall, authentication
skills/symfony-security-voters/ on GitHub (opens in a new tab)SKILL.md -
symfony-testing
Testing Symfony hexagonal architecture with PHPUnit 10-13 and PHPStan 2: test organization mirroring src/, pure domain unit tests, handler tests with in-memory adapters and stubs, functional API tests, Messenger in-memory transport, Foundry 2 factories, TDD workflow. Use when: test, PHPUnit, TDD, unit test, integration test, functional test, mock, stub, testing, test driven, code quality, PHPStan…
skills/symfony-testing/ on GitHub (opens in a new tab)SKILL.md -
symfony-validation
Symfony 3-layer validation in hexagonal architecture: Presentation request DTOs with #[MapRequestPayload], Application command validation via Messenger validation middleware, Domain invariants in value objects; custom constraints with named arguments, #[ExtendsValidationFor] (7.4+), validation groups. Use when: validation, validator, constraint, DTO validation, input validation, invariant, assert…
skills/symfony-validation/ on GitHub (opens in a new tab)SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.