Volver a Claude Code
Claude CodeIntermedio2 min de lectura

Playbook Claude para Refactor de Tamaño Medio

Guía intermedia para dividir refactors de varios días en lanes seguros con checkpoints revisables.

refactorintermediateworkflowreview

Referencias Oficiales: Sub-agents · Agent Teams · Best Practices

El problema intermedio es coordinación

En esta etapa, el reto no es escribir código: es alinear alcance, evidencia y ownership.

Lanes recomendados:

  • lane de implementación
  • lane de verificación
  • lane de review

Paso 1: dividir por fronteras independientes

No dividas por disponibilidad de personas; divide por límites de módulo.

Paso 2: contrato de lane

Cada lane debe entregar:

  • estado de objetivo
  • evidencia
  • alcance de diff
  • nota de riesgo
  • siguiente owner

Paso 3: checkpoints por chunk significativo

Tras cada chunk:

  1. correr checks
  2. revisar alcance
  3. registrar handoff corto

Así evitas un diff final imposible de revisar.

Paso 4: rollback simple

  • evitar commits mezclados (feature + refactor)
  • mantener historia legible
  • documentar renames de riesgo

Anti-patrones intermedios

"Lo limpiamos al final"

Suele terminar en caos de merge.

Ownership difuso de review

Retrasa aprobación final.

Posponer ajustes de tests

Degrada la señal de calidad al cierre.

Checklist rápido

Antes de merge:

  • contrato de lane completo
  • evidencia fresca por chunk
  • diff final alineado con alcance declarado
  • ruta de rollback clara

Eso separa "código cambiado" de "refactor entregado".

Guías Conectadas