skill-clean-architecture
Overview
This skill enforces Clean Architecture and Domain-Driven Design (DDD) principles across any codebase. When invoked, it identifies the current software architecture (or lack thereof), detects layer violations and anti-patterns, and either recommends improvements within the existing architecture or recommends the best architecture for the project's size and complexity. It applies the essential 4-layer model (Domain, Application, Infrastructure, Interface) without over-engineering.
Trigger phrases: "clean architecture", "DDD", "analyze architecture", "layer violations", "dependency rule", "refactor architecture", "identify architecture", "recommend architecture", "architecture audit".
Parameters
The agent requires access to the project's source files. Before starting, confirm:
| Input | Required | Description |
|---|---|---|
| Project source directory | Yes | The root path or src/ folder to scan |
| Framework / language | Auto-detected | Detected from package.json, file extensions, config files |
| Mode | Optional | identify (detect current arch), recommend (suggest best arch), or enforce (apply Clean Architecture patterns) |
Returns
This skill produces one or more of the following outputs depending on mode: