tetriz-harness

tetriz-harnessは、AIコーディングツールのルール、スキル、フック、エージェントなどの設定を検査・改善するオープンソース開発者向けツールです。推奨内容をレビューし、承認済みの変更を開発者やチームへ配布できます。

AIコーディングハーネスの推奨事項と管理された配布

tetriz-harnessは、AIコーディングエージェントを導くハーネスを評価・改善するためのオープンソース開発者向けツールです。そのハーネスモデルには、Claude Code、Codex、Cursor、Kiroなどのツール向けのルール、スキル、エージェント、コマンド、フック、MCP設定が含まれます。

このリポジトリは、リポジトリを認識するスキャナーと推奨エンジンを、承認済みの変更を配布するコントロールプレーンと組み合わせています。チームは検出された問題を確認し、コーディングや組織のシグナルを使用して追加の推奨事項を導出し、検出結果をレビューしたうえで、選択した成果物を開発者やグループに配布できます。オーディエンスターゲティングでは、手動で管理するテスト・コントロール展開にも対応しますが、結果の分析はコントロールプレーンの外部で行います。

主な機能

ハーネスの問題を検出

コミット済みのハーネスファイルをリポジトリのパスや設定と照合し、競合、存在しないファイルへの参照、どのファイルにも一致しないパターン、範囲が広すぎる権限を、根拠と検出器のカバレッジとともに特定します。

コーディングシグナルから推奨事項を導出

組織のセッション分析、コードレビューのテーマ、セキュリティシグナルを使用して、新しいルール、エージェント、フックを提案します。このワークフローには、入力済みのシグナルデータ、同梱のtetriz-pyサービス、モデルキーが必要です。

インベントリと使用状況の証拠を利用

使用状況を踏まえた検査のために、取り込みレイヤーを通じて提供された個人のハーネスインベントリや呼び出し記録を利用できます。ディスク上のチェックアウトスキャンだけでは、これらの入力を推測できません。

変更をレビューして承認

検出結果と推奨事項を保存し、公開前にチームが内容を確認して、採用する変更を明示的に選択できるようにします。

承認済みの成果物を配布

承認済みのハーネス成果物を配布するためのGoサーバーライブラリ、管理UIを備えたリファレンスホスト、harness-agent CLI、Nodeライブラリを提供します。

展開を対象指定して監視

指定した個人、チーム、または組織全体を対象にルール、スキル、フック、エージェントを配布し、サポートされているユーザー設定の場所または既知のリポジトリチェックアウトにインストールして、個人ごとのインストール状況を報告します。

実用的なユースケース

既存のリポジトリハーネスを監査
コミット済みのハーネスファイルに対してDETECTEDスキャンを実行し、ハーネスを変更する前に、古い参照、効果のないファイルパターン、競合、意図より広範な権限を見つけます。
チームのシグナルを提案成果物に変換
セッション分析、コードレビューのテーマ、セキュリティシグナルを組み合わせ、繰り返し発生するエンジニアリングパターンに対処する候補ルール、エージェント、フックを特定します。
管理されたチーム展開を実行
選択した推奨事項のみをレビューして公開し、指定した開発者、チーム、または組織全体に配布しながら、インストール状況を確認します。
手動でハーネス実験を実施
相互に重複しないテストグループとコントロールグループを作成し、ハーネス変更をテストグループだけに対象指定して、外部のセッション分析またはレビュー分析システムを使用してコーディング結果を比較します。
ローカルエージェントの証拠で分析を補強
スタンドアロンのAgent Desk探索・セッション抽出パッケージをアダプター経由で使用し、ハーネスインベントリと観測されたアクティビティを推奨ワークフローに提供します。

Pros and Cons

Pros

