/ Каталог / Песочница / symfony-hexagonal-skill
← Все серверы ↗ GitHub
● Сообщество aligundogdu ⚡ Сразу

symfony-hexagonal-skill

автор 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).

▶ Смотреть демо 📦 Установить 💡 Сценарии

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

symfony-hexagonal-skill.replay ▶ готово
0/0

Установка

Репозиторий автора · Официальная документация Claude Skills

Сценарии использования

Реальные сценарии: symfony-hexagonal-skill

Scaffold a new bounded context with hexagonal layers

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

Когда использовать: You're starting a new feature and want the layering right from day one.

Поток
  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.✓ Скопировано
    → src/Billing/Domain, Application, Infrastructure folders with proper separation
  2. Wire the infrastructure
    Add a Doctrine adapter for InvoiceRepository behind the domain port.✓ Скопировано
    → 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.✓ Скопировано
    → Controller calls bus, not repository directly

Итог: A clean bounded context that won't turn into spaghetti in 6 months.

Подводные камни
  • Domain depending on Doctrine annotations — Use XML / attribute mapping in Infrastructure, not on domain entities
Сочетать с: filesystem

Review a PR for hexagonal layering violations

👤 Tech leads on Symfony teams ⏱ ~20 min intermediate

Когда использовать: Reviewing a PR and you want an automated first-pass on layering.

Поток
  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.✓ Скопировано
    → Concrete findings with file+line
  2. Suggest fixes
    For each finding, propose the minimal refactor.✓ Скопировано
    → Diffs introducing a port or DTO

Итог: A PR that doesn't silently degrade the architecture.

Сочетать с: github

Progressively refactor an existing Symfony app toward hexagonal

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

Когда использовать: Big-bang rewrite is off the table; you want incremental cleanup.

Поток
  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?✓ Скопировано
    → Specific class identified with extraction plan
  2. Extract incrementally
    Walk me through the extraction in 3 PR-sized steps.✓ Скопировано
    → Staged plan with tests preserved at each step

Итог: A legacy codebase getting better, one PR at a time.

Подводные камни
  • Extracting too much in one step — PR-sized slices only; the plugin's review agent helps gate each step
Сочетать с: git

Комбинации

Сочетайте с другими MCP — эффект x10

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.✓ Скопировано
symfony-hexagonal-skill + filesystem

Apply scaffolds into the actual repo

Apply the context scaffold to my project under src/.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
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

Стоимость и лимиты

Во что обходится

Квота API
None
Токенов на вызов
Moderate — reviews scan files
Деньги
Free
Совет
Scope reviews to the diff, not whole repos, to save tokens.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: None
Исходящий трафик: None from skill

Устранение неполадок

Частые ошибки и исправления

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

Альтернативы

symfony-hexagonal-skill в сравнении

АльтернативаКогда использоватьКомпромисс
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

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills