docs(methodology): commit inicial del método de trabajo con agentes

methodology/CASE_STUDIES/inq-roi-sprint-1-5.md

@@ -0,0 +1,90 @@
+# Caso de estudio: InQ ROI Sprint 1.5
+
+> Primer caso completo del método aplicado en producción.
+>
+> **Período:** Mayo 2026
+> **Producto:** InQ ROI — herramienta de cálculo de costos y ROI para procesos BPMN
+> **Equipo:** 1 director técnico + Claude Code como agente de implementación
+> **Duración real:** ~ [completar al cierre]
+> **Sprint objetivo:** rediseño visual completo del producto con manual de marca InQ
+
+---
+
+## Acceso al material
+
+Todos los artefactos del sprint están versionados en el repo del producto:
+
+- **Brief del sprint:** `sprints/sprint-1-5/BRIEF.md`
+- **Prompts por etapa:** `sprints/sprint-1-5/ETAPA_X_PROMPT.md`
+- **Reportes por etapa:** `sprints/sprint-1-5/ETAPA_X_REPORT.md` (cuando se capturen)
+- **Audits:** `sprints/sprint-1-5/etapa-X-audit.md`
+- **Screenshots:** `tests/screenshots/etapa-X/`
+- **PDFs generados:** `tests/e2e/__output__/`
+
+---
+
+## Estructura del sprint
+
+11 etapas en orden:
+
+| # | Etapa | Estado | Patrón principal aplicado |
+|---|---|---|---|
+| 1 | Setup del sistema de diseño | ✅ Cerrada | A.1, B.4 |
+| 2 | Helper formatPayback + aplicación | ✅ Cerrada | C.3, E.1 |
+| 3 | Rediseño web app con identidad InQ | 🔄 En curso | C.1, C.4 |
+| 4 | PDF: header y footer compartidos | ⏳ Pendiente | |
+| 5 | PDF: layout híbrido portrait + landscape | ⏳ Pendiente | |
+| 6 | PDF: rediseño página 1 ROI | ⏳ Pendiente | |
+| 7 | PDF: páginas 3 y 4 ROI | ⏳ Pendiente | |
+| 8 | PDFs de Actual y Automatizado | ⏳ Pendiente | |
+| 9 | Badge ⚡ en BpmnCanvas | ⏳ Pendiente | |
+| 10 | Validación E2E final | ⏳ Pendiente | |
+| 11 | Documentación + Deploy | ⏳ Pendiente | |
+
+---
+
+## Lecciones documentadas
+
+### Patrones validados durante este caso
+
+[Se completa al cierre del sprint con la lista de patrones que se validaron en práctica]
+
+### Anti-patrones cazados durante este caso
+
+- **AP.1 — Tests verdes como aprobación final**: caso del PDF de heatmap embebido en blanco (origen en MVP previo al sprint)
+- **AP.2 — Pasamanos invertido**: notado por el director en Etapa 5, llevó a discusión meta sobre el método
+- **AP.3 — Racionalización de output anómalo**: PDF de 36 KB con 4 páginas (Etapa 4 inicial)
+- **AP.6 — Brief grande pegado en chat**: corregido a estructura `sprints/sprint-N/`
+
+### Decisiones arquitectónicas memorables
+
+- Heatmap saturado en lugar de pastel (decisión consciente vs propuesta inicial)
+- Layout híbrido portrait + landscape en PDFs (resolución del problema "diagramas BPMN no entran en A4 vertical")
+- font-weight 700 en CTAs para remediación WCAG parcial
+- Carátula del PDF eliminada — info integrada en header de página 1
+
+### Decisiones de producto memorables
+
+- Posicionamiento como herramienta interna de InQuality (no producto independiente)
+- Identidad propia (naranja) diferenciada de CONCILIA (morado) manteniendo familia visual
+- Regla de marca no negociable: "InQ" siempre I-n-Q
+- Detector de ROI inusual (>1000%) como feature de transparencia
+
+---
+
+## Métricas finales del sprint
+
+[Completar al cierre]
+
+- Cantidad de tests al inicio del sprint: 440
+- Cantidad de tests al cierre: [N]
+- Tamaño promedio de PDF inicial: [KB]
+- Tamaño promedio de PDF final: [KB]
+- Cantidad de screenshots de validación capturados: [N]
+- Cantidad de iteraciones de mockup: [N]
+
+---
+
+## Reflexión final
+
+[Completar al cierre del sprint con observaciones del director sobre qué funcionó, qué no, y qué cambiaríamos para el próximo proyecto]