¿Qué hace esta skill?

La Arquitectura Hexagonal Skill diseña, implementa y refactoriza sistemas basados en Puertos y Adaptadores con límites de dominio claros y inversión de dependencias. Define casos de uso con orquestación pura, puertos de salida que modelan capacidades sin acoplarse a tecnologías, y adaptadores que aíslan los detalles de infraestructura. Genera diseños testeables con fakes en memoria en TypeScript, Java, Kotlin y Go.

Funcionalidades nuevas mantenibles
Construye nuevas características donde la mantenibilidad y testeabilidad a largo plazo son críticas desde el primer commit.
Refactor de código acoplado
Desacopla lógica de dominio mezclada con concerns de I/O y frameworks, separando transporte de reglas de negocio.
Un caso de uso, múltiples interfaces
Soporta HTTP, CLI, workers de cola y cron jobs sobre el mismo caso de uso sin duplicar lógica.
Reemplazo de infraestructura
Cambia base de datos, APIs externas o bus de mensajes sin reescribir las reglas de negocio del dominio.

Ejemplos de uso

🚀 Sistema nuevo
Diseña la arquitectura hexagonal para un caso de uso de creación de pedidos en TypeScript con puertos de persistencia y pago.
🧹 Refactor
Refactoriza este controlador de Express que mezcla lógica de dominio con acceso a PostgreSQL aplicando puertos y adaptadores.
🔀 Multi-interfaz
Define el mismo caso de usuario de procesamiento de pagos para que funcione vía HTTP, CLI y un worker de cola sin duplicar lógica.
🔄 Cambiar infraestructura
Reemplaza el adaptador de PostgreSQL por uno de MongoDB sin tocar el caso de uso de creación de órdenes.

Características

Modelado de límites de caso de uso Define casos de uso únicos con DTOs de entrada y salida claros, manteniendo los detalles de transporte fuera del límite.
Puertos de salida por capacidad Identifica cada efecto secundario como un puerto que modela capacidades, no tecnologías concretas.
Casos de uso con orquestación pura El caso de uso recibe puertos por constructor, valida invariantes y devuelve estructuras planas sin acoplarse a I/O.
Adaptadores en el borde Los adaptadores de entrada y salida convierten contratos de protocolo a contratos de aplicación, sin tocar el dominio.
Composition root centralizado Instancia adaptadores e inyéctalos en los casos de uso en un único punto, evitando service locators ocultos.

Preguntas frecuentes

Aplica igual en TypeScript, Java, Kotlin y Go. Solo cambia la sintaxis y el estilo de wiring; el patrón de Puertos y Adaptadores es el mismo.
No. La skill genera diseños agnósticos a frameworks. Los adaptadores se implementan luego sobre la infraestructura que uses (Express, Spring, etc.).
Con unit tests que inyectan puertos fake en memoria, sin tocar infraestructura real. Los adaptadores se prueban con integration tests y los flujos con E2E.
Sí. La skill propone una estructura por feature con carpetas domain/application/adapters/composition, pero puedes adaptarla a tu convención de proyecto.

Skills relacionadas

Mas skills de la misma categoria:

Arquitectura Hexagonal — Puertos y Adaptadores con Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.