Activation Contract / Contrato de activación
Usa esta skill cuando un comportamiento recurrente necesita una colaboración explícita entre objetos, módulos o servicios. No la uses para añadir nombres de patrones sin presión de diseño real.
Hard Rules / Reglas estrictas
- Empieza por el problema, sus fuerzas y la alternativa más simple; el patrón es la consecuencia.
- No uses herencia cuando composición resuelva el cambio con menor rigidez.
- No introduzcas distribuido, colas, CQRS, event sourcing o sagas sin necesidad de escala, consistencia o autonomía demostrada.
- Un patrón debe reducir acoplamiento o clarificar responsabilidades; si solo añade indirección, elimínalo.
Decision Gates / Puertas de decisión
| Problema |
Patrón candidato |
Coste a validar |
| Algoritmo intercambiable |
Strategy |
Más tipos y selección explícita. |
| API externa incompatible |
Adapter / Anti-Corruption Layer |
Traducción y mantenimiento de contrato. |
| Construcción compleja |
Builder / Factory |
Abstracción innecesaria si hay pocos casos. |
| Eventos dentro de un límite |
Observer / Command |
Orden, errores e idempotencia. |
| Fallos transitorios remotos |
Retry, Circuit Breaker, Bulkhead |
Latencia, carga y observabilidad. |
| Consistencia entre servicios |
Outbox, Saga, idempotencia |
Complejidad operacional y compensación. |
Execution Steps / Pasos de ejecución
- Describe el problema sin nombrar un patrón.
- Enumera fuerzas, invariantes, cambios esperados y alternativa simple.
- Selecciona el patrón mínimo y define colaboradores y contratos.
- Prueba el comportamiento observable y sus fallos.
- Documenta beneficio, coste, señales de mal uso y criterio para retirarlo.
Output Contract / Contrato de salida
Para cada decisión entrega problema, patrón, alternativa simple, beneficios, costes, límites y pruebas requeridas.
References / Referencias
-
eferences/catalogo-patrones.md — catálogo de familias y alternativas.
AGENTS.md — catálogo GoF y arquitecturas.
skills/software-architecture/SKILL.md — límites y dirección de dependencias.
1---2name: design-patterns3description: Disparador: patrón de diseño, GoF, integración, resiliencia, sistema distribuido. Selecciona patrones por problema y coste.4license: Apache-2.05---67## Activation Contract / Contrato de activación89Usa esta skill cuando un comportamiento recurrente necesita una colaboración explícita entre objetos, módulos o servicios. No la uses para añadir nombres de patrones sin presión de diseño real.1011## Hard Rules / Reglas estrictas1213- Empieza por el problema, sus fuerzas y la alternativa más simple; el patrón es la consecuencia.14- No uses herencia cuando composición resuelva el cambio con menor rigidez.15- No introduzcas distribuido, colas, CQRS, event sourcing o sagas sin necesidad de escala, consistencia o autonomía demostrada.16- Un patrón debe reducir acoplamiento o clarificar responsabilidades; si solo añade indirección, elimínalo.1718## Decision Gates / Puertas de decisión1920| Problema | Patrón candidato | Coste a validar |21| --- | --- | --- |22| Algoritmo intercambiable | Strategy | Más tipos y selección explícita. |23| API externa incompatible | Adapter / Anti-Corruption Layer | Traducción y mantenimiento de contrato. |24| Construcción compleja | Builder / Factory | Abstracción innecesaria si hay pocos casos. |25| Eventos dentro de un límite | Observer / Command | Orden, errores e idempotencia. |26| Fallos transitorios remotos | Retry, Circuit Breaker, Bulkhead | Latencia, carga y observabilidad. |27| Consistencia entre servicios | Outbox, Saga, idempotencia | Complejidad operacional y compensación. |2829## Execution Steps / Pasos de ejecución30311. Describe el problema sin nombrar un patrón.322. Enumera fuerzas, invariantes, cambios esperados y alternativa simple.333. Selecciona el patrón mínimo y define colaboradores y contratos.344. Prueba el comportamiento observable y sus fallos.355. Documenta beneficio, coste, señales de mal uso y criterio para retirarlo.3637## Output Contract / Contrato de salida3839Para cada decisión entrega problema, patrón, alternativa simple, beneficios, costes, límites y pruebas requeridas.4041## References / Referencias4243- 44eferences/catalogo-patrones.md — catálogo de familias y alternativas.4546- `AGENTS.md` — catálogo GoF y arquitecturas.47- `skills/software-architecture/SKILL.md` — límites y dirección de dependencias.