Prompt monolito
Síntoma: Un prompt de 4.000 líneas que mezcla rol, contexto, reglas y datos.
Corrección: Descomponer en rol, spec, contexto dinámico y ejemplos versionados.
Fundamentos · 04
Patrones de Diseño: el lenguaje común del software
Los patrones son soluciones nombradas a problemas recurrentes. Dominarlos es dominar el idioma en el que se comunica el diseño — y el idioma con el que instrumentamos a los agentes para que no tengan que reinventar nada.
Catálogo
Patrones clásicos y modernos
Antipatrones
Lo que debes detectar y eliminar
Agentes sin objetivo
Síntoma: Un agente "general" que no tiene criterio de éxito medible.
Corrección: Definir la spec con entrada, salida y rúbrica antes de escribir código.
RAG ciego
Síntoma: Se recupera todo, no se filtra, el modelo alucina con contexto irrelevante.
Corrección: Reranker, filtros de dominio y citación explícita.
Pruebas acopladas al LLM
Síntoma: Tests que dependen literalmente del texto devuelto.
Corrección: Evaluar por propiedades, contratos o LLM-as-judge con rúbrica.
Spec = documento PDF
Síntoma: La spec vive en Word, no en el repo; el código y la spec divergen.
Corrección: Specs versionadas junto al código, ejecutables o verificables.
Patrones + IA
Cómo los patrones mejoran la supervisión de agentes
Cuando un agente entrega código, la primera pregunta útil no es "¿funciona?". Es: ¿qué patrón implementa y por qué?. Si el agente no puede nombrar la solución que está aplicando, probablemente no está aplicando ninguna — está adivinando.
Por eso en SDD insistimos en redactar la spec en términos de patrones conocidos: "usa un Repository", "aplica Outbox", "expón esto como Tool". No es pedantería: es reducir la entropía de la generación y facilitar la revisión.
Los patrones de IA (Tool Adapter, RAG, LLM-as-Judge, Supervisor) son tan importantes hoy como lo fueron los GoF en los 90. Forman el vocabulario con el que se diseñan sistemas con agentes.