EIS-016 — Construir la sección «Cómo se construyó esta web» (caso práctico vivo, ciclo completo)

EIS-016 — Sección «Cómo se construyó esta web» (caso práctico vivo)

1. Contexto técnico

La sección meta: demuestra con esta misma web cómo se crea una app mediante construcción agéntica con Designio, cubriendo el ciclo completo, no solo la Fase 0. Publica tres bloques encadenados por el hilo de trazabilidad:

A) Pipeline de intención (Fase 0) — en orden: prompt fundacional → ADN Arquitectónico → MAP → ADR-001 (decisión de stack) → Documento de Requisitos (con huecos funcionales) → EIS atómicas (las 23) → registro del interrogatorio (AI-Refiner, sesiones 1 y 2) → acta de certificación/firma → plan de construcción acordado con el Intent Director.

B) Construcción (qué pasa después de las EIS) — por cada EIS construida se publica: su manifiesto de implementación (EIS-XXX.impl.md: criterio → test → resultado, justificación de diseño), los micro-ajustes del Delivery Lead si los hubo, y los ADRs menores surgidos durante la construcción. El log de sprint (qué se construyó cada día, generado de commits y manifiestos) cierra el bloque.

C) Evidencias de calidad post-construcción (la fase 5 del libro aplicada a esta web) — por sprint y accesible por EIS:

• Informe del Security Sentinel de esta web: la auditoría automática de CI (seguridad de cabeceras, secretos, dependencias, accesibilidad axe) con sus hallazgos y severidades — el equivalente local del Sentinel del libro (pp. 97-99).
• Health Score del sprint (0-100, umbral ≥ 98): compuesto publicado con sus vectores (seguridad, fidelidad a la EIS, mantenibilidad, rendimiento Lighthouse, cobertura).
• Pruebas unitarias: resultados y cobertura (objetivo ≥ 90 % sobre lógica nueva).
• Pruebas e2e y smoke tests: resultados de Playwright (criterios de aceptación marcados // Criterio:) y de los smoke tests post-despliegue (la web viva responde, HTTPS válido, rutas críticas 200).
• Validación humana: la firma de cierre del Intent Director por EIS (el «OK Final»).

D) WORM — el registro de trazabilidad inmutable — la «caja negra del sprint» (libro, p. 110) de este proyecto: una vista que consolida, con hashes, la cadena EIS firmada → ADRs → commits → reportes del Sentinel → resultados de pruebas → firmas → despliegue. En este proyecto el WORM práctico es el historial Git firmado por convención EIS-XXX: más los manifiestos versionados: la vista lo hace navegable y explica honestamente qué garantiza (hashes y trazabilidad pública) frente al WORM corporativo del libro (S3 Object Lock / Immutable Storage).

2. Restricciones de arquitectura

• Página índice con el hilo de trazabilidad (motivo del ADN §8.3) conectando los 4 bloques A→B→C→D; cada nodo enlaza a su artefacto o evidencia.
• Todos los artefactos provienen de docs/ versionado (fuente única, EIS-004); las evidencias de calidad (cobertura, e2e, Lighthouse, Health Score) se generan en CI y se publican como datos de la colección artefactos — sin redacción manual.
• El Health Score se calcula con los 5 vectores del libro (pp. 99-100) adaptados a esta web y su fórmula se muestra junto al valor (transparencia).
• La vista WORM muestra hash corto + enlace al commit; ningún hash se escribe a mano.
• Una introducción explica el ciclo en 7 pasos (espejo del sprint del libro) y enlaza a la página Metodología.

3. Criterios de aceptación (Test-Driven Intent)

criterios:
  - id: C1
    given: "la sección publicada"
    when: "se recorre el índice"
    then: "los 4 bloques (pipeline de intención, construcción, evidencias de calidad, WORM) aparecen en orden con cada artefacto, su estado y su versión"
  - id: C2
    given: "un visitante escéptico"
    when: "abre el registro del interrogatorio"
    then: "puede leer las preguntas reales del AI-Refiner y las respuestas reales del Intent Director (sesiones 1 y 2)"
  - id: C3
    given: "una EIS construida y cerrada"
    when: "se consulta su ficha en la sección"
    then: "muestra manifiesto de implementación, cobertura unitaria, resultado e2e/smoke, hallazgos del Sentinel, Health Score y la firma de cierre del Intent Director"
  - id: C4
    given: "la vista WORM"
    when: "se inspecciona cualquier entrada"
    then: "expone la cadena EIS→ADR→commit→evidencias→firma con hashes enlazados al historial real, y la nota que distingue lo que garantiza de lo que facilita"
  - id: C5
    given: "un nuevo artefacto o evidencia generado por la CI"
    when: "se reconstruye el sitio"
    then: "aparece en su bloque sin tocar HTML"

4. Definition of Done

• Sección navegable con: bloque A completo (artefactos 01-07 + plan), bloque B/C alimentándose automáticamente a medida que se construyen EIS, y vista WORM operativa con hashes reales del repositorio.