Poids du Contexte

Que fait Poids du Contexte ?

Tout ce qui est chargé au démarrage est renvoyé avec chaque requête dans la session. Un CLAUDE.md de 150k tokens coûte 150k tokens par requête avant même que le travail ne commence. Cette compétence mesure cette charge, la réduit, et prouve la réduction avec des chiffres.

Le script est scripts/cw.py dans le répertoire de cette compétence. Résolvez son chemin absolu à partir de l'emplacement de ce fichier. Il nécessite Python 3.8+ et rien d'autre. Il ne modifie jamais les fichiers de l'utilisateur, il affiche des chiffres, jamais le contenu des transcriptions, et le seul fichier qu'il écrit est l'image demandée avec --svg ou --open.

Jauge en direct ? Pour « quelle est la plénitude de mon contexte maintenant », utilisez la console : Claude Code /context, Codex /status. Cette compétence concerne le dépôt et l'historique.

1. Peser (lecture seule)

python3 <skill-dir>/scripts/cw.py report <repo> --days 30 --svg

--svg dessine également le rapport sous forme d'une image dans le dossier temporaire du système et affiche son chemin sur la dernière ligne (Picture: ...). Donnez ce chemin à l'utilisateur pour qu'il puisse lire les chiffres d'un coup d'œil ; ajoutez --open pour l'ouvrir pour lui lorsqu'il vous demande de le voir. Utilisez --svg FILE pour choisir l'emplacement, jamais un chemin dans le dépôt sauf si l'utilisateur le demande.

La sortie texte comporte quatre parties :

• les fichiers d'instructions que chaque console charge au démarrage, en tokens estimés ;
• la liste des compétences par rapport au budget de chaque console ;
• les chiffres mesurés des sessions pour ce dépôt ;
• les constats classés.

Vues plus ciblées : files <repo>, skills <repo>, sessions --top 20, sessions --project <name> --compare-at YYYY-MM-DD. Ajoutez --json à n'importe laquelle pour obtenir du JSON.

Lorsque vous faites votre rapport à l'utilisateur, donnez :

• les tokens de démarrage par console ;
• start (contexte médian de la première requête d'une session) ;
• start% (part de toutes les entrées qui est cette charge de démarrage renvoyée) ;
• la part >threshold tok ;
• les constats.

Dites quels chiffres sont des estimations (files, skills) et lesquels sont mesurés (sessions). Le budget de compétences de Claude Code dépend de la fenêtre de contexte du modèle, que les logs n'enregistrent pas : cw.py suppose 200k et le précise. Si l'utilisateur utilise un modèle à 1M de contexte, relancez avec --window 1000000.

2. Choisir le levier indiqué par les chiffres

Signal	Levier
Instructions du dépôt > ~5k tokens, start% élevé	Réduire les fichiers d'instructions (étape 3)
>threshold tok > 50%	Hygiène des sessions (étape 4)
« les consoles suivent des règles différentes »	Un AGENTS.md canonique unique (étape 3)
Avertissement Codex « never sees »	Réduire, ou déplacer des parties dans des fichiers AGENTS.md imbriqués
Liste de compétences dépassant le budget	Désinstaller les compétences ou plugins inutilisés. Demandez d'abord : c'est la configuration de l'utilisateur

Commencez par le chiffre le plus important. Ne touchez pas à ce que les chiffres ne pointent pas.

3. Réduire les fichiers d'instructions

La procédure complète se trouve dans references/slimming.md. Lisez-la avant de modifier. Version courte :

1. Sauvegardez le fichier, puis enregistrez cw.py files <repo>.
2. Classez chaque section dans l'un des cinq types : règle (conservez-la, rendez-la concise), pointeur, référence, journal ou doublon.
3. Déplacez les références et les journaux vers docs/agent-notes/. Laissez un pointeur d'une ligne avec un chemin simple. N'utilisez pas @ : Claude Code développe les @imports au lancement, et Codex les ignore.
4. Gardez le cœur sous 200 lignes et environ 5k tokens, dans la limite de chaîne de 32 Ko de Codex.
5. Faites d'AGENTS.md le fichier canonique unique. CLAUDE.md contient @AGENTS.md plus les lignes spécifiques à Claude.
6. Prouvez-le : verify-split sort avec le code 0, files montre la baisse, et la porte --max-tokens passe.

Déplacer du texte est sûr. Supprimer des connaissances est la décision de l'utilisateur : demandez avant de supprimer toute ligne qui n'est pas un doublon avéré.

4. Hygiène des sessions

La plupart des tokens d'entrée proviennent des requêtes tardives dans les longues sessions. Chaque requête renvoie tout ce qui la précède.

• Utilisez une tâche par session.
• Lorsque le contexte dépasse environ la moitié de la fenêtre, ou que la tâche change, écrivez un court point de passage (objectif, état, prochaine étape, fichiers touchés) et commencez une nouvelle session. Dans Claude Code, c'est /clear ; dans Codex, c'est /new. Préférez cela à une compaction répétée.
• Gardez les gros résultats d'outils hors du contexte : filtrez-les, tronquez-les, ou écrivez-les dans un fichier et lisez seulement ce dont vous avez besoin.

5. Prouver la réduction

• Immédiatement : comparez cw.py files <repo> avant et après, et vérifiez que verify-split sort avec le code 0.
• Empêcher la ré-augmentation : ajoutez python3 <skill-dir>/scripts/cw.py files . --max-tokens 6000 dans le CI ou pre-commit. Il sort avec le code 1 lorsque les instructions du dépôt dépassent la limite ou lorsque Codex en couperait une partie, et 2 lorsque le chemin est erroné, de sorte qu'une faute de frappe ne passe jamais.
• Après quelques jours d'utilisation réelle : exécutez cw.py sessions --project <name> --compare-at <date du changement> et rapportez start et start% avant et après.

Ne prétendez pas à des économies réalisées tant que cette dernière commande n'a pas été exécutée sur des sessions postérieures au changement.

Codes de sortie

0 ok, 1 une vérification a échoué (--max-tokens, verify-split), 2 mauvaise entrée (chemin manquant, fichier illisible, mauvaise date). Les erreurs vont sur stderr.

Référence

• references/harnesses.md : ce que chaque console charge et quand, limites de taille, dossiers de compétences, avec sources.
• references/slimming.md : la procédure de réduction et la vérification.