agent-rules-books : les classiques du logiciel en règles pour l'agent
Un agent produit du code qui tourne, mais multiplie volontiers les abstractions creuses, mélange les couches et refactorise en ajoutant des fonctions. Le dépôt propose 14 jeux de règles issus de livres reconnus sur la conception, l'architecture, le DDD et le code legacy, chacun en trois tailles : mini au quotidien, nano pour un contexte serré, full comme référence.
Règles inspirées de Clean Code et Code Complete : nommage, petites fonctions, responsabilités, programmation défensive, tests.
Jeux d'architecture : Clean Architecture, Patterns of Enterprise Application Architecture et trois livres sur la conception pilotée par le domaine.
Code legacy selon Michael Feathers : tests de caractérisation, points de jonction, rupture de dépendances, sprout method et wrap method.
Le jeu release-it, d'après Michael Nygard, traite timeouts, nouvelles tentatives, circuit breakers, bulkheads et observabilité.
Chaque SKILL.md charge la version mini par défaut et garde la version full sous la main comme référence.
Quand s’en servir
Avant une grosse refactorisation, quand l'agent doit avancer à petits pas sans changer le comportement observable.
Un projet DDD où l'agent doit raisonner en bounded contexts et agrégats plutôt qu'en tables et DTO.
La revue d'un service avec files de messages et API tierces, où timeouts et relances font la stabilité.
Demandez à l’agent
Refactorise le module billing selon les règles refactoring : petits pas, tests après chacun
Passe ce service au crible des règles release-it et signale les appels sans timeout ni limite de relances
Découpe la classe legacy OrderManager en écrivant d'abord des tests de caractérisation
Questions
Comment installer agent-rules-books ?
Tous les jeux avec npx skills add ciembor/agent-rules-books --all, ou un seul avec --skill suivi du nom, par exemple --skill refactoring. L'option --list affiche la liste sans rien installer.
agent-rules-books fonctionne-t-il dans Cursor et Codex ?
Oui. Les règles sont du Markdown neutre pour AGENTS.md ou des skills, et docs/USAGE.md détaille la configuration pour Codex, Claude Code et Cursor.
Quelle différence entre mini, nano et full ?
full est le texte canonique complet, mini la version courte recommandée pour le travail réel, nano la solution de repli très compacte pour un contexte étroit.
