Agent Harness Evolve

Que es

El arnes aprende o se pudre. Tres movimientos (references/reglas-y-retiro.md): (1) regla nueva — feedback recurrente de revision se convierte en una linea estructurada de AGENTS.md, con su modo de fallo nombrado; (2) playbook — preferencias estables y decisiones reconfirmables se extraen SIN secretos ni PII, con condicion de retiro propia; (3) retiro — un documento de gobierno cumplido sale del arbol vivo hacia su archive_location, porque un plan terminado que sigue en presente conserva autoridad que ya no tiene. [DOC]

Cuando usar

• Post-retro, post-review con patrones repetidos, o al cumplirse la meta del goal contract.
• NO para reparar drift mecanico ni para simplificar estructura.

Procedimiento

1. Junta el feedback fuente (reviews, loop-state ledgers, drift reports historicos).
2. Por cada patron repetido >= 2 veces: redacta la regla con modo de fallo y agregala como linea estructurada de AGENTS.md (el audit Q9 la puntua). [CÓDIGO]
3. Extrae playbook: solo preferencias explicitas y estables; excluye secretos, PII, hechos temporales y permisos de proyecto como universales. Declara condicion de retiro. [CONFIG]
4. Documentos cumplidos: redacta lo terminado en pasado, mueve a archive_location, actualiza referencias.
5. Re-audita: Q12 (retiro declarado) en verde. [CÓDIGO]
6. Si la regla propuesta cambia comportamiento y no solo documentacion, pruebala como experimento acotado antes de adoptarla: bounded-experiment (ExperimentSpec v2 con limite de ciclos y guards; su validate_spec valida la spec sin ejecutar nada). Una regla adoptada sin corrida acotada es una hipotesis. [CÓDIGO]

Contract

• Aceptacion: cada regla nueva nombra su modo de fallo; playbook sin PII y con retiro; cero docs cumplidos en el arbol vivo. [CÓDIGO]
• Limites: no inventa reglas sin >= 2 ocurrencias de evidencia; no borra historia (archiva). [EXPLICIT]
• Casos borde: regla que contradice una existente (resolver explicito, no acumular); playbook sin condicion de retiro (no se publica). [EXPLICIT]
• Supuestos: existe material fuente de aprendizaje. [SUPUESTO]
• Trade-off: archivar en vez de borrar cuesta espacio y compra trazabilidad. [EXPLICIT]

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): references/ guías de profundidad (cargar UNA por etapa) · knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · scripts/ automatización local · assets/ recursos estáticos.