Communitygithub.com

House ルール同期

リポジトリのベンダーハウスファイルをインストール済みプラグインのバージョンと同期し、ローカルの編集を決して静かに破棄しないスキルです。

House ルール同期 とは?

このスキルは、`/house-rules:sync` コマンドを介して、リポジトリ内のベンダー化されたハウスルールファイルを、インストールされているプラグインの最新バージョンと同期させるためのものです。ファイルの上書きを行うため、単なる参照クエリでは起動せず、明示的なコマンドでのみ呼び出されます。主な処理フローは、まず `house.json` がリポジトリルートに存在するか確認し、なければブートストラップが必要であることをユーザーに通知します。次に、`render` コマンドを `--apply` なしで実行し、各管理ファイルの状態(クリーン、欠落、ローカル変更)をドライランで分類します。ローカル変更があるファイルに対しては、決して静かに上書きせず、上流へのPR送信、逸脱の記録、強制上書きの3つの排他的な選択肢を提示します。最後に、`--apply` で変更を適用し、チェッカーとドクターを実行して、変更が正しく適用され、追加の注意点がないことを確認します。このスキルはClaude CodeなどのAIエージェント環境で使用することを想定しており、ユーザーが明示的に `/house-rules:sync` を呼び出した場合にのみ動作します。

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

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

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

ドキュメント

ハウス同期

リポジトリのベンダーハウスファイルをインストール済みプラグインの最新バージョンと同期し、ローカルの編集を決して静かに破棄しない。このスキルは /house-rules:sync 経由でのみ呼び出すこと。これはファイルを書き込むスキルであり、規約に関する単なる質問から発動することはありません(その場合は /house-rules:conventions を使用してください)。

このスキルが駆動するCLI:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house <init|render|check> [--repo <path>] [--apply] [--force-managed <path>]

--repo のデフォルトはカレントディレクトリです。以下では init、render、check 以外のサブコマンドを発明することはありません。

デフォルトのパス: 計画、そして適用

同期にはただ一つのデフォルトパスがあります。毎回この順序で実行してください。

1. リポジトリがハウスを採用していることを確認する

リポジトリルートの house.json を読み取ります。house.json がない場合は、このリポジトリがまだブートストラップされていないことを意味します: 停止し、ユーザーに /house-rules:bootstrap を実行するように伝えてください。マニフェストがないことを「同期するものがない」と扱わないでください。

2. 計画 (ドライラン)

node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path>

--apply がない場合、これは計画のみを行います。.house/lock.json (各エントリ: path, module, source, bodySha256) を読み取り、ディスク上の各管理ファイルの現在のボディハッシュをロックと比較し、次に新しくレンダリングされるボディと比較します。各管理ファイルを正確に1つのバケットに分類します:

  • クリーン. ディスク上のハッシュがロックと一致します。計画: 新しくレンダリングされたボディで上書きします。
  • 欠落. ファイルがディスク上に存在しません。計画: 復元します。
  • ローカル変更. ディスク上のハッシュがロックともレンダリングされたno-opとも一致しません。計画: 拒否します。以下の3つの出口を参照してください。

他のことをする前に計画を出力してください。このステップでは、クリーンまたは欠落ファイルに対しても何も適用しないでください。

3. ローカル変更: 3つの出口、決して暗黙の選択はない

ローカルに変更された管理ファイルは、マージされず、上書きされず、静かに放置されることもありません。ディスク上のファイルとハウスがレンダリングするものとの差分を出力し、次に以下の3つの出口を正確にこの順序で出力し、そのファイルに対して停止します (--apply 下でもファイルは未変更のまま保持され、単に書き込みから除外されます):

  1. 上流優先. 変更を加えたハウスパッケージリポジトリ自体 (dubbl-a/house-rules) に対してPRを開き、その編集がプライベートフォークではなく、全員の新しいハウスルールになるようにします。これが推奨される出口です。
  2. 逸脱を記録し管理対象から外す. house.json の deviations 配列に why を持つエントリを追加し、ファイルを管理セットから削除し、リポジトリの CLAUDE.md の ## Deviations from house セクションにミラーリングします。これは編集が本当にリポジトリ固有であり、決して上流に送られない場合に使用します。
  3. 強制上書き. 以下を実行します:
    node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --force-managed <path>
    
    これはローカル編集が破棄可能であることが確認された場合にのみ使用し、最も高速であるためデフォルトとして決して使用しないでください。実行する前にユーザーに確認を求めてください。ユーザーに代わってプロンプトなしで選択しないでください。

