Aula interactiva · Clase 5Estado deseado
Qué cambia, para quién, con qué evidencia, antes de cuándo y bajo qué límites.
Clase 5 · Sistemas y agentes
Diseña trabajo que sabe avanzar, pedir ayuda y terminar.
Un agente útil no es un cargo imaginario. Es un contrato: objetivo, contexto, herramientas, plan, límites, evidencia y una condición explícita de cierre.
Objetivo verificableBucle acotadoHandoffsProyecto legible
Cuatro capas
Objetivo, plan, bucle y agente no son sinónimos.
Hipótesis de camino
Pasos revisables, dependencias, riesgos y puntos donde una decisión humana puede cambiar la ruta.
Ciclo de control
Observar, decidir, actuar, verificar y detenerse. Repetir no significa actuar sin límite.
Responsable acotado
Ejecuta una parte del plan con contexto, herramientas, Skill, presupuesto y definición de terminado.
Objetivo con contrato
“Mejorar ventas” no permite decidir ni cerrar.
| Pregunta | Respuesta OmniMarket |
|---|---|
| Qué cambia | La conversión de tres productos con stock suficiente. |
| Línea base | Conversión, sesiones y margen de los últimos 28 días. |
| Éxito | Mejora definida sin reducir margen bajo el guardarraíl. |
| Permitido | Analizar, priorizar y preparar una prueba. |
| Gate | Publicar, contactar o gastar exige aprobación. |
| Detención | Tres intentos, 90 minutos, permiso insuficiente o fuente no disponible. |
La métrica también necesita semántica. “Conversión” debe indicar numerador, denominador, moneda, zona horaria, productos incluidos y fuente. Si dos agentes calculan periodos o universos distintos, pueden ejecutar perfectamente y aun así entregar conclusiones incompatibles. El contrato conserva esas definiciones junto con el objetivo.
Interacción · Estado del bucle
La evidencia decide la transición.
Observar
Reúne línea base, periodo, fuente y calidad. Todavía no cambia nada.
Reúne línea base, periodo, fuente y calidad. Todavía no cambia nada.
El bucle no avanza por entusiasmo. Cada transición exige un recibo: una consulta reproducible para pasar de observar a planear; una aprobación identificable para pasar de borrador a ejecución; y una comparación contra la línea base para declarar resultado. Si el recibo no existe, el estado real es pendiente, unavailable o blocked.
Equipo OmniMarket
Divide por responsabilidad, no por personajes.
Investigación
Recibe pregunta y fuentes; entrega hechos, inferencias, fecha y vacíos.
Handoff 01Estrategia
Recibe evidencia; prioriza hipótesis, audiencia, oferta y métrica.
Handoff 02Producción
Recibe decisión aprobada; crea borradores y marca lo que exige autorización.
Handoff 03QA
Recibe entregable y criterios; devuelve pass, fail, unavailable o blocked con evidencia.
GateUn handoff no dice “listo”. Incluye artefacto, fuentes, decisiones, estado, riesgos, elementos pendientes y siguiente responsable.
La especialización sirve cuando reduce ambigüedad. Investigación no elige la oferta; estrategia no inventa hechos; producción no se aprueba a sí misma; QA no sustituye al dueño del negocio. Cada responsable puede devolver el trabajo con una razón estructurada, y el coordinador conserva quién decidió, con qué evidencia y qué cambió.
Proyecto legible
La estructura evita que cada agente empiece desde cero.
omnimarket/ ├─ AGENTS.md # reglas, roles y gates ├─ 00-brief/ # objetivo y aceptación ├─ 01-inputs/ # fuentes preservadas ├─ 02-work/ # análisis y borradores ├─ 03-deliverables/ # resultados revisables ├─ skills/ # procedimientos reutilizables └─ evidence/ # pruebas, decisiones y cierres
Los archivos no son decoración: reducen el costo del handoff. El brief conserva la decisión vigente; inputs preserva la fuente; work permite experimentar; deliverables contiene sólo salidas revisables; evidence guarda pruebas y cierres. Mezclar esas capas hace imposible saber qué era fuente, qué fue transformación y qué está autorizado.
Laboratorio OmniMarket
Construye un bucle de recuperación de ventas sin automatizar el daño.
Define el objetivoAudiencia, cambio, línea base, éxito y guardarraíl.
Dibuja cinco estadosPendiente, investigando, borrador, aprobación y cerrado.
Asigna responsablesCada rol recibe entradas y entrega un paquete observable.
Escribe transicionesQué evidencia permite avanzar, volver, bloquear o terminar.
Prueba el límiteDatos ausentes, desacuerdo, herramienta caída y aprobación negada.
Cierra con evidenciaResultado, comparación, riesgos residuales y decisión de iterar o detener.
Antipatrones
Más agentes no corrigen un contrato débil.
Objetivo infinito
“Sigue mejorando” no tiene línea base, presupuesto ni condición de cierre.
Plan rígido
Ignora evidencia nueva y convierte los pasos en obediencia ciega.
Bucle sin límite
Reintenta una fuente caída o un permiso negado hasta ocultar el bloqueo.
Roles duplicados
Dos agentes producen la misma decisión y nadie es dueño del cierre.
Handoff verbal
“Ya quedó” sin artefacto, fuentes ni estado obliga a rehacer contexto.
Éxito por actividad
Contar tareas ejecutadas sustituye la pregunta: ¿qué cambió?
Plantilla de salida
Contrato de sistema v1.
OBJETIVO: [cambio + audiencia + plazo] LÍNEA BASE: [métrica + fuente + periodo] ÉXITO Y GUARDARRAÍL: [resultado + límite] ESTADOS: [pendiente / trabajando / aprobación / cerrado / blocked] TRANSICIONES: [evidencia requerida] ROLES: [entrada → responsabilidad → salida] HERRAMIENTAS Y SKILLS: [permitidas] GATES: [publicar / contactar / gastar / borrar] PRESUPUESTO: [tiempo + intentos + costo] CIERRE: [done / no_op / unavailable / blocked] EVIDENCIA FINAL: [artefactos + comparación + riesgos]
Puente a producción
El sistema ya piensa. Ahora necesita memoria durable.
En la clase 6 convertimos los estados, identidades y eventos de OmniMarket en una base Supabase y una automatización n8n verificable.