Improve Codebase Architecture (Claude Code skill)
Tu invoques /improve-codebase-architecture quand le codebase devient hostile à toi-même et à Claude, modules trop fins, responsabilités tartinées, tests qui cassent à chaque refactor. La skill cherche les 'deepening opportunities' (transformer du shallow en deep) avec un test imparable : le 'deletion test', si tu supprimes ce module, est-ce que la complexité disparaît, ou est-ce qu'elle réapparaît dans 5 callers ? Distribuée par Matt Pocock dans son repo skills.
Forces
- Le 'deletion test' (supprimer le module fait-il disparaître ou réapparaître la complexité ?), discriminator simple et brutal
- Vocabulaire imposé (depth, leverage, locality, seam), fini les conversations refactor floues
- Lit ADR + CONTEXT.md avant de proposer, ne re-suggère pas les refactors déjà rejetés avec raison
- Le 'grilling loop' interactif après le candidat retenu, t'oblige à walker l'arbre de design avant de coder
Limites
- Demande un CONTEXT.md décent et idéalement des ADR, sinon les suggestions sont génériques
- Refactor multi-fichier non trivial, review humaine obligatoire avant merge
- Pas de garantie de stabilité d'API skill long terme (distribué hors registry Anthropic officielle)
Pour qui
- Tech leads qui sentent leur codebase fuir (modules shallow partout, tests cassants) sans savoir par où commencer
- Devs qui veulent passer du refactor cosmétique au refactor argumenté (depth/leverage/locality)
- Équipes agent-first qui veulent un codebase navigable par Claude (vocabulaire précis = AI-navigable)