Système d'ingénierie portable pour Claude Code avec crochets, agents spécialisés et auto-amélioration

Un développeur frustré de répéter des instructions à Claude Code a créé un système d'ingénierie portable qui réside dans ~/.claude/ et s'applique automatiquement à chaque projet. Le système résout deux problèmes fondamentaux : la boucle de répétition où Claude Code rencontrait le même bug des jours plus tard et le résolvait à partir de zéro, et la déconnexion entre projets où les règles affinées dans un projet n'existaient pas dans un autre.

Composants du système

Le système comprend plusieurs composants clés :

• Une constitution (CLAUDE.md) – 650 lignes de règles avec une hiérarchie de valeurs, des limites de décision et trois modes d'exécution selon la complexité de la tâche
• Des crochets qui appliquent les règles de manière déterministe – Non pas des suggestions que l'IA pourrait ignorer, mais des scripts bash qui bloquent physiquement les commandes dangereuses comme les push forcés, l'utilisation du mauvais gestionnaire de paquets ou rm -rf
• Trois agents spécialisés – Un orchestrateur qui délègue mais ne code jamais, des constructeurs qui travaillent dans des copies isolées du dépôt, et un réviseur en lecture seule qui ne peut pas corriger (seulement signaler)
• Un pipeline de compétences – De la planification à la construction, à l'expédition et à la production, principalement autonome avec une porte non négociable : le déploiement en production demande toujours confirmation
• Un système immunitaire – Chaque erreur est enregistrée avec la cause racine ET les approches qui ont échoué. Le même bug dans 2+ projets devient une règle permanente, développant des anticorps
• Une vérification anti-Goodhart – Cinq questions que chaque agent doit répondre avant de déclarer "terminé", car "tous les tests passent" ne signifie pas que l'application fonctionne

Approche d'ingénierie composite

Le système est construit sur l'Ingénierie Composite : Planifier → Travailler → Examiner → Composer. Cette quatrième étape est celle où le système s'améliore lui-même. Le développeur mentionne des règles spécifiques qu'il devait auparavant répéter quotidiennement : "utiliser pnpm pas npm", "ne pas supprimer les tests qui passent" et "exécuter les tests avant de valider".

Le projet est open source à https://github.com/vinicius91carvalho/.claude avec une visite guidée complète des 15 pièces disponible à https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code.