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

methodology/TEMPLATES/REPORT_TEMPLATE.md

@@ -0,0 +1,100 @@
+# Sprint N — Etapa X: Reporte final
+
+> Reporte capturado al cierre de la etapa. Útil para auditoría y para reconstruir contexto en sesiones futuras.
+>
+> Generado por el agente, validado por el humano antes del commit.
+
+---
+
+## 1. Resumen de cambios
+
+### Archivos creados/modificados
+
+| Archivo | Acción | Líneas | Propósito |
+|---|---|---|---|
+| [path] | Creado/Modificado | +N/-M | [descripción breve] |
+
+---
+
+## 2. Tests
+
+### Resultados
+
+- Tests previos: N (sin regresión)
+- Tests nuevos: M
+- Total: N+M verdes
+
+### Tests nuevos agregados
+
+| Test | Caso | Resultado |
+|---|---|---|
+| [nombre] | [input → output esperado] | ✅ |
+
+---
+
+## 3. Artefactos visibles generados
+
+| Artefacto | Tamaño | Validación | Path |
+|---|---|---|---|
+| [PDF / screenshot / archivo] | XX KB | ✓ visualizado | [path] |
+
+---
+
+## 4. Verificación programática (si aplica)
+
+### Análisis de píxeles / contenido / métricas
+
+[Resultados concretos: qué se midió y qué dio]
+
+### Text extraction (si aplica)
+
+[Palabras clave esperadas confirmadas en el output]
+
+---
+
+## 5. Validado vs Asumido
+
+### Verificado
+- [Lista de cosas efectivamente comprobadas]
+
+### Asumido (no validado en esta etapa)
+- [Lista de cosas que se asumen funcionando pero no se probaron explícitamente]
+
+---
+
+## 6. Hallazgos no esperados
+
+[Cualquier descubrimiento durante la implementación que merezca decisión arquitectónica, aunque no esté en el DoD]
+
+- **Hallazgo 1:** [descripción]
+  - Impacto: [cuál]
+  - Decisión requerida: [qué tiene que decidir el humano]
+  - Sugerencia del agente: [recomendación]
+
+---
+
+## 7. Patrones aprendidos (cosecha para methodology/)
+
+[Si durante esta etapa surgió un patrón nuevo o se validó uno existente, registralo acá. El humano decide si pasa a `methodology/PATTERNS.md`.]
+
+- **Patrón candidato:** [descripción]
+  - Categoría: [A/B/C/D/E]
+  - Deriva de: [Principio N]
+  - Indicador de aplicación correcta: [...]
+  - Indicador de violación: [...]
+
+---
+
+## 8. Definition of Done — checklist final
+
+```
+[x] Criterio 1 cumplido
+[x] Criterio 2 cumplido
+[ ] Criterio 3 — pendiente porque [razón]
+```
+
+---
+
+## 9. Próximo paso
+
+[Qué viene después: etapa siguiente, decisión pendiente del humano, etc.]