Cambiar herramientas, estructura y diseño de una web con Claude Code

A quién le sirve. Programadores con un proyecto grande que quieren cambiar herramientas de revisión y compilación, reorganizar el código o rediseñar su web con ayuda de un agente.

Qué hicieron

En un proyecto de 7 aplicaciones sobre Cloudflare Workers, con unos 1.670 archivos de TypeScript, Claude Code sustituyó Biome por oxlint y oxfmt, y después tsc por tsgo, en solicitudes de cambios separadas. También reorganizó una parte visible en módulos por funciones a partir de una especificación escrita por el desarrollador, y ayudó a rediseñar su web gracias a un archivo CLAUDE.md bien cuidado. En cada paso se ejecutaban revisión de código, comprobación de tipos, pruebas y compilación, y él leía el resultado.

Cómo salió

La revisión de código más la comprobación de tipos pasó de 29,04 s a 1,25 s, unas 23 veces más rápido. La solicitud de cambios de oxlint tocó más de 700 archivos. El rediseño de la web llevó un par de días en lugar de unas dos semanas.

Conviene saber

Planifica primero, divide el trabajo en fases con cambios pequeños y completos, y mide antes y después. No aceptes cambios que no entiendas.

Qué necesitas

• Claude Code con un plan de pago de Claude
• Un repositorio con pruebas, revisión de código y compilación que funcionen
• Un archivo CLAUDE.md bien cuidado con las normas de tu proyecto
• Una rama aparte de git, que es una copia de trabajo, para cada cambio

Cómo hacerlo tú, paso a paso

1. Escribe o actualiza tu archivo CLAUDE.md con las normas del proyecto: cómo se compila, cómo se prueban los cambios y qué convenciones sigues.
2. Mide el punto de partida: cuánto tarda hoy la revisión de código más la comprobación de tipos.
3. Pide primero un plan dividido en fases, con cambios pequeños y completos, cada uno en su propia rama y su propia solicitud de cambios (una propuesta de cambio para que otros la revisen).
4. Pega el prompt de esta ficha para el primer cambio de herramienta: que arregle lo que se rompa y repita hasta que todo esté en verde.
5. Lee el resultado de las comprobaciones en cada paso. No aceptes cambios que no entiendas.
6. Mide otra vez al acabar y compara con el punto de partida.
7. Para rediseñar la web, repite el método: una especificación escrita por ti, fases pequeñas y revisión visual de cada una.

En mi repositorio de [ruta], cambia las herramientas de revisión y formato del código a [por ejemplo oxlint y oxfmt] y arregla todo lo que se rompa. Ejecuta la compilación, las pruebas y la revisión tras cada cambio y repite hasta que todo pase. Trabaja en una rama aparte, resume lo que has cambiado y para cuando todo esté en verde, sin fusionar nada.

Consejos

• Planifica antes de pedir. Un buen plan evita cambios gigantes que nadie puede revisar.
• Mide antes y después para saber si el cambio ha merecido la pena.
• Si no entiendes un cambio, pídele que te lo explique antes de aceptarlo.

Preguntas frecuentes

Fuentes

• sergioazocar.com ↗

En el directorio desde el 3 de octubre de 2026.