Communitygithub.com

dubbl-a/house-rules

リポジトリにhouseを初めてセットアップし、house.jsonマニフェスト、ベンダールール、CLAUDE.mdスケルトンを提案します。デフォルトではドライランを実行します。「houseをブートストラップ」または「ここにhouseを導入」に使用します。

house-rules とは?

このスキルは、未管理のリポジトリをhouseコンシューマーに変換するためのブートストラッププロセスを提供します。リポジトリをプローブし、house.jsonマニフェストを提案し、--applyフラグを使用してベンダールール、テンプレート、CLAUDE.mdスケルトンを書き込みます。既存のCLAUDE.mdを編集することはなく、同じマニフェストに対して2回実行されることもありません。スキルはデフォルトでドライランモードで動作し、実際のファイル書き込みの前に提案内容を確認できます。ディスクへの副作用があるため、明示的に要求された場合のみ実行されます。Claude Code、Cursor、CodexなどのAIエージェントツールで動作し、house.jsonの設定、ルールのレンダリング、CI/CDワークフローのセットアップをガイドします。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ブートストラップ

ブートストラップは、未管理のリポジトリをhouseコンシューマーに変換します。リポジトリをプローブし、house.jsonを提案し、--apply でベンダールール、テンプレート、CLAUDE.mdスケルトンを書き込みます。 既存のCLAUDE.mdを編集することはなく、同じマニフェストに対して2回実行されることもありません。 CLAUDE.mdのhouse側のみを別のスケルトンファイルとして書き込み、コードベース由来の部分はハーネス自身のinitコマンドに任せます。initコマンドはCLAUDE.mdの初期版を生成するか、既存のものに改善を提案します。

このスキルはディスクに副作用をもたらすため、単独で実行されることはありません。明示的に要求された場合にのみ実行してください。

デフォルトの手順

  1. ドライラン:リポジトリをプローブし、提案されるhouse.jsonを表示します。何も書き込みません。
  2. 提案をスキルを実行している人に表示し、適用するよう指示が出るまで待ちます。
  3. 適用:house.jsonを書き込み、ルール、テンプレート、スケルトンをレンダリングします。
  4. 以下の配線ブロックを印刷し、人が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" を提案し、リポジトリに決定させてください。

Individual skills in this repo

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

関連スキル