From f283ec3ba08b89ac342ca43045519f4131801df1 Mon Sep 17 00:00:00 2001 From: Aliquanto3 Date: Thu, 19 Nov 2026 10:00:47 +0100 Subject: [PATCH] =?UTF-8?q?0.22.3=20:=20trois=20pratiques=20du=20guide=20I?= =?UTF-8?q?NR=20(Green=20Claude)=20dans=20les=20consignes=20globales=20:?= =?UTF-8?q?=20/rewind=20et=20/compact=20dirig=C3=A9,=20brief=20de=20dev-st?= =?UTF-8?q?ory=20en=20trois=20parties,=20--bare=20pour=20les=20scripts?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 1 + modeles/CLAUDE.global.md | 6 +++--- 3 files changed, 5 insertions(+), 4 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 4f8c58d..7c25eec 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agent-cost-kit", - "version": "0.22.2", + "version": "0.22.3", "description": "Setup de développement par agents économe en tokens pour Claude Code : quatre sous-agents routés par rôle (dev-story Sonnet, second-avis Haiku, reviewer Opus, lookup Haiku), un contrôle rapide de fin de story, un script de mesure du coût réel des agents depuis les transcriptions, un skill d'installation, et des bancs pour re-tester le kit quand de nouveaux modèles sortent.", "author": { "name": "Anaël Yahi" diff --git a/CHANGELOG.md b/CHANGELOG.md index fe5823d..9b8d9d0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,6 @@ # Historique +- **0.22.3** (2026-11-19) : **consignes globales** (`modeles/CLAUDE.global.md`), trois pratiques reprises du guide de l'INR [« Écoconcevoir avec un assistant de code »](https://institutnr.org/ecoconcevoir-avec-un-assistant-de-code) (Green Claude, `rules/usage.json` : USAGE-CTX-02, USAGE-CTX-03, USAGE-BRIEF-01, USAGE-CPU-03) : `/rewind` plutôt que des corrections empilées et `/compact` dirigé ; brief de dev-story en trois parties (objectif, contraintes, critères d'acceptation) ; `--bare` pour les `claude -p` scriptés qui n'ont pas besoin des personnalisations, hors bancs. Non mesuré. Écartés : le hook de rappel `UserPromptSubmit` (texte ajouté au contexte à chaque demande), les heures creuses 22 h–6 h UTC (aucune mesure du mix électrique des centres de données), le cache de réponses `[cache]` et l'audit après chaque écriture en global. Les rapports finaux des agents étaient déjà plafonnés. - **0.22.2** (2026-11-14) : **correctif** de la description du skill `essai-outil`. Elle contenait ``, lu comme une balise XML, ce que la spécification des skills interdit dans ce champ. Constat du test T18 de la [veille](https://github.com/Aliquanto3/veille-agents-code) (SkillEvaluator, étage 1). Les phrases de déclenchement sont inchangées ; le comportement du skill dans Claude Code n'était pas affecté. - **0.22.1** (2026-11-11) : **correctif** de `bancs/banc_relecteur.sh`. Sous Windows, Python écrivait en cp1252 : un second avis contenant un caractère hors de ce jeu (« → ») faisait échouer sa lecture, et la liste arrivait vide au relecteur (3 essais sur 6 le 2026-11-10, 1 sur 6 le 2026-11-11, à l'identique pour les relecteurs comparés) ; le script force maintenant UTF-8. Nouvelle référence dans `bancs/README.md` : `reviewer` Opus 5.5 en `high` contre `medium` dans la chaîne (12 revues, 22,85 $), 1,45 $ contre 0,95 $ par revue, mêmes fiches après revue (9 sur 15 cas), un constat Important de plus corrigé dans 1 essai sur 6 ; l'effort du `reviewer` reste `medium`. Aucun agent ne change ; - **0.22.0** (2026-11-11) : sortie de Fable 5.2 (`claude-fable-5-2`, 8 $ / 40 $ par Mtok, lecture du cache à 0,20 $). **Correctif de prix** : sans entrée dédiée, `tarifs.json` lui donnait le tarif du préfixe `claude-fable-5`, avec une lecture du cache à 1 $ (5 fois trop) ; entrées `claude-fable-5-2` et `claude-mythos-5-2` ajoutées, familles `fable` et `mythos` alignées, `tarifs.ts` régénéré, test ajouté au mod `couts-session`. **Aucun agent ne change**, d'après quatre bancs du 2026-11-10 (112 $, références dans `bancs/README.md`) : en contre-revue isolée, Fable 5.2 `medium` signale 20 défauts connus sur 24 contre 13 pour Opus 5.5, mais comme `reviewer` dans la chaîne le code sort avec les mêmes fiches (9 sur 15 cas) pour 1,97 $ contre 0,99 $ ; en développement, même qualité que Sonnet pour 4 fois le coût ; en orchestration, +49 % sans gain. La description de `reviewer` le dit. `installer_global.py` ne pose plus `modelSettings.claude-fable-5-1` (effort `high`) et signale cette règle si elle reste. **Bancs rejouables** : `bancs/corpus.json` (6 stories, 2 dépôts), `bancs/verite-terrain.json` (13 fiches de défauts, à valider), `bancs/banc_relecteur.sh` (même développement, un clone par relecteur candidat, vérificateur en lecture seule), `bancs/noter.py`, `bancs/reglages-banc.json` (`acceptEdits` et liste d'outils, sans `bypassPermissions`, que le mode auto refuse). **Nouveau skill `new-model`**, à invocation manuelle : sans argument, il compare les modèles publiés à `tarifs.json` et s'arrête là ; avec un identifiant, il relève prix et recommandations, liste les écarts avec le kit et les réglages, chiffre les bancs, les lance après accord, puis propose les réglages sans rien appliquer seul ; diff --git a/modeles/CLAUDE.global.md b/modeles/CLAUDE.global.md index 2fd3e84..e53b480 100644 --- a/modeles/CLAUDE.global.md +++ b/modeles/CLAUDE.global.md @@ -6,11 +6,11 @@ Réduire au minimum le coût de développement avec Claude Code, sans baisser la - Effort `medium` par défaut ; monter l'effort avant de changer de modèle ; `high` seulement pour les cas de bord que les tests n'attrapent pas. - Contexte court : lire des extraits ciblés, tests ciblés pendant le travail, pas de relecture d'un fichier qu'on vient d'éditer. Suite complète à mi-parcours (après 3 ou 4 fusions) et à la fin : les défauts croisés entre stories n'apparaissent qu'à la suite. En run parallèle, c'est la CI de branche qui la joue, pas le poste. - Garder `CLAUDE.md` et `MEMORY.md` courts : ils sont relus à chaque appel. L'historique des lots terminés va dans un `archive/` non indexé. -- Couper la session principale entre le cadrage (spec, UX, plan, liste des stories) et l'exécution, puis avant la recette : `/rename`, `/clear`, reprise depuis ces fichiers. Une orchestration d'une traite a coûté 68 $ (contexte de 866 k). Proposer aussi `/clear` entre deux tâches sans lien : `/clear` ne coûte rien, `/compact` relit tout le contexte. +- Couper la session principale entre le cadrage (spec, UX, plan, liste des stories) et l'exécution, puis avant la recette : `/rename`, `/clear`, reprise depuis ces fichiers. Une orchestration d'une traite a coûté 68 $ (contexte de 866 k). Proposer aussi `/clear` entre deux tâches sans lien : `/clear` ne coûte rien, `/compact` relit tout le contexte ; s'il faut compacter, dire quoi garder et quoi jeter (« `/compact` garde la refonte auth, jette le débogage des tests »). Piste sans issue : `/rewind` (double Échap) avant elle plutôt que d'empiler des corrections, qui restent dans le contexte et se relisent à chaque tour. - PR empilées : recibler chaque PR fille sur la branche principale (`gh pr edit --base main`) avant de fusionner sa base avec `--delete-branch`, sinon GitHub ferme les PR filles. -- Prompt de dev-story : nommer les tests et E2E à réaligner quand la story change une structure partagée (barre commune, liste d'outils, schéma d'événement). Documentation d'une story : en parallèle de sa revue, d'après la spec, réalignée après fusion. +- Prompt de dev-story : objectif, contraintes (ce qui ne bouge pas, contrats à tenir) et critères d'acceptation dès le premier message ; nommer les tests et E2E à réaligner quand la story change une structure partagée (barre commune, liste d'outils, schéma d'événement). Documentation d'une story : en parallèle de sa revue, d'après la spec, réalignée après fusion. - Après chaque fusion, vérifier la branche principale (`git log -1`) avant de lancer des tests dessus. -- Sorties de tests et de logs courtes (`pytest -q --tb=short`, filtrer les erreurs) ; préférer une CLI (`gh`, `git`) à un serveur MCP. +- Sorties de tests et de logs courtes (`pytest -q --tb=short`, filtrer les erreurs) ; préférer une CLI (`gh`, `git`) à un serveur MCP. Script `claude -p` qui n'a besoin ni des hooks, ni des plugins, ni de `CLAUDE.md` : `--bare` (auth par `ANTHROPIC_API_KEY` seulement), jamais pour un banc qui doit reproduire l'usage réel. - Tâche complexe ou ambiguë : plan d'abord, validé avant d'écrire du code, pour éviter les reprises. - Pas de fast mode (`/fast`, facturé en premium) sans demande. - Ne pas poser `subagentPromptCacheTtl: "1h"` sans mesure (`/agent-cost-kit:mesurer-couts`) montrant au moins une expiration par agent.