omaromar9091/clean-architecture-skill

Una habilidad calibrada de Claude para Arquitectura Limpia, SOLID y desacoplamiento de componentes — escalada según el tamaño de la tarea, respaldada por ejemplos reales de código en múltiples lenguajes y honesta sobre los compromisos que los frameworks reales imponen.

¿Qué es clean-architecture-skill?

Esta habilidad de Claude está diseñada para ayudar a desarrolladores y agentes de IA a aplicar principios de Arquitectura Limpia, SOLID y desacoplamiento de componentes de manera práctica y escalable. A diferencia de guías teóricas, esta habilidad se enfoca en ejemplos concretos de código en múltiples lenguajes (como TypeScript, Python o Java) y aborda de manera realista los compromisos que los frameworks modernos (como Spring, Django o Express) imponen al diseño limpio. Es útil tanto para tareas pequeñas (refactorización de una función) como para grandes proyectos (diseño de una arquitectura completa). Soporta plataformas como Claude Code, Cursor y Codex, y su documentación (SKILL.md) incluye patrones, anti-patrones y estrategias para mantener el desacoplamiento sin caer en la sobreingeniería. En resumen, es una guía honesta y práctica para lograr un código más mantenible y modular.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add omaromar9091/clean-architecture-skill

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace clean-architecture-skill?

Una habilidad calibrada de Claude para Arquitectura Limpia, SOLID y desacoplamiento de componentes — escalada según el tamaño de la tarea, respaldada por ejemplos reales de código en múltiples lenguajes y honesta sobre los compromisos que los frameworks reales imponen.

¿Qué hace?

Esta habilidad guía a Claude para producir código que siga los principios de Arquitectura Limpia y SOLID, adaptando el nivel de detalle a la complejidad de la tarea. Proporciona ejemplos prácticos en varios lenguajes de programación y reconoce cuándo los frameworks obligan a hacer concesiones.

Principios clave

  • Separación de responsabilidades: Mantén las capas de dominio, aplicación e infraestructura claramente separadas.
  • Inversión de dependencias: Depende de abstracciones, no de implementaciones concretas.
  • Escalabilidad: Aplica solo la estructura necesaria para la tarea actual, evitando sobreingeniería.

Ejemplos de uso

// Ejemplo en TypeScript: Interfaz de repositorio limpia
interface UserRepository {
  findById(id: string): Promise<User | null>;
  save(user: User): Promise<void>;
}
# Ejemplo en Python: Caso de uso limpio
class CreateUserUseCase:
    def __init__(self, repo: UserRepository):
        self.repo = repo
    
    def execute(self, data: UserData) -> User:
        user = User.from_data(data)
        self.repo.save(user)
        return user

Compromisos reales

  • Los frameworks como Spring o Django pueden forzar acoplamiento en las capas de infraestructura.
  • A veces es más pragmático aceptar una dependencia directa que crear una abstracción innecesaria.
  • La habilidad te ayuda a identificar cuándo es aceptable desviarse de la teoría.

Plataformas compatibles

  • Claude Code
  • Cursor
  • Codex

Licencia

MIT

Skills relacionados