4つ目のオプションを提供したり、これを選択を待つインタラクティブメニューにしないでください。3つの出口を実行の結果として述べ、ユーザー(またはこのスキルの後続の呼び出し)がいずれか1つに対して行動できるようにします。

4. 適用

クリーンなファイルと欠落ファイルが accounted for され、ローカルに変更されたすべてのファイルが3つの出口のいずれかにルーティングされるか(または意図的に拒否されたまま)、適用します:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house render --repo <path> --apply

これにより、クリーンなファイルと欠落ファイルが書き込まれます。拒否されたままのローカル変更ファイルには決して書き込みません。--force-managed がそれを行う唯一のパスであり、指定された1つのパスに対してのみです。

レンダリングが warning: ... is git-ignored という行を出力した場合、続行する前に停止して無視ルールを修正してください: git が認識できない宛先はチェッカーやCIに届きません。.claude/settings.local.json のみを無視し、.claude/ や .house/ を決して無視しないでください。

レンダリングまたはチェッカーが warning: module is not in house.json, but <dir>/ exists here を出力した場合、このリポジトリの house.json が作成された後にモジュールが出荷され、そのルールはリポジトリが modules の下に "<name>": {"enabled": true} を追加するまでベンダー化されていません。自分でキーを追加しないでください: 警告行をそのまま同期PRの本文に、新しいモジュールがこのリポジトリに適用され、採用者の選択が必要であると述べる行の下にコピーしてください。

4b. レンダリングが書き込んだものをパスごとにステージングする

git add house.json .house/ .claude/rules/house/

レンダリング計画がそこにファイルをリストした場合にのみ、そのコマンドに scripts/house/ を追加してください。git はパススペックが何も一致しない場合、コマンド全体を拒否します。明示的なパスで、決して git add -A はしないでください: チェッカーとCIは git ls-files を読み取るため、ステージングされていないレンダリングファイルは誰もチェックしないものであり、ブランケット追加はツリーにある他のものをすべて掃き込んでしまいます。

レンダリングの Scaffolded リスト (.github/PULL_REQUEST_TEMPLATE.md、.github/workflows/pr-checks.yml、CLAUDE.md スケルトン) は管理ファイルではないため、[untracked] 警告はそれを認識できません: それらのファイルをレビューし、パスごとにステージングしてください。

スキャフォールドはレンダリングごとではなくリポジトリごとに1回提供されます。ロックの scaffolds リストは、このリポジトリがすでに受け取ったテンプレートを記録します。記録されたテンプレートは、そのファイルがまだディスク上にあるかどうかに関係なく、二度と書き込まれることはありません。そのため、CLAUDE.md.house-skeleton が CLAUDE.md にマージされて削除された場合、削除されたままであり、再同期で rm する必要はありません。リポジトリがそれを戻したい場合、render --apply --scaffold は欠落しているスキャフォールドを書き込み、既存のファイルを決して上書きしません。scaffolds キーが0.2.3以降の最初の同期でロック差分に現れることを期待してください。これは記録でありハッシュではなく、何もそれを拒否しません。

4c. Gitignore ツールスクラッチ

リポジトリの .gitignore に .claude/worktrees/ と .superpowers/ が含まれていることを確認し、欠けている行を追加してください。git status に表示されるツールスクラッチは、git add -A がされるとコミットされてしまいます。

5. ピンを確認する

house.json にロードされたプラグインバージョンが含まれていることを確認します。レンダリングによって書き込まれ、手動で編集しないでください。render --apply は version フィールドを以下のプラグインバージョンに設定します:

