/ Diretório / Playground / symfony-hexagonal-skill
← Todos os servidores ↗ GitHub
● Comunidade aligundogdu ⚡ Instantâneo

symfony-hexagonal-skill

por aligundogdu · aligundogdu/symfony-hexagonal-skill

Enforces hexagonal architecture in Symfony projects — 10 auto-triggered skills plus 2 review agents that stop you from leaking infrastructure into domain.

A Claude Code plugin for Symfony developers who actually want to keep ports & adapters clean. Auto-triggers on Symfony code patterns to guide domain/application/infrastructure separation. Includes review agents that catch leaks (Doctrine entities imported into domain, controllers calling repositories directly).

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

symfony-hexagonal-skill.replay ▶ pronto
0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: symfony-hexagonal-skill

Scaffold a new bounded context with hexagonal layers

👤 Symfony devs building non-trivial domain logic ⏱ ~60 min advanced

Quando usar: You're starting a new feature and want the layering right from day one.

Fluxo
  1. Name the context
    Use symfony-hexagonal-skill. Scaffold a 'Billing' bounded context with Invoice aggregate, issue/void commands, and a query for open invoices.✓ Copiado
    → src/Billing/Domain, Application, Infrastructure folders with proper separation
  2. Wire the infrastructure
    Add a Doctrine adapter for InvoiceRepository behind the domain port.✓ Copiado
    → Interface in Domain, implementation in Infrastructure, services.yaml binding
  3. Expose via controller
    Add an HTTP adapter with a POST /invoices endpoint that dispatches the IssueInvoice command.✓ Copiado
    → Controller calls bus, not repository directly

Resultado: A clean bounded context that won't turn into spaghetti in 6 months.

Armadilhas
  • Domain depending on Doctrine annotations — Use XML / attribute mapping in Infrastructure, not on domain entities
Combine com: filesystem

Review a PR for hexagonal layering violations

👤 Tech leads on Symfony teams ⏱ ~20 min intermediate

Quando usar: Reviewing a PR and you want an automated first-pass on layering.

Fluxo
  1. Run the review agent
    Use symfony-hexagonal-skill review agent on this diff. Flag any Doctrine / Symfony FW imports in Domain/, any controller->repository direct calls, any ORM leakage into responses.✓ Copiado
    → Concrete findings with file+line
  2. Suggest fixes
    For each finding, propose the minimal refactor.✓ Copiado
    → Diffs introducing a port or DTO

Resultado: A PR that doesn't silently degrade the architecture.

Combine com: github

Progressively refactor an existing Symfony app toward hexagonal

👤 Teams with a legacy Symfony project ⏱ ~120 min advanced

Quando usar: Big-bang rewrite is off the table; you want incremental cleanup.

Fluxo
  1. Identify a seam
    Use symfony-hexagonal-skill. Look at src/Module/Orders — what's the smallest slice I can lift into a clean domain?✓ Copiado
    → Specific class identified with extraction plan
  2. Extract incrementally
    Walk me through the extraction in 3 PR-sized steps.✓ Copiado
    → Staged plan with tests preserved at each step

Resultado: A legacy codebase getting better, one PR at a time.

Armadilhas
  • Extracting too much in one step — PR-sized slices only; the plugin's review agent helps gate each step
Combine com: git

Combinações

Combine com outros MCPs para 10× de alavancagem

symfony-hexagonal-skill + github

Gate PRs on layering review before merge

Run the hex review on the open PR in this repo and post findings as comments.✓ Copiado
symfony-hexagonal-skill + filesystem

Apply scaffolds into the actual repo

Apply the context scaffold to my project under src/.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
context_scaffold context name, aggregates New bounded context 0
port_adapter_pair port interface name, adapter type Adding infrastructure 0
layering_review diff or directory Pre-merge 0
refactor_plan legacy module Starting a cleanup 0

Custo e limites

O que custa rodar

Cota de API
None
Tokens por chamada
Moderate — reviews scan files
Monetário
Free
Dica
Scope reviews to the diff, not whole repos, to save tokens.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: None
Saída de dados: None from skill

Solução de problemas

Erros comuns e correções

Review agent misses violations

Ensure the full diff is in context; very large diffs may need chunking

Scaffold produces old Symfony 5 style

Mention your Symfony version explicitly — 6 vs 7 conventions differ

Alternativas

symfony-hexagonal-skill vs. outros

AlternativaQuando usarTroca
Deptrac static analysisYou want rule-based static enforcement of layeringNo refactor help; purely gates violations
craftcms-claude-skillYou're on Craft CMS, not SymfonyDifferent framework

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills