clean-architecture

name	clean-architecture
description	Reglas para desarrollo con Clean Architecture. Activar cuando el proyecto use capas domain/application/infrastructure/presentation.
trigger	always_on
type	rule

Cada vez que te pida realizar una arquitectura limpia debes seguir estas reglas:

Reglas para Clean Architecture

Principios

• Separación de responsabilidades estricta.
• El dominio NO depende de frameworks ni infraestructura.
• Las dependencias siempre apuntan hacia el dominio (Dependency Rule).

Capas

• Domain: entidades y lógica pura. No importa nada externo. Define interfaces (ports).
• Application: orquesta lógica de negocio. Solo depende de dominio.
• Infrastructure: implementa interfaces del dominio. HTTP, DB, APIs externas.
• Presentation: UI. Se conecta a Application, nunca directamente a Infrastructure.

Reglas de dependencias

• Domain → NO depende de nadie
• Application → depende de Domain
• Infrastructure → depende de Domain
• Presentation → depende de Application
• NUNCA: Domain → Infrastructure, Presentation → Infrastructure directamente

Diseño

• Entidades con comportamiento, no solo datos.
• Casos de uso con una responsabilidad clara, entrada/salida bien definida.
• Interfaces nombradas según intención: UserRepository, no PostgresUserRepository.
• Domain y application deben ser testeables sin infraestructura.

Anti-patrones

• Lógica de negocio en controladores.
• Acceso directo a DB desde use cases.
• Entidades de dominio como DTOs.
• Mezclar lógica de infraestructura con dominio.