${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json

これを確認するために installed_plugins.json を決して読み取らないでください。これはリポジトリ間のインストール状態を記録し、現在ロードされているものと遅れたり異なったりする可能性があります。CLAUDE_PLUGIN_ROOT の下の plugin.json が実際にこの同期を実行しているバージョンです。

6. ベンダー化されたチェッカーで検証する

CI と prebuild が実際に実行する方法でチェッカーを実行してください。プラグイン自身のコピーではありません:

node .house/check.mjs

node ${CLAUDE_PLUGIN_ROOT}/scripts/house check --repo <path> はプラグイン自身のペイロードに対して同一のロジックを実行し、.house/check.mjs がリポジトリにベンダー化される前(初回同期時)に便利です。ベンダー化されたコピーが存在する場合は、それを直接実行することで、出荷されるファイルが実際にパスするファイルであり、同じように見えるだけのコピーではないことを証明します。

ここでの [untracked] 警告は、ステップ4bでそのファイルがスキップされたことを意味します。ステージングして再実行してください。[gitignored] の発見は、ステップ4の無視ルールがまだ管理ファイルを飲み込んでいることを意味します。

7. ドクターの出力を表示する

チェックの実行後、ドクターを実行しその行を報告してください:

node ${CLAUDE_PLUGIN_ROOT}/scripts/house doctor --repo <path>

各出力行の意味 (ラベルは doctor が出力する通り):

  • effective branch guard: plugin | repo | NONE.
    • NONE: house.json がなく、リポジトリローカルのフックもありません。現在、保護ブランチへの直接コミットをガードしているものは何もありません。
    • repo: リポジトリローカルの .claude/hooks/no-direct-master.sh ファイルが存在するか、.claude/settings.json が hooks ブロックを持っています。移行中はリポジトリフックが優先されます。プラグインフックは deferred になり、exit 0 になります。
    • plugin: house.json が存在し、リポジトリローカルのフックシグナルがどちらも存在しません。プラグインフックが実際に branchPolicy と protectedBranches を強制しているものです。house.json が guard レコードを持つ場合は plugin (recorded <date>)、持たない場合は plugin (unrecorded) と出力されます。これはチェッカーの guard 警告がクリアされているかどうかについてのみです。フックはどちらにせよ同じように強制します。
  • git-hook floor: .... ベンダー化された .githooks/ ツリーがこのクローンで実際にgitに配線されているかどうか。core.hooksPath は .git/config に存在するため、これはマシン状態であり、クローン、レンダリング、PRはそれを保持しません。チェッカーはそれを決して読み取りません(ADR 0008 はチェッカーをリポジトリのみに保ちます)。そしてドクターがそれを報告する場所です。
    • armed (core.hooksPath=<path>, <scope>): git がここでフロアを実行しています。何もする必要はありません。
    • NOT armed -- core.hooksPath is unset in this clone: フロアはレンダリングされていますが、非アクティブです。house render --apply で有効化されるか、プラグインがインストールされた状態でリポジトリでセッションを開始すると有効化されます。
    • NOT armed -- core.hooksPath is <other>: 別のツール(husky、lefthook、モノレポの慣習)が、このリポジトリが持つ唯一の hooksPath を所有しています。House はそれを決して上書きしません。そこからフロアをチェーンするか、それを unset して render を再実行してください。
    • not rendered here (missing: <paths>): 7つのフロアファイルのうち少なくとも1つが欠落しており、行はそれらを指定します。7つすべてが欠落しているのは、単にまだフロアをレンダリングしていないリポジトリです。1つ欠落しているのは見た目以上に悪いです。すべてのガードは .githooks/house-lib.sh を source し、その source が失敗した場合に非ゼロで終了します。そのため、ライブラリのみが欠落しているフロアは、フェイルオープンする代わりにすべてのコミットを失敗させます。いずれにせよレンダリングしてください。
    • not applicable: このルートに house.json がないか、branchPolicy が pr ではありません。
    • インデントされた後続の行は、保護的ではなくフロアを静かにするものを報告します。foreign hooks in this clone's .git/hooks: アーミングは拒否されます。なぜなら core.hooksPath は .git/hooks を完全に置き換え、それらを静かに無効にするからです。not executable: git はビットがないフックを静かに無視するため、失われたモードはフェイルオープンです。レンダリングはそれを復元します(ファイルを読み取れるクラスに対してのみビットを追加するため、意図的に 0600 のフックは 0700 に戻り、決して拡張されません)。reference-transaction: supported by git <version> (>= 2.28) または inert on git <version> (needs 2.28): 2.28 以降ではフロアにどのフラグもオフにできないメンバーがあり、inert な行は表面的なものではなく実際のギャップです。2.28 未満では --no-verify は pre-commit と pre-push を一緒にスキップし、他にそれをキャッチするものはありません。そのため、そのgitではフラグはセッション時間の PreToolUse フックによってのみ拒否され、ループ内にセッションがない場合、それは存在しません。この行をgitをアップグレードするプロンプトとして扱い、メモとして扱わないでください。
  • jq on PATH: yes | no. フックはそれなしでも拒否します(手書きのdeny JSON)が、ギャップを報告して修正されるようにします。
  • pin vX matches plugin vY | pin vX differs from installed plugin vY. house.json の version とプラグイン自身の plugin.json の比較。ステップ5と同じ比較です。differs はピンの更新がまだ行われていないか、スキップされたことを意味します。
  • npm wiring (.house/check.mjs referenced by): <scripts> | none found. .house/check.mjs --only=drift,todo を呼び出す check:docs (または同等の軽量なスクリプト)と、完全な .house/check.mjs を呼び出す check:house スクリプトを期待します。いずれかが欠落している場合、package.json を直接編集するのではなく、コピー&ペースト可能なスニペットを出力してください:
    "check:docs": "node .house/check.mjs --only=drift,todo"
    "check:house": "node .house/check.mjs"
    
  • rule-load positive control: .... InstructionsLoaded フックが配線されているかどうか、そしてその独自のログが実際に何を目撃したか。これがないと、グロブが決して一致しないルールは、何もしないルールとまったく同じに見えます。repo (.claude/settings.json): リポジトリが独自のフックを宣言しています。plugin hook; log <path>: last load <ts>, <n> of <m> vendored rules seen: プラグイン自身のフックが配線され、少なくとも1回のロードをログに記録しており、実際にロードされたベンダールールファイルの実数を持っています。<n> が <m> より少ない場合、行は ; not seen in this log: <names> と続き、ログがロードを保持していない各ベンダールールを名前で示します。なぜなら、数だけでは何かが間違っているとわかっても、どのファイルを開けばいいかわからないからです。そのリストをリードとして読み、評決として読まないでください。ログは自己トリミングされるため、ルールはずっと前にロードされた後にのみそこに現れる可能性があり、誠実な次のステップは、ルールの paths: が主張するファイルを開き、ドクターを再実行することです。それを生き残った名前は、その範囲が書かれたファイルに到達していないルールです。plugin hook declared; no log yet for this checkout: プラグインのフックは配線されていますが、ここではまだ何もログに記録していません -- このリポジトリでセッションを開始し、ドクターを再実行してください。none wired: 何もフックを宣言していません。
  • git-ignored house destinations: none | <paths>. none 以外は、チェッカーが認識できない宛先です。ステップ4と同様に無視ルールを修正してください。

8. リポジトリが上流で修正できないものを、アイテムごとに1つのIssueにルーティングする

同期またはコンプライアンスパスは、多くの場合、パッケージのみが対処できる所見や警告を表面化します: チェッカーのギャップ、ここに存在しないファイルに名前を付けるルールアンカー、リポジトリが必要としスキーマに欠けている設定スロット。そのような各アイテムに対して、同じセッションで上流で修正するか(パッケージリポジトリへのブランチとPR。ステップ3と同じ上流優先の出口)、またはパッケージリポジトリにアクション可能なアイテムごとに1つのIssueをファイルし、単一の変更でクローズできるほど小さくします。

決して複数アイテムのダイジェストIssueにバッチ化しないでください: ダイジェストは最も遅いアイテムが着地するまでクローズできず、そのアイテムは独立して優先順位付けできず、半分解決されたダイジェストが蓄積されます。このリポジトリに残るのは、このリポジトリが修正できるものだけです。

エスケープハッチ

これらは上記のデフォルトパスでインラインで表面化される例外であり、事前に選択するための別個のメニューではありません:

  • house.json がない: ステップ1で停止し、/house-rules:bootstrap を指定します。
  • ローカルに変更されたファイル: ステップ3の3つの出口。
  • 破棄可能であることが確認されたローカル編集: --force-managed <path>。尋ねた後にのみ。
  • リポジトリでの初回同期、.house/check.mjs がまだベンダー化されていない: ステップ6でベンダー化されたパスの代わりに house check --repo <path> を使用し、これが1回限りの置換であり、定常状態ではないことに注意してください。

してはいけないこと

  • ローカルに変更された管理ファイルをマージしないでください。

…

[truncated for translation]

Individual skills in this repo

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

関連スキル