iCode Agent · Guide · Workflow
Refactorisez un module.
Refactoriser, c’est surtout comprendre : qui appelle ceci, ce que cela appelle et ce qui doit rester vrai pendant que la structure change. iCode Agent fait cette cartographie sur le code réel avant de modifier quoi que ce soit.
La tâche
Nommez le module et la modification souhaitée, puis laissez-le d’abord cartographier l’impact :
Refactor src/report/builder.ts. Extract the formatting into a separate module, update all callers, and make sure the tests still pass.
Nommer le fichier délimite le travail. Si vous ne savez pas où la modification doit aller, décrivez l’objectif et laissez l’agent trouver la limite — mais une cible nommée garde la modification concentrée.
Ce qui se passe
- Cartographier.
grepetfindlocalisent les appelants du module ;readaffiche le code avec les numéros de ligne pour que l’agent voie la structure au lieu de la deviner. - Planifier la modification. Il identifie ce qui bouge, ce qui reste et chaque appelant à mettre à jour.
- Modifier par petites étapes.
editremplace un segment exact à la fois et affiche le diff, afin que la révision voie la modification, pas un fichier réécrit. - Garder les tests au vert. Il exécute votre suite — le filet de sécurité qui rend un refactor sûr plutôt que risqué.
Rien n’est réécrit en bloc : edit modifie un segment ciblé et write ne sert qu’aux fichiers réellement nouveaux. Le diff est toujours visible avant que vous l’acceptiez.
Relire le diff
C’est là que vous tirez la valeur : l’agent propose, vous décidez. Un bon prompt pour un refactor demande un raisonnement vérifiable, pas seulement un résultat :
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 une modification est mauvaise, orientez en cours de tâche plutôt que de revenir en arrière après coup — l’agent n’a rien commité, une réorientation coûte donc peu.
De bons prompts pour ce workflow
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.
Le dernier est délibérément en lecture seule : demandez l’analyse, lisez-la, puis demandez la modification. Pour un gros refactor, c’est souvent la meilleure approche.