Adaptation aux mises à jour du harnais
Le test permanent du package : compléter et améliorer le harnais, sans jamais le dupliquer ni entrer en conflit avec lui, sauf déclaration explicite d'une intention contraire avec mention du niveau natif concerné. Une publication du harnais peut échouer à ce test de trois manières. Elle peut intégrer nativement ce que fait une règle ou un mécanisme, rendant la règle dupliquée. Elle peut modifier le comportement décrit par une règle, créant ainsi un conflit. Ou elle peut ajouter un niveau natif qu'une règle devrait citer. Un nouveau modèle peut aussi rendre obsolète le style de formulation d'une règle, même si tous les faits qu'elle contient restent vrais. Cette compétence identifie et corrige ces quatre cas.
Parcours par défaut
- Créez un worktree depuis
origin/mainavant toute autre action. Les workflows d'analyse utilisent une copie propre du dépôt ; dirigez-les donc vers un second worktree que personne ne modifie. - Trouvez la référence de base. La dernière version et la date de la dernière analyse se trouvent dans la section datée finale de
docs/handbook/sources/harness-survey.md. La dernière section de re-survey y nomme le répertoire de la banque de recherche. Les faits enregistrés sur les modèles figurent dans les paragraphes « ladder » dedocs/handbook/claude-code.md.npm run check:harnessimprime cette référence de base et toutes les versions du changelog depuis celle-ci ; l'action planifiéeharness-watchcrée un ticketharness-updatelorsque la liste n'est pas vide. Lorsque les secretsHARNESS_ROUTINE_URLetHARNESS_ROUTINE_TOKENsont définis, l'Action déclenche également une routine cloud. Cette routine exécute le chemin d'addendum delta et ouvre une Pull Request en brouillon surclaude/harness-addendum-<version>. Lorsque cette PR existe, partez d'elle plutôt que de refaire le tri. Comparez aussi avecclaude --version. - Exécutez la porte sous la nouvelle CLI avant de lire quoi que ce soit :
npm run verifysur une copie propre. Le validateur de plugin fonctionne avec--strict, donc un avertissement ajouté par une publication fait échouer la porte, et un tri de changelog peut lire cette entrée comme du bruit. - Recueillez le delta dans le bloc-notes, une source par agent :
- les sections du changelog de Claude Code depuis la référence de base (https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md), la seule source qui date un changement ;
- la page de présentation des modèles et la page de configuration des modèles, pour les nouveaux modèles, les valeurs par défaut, les prix et l'effort ;
- l'audit des invites du harnais lui-même dans ce dépôt (
/doctor prompt-auditdans une session). Il signale les chemins obsolètes, les commandes mortes, les instructions contradictoires et les motifs d'invite écrits pour des modèles plus anciens.
- Choisissez la profondeur. Utilisez le jugement ci-dessous. Dites laquelle vous avez choisie et pourquoi.
- Triez et classez. Chaque candidat reçoit une disposition : DUPLICATE, CONFLICT, COMPLEMENT ou UNIQUE (définitions dans references/dispositions.md). Recherchez dans les fichiers de règles,
plugins/house/orchestration/ORCHESTRATION.md, les agents, les hooks, les compétences et les évaluations tout texte faisant référence à l'ancien comportement. - Vérifiez. Une disposition DUPLICATE ou CONFLICT n'est retenue qu'après que deux sceptiques n'ont pas réussi à la réfuter. L'un vérifie l'exactitude de la documentation, l'autre la réalité de l'application, et chacun par défaut considère comme réfuté en cas de doute. La session lit ensuite la ligne citée et le texte de la règle elle-même. Tout ce que vous pouvez trancher en l'exécutant (
--help, un hook avec une charge utile réelle, le vérificateur), exécutez-le. - Agissez selon la disposition. Résolvez un conflit dans la règle ou le hook. Retirez un doublon, ou conservez-le comme doublon déclaré en nommant le niveau natif. Reformulez un complément uniquement là où la règle prétend ou implique un niveau, et citez le fait. Enregistrez un UNIQUE et laissez-le tel quel. Une constatation de l'audit d'invite modifie la formulation, jamais l'affirmation d'une règle, et doit correspondre à la forme de règle imposée par le vérificateur. Avant d'accepter une déviation d'un agent, une note « non-bloquant » d'un relecteur ou une « limite connue », nommez la règle interne ou la recommandation documentaire qui la régit et suivez l'option recommandée, sauf si vous pouvez expliquer pourquoi pas.
- Enregistrez aux trois endroits décrits dans references/recording-and-release.md. Puis publiez via le flux de release qui s'y trouve.
Choisir la profondeur
Addendum delta (par défaut). Triage uniquement des sections du changelog et des modifications des modèles depuis la référence de base, avec un chercheur par source. Classez les correspondances par rapport à la surface des règles, puis rédigez une section ## Addendum datée. Cela convient à une ou deux publications de corrections et de petites fonctionnalités, ainsi qu'à un changement de modèle dont l'effet porte sur les niveaux et l'effort.
Re-survey complète. Ré-analysez chaque domaine du harnais à partir de la documentation, classez chaque en-tête de règle et mécanisme, vérifiez, synthétisez et exécutez un critique d'exhaustivité. Puis effectuez un passage sur les lacunes que le critique a nommées. Exécutez le tri du changelog provenant du chemin delta en parallèle : les pages de documentation ne portent pas de dates, donc sans le changelog une exécution complète ne peut pas distinguer une page à jour d'une page obsolète. Signaux que l'addendum ne suffit pas :
- le delta touche plusieurs domaines à la fois ;
- une nouvelle famille de modèles ou une nouvelle valeur par défaut arrive ;
- l'audit d'invite signale des motifs répartis sur de nombreux fichiers ;
- un addendum révèle un conflit dans un domaine dont les faits en banque sont antérieurs au changement ;
- le critique de la dernière re-survey a listé des domaines que personne n'a analysés depuis.
Les scripts sont scripts/house-vs-harness-audit.js (principal) et scripts/house-vs-harness-gap-audit.js (lacunes). Chacun prend args.repo (un chemin absolu vers le worktree propre) et args.date. L'exécution des lacunes prend également args.areas et args.targets issus des résultats du critique, plus une args.context facultative indiquant le résultat de l'exécution principale pour son addendum. Ils s'exécutent via l'outil Workflow, qui nécessite une acceptation explicite de l'utilisateur. Avant de demander, indiquez le nombre d'agents : l'exécution principale comprend un chercheur par domaine, un classifieur Opus par module plus un pour les mécanismes, deux sceptiques par affirmation de duplication ou conflit, et deux agents de synthèse.
Risques
- La plupart des constatations sont des attributions, pas du fond. La plus grande re-survey à ce jour n'a trouvé ni doublons ni conflits, mais a trouvé 27 reformulations où une règle prétendait à un niveau natif que la documentation n'établit pas. Avant qu'une règle ne dise que le harnais fait quelque chose, le fait doit exister dans la banque ou sur une page récupérée.
- Les sceptiques ne voient que les doublons et les conflits. La reformulation proposée d'un complément parvient au rapport sans être vérifiée, et elle peut aussi facilement surestimer le harnais que l'ancien texte. Envoyez un réfutateur vérifier chaque reformulation par rapport aux faits en banque avant de la publier.
- Un comptage naïf des titres saute une règle. Chaque fichier de règle se termine par
## Don't, et certaines vraies règles commencent par « Don't ». Comptez les titres par correspondance exacte, pas par préfixe. - Les pages de documentation ne portent pas de dates. Enregistrez la date de récupération à côté de chaque citation. Si le changelog et une page sont en désaccord, faites confiance au changelog pour la date et à la page pour le contenu.
- Les paramètres de modèle vivent en dehors du dépôt. Le niveau du sous-agent et l'effort par modèle sont des paramètres utilisateur. Lorsqu'un changement de modèle les déplace, dites à l'utilisateur quoi définir ; ne modifiez jamais ses paramètres depuis ici. Un modèle nouvellement publié fonctionne avec son effort par défaut jusqu'à ce qu'un niveau par modèle s'applique.
- Une constatation d'audit d'invite peut entrer en collision avec la forme de la règle. Un indicateur d'audit sur une liste d'interdictions ou un nombre fixe est un signal de style. La section
## Don'tet les plafonds de longueur sont une forme vérifiée et des cliquets, donc les modifier est une décision du package selon les ADR, pas une reformulation. - Le garde de branche lit le texte des commandes. Rédigez les corps de PR et les messages de commit qui mentionnent des verbes git près des noms de branche avec l'outil Write, puis transmettez-les avec
--body-fileou-F. - Les sous-agents ne commettent pas. La session commet et pousse ce qu'un agent a préparé.
Quand une modification ici prend effet
Cette compétence est locale au dépôt. Une modification atteint la session suivante qui l'invoque par son nom, et rien n'est livré aux adoptants. Ce qui atteint les adoptants, ce sont les modifications de règles et de mécanismes qu'elle produit, via une publication et le render --apply de chaque adoptant.