ハーネスアップデートへの適応
このパッケージの継続的なテストとは、ハーネスを補完し改善し、決して重複したり矛盾したりしないことです(意図的に宣言され、ネイティブのフロアが指定されている場合を除く)。ハーネスのリリースは、このテストを3つの方法で破る可能性があります。ルールやメカニズムが行うことをネイティブで提供する場合、そのルールは重複になります。ルールが説明する動作を変更する場合、そのルールは矛盾になります。ルールが引用すべきフロアを追加する場合もあります。また、新しいモデルにより、ルール内のすべての事実が依然として有効であっても、ルールのプロンプトスタイルが古くなる可能性があります。このスキルはこれら4つすべてを発見し修正します。
デフォルトのパス
origin/mainからワークツリーを作成 まずそれを行います。調査ワークフローはクリーンなチェックアウトを読み取るため、誰も編集しない2番目のワークツリーを指定します。- ベースラインを見つける。 最後に調査されたバージョンと日付は、
docs/handbook/sources/harness-survey.mdの最後の日付付きセクションにあります。最新の再調査セクションには、リサーチバンクディレクトリが記載されています。記録上のモデルファクトは、docs/handbook/claude-code.mdの「ladder」パラグラフにあります。npm run check:harnessはそのベースラインとそれ以降のすべてのチェンジログバージョンを出力し、スケジュールされたharness-watchAction はリストが空でない場合にharness-updateイシューを1つ作成します。HARNESS_ROUTINE_URLとHARNESS_ROUTINE_TOKENシークレットが設定されている場合、Action はクラウドルーチンも起動します。ルーチンはデルタ補遺パスを実行し、claude/harness-addendum-<version>にドラフトPRを開きます。そのPRが存在する場合は、再トリアージせずにそこから開始します。claude --versionとも比較します。 - 新しいCLIでゲートを実行 何かを読む前に:クリーンなチェックアウトで
npm run verifyを実行します。プラグインバリデーターは--strictで実行されるため、リリースで追加された警告はゲートを失敗させ、チェンジログのトリアージはそのエントリをノイズとして読み取ることができます。 - デルタをスクラッチパッドに収集 エージェントごとに1つのソースから:
- ベースライン以降のClaude Codeチェンジログセクション(https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md)。これは変更に日付を付ける唯一のソースです。
- 新しいモデル、デフォルト、価格、エフォートのためのモデル概要とモデル設定ページ。
- このリポジトリ上のハーネス自身のプロンプト監査(セッション内の
/doctor prompt-audit)。古いパス、死んだコマンド、矛盾する指示、古いモデル向けに書かれたプロンプトパターンを報告します。
- 深さを選択する。 以下の判断を使用します。選択したものとその理由を述べてください。
- トリアージと分類。 すべての候補には1つの処分が割り当てられます:DUPLICATE(重複)、CONFLICT(矛盾)、COMPLEMENT(補完)、またはUNIQUE(独自)(定義は references/dispositions.md)。ルールファイル、
plugins/house/orchestration/ORCHESTRATION.md、エージェント、フック、スキル、評価をgrepして、古い動作を主張するテキストを探します。 - 検証。 DUPLICATE または CONFLICT は、2人のスケプティックが反論に失敗した場合のみカウントされます。1人はドキュメントの正確性を読み、もう1人は実際の強制力を読み、それぞれが確信が持てない場合はデフォルトで反論として扱います。セッションはその後、引用された行とルールテキスト自体を読みます。実行して解決できるもの(
--help、実際のペイロードを使ったフック、チェッカー)は実行します。 - 処分に基づいて行動する。 ルールまたはフック内の矛盾を解決します。重複を退役させるか、ネイティブのフロアを指定した宣言された重複として保持します。ルールがフロアを主張または暗示している場合にのみ補完を言い換え、事実を引用します。独自のものは記録してそのままにします。プロンプト監査の結果は言い回しを変更しますが、ルールの主張は変更せず、チェッカーが強制するルールの形状に適合する必要があります。エージェントの逸脱、レビュアーの「非ブロッキング」ノート、または「既知の制限」を受け入れる前に、それを統制するハウスルールまたはドキュメントの推奨を指定し、そうしない理由を説明できない限り推奨されるオプションを取ります。
- 記録 references/recording-and-release.md に記述されている3か所に記録します。その後、そこにあるリリースフローを通じて出荷します。
深さの選択
デルタ補遺(デフォルト)。ベースライン以降のチェンジログセクションとモデル変更のみを、ソースごとに1人のリサーチャーでトリアージします。ルールサーフェスに対するヒットを分類し、日付付きの ## Addendum セクションを書き込みます。これは、修正と小さな機能の1~2リリース、およびティアとエフォートに影響を与えるモデル変更に適しています。
完全再調査。 ドキュメントからすべてのハーネス領域を再リサーチし、すべてのルール見出しとメカニズムを分類し、検証し、統合し、完全性批評を実行します。次に、批評家が指定したものに対してギャップパスを実行します。その横でデルタパスからチェンジログのトリアージを実行します:ドキュメントページには日付がないため、チェンジログなしでは完全な実行は現在のページと古いページを区別できません。補遺では不十分であるシグナル:
- デルタが複数の領域に同時に触れている。
- 新しいモデルファミリーまたはデフォルトが到着した。
- プロンプト監査が多くのファイルにわたってパターンをフラグする。
- 補遺で、保存された事実が変更より前のものである領域で矛盾が見つかった。
- 最後の再調査の批評家が、その後誰もリサーチしていない領域をリストした。
スクリプトは scripts/house-vs-harness-audit.js(メイン)と scripts/house-vs-harness-gap-audit.js(ギャップ)です。それぞれ args.repo(クリーンなワークツリーへの絶対パス)と args.date を取ります。ギャップ実行はまた、批評家の結果から args.areas と args.targets、およびメイン実行の結果を補遺に記載するためのオプションの args.context 文を取ります。これらは Workflow ツールを通じて実行され、ユーザーの明示的なオプトインが必要です。尋ねる前に、エージェント数を述べてください:メイン実行は領域ごとに1人のリサーチャー、モジュールごとに1人のOpus分類器とメカニズム用に1つ、重複または矛盾の主張ごとに2人のスケプティック、および2つの統合エージェントです。
危険性
- ほとんどの発見は帰属であり、実質ではありません。 これまでの最大の再調査では、重複も矛盾も見つかりませんでしたが、ルールがドキュメントに記載されていないネイティブフロアを主張している27件の言い換えが見つかりました。ルールがハーネスが何かを行うと言う前に、その事実はバンクまたは取得したページに存在しなければなりません。
- スケプティックは重複と矛盾のみを見ます。 補完の提案された言い換えは、検証されずにレポートに到達し、古いテキストと同じくらい簡単にハーネスを誇張する可能性があります。出荷前に、保存された事実に対して各言い換えをチェックする反論者を送ってください。
- 単純な見出しカウントはルールを見逃します。 すべてのルールファイルは
## Don'tで終わり、実際のルールの中には「Don't」で始まるものもあります。見出しはプレフィックスではなく、完全一致でカウントします。 - ドキュメントページには日付がありません。 すべての引用の横に取得日を記録します。チェンジログとページが矛盾する場合は、いつについてはチェンジログを、何についてはページを信頼します。
- モデル設定はリポジトリの外部にあります。 サブエージェントフロアとモデルごとのエフォートはユーザー設定です。モデル変更によってそれらが移動した場合、ユーザーに何を設定すべきかを伝えてください。ここから設定を編集しないでください。新しくリリースされたモデルは、モデルごとのレベルが適用されるまで、独自のデフォルトエフォートで実行されます。
- プロンプト監査の結果はハウス形状と衝突する可能性があります。 禁止リストやハードナンバーに関する監査フラグはスタイルシグナルです。
## Don'tセクションと長さの上限はチェックされた形状とラチェットであるため、それらの変更はADRに基づくパッケージ決定であり、言い換えではありません。 - ブランチガードはコマンドテキストを読み取ります。 Write ツールを使用して、git 動詞をブランチ名の近くに含むPR本文とコミットメッセージを書き込み、
--body-fileまたは-Fで渡します。 - サブエージェントはコミットしません。 セッションは、エージェントが準備したものをコミットしてプッシュします。
ここでの編集が有効になるタイミング
このスキルはリポジトリローカルです。編集は、それを名前で呼び出す次のセッションに到達し、採用者に出荷されるものはありません。採用者に届くのは、それが生成するルールとメカニズムの変更であり、リリースと各採用者の render --apply を通じてです。