Proyecto 6, el harness completo (capstone)

Qué piezas del coche son necesarias

Si quitas el aire acondicionado, el coche sigue andando. Si quitas los frenos, no. Con un harness pasa igual: no todo lo que montaste pesa lo mismo. Este proyecto final reúne los cinco anteriores y te enseña a distinguir lo imprescindible de lo que sobra. Repasa de observabilidad y estado limpio.

La tarea

Un conjunto fijo de tareas de varias funciones que cubra una porción completa del producto: importación de documentos, indexado, preguntas y respuestas con citas, observabilidad de runtime y un repo legible y reiniciable.

Las cuatro fases

1. Baseline débil: AGENTS.md básico, sin lista de funciones, sin handoff, sin checklist, sin scripts. Anota lo que observas.
2. Harness fuerte: AGENTS.md, CLAUDE.md, feature_list.json, init.sh, session-handoff.md, clean-state-checklist.md, documento de calidad y rúbrica.
3. Limpieza: el repo trae benchmark.sh y cleanup-scanner.sh para medir y detectar deriva. Pasa el escáner y vuelve a ejecutar.
4. Ablación: quita un componente cada vez y observa qué empeora.

El documento de calidad

Es una foto de la salud del código base: cada dominio de producto y cada capa arquitectónica reciben una nota de A a D (estado de verificación, legibilidad para agentes, estabilidad de tests, huecos). La rúbrica puntúa una entrega concreta; el documento de calidad puntúa el proyecto en el tiempo. Actualízalo tras cada sesión importante y antes de cada comparación.

El estudio de ablación paso a paso

Cada pieza del harness encierra una suposición sobre lo que el modelo no sabe hacer. Con modelos mejores, algunas suposiciones caducan.

1. Haz una foto del documento de calidad.
2. Quita un componente (por ejemplo, el handoff).
3. Ejecuta el mismo conjunto de tareas.
4. Haz otra foto.
5. Si las notas no bajaron, era peso muerto. Si bajaron, restáuralo.

| Componente quitado | Nota antes | Nota después | Decisión   |
| session-handoff.md | B          | C            | Restaurar  |
| quality-document   | B          | B            | Prescindible* |

*Prescindible para esta tarea y este modelo, no para siempre.