Communitygithub.com

dubbl-a/house-rules

Achemine les apprentissages d'une session vers le fichier de règle correspondant et les incidents datés vers les archives du dépôt, jamais vers le fichier racine ; se déclenche sur « révise les docs », « capture cet apprentissage », « où cela va-t-il ».

Qu'est-ce que house-rules ?

Cette compétence pour agents IA (Claude Code, Cursor, Codex, etc.) remplace le comportement par défaut du plugin officiel de gestion des fichiers d'instructions. Au lieu d'ajouter systématiquement un apprentissage à la fin du fichier d'instructions racine – ce qui le rend illisible et rarement pertinent – elle achemine chaque élément vers l'emplacement le plus approprié. Elle analyse la portée de l'apprentissage, le classe comme règle (applicable de manière récurrente) ou incident (événement ponctuel daté), puis le route : une règle vers le fichier de règles existant dont les chemins (paths:) couvrent le sujet concerné, un incident vers les archives du dépôt. Une étape cruciale de vérification audite chaque affirmation contre le codebase avant écriture. La compétence refuse de modifier les fichiers gérés (vendus) sous `.claude/rules/house/**` pour éviter les pertes silencieuses, et propose plutôt une mise à jour en amont. Elle fournit des échappatoires pour les contradictions entre règles, les cas ponctuels, les doutes de classification, et les dépôts sans structure de règles ni archives.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/plugins/house/skills/revise-docs

Demander à votre IA préférée

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

Documentation

Révise les docs

Le plugin officiel de gestion des fichiers d'instructions embarque une commande revise qui capture les apprentissages d'une session en les ajoutant à la fin du fichier d'instructions racine. C'est exactement le comportement que cette compétence existe pour remplacer. Un fichier racine qui ne fait que grossir n'est plus lu jusqu'au bout, et un apprentissage qui y est accolé est rarement le fait dont une future session aurait besoin au moment où elle en aurait besoin. Cette compétence conserve la moitié utile de ce plugin – auditer une affirmation par rapport au codebase avant de l'écrire – et abandonne la moitié d'ajout à la fin au profit du routage. Les notes de mémoire locale de la machine du harnais capturent déjà ce qu'une session a appris et ignorent ce que les fichiers d'instructions disent déjà ; cette compétence achemine donc la moitié partageable et versionnée : une règle vers le fichier de règles dont les chemins couvrent la surface qu'elle touche, un incident vers les archives du dépôt.

Chemin par défaut

  1. Nommez la chose que cette session a produite et qui mérite d'être conservée : une correction, une convention décidée, un bogue et son correctif, un résultat mesuré, une décision entre deux approches.
  2. Classez-la comme règle ou incident.
    • Une règle s'applique chaque fois qu'une situation similaire se reproduit. Énoncez-la une fois et elle devrait encore être vraie après le prochain refactoring.
    • Un incident s'est produit une fois, à une date, avec un nom ou un nombre mesuré. C'est une preuve de l'existence d'une règle, pas la règle elle-même.
  3. Acheminez une règle vers son fichier de règles correspondant.
    • Recherchez les fichiers de règles existants par portée et en-tête, pas seulement par nom de fichier. Ouvrez celui dont les paths: couvrent déjà la surface que l'apprentissage touche.
    • Si l'un d'eux la couvre, ajoutez un nouvel en-tête ou intégrez le point dans un en-tête existant. Suivez la forme de la règle : un en-tête impératif qui est lui-même la règle, une clause de raison, une ligne Anchor: nommant ce qui l'applique, une ligne Receipts: pointant vers l'entrée des archives, et terminez le fichier par ## Ne pas faire.
    • Vérifiez avant d'écrire. Assurez-vous que chaque jeton de la ligne Anchor:, chaque chemin, chaque nom de script, existe réellement dans le dépôt à l'instant présent. C'est l'habitude d'audit empruntée au plugin ci-dessus : n'écrivez jamais une affirmation que vous n'avez pas vérifiée.
    • Si rien ne la couvre, dites-le et proposez un nouveau fichier de règles ou une portée plus large pour un fichier existant. Ne mettez pas le point dans le fichier le plus proche simplement parce qu'il est proche.
  4. Acheminez un incident vers le niveau d'archives du dépôt.
    • Les archives sont ce que le dépôt appelle son document de preuves datées : un chapitre de manuel, un fichier d'historique de conception, un journal de post-mortem. Écrivez-y la date, le nom, le nombre mesuré, intitulé comme une leçon en une ligne afin que l'entrée se lise comme une affirmation plutôt qu'un nom de fichier.
    • Pointez le fichier de règles vers l'entrée avec son titre entre guillemets. Ne reformulez pas les détails de l'incident dans la prose de la règle ; une date ou un nombre dans une règle, c'est de l'histoire déguisée en règle.
    • Si le dépôt n'a pas encore d'archives, dites-le et proposez d'en créer. N'intégrez pas l'incident dans un fichier de règles ou le fichier racine faute de place.
  5. Ne touchez jamais au fichier d'instructions racine. Si ni un fichier de règles ni les archives ne conviennent, c'est le signe que le fait n'est pas assez durable pour être conservé, pas une raison de le mettre par défaut dans le fichier racine. Dites-le clairement et arrêtez-vous.
  6. Montrez la modification avant de l'enregistrer. Affichez l'en-tête et le paragraphe que vous proposez, ou un diff par rapport au fichier existant, et attendez une confirmation, sauf si on vous a dit clairement de simplement faire la modification.

