Green Claude : sobriété numérique pour Claude Code

Green Claude est un skill pour Claude Code qui guide Claude vers un code éco-conçu, de façon automatique, sans commande à retenir.

Une production de l'Institut du Numérique Responsable, 2026, sous licence MIT.

Un code éco-conçu = moins de ressources consommées chez chaque utilisateur, à chaque exécution, pendant toute la vie du logiciel.

Ce dépôt est spécifique à Claude Code. Une version indépendante des règles, portable vers d'autres assistants IA et d'autres langages, est en cours de développement ici : regles-ecoconception-ia.

En une phrase

Tu installes le skill une fois. Ensuite, quand Claude Code écrit ou revoit du code dans tes projets, il applique de lui-même les règles d'éco-conception (RGESN 2024, GR491, Green Software Foundation), sans que tu aies à le lui demander à chaque fois.

Pourquoi un skill plutôt qu'une simple liste de règles

Une checklist RGESN en PDF ou en wiki dépend de la mémoire de qui l'a lue une fois. Personne ne la rouvre avant chaque ligne de code, et son application varie d'une personne à l'autre selon qui s'en souvient ce jour-là.

Un skill Claude Code apporte trois différences concrètes :

• Chargement automatique à chaque session. Le skill se charge tout seul, sans qu'on ait à le mentionner en tête de conversation.
• Sélection contextuelle des règles. Claude applique les familles pertinentes pour ce qu'il écrit à l'instant : un backend déclenche les règles SQL et pools de connexions, pas les règles UX/UI sur l'autoplay.
• Vérification a posteriori intégrée. Le script d'audit (eco-audit.sh) tourne à la demande sur le code déjà écrit, sans coût de raisonnement pour le modèle, pour attraper ce que l'application proactive a raté.

La checklist reste un document qu'on consulte. Le skill s'exécute au moment où le code s'écrit, dans la session de travail elle-même.

Installation

git clone https://github.com/Institut-du-Numerique-Responsable/green-claude.git
cd green-claude
./install.sh

Ça installe le skill dans ~/.claude/skills/green-claude. Rien d'autre à faire : Claude Code le charge automatiquement dans tes sessions suivantes.

Prérequis : jq, pour le script d'audit (brew install jq / sudo apt install jq).

Utilisation

Rien à taper. Trois façons de s'en servir :

L'audit (skill/green-claude/scripts/eco-audit.sh) est un script déterministe (grep sur les règles) : il ne coûte pas de raisonnement au modèle, juste la lecture du résultat.

Les règles : 35 règles alignées sur les 9 familles du RGESN 2024

skill/green-claude/rules/ecoconception.json couvre les 9 familles du RGESN 2024 (78 critères officiels). Chaque règle référence le critère RGESN correspondant (rgesn_ref) et la famille GR491 (gr491_famille) :

Les règles sans motif détectable (démarche, gouvernance) sont ignorées par l'audit et servent de checklist dans /green-claude.

Les pratiques Boris : utiliser Claude sobrement et avec bon sens

Coder avec l'IA a aussi un coût pendant la session elle-même : chaque requête consomme de l'énergie. Boris Cherny, créateur de Claude Code, documente des pratiques d'usage efficace. Un usage efficace est aussi un usage sobre : chaque aller-retour évité économise des tokens, chaque contexte allégé aussi.

skill/green-claude/rules/boris.json en reprend 14, dont deux ajoutées avec des exemples d'outils open source vérifiés :

Détail complet : skill/green-claude/rules/boris.json.

Les outils tiers cités (graphify, caveman) sont des exemples illustratifs vérifiés (open source, licence MIT). Le projet ne les audite pas et n'en dépend pas.

Ce qu'un skill ne peut pas faire (et comment on le couvre quand même)

Un skill s'exécute pendant une session déjà lancée. Il ne peut donc pas décider avec quel modèle démarrer, ni empêcher un appel au modèle avant qu'il n'ait lieu. Deux leviers restent donc hors du skill, dans hooks/, optionnels et proposés à l'installation :

• Cache local (hooks/green-claude-cache.sh) : une question déjà posée est resservie sans réappeler le modèle, zéro token consommé.
• Avertissement heures creuses (même hook) : signale les heures de pointe (hors 22h-6h UTC) sans bloquer.

Ces hooks se câblent dans ~/.claude/settings.json. install.sh te guide, mais vérifie la doc hooks de ta version de Claude Code avant de coller la config.

Écrire ses propres règles

Ajoute un fichier JSON dans skill/green-claude/rules/, structuré comme ecoconception.json (catégories → règles) :

{
  "id": "CUSTOM-001",
  "title": "Ma règle",
  "impact": "Élevé",
  "patterns": ["mon_motif_regex"],
  "recommendation": "Quoi faire à la place."
}

• patterns : expressions régulières grep -E détectant le problème. Liste vide = pratique (checklist, ignorée par l'audit).
• impact : Élevé, Moyen ou Faible.
• rgesn_ref / gr491_famille (optionnels) : renvoi vers les référentiels officiels.

Relance ensuite ./install.sh pour republier le skill mis à jour.

🤝 Contribuer

1. Fork ce dépôt
2. Créez une branche (git checkout -b feature/ma-regle)
3. Ajoutez vos règles ou améliorations (jq empty skill/green-claude/rules/*.json pour valider le JSON)
4. Ouvrez une Pull Request

Les contributions les plus utiles : nouvelles règles d'audit sourcées (RGESN, GR491, GSF) avec leur rgesn_ref, corrections de patterns (faux positifs), traductions.

Détail complet du format des règles et du processus de PR : CONTRIBUTING.md.

🙏 Références

• RGESN 2024 : Référentiel Général d'Écoconception de Services Numériques (78 critères, 9 familles)
• GR491 : Guide de référence de conception responsable de services numériques (61 recommandations, 516 critères)
• Green Software Foundation : patterns d'éco-conception logicielle
• How Boris uses Claude Code : les pratiques de Boris Cherny, créateur de Claude Code
• Anthropic : Claude et Claude Code

📄 Licence

MIT, © 2026 Institut du Numérique Responsable