Bootstrap
Bootstrap verwandelt ein unverwaltetes Repository in einen House-Consumer. Es durchsucht das Repository, schlägt ein house.json vor und schreibt bei --apply die importierten Regeln, Vorlagen und ein CLAUDE.md-Skelett. Es bearbeitet niemals ein vorhandenes CLAUDE.md und wird niemals zweimal über dasselbe Manifest ausgeführt. Es schreibt nur die House-Hälfte des CLAUDE.md als separate Skelettdatei und überlässt die codebasier-abgeleitete Hälfte dem eigenen Init-Befehl des Harness, der ein startendes CLAUDE.md generiert oder Verbesserungen für das bereits vorhandene vorschlägt.
Dieser Skill hat Seiteneffekte auf der Festplatte, daher wird er niemals von selbst ausgelöst. Führe ihn nur auf Anfrage aus.
Standardablauf
- Trockenlauf: Durchsuche das Repository und drucke das vorgeschlagene
house.json. Nichts schreiben. - Zeige den Vorschlag der Person, die den Skill ausführt, und warte, bis sie sagt, dass er angewendet werden soll.
- Anwenden: Schreibe
house.json, dann rendere die Regeln, Vorlagen und das Skelett. - Drucke den untenstehenden Wiring-Block, damit die Person ihn in
package.json, CI und ihr Terminal einfügen kann.
Überspringe Schritt 2 nicht. Ein Vorschlag, den die Person nie gesehen hat, ist kein Vorschlag, sondern eine Überraschung.
Verweigern, wenn ein Manifest existiert
Bevor du irgendetwas untersuchst, überprüfe, ob house.json bereits im Repository-Stammverzeichnis existiert.
Wenn es existiert, verweigere. Gib aus, dass das Repository bereits ein Manifest hat, und verweise stattdessen auf /house-rules:sync. Dies gilt auch im Trockenlauf: Bootstrap erstellt niemals einen zweiten Vorschlag über einem ersten, selbst wenn keiner noch angewendet wurde. Ein Repository erhält genau einen Bootstrap.
Durchsuche das Repository
Führe die CLI im Trockenlauf aus, um zu sammeln, was der Vorschlag benötigt:
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path>
Die Untersuchung liest, aber schreibt nicht:
- Stack: Vorhandensein von
package.json, dessen Skripten und etwaigen Framework-Konfigurationsdateien im Stammverzeichnis. - Standard-Branch:
git symbolic-ref refs/remotes/origin/HEAD, fallback auf den aktuellen Branch. - Top-Level-Verzeichnisse, um zu erraten, welche optionalen Module zutreffen (
db/deutet aufdatabasehin, eine Deploy-Konfiguration aufdeploymentusw.). - Ob
.claude/rules/oder ein Branch-Guard-Hook bereits existiert, damit der Vorschlag sagen kann, was Bootstrap hinzufügen würde im Vergleich zu dem, was das Repository bereits hat. - Ob das aktuelle Dokumenten-Scanning des Repositorys bereits eine Archivstufe ausschließt, um
scanArchiveaus beobachtetem Verhalten zu bestimmen, nicht aus einer Vermutung. - Ob
git check-ignoresagt, dass ein House-Schreibziel (.claude/rules/house/,.house/) ignoriert wird. Der Checker durchläuftgit ls-files, daher ist eine ignorierte Regeldatei für ihn unsichtbar und der erste Lauf druckt eine Null, die es nicht verdient hat. Die Untersuchung warnt und nennt die Lösung: ignoriere nur.claude/settings.local.json, niemals.claude/oder.house/.
Vorschlage house.json
Jedes Modul, das die Untersuchung nicht ausschließen kann, geht in den Vorschlag als "detect", nicht als true oder false. "detect" bedeutet, dass das Repository zur Renderzeit entscheidet, nicht der Skill, der für es rät. Kernmodule (docs, engineering, github, claude-code) sind immer aktiv. Drucke den vollständigen vorgeschlagenen house.json-Body, nicht eine Zusammenfassung, damit die Person, die ihn überprüft, jedes Feld lesen kann, bevor etwas geschrieben wird.
Anwenden: Manifest, Regeln und Skelett schreiben
Nur nachdem die Person sagt, dass angewendet werden soll:
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply
init --apply schreibt house.json. render --apply schreibt die importierten Regeldateien, die Vorlagen, .house/check.mjs, .house/lock.json, .house/INDEX.md und eine weitere Datei:
- Wenn das Repository ein CLAUDE.md hat, schreibe
CLAUDE.md.house-skeletondaneben. Öffne nicht das vorhandene CLAUDE.md und schreibe nicht hinein. - Wenn das Repository kein CLAUDE.md hat, schreibe immer noch
CLAUDE.md.house-skeleton, nichtCLAUDE.mdselbst. Bootstrap erstellt niemals die Stammdatei des Repositorys. Eine Person führt das Skelett manuell zusammen.
In beiden Fällen ist ein vorhandenes CLAUDE.md byte-identisch vor und nach jedem Bootstrap-Lauf. Das ist die Kontrolle, an die dieser Skill gebunden ist: vergleiche es vor der Anwendung, vergleiche es danach, und wenn sich etwas geändert hat, stoppe und sage dies, anstatt Erfolg zu melden.
Das Skelett wird einmal pro Repository angeboten: render zeichnet es in .house/lock.json unter scaffolds auf, sodass, sobald es in CLAUDE.md zusammengeführt und gelöscht wurde, kein späteres Render es erneut schreibt. render --apply --scaffold ist die Art, es erneut anzufordern.
Stelle sicher, dass das .gitignore des Repositorys .claude/worktrees/ und .superpowers/ enthält, indem du die fehlende Zeile anhängst. Werkzeug-Schrott, der in git status auftaucht, ist nur ein git add -A von einem Commit entfernt.
Drucke den Wiring-Block
Nach einer erfolgreichen Anwendung drucke diesen Block wörtlich, damit er in ein einfaches Terminal kopiert werden kann. Fülle nichts aus; die Person passt ihn an ihr package.json und ihren Workflow an.
Add to package.json scripts:
"check:docs": "node .house/check.mjs --only=drift,todo"
"check:house": "node .house/check.mjs"
Add a CI step that runs:
node .house/check.mjs
Install the plugin once per machine:
claude plugin marketplace add dubbl-a/house-rules
claude plugin install house-rules@house-rules --scope user
Arm the git hooks once per clone (render --apply and every session start also do this):
git config core.hooksPath "$(pwd)/.githooks"
core.hooksPath lebt in .git/config, das kein Clone und kein PR mit sich trägt, daher ist der importierte .githooks/-Baum in einem frischen Checkout inaktiv, bis etwas ihn setzt. render --apply und der SessionStart-Hook des Plugins aktivieren ihn beide; die obige Zeile ist für einen Clone, der keines von beiden hat. Weder sie noch die Person sollten ein core.hooksPath überschreiben, das bereits einem anderen Tool gehört.
Wenn das Repository kein .claude/settings.local.json hat, sage dies in der ausgegebenen Ausgabe. Diese Datei ist der Ort, an dem ein pro-Repo-Opt-out eines House-Moduls oder Hooks leben würde, und ihre Abwesenheit bedeutet, dass das Repository nur mit den Standardeinstellungen läuft.
Nach Bootstrap
Sage der Person, was noch nicht erledigt ist: das Skelett muss noch manuell in CLAUDE.md zusammengeführt und dann gelöscht werden (es wird nicht wieder geschrieben), der Wiring-Block muss noch eingefügt werden, und node .house/check.mjs ist einen lokalen Lauf vor dem ersten Commit wert, damit das Repository von einem sauberen Gate aus startet, nicht von einem vererbten Fehler. Stage die gerenderten Dateien zuerst nach Pfad (house.json .house/ .claude/rules/house/, plus scripts/house/ nur wenn render dort eine Datei aufgelistet hat, da git einen Pfadspezifikator ablehnt, der nichts trifft): bis sie gestaged sind, warnt die Manifamilie [untracked] pro Datei, und ein vollständiger .claude/ oder .house/-Ignor ist ein [gitignored]-Befund, weil eine Datei, die git nicht sehen kann, eine ist, die keine Familie überprüft. Nichts davon ist die Aufgabe dieses Skills für sie zu erledigen; Bootstrap endet beim Render.
Nicht
- Schreibe
house.jsonoder eine gerenderte Datei während des Trockenlaufs nicht. Trockenlauf druckt nur. - Überschreibe oder hänge niemals an ein vorhandenes CLAUDE.md an, unter keinem Flag.
- Erstelle keinen erneuten Vorschlag über einem Repository, das bereits
house.jsonhat. Sende es zu/house-rules:sync. - Rate ein Modul nicht ein oder aus, wenn die Untersuchung mehrdeutig ist. Schlage
"detect"vor und lass das Repository entscheiden.