Que fait orch-refine-code ?
Acteur · action · cible : orch · refine · code. Mince surcouche du moteur partagé dans orch-pipeline.
Quand l'utiliser
- Même comportement, meilleure structure : extraire des modules, supprimer la duplication, éliminer le code mort, réduire l'imbrication, renommer pour clarifier.
- Distinguer des compétences sœurs : si le comportement est censé changer du tout au tout, ce n'est pas la bonne compétence (
orch-change-feature/orch-fix-defect).
Paramètres d'opération
- Taille minimale par défaut : standard — les restructurations touchent plusieurs fichiers.
- Masque de phase : 0 → 2 (planifier la restructuration) → 4 (maintenir vert) → 5 → 6. Aucun nouveau test de comportement n'est écrit — la suite existante est le filet de sécurité.
- Première action (phase 4) : vérifier que les tests pertinents existent et sont verts avant de toucher au code ; si la couverture est faible, ajouter d'abord des tests de caractérisation. Ensuite, restructurer par petites étapes, en relançant les tests après chacune.
Comment ça fonctionne
- Exécuter le moteur
orch-pipelineavec les paramètres ci-dessus. - Pour les nettoyages de code mort / duplication, déléguer à l'agent
refactor-cleaner(il exécute knip / depcheck / ts-prune et supprime en toute sécurité). - S'arrêter à la Porte 1 (plan de restructuration) et à la Porte 2 (pré-engagement).
- Engager avec
refactor:— le diff doit être neutre en comportement.
Exemple
orch-refine-code: extraire le client HTTP NWS de poller.py
→ vérifier que les tests sont verts → planifier l'extraction [PORTE 1 : approuver]
→ déplacer par petites étapes, tests verts tout au long → révision de code
→ engager refactor: [PORTE 2 : confirmer]