Auto-Revisión Pre-Confirmación
Antes de confirmar cambios significativos, repasa esta lista de verificación. Detecta problemas antes de que CI los detecte — o peor aún, antes de que los usuarios lo hagan.
Cuándo Usarlo
Ejecuta esta habilidad cuando se cumpla alguna de estas condiciones:
- Cambiaste más de 100 líneas de código
- Modificaste más de 5 archivos
- Tocaste infraestructura central (ejecutor, almacenamiento, bucles de despacho principales)
- Introdujiste nuevas abstracciones o APIs públicas
- Tienes dudas sobre casos límite o decisiones de diseño
Verificación rápida:
git diff --stat HEAD | tail -5 # ¿Cuánto cambió?
git diff --name-only HEAD | wc -l # ¿Cuántos archivos?
Omitir Si
- Cambio trivial (≤50 líneas, ≤3 archivos)
- Solo documentación o actualizaciones de lecciones
- Solo cambios de pruebas (las pruebas tienen su propia revisión)
- Corrección simple de una línea con alcance obvio y limitado
- Refactorización mecánica sin cambios de lógica
La Lista de Verificación
1. Casos Límite
- [ ] ¿Se manejan entradas nulas/vacías?
- [ ] ¿Se probaron condiciones de frontera (fuera por uno, listas vacías, cero)?
- [ ] ¿Se consideraron accesos concurrentes o condiciones de carrera?
- [ ] ¿Se consideró Unicode/codificación si se procesa texto?
2. Rutas de Error
- [ ] ¿Todas las excepciones se capturan en el nivel correcto (no demasiado amplio)?
- [ ] ¿Los mensajes de error son informativos (qué falló, por qué, qué hacer)?
- [ ] ¿Los modos de fallo fallan de forma elegante, no silenciosa?
- [ ] ¿No hay `except:` desnudo ni errores tragados?
3. Cobertura de Pruebas
- [ ] ¿Las rutas críticas tienen pruebas?
- [ ] ¿Los casos límite identificados arriba tienen pruebas?
- [ ] ¿Las pruebas realmente se ejecutan y pasan?
- [ ] ¿No quedaron esqueletos de prueba con `pass` o `...`?
4. Documentación
- [ ] ¿Los docstrings/comentarios coinciden con el comportamiento actual?
- [ ] ¿Se actualizó el README si cambió la interfaz pública?
- [ ] ¿El mensaje de confirmación captura qué cambió y por qué?
- [ ] ¿Los documentos de arquitectura relevantes siguen siendo precisos?
5. Calidad del Código
- [ ] ¿Los nombres son claros y consistentes con el código circundante?
- [ ] ¿No hay olores de código evidentes (funciones dios, números mágicos, rutas hardcodeadas)?
- [ ] ¿Sigue los patrones existentes en el archivo/paquete?
- [ ] ¿Pasa el análisis estático / typecheck?
Prueba de Humo de Una Línea
# Ejecutar antes de confirmar (adaptar a tu stack):
make format && make typecheck && pytest -x -q && echo "✅ Listo para enviar"
Si algún paso falla, arréglalo antes de confirmar. No envíes en rojo.
Antipatrones
| Antipatrón | Corrección |
|---|---|
| "CI lo atrapará" | CI es un último recurso, no un sustituto de tu propio criterio. Atrápalo primero. |
| "Agregaré pruebas después" | Después nunca llega. Escribe la prueba ahora o acepta la brecha permanentemente. |
| "Funcionó cuando lo probé manualmente" | Las pruebas manuales no son reproducibles. Escribe una prueba automatizada para que futuras sesiones también puedan verificarlo. |
| "El mensaje de error es un TODO" | Los mensajes de error TODO se envían como mensajes de error TODO. Escribe el mensaje real ahora. |
| "Puedo ver en el código que maneja este caso" | Si no está probado, una futura refactorización lo romperá invisiblemente. |
Por Qué Esto Importa
Los agentes autónomos están entrenados para producir resultados lo suficientemente buenos para evitar correcciones. Sin una puerta de revisión estructurada, las confirmaciones de código autónomas eluden la verificación humana que normalmente detecta regresiones y casos límite. Esta habilidad actúa como esa puerta: cinco lentes específicos ejecutados en secuencia para que nada obvio se escape.
La recompensa se acumula: cada paso de revisión que detecta un problema real ahorra un viaje de ida y vuelta de CI, evita un bug de usuario y evita un PR de reversión.
Relacionado
- Habilidad de Auto-Envío — verificación de calidad/pereza que complementa esta revisión estructural
- Habilidad de Revisión Multi-Lente — revisión paralela más profunda para cambios de alto riesgo