orch-refine-code

Que fait orch-refine-code ?

Acteur · action · cible : orch · refine · code. Fine enveloppe autour du moteur partagé dans orch-pipeline.

Quand l'utiliser

• Même comportement, meilleure structure : extraire des modules, supprimer les duplications, éliminer le code mort, réduire l'imbrication, renommer pour plus de clarté.
• Distinguer des skills frères : si le comportement doit changer de quelque manière que ce soit, ce n'est pas le bon skill (orch-change-feature / orch-fix-defect).

Paramètres de fonctionnement

• Seuil de taille 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 sert de filet de sécurité.
• Première action (phase 4) : confirmer 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

1. Exécuter le moteur orch-pipeline avec les paramètres ci-dessus.
2. Pour les passages de code mort / duplication, déléguer à l'agent refactor-cleaner (il exécute knip / depcheck / ts-prune et supprime en toute sécurité).
3. S'arrêter à la Porte 1 (plan de restructuration) et à la Porte 2 (pré-commit).
4. Commiter sous refactor: — la différence doit être neutre en termes de comportement.

Exemple

orch-refine-code: extraire le client HTTP NWS de poller.py
→ confirmer tests verts → planifier extraction  [PORTE 1 : approuver]
→ déplacer par petites étapes, tests verts tout au long → révision de code
→ commit refactor:  [PORTE 2 : confirmer]