🌱 Écoconception pour tout assistant IA de code

RGESN, GR491, Opquast et RGAA traduits en règles qu'un assistant applique en écrivant du code, et qu'un agent vérifie sur le diff. Une source, onze assistants.

Voir sur GitHub Installer pour votre assistant

Un assistant qui écrit une requête, une image ou une boucle ne connaît pas par défaut le référentiel d'écoconception de votre organisation. Une fois le code en production, chaque exécution reproduit ce choix initial chez chaque utilisateur, pendant toute la durée de vie du service. Ce dépôt ferme cet écart : il transforme RGESN, GR491, Opquast et RGAA en instructions que l'assistant charge automatiquement, dans son propre format.

Deux moments, un seul jeu de règles

-- demande : « le rapport des opérations d'un client »
SELECT * FROM operations;
SELECT id, client_id, date_operation, montant
FROM operations
WHERE client_id = :id
ORDER BY date_operation DESC
LIMIT 50;

$ cn review --review-agents eco-check.md

[Moyen] rapport-clients.sql:9
  SELECT * sur une table non filtrée, GR491_Backend_3
  → colonnes explicites + pagination

1 constat, 0 régression

Une source, onze assistants

Les règles s'écrivent une seule fois, ciblées par langage. Un script (scripts/generer-versions.py) les décline dans le format natif de chaque assistant. Aucune copie manuelle, aucune version qui prend du retard sur les autres.

Quatre référentiels, ramenés à l'actionnable

Treize langages, chacun avec ses propres réflexes

Un N+1 ne s'écrit pas pareil en JPA, en Entity Framework ou en ActiveRecord. Chaque règle nomme les motifs spécifiques au langage plutôt que des principes génériques, ce qui se vérifie et se corrige.

Et green-claude ?

green-claude, un autre projet de l'INR, répond à la même question : faire respecter le RGESN et le GR491 par un assistant de code. Les choix de conception diffèrent sur trois points.

green-claude est un skill Claude Code : il s'installe une fois dans ~/.claude/skills/ et ne vise que ce harnais, avec des hooks propres à ce produit (cache local, avertissement aux heures de pointe). Ce dépôt part d'une source unique et la décline pour onze assistants. Une équipe qui travaille sur Gemini CLI ou sur Continue n'a aucun accès aux règles de green-claude ; elle a accès à celles-ci.

Sur la détection, les deux projets ont maintenant le même étage déterministe. Celui de green-claude, eco-audit.sh, a inspiré le nôtre, qui en reprend les motifs et y ajoute la couche HTML/CSS que green-claude ne couvre pas, puis rattache chaque constat à un critère vérifié dans referentiels/. Cet étage compte : mesuré sur notre corpus de vérification, un modèle local détecte 16 écarts sur 18 mais ne les rattache correctement qu'une fois sur dix-huit, et invente des identifiants de critères. Le grep en trouve moins (12 sur 18) et les trace tous. Aucun des deux ne suffit seul.

Sur la couverture, les rôles s'inversent. green-claude retient 35 règles parmi les 78 critères RGESN, avec un ancrage marqué sur la famille Algorithmie/IA et sur la sobriété d'usage de Claude Code lui-même (14 pratiques inspirées de Boris Cherny). Ce dépôt couvre ce dernier point dans la règle usage-sobre-assistant.md, et ajoute treize langages avec des anti-patterns propres à chacun ainsi qu'un référentiel que green-claude n'utilise pas, Opquast.

Une équipe outillée des deux gagnerait le meilleur des deux mécanismes : le script de green-claude pour un premier passage rapide sur les motifs connus, les règles de ce dépôt pour ce que le grep ne voit pas.

Aller plus loin

• Guide développeur : installer, utiliser au quotidien, lancer une revue, dépanner.
• Guide de déploiement : diffuser les règles aux équipes (git, Hub, CI).
• Développer un skill : écrire et tester une règle ou un agent.