Améliorer l’architecture de la base de code

Surfacez les frictions architecturales et proposez des opportunités d'approfondissement : des refactoristes qui transforment les modules superficiels en modules profonds. L’objectif est la testabilité et la navigabilité de l’IA.

Cette commande est informée par le modèle de domaine du projet et construite sur un vocabulaire de conception partagé :

• Exécutez la /codebase-design skill pour le vocabulaire d'architecture (module, interface, profondeur, seam, adapter, leverage, locality) et ses principes (le test de suppression, "l'interface est la surface de test", "un adaptateur = couture hypothétique, deux = réel"). Utilisez ces termes exactement dans chaque suggestion – ne dérivez pas vers « composant », « service », « API » ou « limite ».
• La langue du domaine dans CONTEXT.md donne des noms aux bonnes coutures ; Les ADR dans docs/adr/ enregistrent les décisions que cette commande ne devrait pas relancer.

Processus

1. Explorer

Portée avant de numériser — YAGNI. L'approfondissement d'un module est payant en facilitant les modifications futures, alors accordez un poids supplémentaire aux parties de la base de code qui ont récemment changé. Décidez où chercher avant de regarder :

• Si l'utilisateur a nommé une direction - un module, un sous-système, un problème - prenez-la et ignorez l'inférence ci-dessous.
• Sinon, revenez en arrière sur une bonne partie de l'historique des validations (git log --oneline) pour trouver les points chauds de la base de code - les fichiers et les zones qui continuent à apparaître - et laissez ces chemins attirer votre attention en premier. Si les changements sont dispersés sans point chaud clair, élargissez le filet.

Lisez le glossaire de domaine du projet (CONTEXT.md) et tous les ADR dans le domaine que vous touchez en premier.