Communitygithub.com

House-Regeln – Bootstrap

Richtet ein Repository als House-Consumer ein, indem es ein `house.json`-Manifest vorschlägt, Regeln ablegt und ein CLAUDE.md-Skelett erstellt – standardmäßig als Trockenlauf. Verwende „Bootstrap House“ oder „Adopt House Here“.

Was ist House-Regeln – Bootstrap?

Der Skill **Bootstrap** verwandelt ein unverwaltetes Repository in einen House-Consumer. Er untersucht das Repository, schlägt ein `house.json`-Manifest vor und schreibt bei Bestätigung (`--apply`) die importierten Regeln, Vorlagen und ein CLAUDE.md-Skelett. Der Skill kann auf verschiedenen Plattformen wie Claude Code oder Codex eingesetzt werden und vermeidet es, bestehende CLAUDE.md-Dateien zu überschreiben. Er führt standardmäßig einen Trockenlauf durch, um unerwünschte Seiteneffekte zu verhindern. Der Bootstrap-Prozess analysiert den Stack, den Standard-Branch, Projektstruktur und vorhandene Konfigurationen, um ein maßgeschneidertes Manifests zu erstellen. Nach der Anwendung druckt der Skill einen Copy-Paste-fähigen Block für die Integration in `package.json`, CI und das Terminal aus.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. Trockenlauf: Durchsuche das Repository und drucke das vorgeschlagene house.json. Nichts schreiben.
  2. Zeige den Vorschlag der Person, die den Skill ausführt, und warte, bis sie sagt, dass er angewendet werden soll.
  3. Anwenden: Schreibe house.json, dann rendere die Regeln, Vorlagen und das Skelett.
  4. 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 auf database hin, eine Deploy-Konfiguration auf deployment usw.).
  • 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 scanArchive aus beobachtetem Verhalten zu bestimmen, nicht aus einer Vermutung.
  • Ob git check-ignore sagt, dass ein House-Schreibziel (.claude/rules/house/, .house/) ignoriert wird. Der Checker durchläuft git 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-skeleton daneben. Öffne nicht das vorhandene CLAUDE.md und schreibe nicht hinein.
  • Wenn das Repository kein CLAUDE.md hat, schreibe immer noch CLAUDE.md.house-skeleton, nicht CLAUDE.md selbst. 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.json oder 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.json hat. 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.

Individual skills in this repo

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

Verwandte Skills