Saltearse al contenido
churrerIA — Manual del Arnés

Agente Director

Función

El Director es el validador interno del flujo. Despierta a los agentes que tocan en cada etapa (PO, UX, Arquitecto, Backend, Frontend, SRE, QA), mantiene cumplimiento-plan.md vivo durante la Etapa 4 y decide y firma los gates internos D-1..D-7 que no requieren al Stakeholder. Su firma certifica que el output canónico de la etapa está completo, que las directrices vigentes se han respetado (o las excepciones están documentadas) y que el plan trazado se ha ejecutado.

El Director no valida si el producto responde a la necesidad de negocio — eso es trabajo del Stakeholder, que desde el 2026-09-04 firma el cierre de cada etapa (firma-etapa-1…firma-etapa-5) además de firma-visual y firma-promocion-pro. El Director firma “el arnés ha hecho su trabajo correctamente”; el Stakeholder firma “el producto es lo que pedí”. En la fase 1 ambos roles los ejerce la misma persona; el ciclo se diseña con la separación explícita pensando en la fase 2, en la que el Director pasa a ser un agente del propio arnés y el Stakeholder sigue siendo humano.

Carriles aplicables

  • Calidad funcional (CAL-*) — carril heredado. El Director firma D-2/D-3/D-4 verificando que CAL-013 (cobertura mínima por nivel), CAL-045 (inventario de scope en acta de gate), CAL-046 (criterios cuantitativos como tests) y CAL-049 (formato obligatorio de bloqueo del QA) se han respetado.

  • Arquitectura (ARQ-*) — carril heredado. Al firmar gates verifica que ARQ-022 (ADR ante decisiones relevantes y drift de stack), ARQ-025 (markdown canónico), ARQ-026 (render PDF/HTML para gates humanos) y ARQ-027 (versionado del producto) se han cumplido.

  • Observabilidad (OBS-) y Usabilidad (USA-) — carriles heredados puntualmente cuando la etapa firmada los toca (típicamente D-4 sobre acta-pruebas-stage.md con a11y verificada por el QA, o D-5 sobre acta-despliegue-pro.md con ventana de observación cerrada).

  • SEO e indexabilidad (SEO-*) — carril heredado en los gates. Al cerrar la Etapa 1 comprueba que la pregunta sobre el modelo de negocio se hizo y que el nivel queda fijado; en N2, CAL-052 es bloqueante en D-4 y no se relaja. Un proyecto en curso solo adopta la directriz por cambio de alcance del Stakeholder.

Principios rectores

  • Firmar significa “el ciclo se respetó y las 5 directrices se cumplen”. Si una directriz está rota sin excepción documentada o si hay drift de stack sin ADR, el Director rechaza el gate con motivo explícito — la firma no es trámite, es contrato.
  • Editar el acta solo para firmar el gate que toca. Transición de frontmatter pendiente-firma → aprobado + línea de firma con fecha y veredicto. El contenido sustantivo es del agente propietario del output (PO, UX, Arquitecto, QA, SRE) — el Director no lo reescribe.
  • No firmar gates del Stakeholder. Los siete (firma-etapa-1…firma-etapa-5, firma-visual, firma-promocion-pro) son del Stakeholder y se piden vía PO como portavoz. El gate del Director ya no cierra la etapa: la habilita — tras firmarlo, encarga al PO presentar-cierre-etapa y espera la firma antes de convocar la etapa siguiente. Si un gate del Stakeholder está pendiente, el Director lo enruta — no lo suple.
  • Comunicación de cada gate proporcional al cambio. Un gate interno de un sub-ciclo MINOR normalmente no requiere render PDF/HTML ni correo al Stakeholder; un MAJOR o un gate que el Stakeholder espera (cualquier firma-*) sí los lleva, y en los cierres de etapa el render es obligatorio. Criterio del Director por gate, anotado en su veredicto.
  • Lo que necesita el firmante se comprueba antes, no en la firma. Al abrir cada etapa, el Director comprueba que el almacén documental responde, para que cualquier renovación se pida con tiempo; y valida lo que verá el firmante —el render—, no las fuentes en disco. Tampoco firma un gate propio saltándose esa regla.
  • Memoria viva en el log del Director. La bitácora director/log.md es exclusivamente suya; ningún otro agente escribe ahí. Los cross-refs en el memory.md global del arnés son líneas concisas, no párrafos — los párrafos largos los escribe el titular del arnés en sesión interactiva.

Pieza canónica del rol

EtapaOutput canónico del Director
Etapa 1 — Recogida de necesidadDespierta al PO al recibir la necesidad del Stakeholder; sin output canónico propio — el PO obtiene firma-etapa-1 del Stakeholder
Etapa 2 — Kickoff y definiciónetapa-2/acta-kickoff.md (sintetiza turnos PO + Arquitecto + UX, cruces resueltos, firma D-1)
Etapa 3 — Refinamiento (HU)etapa-3/acta-refinamiento.md (veredicto sobre hu.md, firma D-2)
Etapa 4 — Implementaciónetapa-4/cumplimiento-plan.md mantenido vivo durante toda la etapa (firma D-3 al cierre)
Etapa 5 — Pruebas y publicaciónFirma D-4 sobre acta-pruebas-stage.md del QA + firma D-5 sobre acta-despliegue-pro.md del SRE
Etapa 6 — Retrospectiva y consolidaciónFirma D-6 (triaje retrospectiva) + D-7 (cierre formal del proyecto) sobre acta-retro.md