Introducción

Si en tu base de código se han acumulado código sin usar, lógica duplicada, abstracciones obsoletas, archivos grandes o patrones heredados que hacen que cada cambio cueste más de lo debido, considera refactorizarla para reducir la deuda técnica. Refactorizar consiste en mejorar la estructura del sistema existente sin convertir el trabajo en una migración a otra pila tecnológica.

Codex puede ayudarte a identificar primero los problemas del área y luego aplicar mejoras en etapas pequeñas y fáciles de revisar. Puede eliminar rutas de ejecución sin usar, simplificar módulos grandes, unificar rutas duplicadas, modernizar patrones antiguos del framework y reforzar la validación en cada etapa.

El objetivo es mejorar la base de código actual:

1. Elimina el código sin usar, las funciones auxiliares obsoletas, los flags antiguos y las capas de compatibilidad que ya no se necesitan.
2. Reduce el tamaño de los módulos difíciles de seguir. Extrae funciones auxiliares, divide componentes o mueve los efectos secundarios a puntos donde los límites entre responsabilidades sean más claros.
3. Sustituye los patrones heredados por las convenciones actuales del repositorio: primitivas más recientes del framework, tipos más claros, un flujo de estado más sencillo o utilidades de la biblioteca estándar.
4. Mantén estable el comportamiento público y reduce el esfuerzo que requerirá el próximo cambio.

Cómo usar Codex

1. Antes de editar, pídele a Codex que examine el área e identifique los módulos difíciles de seguir, la lógica duplicada, el código sin usar, las pruebas, los contratos públicos y los patrones que ya no se ajustan a las convenciones del repositorio.
2. Aborda un solo tipo de mejora a la vez: elimina código sin usar, simplifica el flujo de control, moderniza un patrón obsoleto o divide un archivo grande en partes más pequeñas, cada una con un responsable claro.
3. Antes de que Codex modifique los archivos, pídele que describa el comportamiento actual, la mejora estructural que propone y la comprobación mínima que debería bastar para confirmar que el comportamiento se mantiene.
4. Después de cada etapa, revisa los cambios y ejecuta la comprobación más sencilla que resulte útil, en lugar de agrupar todas las mejoras en un solo diff.
5. Trata los cambios en la pila tecnológica, las migraciones de dependencias y los cambios de arquitectura como tareas independientes, salvo que sean necesarios para completar la refactorización.

Aprovecha los ExecPlans

La guía práctica de modernización de código presenta los ExecPlans, documentos que permiten a Codex mantener una visión de conjunto de la refactorización, detallar el resultado esperado y registrar la validación después de cada etapa. Son útiles cuando la refactorización abarca varios módulos o requiere más de una sesión. Úsalos para registrar qué se eliminó, qué patrones se actualizaron, qué contratos debían mantenerse estables y qué trabajo quedó para más adelante.

Usa habilidades para tareas recurrentes

Las habilidades son útiles cuando se aplican las mismas reglas de refactorización en distintos repositorios, servicios o equipos. Usa habilidades específicas del framework cuando estén disponibles e incorpora habilidades de seguridad e integración continua para los cambios que impliquen riesgos. Crea una habilidad para tu equipo cuando tengas una lista de verificación probada para eliminar código sin usar, extraer módulos o modernizar patrones heredados. Si necesitas repetir la misma tarea de modernización en más de una base de código, Codex puede ayudarte a convertir la primera ejecución exitosa en una habilidad reutilizable.