Clean Architecture Php

The clean-architecture-php skill enables AI agents to generate PHP applications following Clean Architecture principles, ensuring separation of concerns and testability. It structures code so that business logic remains independent from external frameworks, databases, and UI layers.

When to use it

• Building new PHP backend systems requiring long-term maintainability and scalability.
• Refactoring legacy monolithic PHP codebases into modular, layered architectures.
• Creating projects where unit testing business rules without external dependencies is critical.
• Developing enterprise applications that must remain framework-agnostic (e.g., switching from Laravel to Symfony later).

Key capabilities

• Generates entity and value object classes adhering to domain-driven design.
• Structures application layers to isolate use cases from infrastructure concerns.
• Produces dependency injection configurations to decouple components.
• Enforces interfaces for external systems like databases or HTTP clients.

Example prompts

• "Create a PHP user management module using Clean Architecture with separate entity and repository classes."
• "Generate a Laravel project skeleton that strictly follows Clean Architecture principles, isolating business logic from the framework."
• "Write a use case class for processing payments that depends only on interfaces, not concrete database implementations."

Tips & gotchas

This skill is best suited for projects prioritizing structural integrity over rapid prototyping; initial setup may require more boilerplate than standard MVC patterns. Ensure your team understands the architectural boundaries to avoid accidentally leaking dependencies between layers.