Communitygithub.com

dubbl-a/house-rules

セッションの学習内容を適切なルールファイルに振り分け、日付付きの出来事はリポジトリのアーカイブに保存します。「ドキュメントを改訂して」「この学習を保存して」「これはどこに?」のトリガーで動作します。

house-rules とは?

このスキルは公式のインストラクションファイル管理プラグインの `revise` コマンドを置き換えるものです。公式プラグインは学習内容をルートファイルに追記しますが、このスキルは内容をコードベースで検証した後、適切なルールファイルまたはリポジトリのアーカイブに振り分けます。学習内容を「ルール」(繰り返し発生する状況に適用される普遍的な知識)と「インシデント」(一度きりの出来事で、ルールを支える証拠)に分類し、それぞれ専用の場所に保存します。Claude CodeなどのAIエージェント向けに設計されており、具体的なトリガーフレーズ(「revise the docs」「capture this learning」「where does this go」)で起動します。このスキルは管理されたハウスルールを直接編集せず、代わりに上流リポジトリへの変更提案や `house.json` を使った逸脱の記録を推奨するなど、管理ファイルとの同期整合性も考慮しています。

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

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

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

ドキュメント

ドキュメントを改訂する

公式のインストラクションファイル管理プラグインには、セッションの学習内容をルートインストラクションファイルに追記する revise コマンドが含まれています。このスキルは、その動作を置き換えるために存在します。ルートファイルは成長し続けると最後まで読まれなくなり、そこに追記された学習内容は、将来のセッションが必要とする瞬間に必要な事実であることはほとんどありません。このスキルは、そのプラグインの有用な半分(コードベースに対して主張を検証してから書き込む)を保持し、追記部分をルーティングに置き換えます。ハーネス自体のマシンローカルメモリノートは、セッションで学習した内容をすでにキャプチャし、インストラクションファイルに既に記載されている内容をスキップするため、このスキルは共有可能でチェックインされる半分、つまり、対象となる表面をカバーするパスのルールファイルへのルール、リポジトリのアーカイブへのインシデントをルーティングします。

デフォルトのパス

  1. このセッションで生成された、保存する価値のあるものを命名します:修正、決定された規約、バグとその修正、測定結果、2つのアプローチ間の決定。
  2. それを ルール または インシデント に分類します。
    • ルールは、一致する状況が繰り返されるたびに成立します。一度記述すれば、次のリファクタリング後も真であるべきです。
    • インシデントは、日付、名前、または測定された数値が付随する、一度発生した出来事です。これはルールが存在する理由の証拠であり、ルールそのものではありません。
  3. ルールを一致するルールファイルにルーティングします。
    • 既存のルールファイルを、ファイル名だけでなく、スコープと見出しで検索します。学習内容が触れる表面を paths: ですでにカバーしているファイルを開きます。
    • カバーしているファイルがある場合、新しい見出しを追加するか、そのポイントを既存の見出しに統合します。ルールの形状に従います:命令形の見出し(それ自体がルール)、理由の1節、それを強制するものを指定する Anchor: 行、アーカイブエントリを指す Receipts: 行。ファイルの末尾は ## 禁止事項 で終わらせます。
    • 書き込む前に検証します。Anchor: 行のすべてのトークン、すべてのパス、すべてのスクリプト名が、現在リポジトリ内で実際に解決されることを確認します。これは上記のプラグインから借用した監査習慣です:確認していない主張は決して書き込まないでください。
    • 何もカバーしていない場合は、その旨を伝え、新しいルールファイルまたは既存のファイルのより広いスコープを提案します。近いという理由だけで、最も近いファイルにポイントをドロップしないでください。
  4. インシデントをリポジトリのアーカイブ階層にルーティングします。
    • アーカイブとは、リポジトリが日付付きの証拠文書(ハンドブックの章、設計履歴ファイル、事後分析ログなど)と呼ぶものです。日付、名前、測定値をそこに書き込み、1行の教訓をタイトルとして、エントリがファイル名ではなく主張として読まれるようにします。
    • ルールファイルから、引用符で囲んだ見出しを使ってエントリをポイントします。ルールの散文内でインシデントの詳細を繰り返し述べないでください。ルール内の日付や数値は、ルールの衣服を着た歴史です。
    • リポジトリにまだアーカイブがない場合は、その旨を伝え、アーカイブを開始することを提案します。居場所がないからといって、インシデントをルールファイルやルートファイルに統合しないでください。
  5. ルートインストラクションファイルには決して触れないでください。ルールファイルもアーカイブも適切でない場合、それはその事実が保存するほど耐久性がないことを示しており、デフォルトでルートファイルに入れる理由にはなりません。そのことを明確に伝え、停止します。
  6. 保存する前に編集内容を表示します。提案する見出しと段落、または既存のファイルに対する差分を表示し、変更を実行するだけと明確に指示された場合を除き、確認を待ちます。

一致が管理されたハウスルールの場合

トピックをすでにカバーしているファイルがベンダー提供のハウスルール(管理ファイルヘッダーを持ち、.claude/rules/house/** の下にある)である場合、このリポジトリでは編集しないでください。管理ファイルへのローカル編集は、次回の /house-rules:sync 実行で自動的に上書きされ、そのサイレントロスはまさにハウスルールが防止しようとしているものです。

代わりに、上流で変更を提案します。同じ見出しと段落をドラフトし、このリポジトリではなくハウスルールリポジトリで変更として開くように指示します。そのポイントがフリート全体のルールではなく、このリポジトリに固有のものである場合は、管理ファイルをフォークする代わりに、house.json に逸脱として記録します。どちらのパスも管理ファイルの同期を保ちます。その場で編集することはしません。

エスケープハッチ

  • 学習内容が既存のルールと矛盾する場合。 そのことを明確に述べ、既存の見出しを引用し、何かを書き込む前にどちらが優先されるかを尋ねます。あるルールを別のルールで黙って上書きしないでください。
  • 学習内容がリポジトリ固有の使い捨てであり、ルールの形状を持たない場合(ベンダーバグの回避策、一度だけ重要なメモなど)。ルールファイルを散らかす代わりに、インシデントとしてアーカイブにルーティングします。将来のセッションが従う必要のないものです。
  • 何かがルールかインシデントか確信が持てない場合。 アーカイブに偏ります。誤ってアーカイブされたルールは、後で誰かがプロモートできる見出しです。誤ってルール化されたインシデントは、何もフラグを立てない古い散文になります。
  • リポジトリにルールファイルもアーカイブもまったくない場合。 そのことを明確に伝え、このスキル内からどちらかを発信するのではなく、停止します。それは /house-rules:bootstrap の仕事であり、このスキルの仕事ではありません。

禁止事項

  • ルートインストラクションファイルに追記しないでください。それは公式のインストラクションファイルプラグインの revise コマンドが実行する動作であり、このスキルが代わりに存在する理由です。
  • コードベースに対して確認していないアンカーを含むルール文を書かないでください。
  • ルールの散文内でインシデントの日付、名前、または数値を繰り返し述べないでください。アーカイブをポイントします。
  • ベンダー提供のハウスルールファイルをその場で編集しないでください。上流に提案するか、逸脱を記録します。
  • 相手が確認していない編集を保存しないでください。ただし、変更を実行するだけと明確に指示された場合は除きます。
  • リポジトリにない場合、ルールファイルやアーカイブを発明しないでください。

Individual skills in this repo

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

関連スキル