From acc
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.
How this skill is triggered — by the user, by Claude, or both
Slash command
/acc:create-anti-corruption-layerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate DDD-compliant Anti-Corruption Layer (ACL) components for isolating bounded contexts and integrating with external/legacy systems.
Generate 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 testsnpx claudepluginhub dykyi-roman/awesome-claude-code --plugin accImplements Clean Architecture, Hexagonal (Ports & Adapters), and Domain-Driven Design patterns in PHP 8.3+ with Symfony 7.x. For enterprise app architecture, legacy refactoring, DDD, and testable backends.
Generates Adapter pattern for PHP 8.4 to convert incompatible interfaces, wrap legacy code or external libraries like Stripe/AWS SDKs. Includes target interfaces, adapters, and unit tests.