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
- Prévisualisation (dry run) : explorer le dépôt et afficher le
house.jsonproposé. Rien n'est écrit. - Montrer la proposition à la personne qui exécute la compétence et attendre qu'elle dise d'appliquer.
- Appliquer : écrire
house.json, puis générer les règles, templates et l'ébauche. - 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èredatabase, une config de déploiement suggèredeployment, 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-ignoredit qu'une destination d'écriture de house (.claude/rules/house/,.house/) est ignorée. Le vérificateur parcourtgit 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, écrireCLAUDE.md.house-skeletonà côté. Ne pas ouvrir leCLAUDE.mdexistant et ne pas écrire dedans. - Si le dépôt n'a pas de
CLAUDE.md, écrire quand mêmeCLAUDE.md.house-skeleton, pasCLAUDE.mdlui-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.jsonni aucun fichier généré pendant la prévisualisation. La prévisualisation affiche seulement. - N'écrasez ni n'ajoutez à un
CLAUDE.mdexistant, 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.