Generates PHP 8.4 DDD Anti-Corruption Layers with adapters, translators, facades, DTOs, exceptions, and tests to isolate domain models from external systems or bounded contexts.
From accnpx claudepluginhub dykyi-roman/awesome-claude-code --plugin accThis skill uses the workspace's default tool permissions.
references/examples.mdreferences/templates.mdGenerate DDD-compliant Anti-Corruption Layer (ACL) components for isolating bounded contexts and integrating with external/legacy systems.
| Scenario | Example |
|---|---|
| Legacy system integration | ERP, CRM, mainframe |
| Third-party API integration | Payment gateway, shipping API |
| Bounded context communication | Order ↔ Inventory contexts |
| Database migration | Old schema → new domain model |
| Microservice integration | External service with different model |
YOUR BOUNDED CONTEXT
├── DOMAIN LAYER
│ └── Port (Interface) ←────────────┐
│ │
├── ANTI-CORRUPTION LAYER │
│ ├── Adapter (implements Port) ────┘
│ ├── Translator (Domain ↔ External)
│ ├── Facade (External system wrapper)
│ └── External DTOs
│
└── EXTERNAL SYSTEM (Legacy, API, other bounded context)
Path: src/Domain/{BoundedContext}/Port/
{ExternalSystem}PortInterface.php — Domain interface for external systemPath: src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/DTO/
{ExternalSystem}{Concept}DTO.php — DTOs matching external formatPath: src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/
{ExternalSystem}Translator.php — Domain ↔ External conversionPath: src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/
{ExternalSystem}Facade.php — Simplified external system interfacePath: src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/
{ExternalSystem}Adapter.php — Implements domain portPath: src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/Exception/
{ExternalSystem}Exception.php — Domain exception{ExternalSystem}ConnectionException.php — Infrastructure exception{ExternalSystem}TranslatorTest.php — Translation tests{ExternalSystem}AdapterTest.php — Adapter integration tests| Component | Path |
|---|---|
| Domain Port | src/Domain/{BoundedContext}/Port/{ExternalSystem}PortInterface.php |
| External DTO | src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/DTO/ |
| Translator | src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/{ExternalSystem}Translator.php |
| Facade | src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/{ExternalSystem}Facade.php |
| Adapter | src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/{ExternalSystem}Adapter.php |
| Exceptions | src/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/Exception/ |
| Tests | tests/Unit/Infrastructure/{BoundedContext}/ACL/{ExternalSystem}/ |
| Component | Pattern | Example |
|---|---|---|
| Port | {ExternalSystem}PortInterface | PaymentGatewayPortInterface |
| DTO | {ExternalSystem}{Concept}DTO | StripeChargeDTO |
| Translator | {ExternalSystem}Translator | StripeTranslator |
| Facade | {ExternalSystem}Facade | StripeFacade |
| Adapter | {ExternalSystem}Adapter | StripeAdapter |
| Exception | {ExternalSystem}Exception | StripeException |
interface {ExternalSystem}PortInterface
{
public function {operation}({DomainParameters}): {DomainReturnType};
}
final readonly class {ExternalSystem}Translator
{
public function toDomain({ExternalSystem}DTO $dto): {Entity};
public function toExternal({Entity} $entity): {ExternalSystem}DTO;
}
final readonly class {ExternalSystem}Adapter implements {ExternalSystem}PortInterface
{
public function __construct(
private {ExternalSystem}Facade $facade,
private {ExternalSystem}Translator $translator,
) {}
public function {operation}({DomainParameters}): {DomainReturnType}
{
$dto = $this->translator->toExternal($entity);
$result = $this->facade->{externalOperation}($dto);
return $this->translator->toDomain($result);
}
}
// Domain port interface
interface PaymentGatewayPortInterface
{
public function charge(Payment $payment): PaymentId;
public function refund(PaymentId $paymentId, Money $amount): void;
}
// Adapter implementation
final readonly class StripeAdapter implements PaymentGatewayPortInterface
{
public function charge(Payment $payment): PaymentId
{
$stripeCharge = $this->translator->toStripeCharge($payment);
$result = $this->facade->createCharge($stripeCharge);
return $this->translator->toPaymentId($result);
}
}
| Anti-pattern | Problem | Solution |
|---|---|---|
| Domain using external DTOs | External concepts leak into domain | Always translate at ACL boundary |
| Translator in domain layer | Infrastructure concern in domain | Keep translator in infrastructure |
| Exposing external exceptions | Coupling to external system | Wrap in domain exceptions |
| Direct API calls from domain | No isolation | Use port/adapter pattern |
| Shared DTOs across ACLs | Coupling between integrations | Each ACL has own DTOs |
| Business logic in translator | Wrong responsibility | Translator only maps data |
# services.yaml
Domain\Payment\Port\PaymentGatewayPortInterface:
alias: Infrastructure\Payment\ACL\Stripe\StripeAdapter
Infrastructure\Payment\ACL\Stripe\StripeFacade:
arguments:
$client: '@stripe.client'
For complete PHP templates and examples, see:
references/templates.md — Domain Port, External DTO, Translator, Facade, Adapter, Exception templatesreferences/examples.md — Stripe Payment Gateway ACL complete example and testsProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.