Communitygithub.com

dubbl-a/house-rules

Adapte les règles internes à une nouvelle version de Claude Code ou à un nouveau modèle Claude, afin que le package continue de compléter le harnais sans le dupliquer ni le contredire.

Qu'est-ce que house-rules ?

Cette compétence permet de maintenir la cohérence du package `house-rules` face aux évolutions de Claude Code et des modèles Claude. Elle détecte automatiquement les doublons, les conflits et les informations obsolètes en comparant les règles internes avec les dernières versions du harnais (changelog, documentation des modèles, audit interne). Elle trie chaque règle affectée selon quatre catégories : DUPLICATE, CONFLICT, COMPLEMENT ou UNIQUE, et applique les corrections nécessaires (réécriture, retrait, ajout de référence). La compétence est conçue pour fonctionner avec Claude Code, Cursor et d'autres agents utilisant un harnais similaire. Son workflow par défaut est l'"addendum delta" (traitement ciblé des changements récents), mais elle peut aussi déclencher une "re-survey" complète si les modifications sont trop importantes. Les résultats sont enregistrés dans un fichier de révision daté, et une version peut être publiée via un flux de release automatisé.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/.claude/skills/adapting-to-harness-updates

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Créez un worktree depuis origin/main avant 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.
  2. 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 » de docs/handbook/claude-code.md. npm run check:harness imprime cette référence de base et toutes les versions du changelog depuis celle-ci ; l'action planifiée harness-watch crée un ticket harness-update lorsque la liste n'est pas vide. Lorsque les secrets HARNESS_ROUTINE_URL et HARNESS_ROUTINE_TOKEN sont 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 sur claude/harness-addendum-<version>. Lorsque cette PR existe, partez d'elle plutôt que de refaire le tri. Comparez aussi avec claude --version.
  3. Exécutez la porte sous la nouvelle CLI avant de lire quoi que ce soit : npm run verify sur 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.
  4. 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-audit dans 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.
  5. Choisissez la profondeur. Utilisez le jugement ci-dessous. Dites laquelle vous avez choisie et pourquoi.
  6. 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.
  7. 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.
  8. 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.
  9. 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't et 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-file ou -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.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Skills associés