リポジトリを認識した静的検査と、コーディング、レビュー、セキュリティ、インベントリ、使用状況のシグナルに基づく推奨事項を組み合わせています。
推奨事項のレビューと公開・配布を分離することで、導入を明示的に管理できます。
個人、チーム、組織単位で対象を指定でき、対象ユーザーのインストール状況を報告します。
ホスト型インターフェースだけでなく、組み合わせて利用できるGo、Node、CLI、サーバー、管理UIのコンポーネントとして提供されています。

Cons

シグナルに基づく推奨事項には、追加のデータソース、取り込みアダプター、同梱のtetriz-pyサービス、モデルキーが必要です。
リポジトリに記載されている展開プロセスは、コホートのランダム化、組み込みの実験分析、自動的なバージョン復元ではなく、手動管理です。
Agent Deskとの連携では、JSONまたはSQLiteのストアを直接インポートできず、アダプターが必要です。

FAQ

tetriz-harnessとは何ですか？

AIコーディングハーネスファイルをスキャンし、リポジトリと組織のシグナルから推奨事項を生成し、承認済みの成果物をコントロールプレーン経由で配布するオープンソースのリポジトリです。

必要な入力とセットアップは何ですか？

DETECTEDスキャンは、モデル呼び出しを行わずに、コミット済みのハーネスファイルをリポジトリのパスや設定と照合して検査できます。組織のシグナルを使用する推奨ワークフローには、データが入力されたシグナルテーブル、同梱のtetriz-pyサービス、モデルキーが必要です。

承認済みの変更はどのように配布されますか？

コントロールプレーンでは、承認済みの成果物を指定した個人、チーム、または組織全体に配布し、ツールのユーザー設定や既知のリポジトリチェックアウトに配置して、インストール状況を報告できます。

テストグループとコントロールグループへの展開に対応できますか？

はい。オーディエンスターゲティングにより、選択した成果物をテストグループに配布し、別のコントロールグループには配布しないようにできます。システムは配布状態を報告しますが、結果の測定と実験分析はユーザー自身の分析システムで行います。

文書化されている展開上の制限は何ですか？

リポジトリには、コホートのランダム化、実験結果の計算、以前のハーネスバージョンの自動復元は行わず、対象外のユーザーが別のソースから同等のファイルを取得していないことも保証しないと記載されています。

Quick Facts

カテゴリー: 開発者向けツール
主な用途: AIコーディングハーネスの分析と配布
リポジトリ: GitHub / tetriz-ai/tetriz-harness
ハーネス成果物: ルール、スキル、エージェント、コマンド、フック、MCP設定
デプロイコンポーネント: Goライブラリとサーバー、harness-agent CLI、Nodeライブラリ、リファレンス管理UI
料金: 提供されたソースには製品の料金情報がありません

tetriz-harnessの代替品

CreateOS Sandbox

CreateOS Sandboxは、FirecrackerマイクロVM上でコードやエージェントのワークロードを実行できる分離型コンピュート環境です。SDK、CLI、MCPで制御可能。

GitBot

GitBotは、Claude Code、Codex、OpenCodeを活用した再利用可能なコーディングボットを作成できるローカルブラウザワークスペースです。永続スレッドと権限設定で、リポジトリ内の作業を効率化します。

ByteAsk

ByteAskは、C/C++向けのターミナル起点AIコーディングエージェント。リポジトリを編集し、コンパイラやデバッガ、サニタイザ、テストで変更を検証してから差分を表示。無料枠あり。

hob

hobは、エージェントのセッション、ターミナル、履歴、後続作業を、既存のツールやプロバイダーに合わせて整理できる独立したコーディングエージェント向けワークスペース。ローカルでの制御を重視する開発者に最適。

Manta AI

Manta AIは、URLからアプリの挙動を把握し、回帰を検出し、スクリプトやセレクタ管理なしでテストを生成できる自律型Webアプリテストツールです。

SonOf

SonOfは、リポジトリとPMツールに接続し、コードベースと周辺の製品コンテキストを監査して、承認済みの作業をシニアエンジニアのレビュー付きで公開済みチケットに変えます。