Runbook: Cómo cambiar harness sin caos

Propósito

Guía para cambios seguros en claude-method/harness/ tras la mañana de bomberos del 05-08-2026. Minimiza fricción, mantiene sincronía de copias, evita sesiones de bomberos >15 min.

Status: DRAFT (completaremos después de los primeros 3 cambios reales)

Checklist PRE-CAMBIO

Antes de tocar harness en claude-method:

• Dashboard: verificar que no hay alertas activas de “Harness drift” (si las hay, resolver primero)
• Log último harness-drift-check (lunes 07:30 UTC): ¿ejecutó OK? Si hace >8 días, esperar a próxima ejecución o forzar
• Comunicar en #ops-ia: “voy a cambiar harness en claude-method, esperado X min de downtime”

Checklist DURANTE-CAMBIO

En el commit de harness:

• Archivo(s) tocados: solo bajo claude-method/harness/ (no mezcles cambios funcionales del método)
• Si cambias checks (.py): duplica el cambio en los stubs de crearack-pro/scripts/harness/ Y crearacksl-workspace/scripts/harness/
• Prueba en tu perfil local: pre_commit_check.py antes de commit
• Si el cambio es mayor (plugin nuevo, rename de checks): abre PR en claude-method separada con descripción clara

Checklist POST-CAMBIO

Después del merge a claude-method:

• Los primeros 2-3 perfiles que ejecuten método: están alerta (pueden fallar si los checks son incompatibles — normal)
• Si fallo: abre issue en harness-leds o dashboard, describe el error
• NO fuerces el lanzamiento a todos los perfiles a la vez — deja que el lanzador estable re-intente
• Semanal (lunes 07:30): harness-drift-check ejecuta y reporta paridad
  • Si hay issues: alerta en dashboard → dev arregla las copias en Pro/workspace
  • Si no hay: auto-resolve

Anti-patrones (QUÉ NO hacer)

❌ Cambiar harness + cambiar lógica de método en el mismo commit
❌ Renombrar checks sin actualizar las copias en Pro/workspace
❌ Confiar en que “el próximo reindex lo sincronizará” (no es cierto; la copia vieja funciona en vacío)
❌ Resolver “harness drift” a mano en los 3 repos sin alterar la fuente (el vigía volverá a alertar)

Flujo recomendado para cambio complejo

Si necesitas cambiar harness + cambiar una copiar + cambiar un check:

1. Commit A (claude-method): cambio del harness solo → PR → merge
2. Esperar 1 ejecución de harness-drift-check (próximo lunes)
3. Commit B (crearack-pro): actualizar copia scripts/harness/ → PR → merge
4. Commit C (crearacksl-workspace): actualizar copia scripts/harness/ → PR → merge
5. Esperar próxima ejecución del vigía (auto-resolve si todo OK)

Tomar 1-2 semanas es normal; prisa causa bomberos.

Resolución de alertas de drift

Si el dashboard muestra "Harness drift: copia crearack-pro/scripts/harness/X.py ≠ fuente":

1. Abre el diff:

   git -C /opt/claude-method show origin/main:harness/X.py | diff - <(git -C /opt/crearack-pro show origin/main:scripts/harness/X.py)

2. Copie manualmente el archivo de la fuente:

   git -C /opt/crearack-pro show origin/main:harness/X.py > scripts/harness/X.py

3. Commit + push en crearack-pro:

   git -C /opt/crearack-pro add scripts/harness/X.py
   git -C /opt/crearack-pro commit -m "chore: sync harness copy from claude-method"
   git -C /opt/crearack-pro push origin main

4. Esperar próxima ejecución del vigía (lunes 07:30, o forzar si es urgente)
5. Auto-resolve: el dashboard limpiará la alerta automáticamente

Métricas de éxito

Apuesta #5 en WAGERS.md: los próximos 3 cambios de harness NO generan:

• Sesiones de bomberos >15 min en perfil distinto del autor
• Drift >7 días sin alerta

Verificar contra:

• Dashboard alertas (archivo + timestamp de resolución)
• WORKLOG bitácora (entrada de sesión fallida = bombero)

Referencias

• [[feature—ops—refuerzo-harness-05-08]] — contexto del refuerzo completo
• [[entity—functions—endpoint—harness-drift-run]] — cómo el vigía detecta drift
• Código base: claude-method/guides/HARNESS_ENGINEERING.md

Próximos pasos (no-bloqueantes)

• Registrar los 3 primeros cambios POST-refuerzo con timestamps + outcomes
• Si alguien tuvo bombero: documentar causa raíz + mejora en este runbook
• Plan para “eliminar copias scripts/harness/” (roadmap post-validación)

Véase también

• [[feature—ops—refuerzo-harness-05-08]]
• [[entity—functions—endpoint—harness-drift-run]]
• [[entity—functions—endpoint—harness-status]]
• [[concept—ci-cd—pre-commit-hooks]]