Lorsque la correspondance est une règle de maison gérée

Si le fichier qui couvre déjà le sujet est une règle de maison importée (porte l'en-tête de fichier géré, se trouve sous .claude/rules/house/**), ne le modifiez pas dans ce dépôt. Une modification locale d'un fichier géré est silencieusement écrasée par la prochaine exécution de /house-rules:sync, et cette perte silencieuse est exactement ce que house existe pour empêcher.

Proposez plutôt la modification en amont. Rédigez le même en-tête et le même paragraphe, puis dites de l'ouvrir comme une modification dans le dépôt de règles maison plutôt que dans celui-ci. Si le point est vraiment spécifique à ce dépôt et non une règle pour toute la flotte, enregistrez-le comme une déviation dans house.json au lieu de forker le fichier géré. L'une ou l'autre voie maintient le fichier géré synchronisé ; le modifier sur place, non.

Échappatoires

  • L'apprentissage contredit une règle existante. Dites-le clairement, citez l'en-tête existant et demandez laquelle l'emporte avant d'écrire quoi que ce soit. N'écrasez pas silencieusement une règle par une autre.
  • L'apprentissage est un cas unique propre au dépôt sans forme de règle, un contournement pour un bogue d'un fournisseur, une note qui n'a d'importance qu'une seule fois. Acheminez-le vers les archives en tant qu'incident au lieu d'encombrer un fichier de règles avec quelque chose qu'aucune session future n'aura besoin de respecter.
  • Vous n'êtes pas sûr qu'il s'agisse d'une règle ou d'un incident. Privilégiez les archives. Une règle mal archivée est un en-tête que quelqu'un pourra promouvoir plus tard ; un incident mal classé comme règle devient une prose obsolète que rien ne signale.
  • Le dépôt n'a ni fichiers de règles ni archives. Dites-le clairement et arrêtez-vous plutôt que de créer l'un ou l'autre à l'intérieur de cette compétence. C'est le travail de /house-rules:bootstrap, pas celui-ci.

Ne pas faire

  • N'ajoutez pas à la fin du fichier d'instructions racine. C'est exactement le comportement de la commande revise du plugin officiel de gestion des fichiers d'instructions, et la raison pour laquelle cette compétence existe à la place.
  • N'écrivez pas une phrase de règle dont vous n'avez pas vérifié l'ancre par rapport au codebase.
  • Ne reformulez pas la date, le nom ou le nombre d'un incident dans la prose de la règle ; pointez vers les archives.
  • Ne modifiez pas un fichier de règles maison importé sur place. Proposez la modification en amont ou enregistrez une déviation.
  • N'enregistrez pas une modification que la personne n'a pas vue, sauf si elle vous a dit clairement de simplement la faire.
  • N'inventez pas un fichier de règles ou des archives quand le dépôt n'en a pas.

Individual skills in this repo

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

Skills associés