ブートストラップ
ブートストラップは、未管理のリポジトリをhouseコンシューマーに変換します。リポジトリをプローブし、house.jsonを提案し、--apply でベンダールール、テンプレート、CLAUDE.mdスケルトンを書き込みます。
既存のCLAUDE.mdを編集することはなく、同じマニフェストに対して2回実行されることもありません。
CLAUDE.mdのhouse側のみを別のスケルトンファイルとして書き込み、コードベース由来の部分はハーネス自身のinitコマンドに任せます。initコマンドはCLAUDE.mdの初期版を生成するか、既存のものに改善を提案します。
このスキルはディスクに副作用をもたらすため、単独で実行されることはありません。明示的に要求された場合にのみ実行してください。
デフォルトの手順
- ドライラン:リポジトリをプローブし、提案される
house.jsonを表示します。何も書き込みません。 - 提案をスキルを実行している人に表示し、適用するよう指示が出るまで待ちます。
- 適用:
house.jsonを書き込み、ルール、テンプレート、スケルトンをレンダリングします。 - 以下の配線ブロックを印刷し、人が
package.json、CI、ターミナルに貼り付けられるようにします。
ステップ2をスキップしないでください。人が一度も見ていない提案は提案ではなく、驚きです。
マニフェストが存在する場合は拒否
プローブする前に、リポジトリルートにhouse.jsonが既に存在するかどうかを確認します。
存在する場合は拒否します。リポジトリには既にマニフェストがあると表示し、代わりに /house-rules:sync を参照するよう指示します。
これはドライランでも同様です。ブートストラップは、最初の提案の上に2番目の提案を作成しません。たとえ誰も適用していなくてもです。リポジトリは正確に1回のブートストラップを得ます。
リポジトリをプローブする
提案に必要なものを収集するために、CLIをドライランモードで実行します。
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path>
プローブは以下の項目を読み取り、書き込みはしません。
- スタック:
package.json、そのスクリプト、およびルートにあるフレームワーク設定ファイルの存在。 - デフォルトブランチ:
git symbolic-ref refs/remotes/origin/HEAD、フォールバックとして現在のブランチ。 - トップレベルのディレクトリ。どのオプションモジュールが適用されるかを推測します(
db/はdatabaseを示唆、デプロイ設定はdeploymentを示唆、など)。 .claude/rules/またはブランチガードフックが既に存在するかどうか。提案で、ブートストラップが何を追加するか、リポジトリが既に持っているかを示せるようにします。- リポジトリの現在のドキュメントスキャンがアーカイブ階層を既に除外しているかどうか。推測ではなく、観察された動作から
scanArchiveを設定するため。 git check-ignoreがhouseの書き込み先(.claude/rules/house/、.house/)を無視しているかどうか。チェッカーはgit ls-filesを調べるため、無視されたルールファイルは見えず、最初の実行では獲得していないゼロを表示します。プローブは警告し、修正方法を示します:.claude/settings.local.jsonのみを無視し、.claude/や.house/は無視しない。
house.jsonを提案する
プローブが除外できないすべてのモジュールは、true や false ではなく "detect" として提案に含められます。"detect" は、スキルが代わりに推測するのではなく、レンダリング時にリポジトリが決定することを意味します。
コアモジュール(docs、engineering、github、claude-code)は常にオンです。
提案された house.json の全文を表示します。要約ではなく、確認している人が何か書き込まれる前にすべてのフィールドを読めるようにします。
適用:マニフェスト、ルール、スケルトンを書き込む
人が適用すると言った場合のみ:
node ${CLAUDE_PLUGIN_ROOT}/scripts/house init --repo <path> --apply
node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply
init --apply は house.json を書き込みます。render --apply はベンダールールファイル、テンプレート、.house/check.mjs、.house/lock.json、.house/INDEX.md、およびもう1つのファイルを書き込みます。
- リポジトリにCLAUDE.mdがある場合、その隣に
CLAUDE.md.house-skeletonを書き込みます。既存のCLAUDE.mdを開いたり、その中に書き込んだりしないでください。 - リポジトリにCLAUDE.mdがない場合でも、
CLAUDE.md.house-skeletonを書き込みます。CLAUDE.md自体ではありません。ブートストラップはリポジトリのルートファイルを作成しません。人が手動でスケルトンをマージします。
どちらの場合でも、既存のCLAUDE.mdはすべてのブートストラップ実行の前後でバイト単位で同一です。これがこのスキルが守るべき制御です。適用前に差分を確認し、適用後にもう一度差分を確認し、何かが移動した場合は停止して成功を報告する代わりにその旨を伝えてください。
スケルトンはリポジトリごとに1回提供されます。render はそれを .house/lock.json の scaffolds の下に記録するため、一度CLAUDE.mdにマージされて削除されると、それ以降のレンダリングでは書き戻されません。render --apply --scaffold は、再度要求する方法です。
リポジトリの .gitignore に .claude/worktrees/ と .superpowers/ が含まれていることを確認し、欠けている行を追加します。git status に表示されるツールのスクラッチは、git add -A を実行すればコミットされる状態になります。
配線を印刷する
適用が成功した後、以下のブロックをそのまま印刷して、プレーンなターミナルにコピー&ペーストできるようにします。何も入力しないでください。人が自分の package.json とワークフローファイルに合わせて調整します。
package.jsonスクリプトに追加:
"check:docs": "node .house/check.mjs --only=drift,todo"
"check:house": "node .house/check.mjs"
以下のコマンドを実行するCIステップを追加:
node .house/check.mjs
マシンごとに一度プラグインをインストール:
claude plugin marketplace add dubbl-a/house-rules
claude plugin install house-rules@house-rules --scope user
クローンごとに一度gitフックを設定(render --apply と各セッション開始時にも行われます):
git config core.hooksPath "$(pwd)/.githooks"
core.hooksPath は .git/config に保存されます。これはどのクローンやPRにも引き継がれないため、ベンダー提供の .githooks/ ツリーは、何かが設定するまで新しいチェックアウトでは非アクティブです。render --apply とプラグインのSessionStartフックはどちらもそれを設定します。上記の行は、どちらも持っていないクローンのためのものです。どちらも、他のツールが既に所有している core.hooksPath を上書きすべきではありません。
リポジトリに .claude/settings.local.json がない場合は、印刷された出力でその旨を伝えます。そのファイルは、houseモジュールやフックのリポジトリごとのオプトアウトが保存される場所であり、その欠如はリポジトリがデフォルト設定のみで実行されていることを意味します。
ブートストラップ後
まだ完了していないことを人に伝えます。スケルトンはまだ手動でCLAUDE.mdにマージして削除する必要があること(再度書き込まれることはありません)、
配線ブロックはまだ貼り付ける必要があること、そして node .house/check.mjs を最初のコミットの前にローカルで実行する価値があること。これにより、リポジトリが継承された障害ではなく、クリーンなゲートから開始されます。レンダリングされたファイルをパスでステージングします(house.json .house/ .claude/rules/house/、および scripts/house/ はレンダリングがそこにファイルをリストした場合のみ。gitは何もマッチしないパス指定を拒否するため)。ステージングされるまで、マニフェストファミリーはファイルごとに [untracked] 警告を表示し、包括的な .claude/ または .house/ の無視は [gitignored] の発見になります。gitが見えないファイルは、どのファミリーチェックも行われないからです。これらのどれもこのスキルの仕事ではありません。ブートストラップはレンダリングで停止します。
禁止事項
- ドライラン中に
house.jsonやレンダリングされたファイルを書き込まないでください。ドライランは表示のみです。 - 既存のCLAUDE.mdを決して上書きしたり追記したりしないでください。あらゆるフラグの下でも。
- 既に
house.jsonがあるリポジトリに対して再提案しないでください。/house-rules:syncに送ってください。 - プローブが曖昧な場合に、モジュールをオンまたはオフと推測しないでください。
"detect"を提案し、リポジトリに決定させてください。