Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven Design in PHP 8.3+ with Symfony 7.x. Use when architecting enterprise PHP applications with entities/value objects/aggregates, refactoring legacy code to modern patterns, implementing domain-driven design with Symfony, or creating testable backends with clear separation of concerns.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Clean Architecture, Hexagonal Architecture & DDD for PHP/Symfony
## Overview
This skill provides guidance for implementing Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven Design patterns in PHP 8.3+ applications using Symfony 7.x. It ensures clear separation of concerns, framework-independent business logic, and highly testable code through layered architecture with inward-only dependencies.
## When to Use
- Architecting new enterprise PHP applications with Symfony 7.x
- Refactoring legacy PHP code to modern, testable patterns
- Implementing Domain-Driven Design in PHP projects
- Creating maintainable applications with clear separation of concerns
- Building testable business logic independent of frameworks
- Designing modular PHP systems with swappable infrastructure
## Instructions
### 1. Understand the Architecture Layers
Clean Architecture follows the dependency rule: dependencies only point inward.
```
+-------------------------------------+
| Infrastructure (Frameworks) | Symfony, Doctrine, External APIs
+-------------------------------------+
| Adapter (Interface Adapters) | Controllers, Repositories, Presenters
…
The line at the top of this page pins the label git:20260223.c6d4db1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_2q26acy5xthd5i5t
GET https://markdownregistry.com/api/v1/resolve?ref=giuseppe-trisciuoglio/developer-kit/clean-architecture
GET https://markdownregistry.com/api/v1/blob/e858338b7aaebb04c019c8c072f6b579c9f29d8ac0c19543b4989d1ee24eec57
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-ai/skills/prompt-engineering/SKILL.md · Provides workflows to write, debug, and optimize prompts for LLMs, including few-shot example selection…
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-aws/skills/aws-cloudformation/aws-cloudformation-auto-scaling/SKILL.md · Provides AWS CloudFormation patterns for Auto Scaling including EC2, ECS, and Lambda. Use when creating Auto Scaling…
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-aws/skills/aws-cloudformation/aws-cloudformation-dynamodb/SKILL.md · Provides AWS CloudFormation patterns for DynamoDB tables, GSIs, LSIs, auto-scaling, and streams. Use when creating…
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-aws/skills/aws-cloudformation/aws-cloudformation-ec2/SKILL.md · Provides AWS CloudFormation patterns for EC2 instances, Security Groups, IAM roles, and load balancers. Use when…
ciembor/agent-rules-books · clean-architecture/SKILL.md · Apply Robert C. Martin-inspired architecture rules when separating business policy from frameworks, databases, UI, or…
wondelai/skills · plugins/systems-architecture/skills/clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
wondelai/skills · clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
wondelai/skills · plugins/wondelai-skills/skills/clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
mindrally/skills · clean-architecture/SKILL.md · Guidelines for implementing Clean Architecture patterns in Flutter and Go applications, with emphasis on separation of…
