docs(methodology): estrategia de automatización de validación

Agrega:
- AUTOMATION_STRATEGY.md: roadmap de 5 fases desde validación 100%
  humana hasta pipeline multi-agente
- PATTERNS.md: patrón C.5 (validaciones programáticas en prompt) +
  nota en C.1 sobre evolución a fases superiores
- PRINCIPLES.md: extensión del Principio 5 con distinción entre
  actividades irremplazables vs delegables del humano

Decisión: InQ ROI Sprint 1.5 permanece en Fase 1. Evolución a Fase 2
después de Sprint 1.5 con criterios documentados.
This commit is contained in:
2026-05-16 21:38:43 -03:00
parent 01e57b1cd4
commit 293c225819
4 changed files with 257 additions and 0 deletions

View File

@@ -115,6 +115,11 @@ Si el output de la etapa es un artefacto visible (PDF, screenshot, página rende
- Páginas web: dev server en navegador
- Documentos: editor que renderice (no solo source)
**Cuándo evolucionar este patrón:** ver methodology/AUTOMATION_STRATEGY.md.
La validación visual humana es Fase 1. Puede complementarse con agentes
auditores (Fase 3) pero NO se reemplaza completamente hasta que el
equipo desarrolle criterio adversarial maduro.
---
### C.2 Validación programática antes de declarar completado (agente)
@@ -163,6 +168,44 @@ Análisis de píxeles del heatmap: verde 36.329px, ámbar 3.889px, rojo 3.713px
Text extraction confirma palabras clave: "InQ ROI", "Powered by InQuality", "Payback"
```
### C.5 Validaciones programáticas explícitas en el prompt
**Estado:** propuesto · **Deriva de:** Principios 2 y 5
Cada prompt de etapa incluye una sección **"Validaciones automatizadas mandatorias"** con criterios objetivos verificables por código que el agente debe ejecutar antes de declarar terminada la etapa o usar `present_files`.
**Por qué:** documenta explícitamente qué se va a auto-validar, hace transferible el conocimiento operativo al equipo, captura el aprendizaje sobre qué problemas son recurrentes y vale la pena chequear automáticamente.
**Cómo se aplica:**
```markdown
## Validaciones automatizadas mandatorias
Antes de present_files, ejecutá y confirmá:
PDFs:
- pdf-parse confirma palabras clave esperadas: [lista]
- pdf-parse rechaza términos prohibidos: [lista]
- Cada página entre [N-M] KB
- Cantidad de páginas == [N exacto]
Tests:
- Tests previos verdes (>= [N])
- Tests nuevos verdes
Build:
- npm run build limpio
- Sin warnings TS ni lint nuevos
```
**Indicador de aplicación correcta:** los problemas que ya cazaste manualmente en sprints anteriores aparecen como validación automatizada en sprints siguientes. Aprendizaje acumulativo.
**Indicador de violación:** el agente declara etapa terminada y vos cazás el mismo tipo de problema que ya cazaste 3 etapas atrás. Significa que el aprendizaje no se está capturando como validación.
**Relación con otros patrones:**
- Extiende **C.2** (validación programática) haciéndola explícita en el prompt
- No reemplaza **C.1** (validación visual humana) — son complementarias
- Es Fase 2 del roadmap de `AUTOMATION_STRATEGY.md`
---
## Categoría D — Estructura del repo