Communitygithub.com

dubbl-a/house-rules

Configure un dépôt pour la première fois en proposant un manifeste house.json, des règles vendues et une ébauche CLAUDE.md, par défaut en mode prévisualisation. Utilisez pour « bootstrap house » ou « adopter house ici ».

Qu'est-ce que house-rules ?

Cette compétence (skill) permet de transformer un dépôt non géré en un consommateur du système « house ». Elle explore le dépôt pour détecter sa stack technique, sa branche par défaut et ses répertoires, puis propose un manifeste `house.json` avec les modules détectés. Le mode prévisualisation (dry run) affiche la proposition sans rien écrire. Sur demande explicite (`--apply`), elle génère les fichiers de règles, les templates, une ébauche `CLAUDE.md.house-skeleton` (sans jamais toucher un `CLAUDE.md` existant) et configure les hooks Git. Elle refuse de s'exécuter deux fois sur le même dépôt et redirige vers `/house-rules:sync` si un manifeste existe déjà. Conçue pour les outils comme Claude Code, elle garantit une transition contrôlée : chaque étape est validée par l'utilisateur avant écriture, et les fichiers critiques ne sont jamais modifiés sans consentement.

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

Demander à votre IA préférée

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

Documentation

Bootstrap

Bootstrap transforme un dépôt non géré en consommateur de « house ». Il explore le dépôt, propose un house.json, et sur --apply écrit les règles vendues, les templates et une ébauche CLAUDE.md. Il ne modifie jamais un CLAUDE.md existant et ne s'exécute jamais deux fois sur le même manifeste. Il écrit uniquement la partie « house » du CLAUDE.md, sous forme d'un fichier d'ébauche séparé, et laisse la partie dérivée du codebase à la commande init du harnais, qui génère un CLAUDE.md de départ ou suggère des améliorations à celui déjà présent.

Cette compétence a des effets de bord sur le disque, donc elle ne se déclenche jamais seule. Exécutez-la uniquement lorsqu'on vous le demande.

Chemin par défaut

  1. Prévisualisation (dry run) : explorer le dépôt et afficher le house.json proposé. Rien n'est écrit.
  2. Montrer la proposition à la personne qui exécute la compétence et attendre qu'elle dise d'appliquer.
  3. Appliquer : écrire house.json, puis générer les règles, templates et l'ébauche.
  4. Afficher le bloc de câblage ci-dessous pour que la personne puisse le coller dans package.json, CI, et son terminal.

Ne sautez pas l'étape 2. Une proposition que la personne n'a jamais vue n'est pas une proposition, c'est une surprise.

Refuser lorsqu'un manifeste existe

Avant toute exploration, vérifiez si house.json existe déjà à la racine du dépôt.

S'il existe, refusez. Affichez que le dépôt a déjà un manifeste et redirigez vers /house-rules:sync à la place. Cela vaut aussi en mode prévisualisation : bootstrap ne rédige jamais une seconde proposition par-dessus une première, même si personne ne l'a encore appliquée. Un dépôt n'a droit qu'à un seul bootstrap.

Explorer le dépôt

Exécutez le CLI en mode prévisualisation pour collecter ce dont la proposition a besoin :

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path>

L'exploration lit, sans écrire :

  • Stack : présence de package.json, ses scripts, et tout fichier de configuration de framework à la racine.
  • Branche par défaut : git symbolic-ref refs/remotes/origin/HEAD, en se repliant sur la branche courante.
  • Répertoires de premier niveau, pour deviner quels modules optionnels s'appliquent (db/ suggère database, une config de déploiement suggère deployment, etc.).
  • Si .claude/rules/ ou un hook de protection de branche existe déjà, pour que la proposition puisse dire ce que bootstrap ajouterait par rapport à ce que le dépôt a déjà.
  • Si l'analyse de docs actuelle du dépôt exclut déjà un niveau d'archivage, pour initialiser scanArchive à partir du comportement observé plutôt que d'une supposition.
  • Si git check-ignore dit qu'une destination d'écriture de house (.claude/rules/house/, .house/) est ignorée. Le vérificateur parcourt git ls-files, donc un fichier de règle ignoré lui est invisible et la première exécution affiche un zéro qu'il n'a pas mérité. L'exploration avertit et nomme le correctif : ignorer seulement .claude/settings.local.json, jamais .claude/ ou .house/.

Proposer house.json

Chaque module que l'exploration ne peut pas exclure va dans la proposition comme "detect", pas true ou false. "detect" signifie que le dépôt décide au moment de la génération, pas la compétence devinant à sa place. Les modules de base (docs, engineering, github, claude-code) sont toujours activés. Affichez le corps complet du house.json proposé, pas un résumé, afin que la personne qui le révise puisse lire chaque champ avant que quoi que ce soit soit écrit.

