iCode Agent · Guía · Flujo de trabajo

Refactoriza un módulo.

Refactorizar consiste sobre todo en entender: qué llama a esto, a qué llama y qué debe seguir siendo cierto mientras cambia la forma. iCode Agent hace ese mapeo contra el código real antes de editar nada.

La tarea

Nombra el módulo y el cambio que quieres, y deja que primero mapee el alcance del impacto:

Refactor src/report/builder.ts. Extract the formatting into a
separate module, update all callers, and make sure the tests still pass.

Indicar el archivo acota el trabajo. Si no tienes claro dónde va el cambio, describe el objetivo y deja que el agente encuentre el límite, pero un objetivo concreto mantiene el cambio enfocado.

Qué ocurre

  1. Mapéalo. grep y find localizan quién llama al módulo; read muestra el código con números de línea para que el agente vea la estructura en lugar de adivinarla.
  2. Planifica el cambio. Identifica qué se mueve, qué se queda y cada llamada que debe actualizarse.
  3. Edita en pasos pequeños. edit sustituye un tramo exacto cada vez y muestra el diff, para que una revisión vea el cambio, no un archivo reescrito.
  4. Mantén los tests en verde. Ejecuta tu suite: la red de seguridad que hace que una refactorización sea segura y no arriesgada.

Nada se reescribe por completo: edit cambia un tramo concreto y write solo se usa para archivos realmente nuevos. El diff siempre está visible antes de que lo aceptes.

Revisar el diff

Aquí es donde se obtiene el valor: el agente propone, tú decides. Un buen prompt para una refactorización pide un razonamiento que puedas comprobar, no solo un resultado:

Refactor the auth module. Show me the callers you found first,
then make the smallest change that removes the duplication.
Run the tests after each file you touch.

Si un cambio va mal, dirige al agente a mitad de tarea en lugar de revertir después; como no ha hecho ningún commit, redirigirlo es barato.

Buenos prompts para este flujo de trabajo

Find every caller of parseConfig() before changing its signature.
Extract the duplicated retry logic into one helper and update both call sites.
Explain what this module does, then suggest a refactor — but make no edits yet.

El último es deliberadamente de solo lectura: pide el análisis, léelo y luego pide el cambio. Para una refactorización grande, suele ser la mejor forma.