Etapa 4 — Implementación
(Sección Etapa 4 pendiente de regeneración — fuente del arnés sin marcador ### Etapa 4 ni ## Etapa 4 detectable.)
El sub-gate 4.2 — validación visual del Stakeholder
A mitad de la Etapa 4, el arnés intercala un sub-gate humano para validar la dirección visual del producto antes de aterrizar el contenido sustantivo. El UX cierra una styleguide navegable (Parte A: catálogo completo de tokens y componentes; Parte B: screenshots por viewport aplicando el sistema sobre las pantallas principales) y un acta-diseno.md con render PDF y HTML subido a Drive. El PO redacta el correo de firma-visual al Stakeholder con resumen ejecutivo de la línea visual, los adjuntos y la URL del entorno de validación con la styleguide accesible.
El Stakeholder firma firma-visual (aprobación) o rechaza con feedback. Si firma, la implementación continúa hacia el cierre de Etapa 4. Si rechaza, retroceso al UX dentro de la propia Etapa 4 (no se vuelve a Etapas 2 o 3): el UX reformula la propuesta visual sobre el feedback recibido y el sub-gate se reabre con una nueva iteración. El Bloque A de infraestructura no retrocede ante un rechazo de S-2.
Flujos alternativos
El Director rechaza el cierre de etapa al firmar D-3
Si al cerrar Etapa 4 el Director detecta que alguna fase del plan-implementacion.md queda en estado distinto de ✅ sin excepción documentada, o que el inventario de scope (HU implementadas vs HU planificadas) no se ha poblado correctamente (viola CAL-045), bloquea D-3 y devuelve al equipo responsable la fase incompleta. El equipo cierra la fase y el Director vuelve a evaluar.
Aparece un gap bloqueante técnico imprevisto durante la construcción
Si durante la implementación un agente ejecutor (Arquitecto, SRE, Frontend, Backend, UX) descubre una decisión técnica firmada D-1 que no se puede materializar (por ejemplo, una dependencia que ya no existe, un patrón que rompe en producción), abre cruce mid-Etapa-4 al Arquitecto. Si la decisión exige modificar el stack respecto a tecnica.md v1, se abre ADR del proyecto documentando la nueva decisión, la firma simbólica del Director sobre el ADR autoriza el cambio, y el plan-implementacion.md se ajusta con las fases nuevas necesarias.
Privacidad bloqueante dispara abort en la regeneración del manual
En proyectos cuyo entregable es documentación generada desde otras fuentes (como este propio manual), el script generador puede abortar si el validador de privacidad detecta un literal sensible. El procedimiento firme es afinar el diccionario de sustituciones o ampliar el patrón bloqueante — nunca relajar las regex ni saltarse el validador con flags de exclusión. Cada iteración deja constancia fechada en memory.md con el literal descubierto y la sustitución elegida.
Documentación generada en esta etapa
| Artefacto | Propietario | Tipo |
|---|---|---|
etapa-4/plan-implementacion.md | Arquitecto | Markdown |
etapa-4/cumplimiento-plan.md (estado vivo de las fases) | Director | Markdown |
etapa-4/acta-diseno.md | UX | Markdown |
etapa-4/renders/acta-diseno.{pdf,html} | UX (snapshot inmutable a Drive — pieza de firma-visual) | PDF + HTML |
etapa-4/screenshots/* | UX (Parte B de la styleguide) | PNG por viewport |
etapa-4/correos/s2-*.txt | PO (correo al Stakeholder y respuesta de firma) | Texto plano |
| Código del producto en el repo del producto | Arquitecto, SRE, Backend, Frontend, UX según fase | Source + tests |
adr/NNNN-<slug>.md (si la implementación abre nuevas decisiones arquitectónicas) | Arquitecto | Markdown |
proyectos/<slug>/memory.md (entradas fechadas por cierre de fase) | Cada agente al cerrar fase | Markdown |