Home ja

Agent Harness Bootstrap

English · 日本語

二つの Claude Code スキルと、一つのビューアです:

• spec-builder は、あなたにも AI にも読める仕様を書きます。
• harness-bootstrap は、リポジトリに合ったエージェントチームを組みます。
• harness-view は結果を見せ、採点し、どの部分でもオフにできます。

この Wiki はリファレンスです。なぜこれが必要なのかは README に、短縮版は ランディングページ にあります。どちらも まだなら、そちらから始めてください。

flowchart TD
    IN[/"アイデア、メモ、既存文書"/]
    CODE[/"コードベース"/]
    SB["spec-builder"]
    SPEC[/"docs/specs/ 契約"/]
    HB["harness-bootstrap"]
    H[/".claude/ ハーネス"/]
    HV["harness-view"]

    IN --> SB --> SPEC --> HB
    CODE --> HB
    HB --> H -->|"スキャン、採点"| HV

    classDef det fill:#2D6A4F,stroke:#081C15,stroke-width:1px,color:#D8F3DC
    classDef mod fill:#5A189A,stroke:#240046,stroke-width:1px,color:#E0AAFF
    classDef art fill:#495057,stroke:#212529,stroke-width:1px,color:#F8F9FA
    class SB,HB mod
    class HV det
    class IN,SPEC,H,CODE art

Loading

紫はモデルが動く工程、緑は決定的なプログラム、灰色はディスク上のファイルです。

ここから始める

やりたいこと	読むページ
インストールして一度動かす	はじめに
ビルドが意図して小さい理由を知る	テーラードビルド
席、ルール、フック、コマンド、フラグを調べる	下のリファレンスページ
自分のハーネスが実際にどうなっているかを見る	Harness View
何かが発火しない理由を突き止める	トラブルシューティング
よくある疑問を確かめる	FAQ

リファレンス

次の五つのページは scripts/build_wiki.py がリポジトリから生成しています。数字を信用できるのは そのためです (現時点では英語のみ):

• Agent Reference - 席、そのモデルと effort、それぞれがいつインストールされるか
• Rule Reference - どのルールが毎セッション読み込まれ、どれがパス限定か
• Hook Reference - 何が何をブロックし、どの終了コードがそれを行うか
• Command Reference - ハーネスがインストールするすべてのスラッシュコマンド
• Flag Reference - 質問票の各回答が何を有効にするか

Wiki の UI での編集は次のビルドで上書きされます。元のアセットを変更してください。

一段落で言うと

spec-builder は、持ち込まれたもの (アイデア、会議の書き起こし、既存の文書、空のリポジトリ) を、 安定した要件 ID を持つ一つの契約にします。harness-bootstrap はコードを読み、それに合った .claude/ ハーネスを組みます。契約と実在するモジュールから導いた編成、実在するパスに限定した ルール、助言ではなくブロックするフックです。ガードレールはシェルスクリプトと終了コードなので、 安全の下限がモデルに左右されることはありません。harness-view は結果を読んで採点し、こちらも モデルを使いません。

自分で走らせられる証拠

python eval/guardrail_eval.py                        # 安全の下限、フックの種類ごと
python benchmark/benchmark.py                        # ハーネスあり vs 素のリポジトリ
python harness-bootstrap/scripts/port.py --self-test # Cursor と Codex のアダプター
python scripts/check_numbers.py                      # 公開しているすべての数字 vs スクリプト

この Wiki の数字は記憶で書いたものではありません。ページとスクリプトが食い違えば、正しいのは スクリプトで、ページがバグです。