Appliquer : écrire le manifeste, les règles, et l'ébauche

Seulement après que la personne ait dit d'appliquer :

node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply

init --apply écrit house.json. render --apply écrit les fichiers de règles vendues, les templates, .house/check.mjs, .house/lock.json, .house/INDEX.md, et un fichier supplémentaire :

  • Si le dépôt a un CLAUDE.md, écrire CLAUDE.md.house-skeleton à côté. Ne pas ouvrir le CLAUDE.md existant et ne pas écrire dedans.
  • Si le dépôt n'a pas de CLAUDE.md, écrire quand même CLAUDE.md.house-skeleton, pas CLAUDE.md lui-même. Bootstrap ne crée jamais le fichier racine du dépôt. Une personne fusionne l'ébauche manuellement.

Dans les deux cas, un CLAUDE.md existant est identique octet par octet avant et après chaque exécution de bootstrap. C'est le contrôle auquel cette compétence est tenue : différenciez-le avant d'appliquer, différenciez-le après, et si quelque chose a bougé, arrêtez-vous et dites-le au lieu de signaler un succès.

L'ébauche est proposée une fois par dépôt : render l'enregistre dans .house/lock.json sous scaffolds, donc une fois qu'elle a été fusionnée dans CLAUDE.md et supprimée, aucune génération ultérieure ne la réécrit. render --apply --scaffold est le moyen de la redemander.

Assurez-vous que le .gitignore du dépôt contient .claude/worktrees/ et .superpowers/, en ajoutant la ligne manquante. Les fichiers temporaires d'outils qui apparaissent dans git status sont à un git add -A d'être commités.

Afficher le câblage

Après une application réussie, affichez ce bloc textuellement pour qu'il soit copiable-collable dans un terminal simple. Ne remplissez rien ; la personne l'adapte à son package.json et son fichier de workflow.

Ajouter aux scripts de package.json :
  "check:docs": "node .house/check.mjs --only=drift,todo"
  "check:house": "node .house/check.mjs"

Ajouter une étape CI qui exécute :
  node .house/check.mjs

Installer le plugin une fois par machine :
  claude plugin marketplace add dubbl-a/house-rules
  claude plugin install house-rules@house-rules --scope user

Activer les hooks Git une fois par clone (render --apply et chaque début de session le font aussi) :
  git config core.hooksPath "$(pwd)/.githooks"

core.hooksPath vit dans .git/config, qu'aucun clone ni aucune PR ne transporte, donc l'arborescence vendue .githooks/ est inerte dans un checkout frais jusqu'à ce que quelque chose la définisse. render --apply et le hook SessionStart du plugin l'activent tous les deux ; la ligne ci-dessus est pour un clone qui n'a ni l'un ni l'autre. Ni eux ni la personne ne devraient écraser un core.hooksPath qu'un autre outil possède déjà.

Si le dépôt n'a pas de .claude/settings.local.json, dites-le dans la sortie imprimée. Ce fichier est l'endroit où une désactivation par dépôt d'un module ou hook de house vivrait, et son absence signifie que le dépôt fonctionne uniquement avec les valeurs par défaut.

Après bootstrap

Dites à la personne ce qui n'est pas encore fait : l'ébauche doit encore être fusionnée manuellement dans CLAUDE.md puis supprimée (elle ne sera plus réécrite), le bloc de câblage doit encore être collé, et node .house/check.mjs mérite une exécution locale avant le premier commit pour que le dépôt démarre sur une base propre plutôt que sur un échec hérité. Stager les fichiers générés par chemin d'abord (house.json .house/ .claude/rules/house/, plus scripts/house/ uniquement lorsque render a listé un fichier là-bas, car git refuse un pathspec qui ne correspond à rien) : tant qu'ils ne sont pas stagés, la famille de manifestes avertit [untracked] par fichier, et une ignorance globale de .claude/ ou .house/ est un constat [gitignored], car un fichier que git ne peut pas voir est un fichier qu'aucune famille ne vérifie. Rien de tout cela n'est le travail de cette compétence ; bootstrap s'arrête après la génération.

À ne pas faire

  • N'écrivez pas house.json ni aucun fichier généré pendant la prévisualisation. La prévisualisation affiche seulement.
  • N'écrasez ni n'ajoutez à un CLAUDE.md existant, jamais, sous aucun indicateur.
  • Ne reproposez pas sur un dépôt qui a déjà house.json. Renvoyez vers /house-rules:sync.
  • Ne devinez pas qu'un module est activé ou désactivé quand l'exploration est ambiguë. Proposez "detect" et laissez le dépôt décider.

Individual skills in this repo

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

Skills associés