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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user