modiqo/cliare

CLI agent-readiness measurement, command-shape inference, and CI scorecards

What it solves

CLIARE（CLI Agent Readiness Evaluation）は、コマンドラインインターフェース（CLI）が人間向けに設計されているのに対し、AI エージェントが使用する際のギャップに対処します。多くの CLI は「ドリフト」―ドキュメント、ヘルプテキスト、実際のランタイム動作が一致しない―が発生し、AI エージェントはトライアンドエラーでトークンとレイテンシを浪費します。また、読み取り専用と思われるバイナリに undocumented な副作用があるかをセキュリティレビュー担当者が特定するのにも役立ちます。

How it works

CLIARE は CLI バイナリをブラックボックスとして扱い、制御された範囲でプローブして実際のランタイム動作を測定します。静的ドキュメントに依存せず、どのコマンドが存在し、どのフラグが安全で、どの出力が機械可読（JSON/YAML）かという証拠を記録します。クリーン、認証済み、またはフィクスチャベースのさまざまなコンテキストで実行でき、包括的なアーティファクトを生成します。その中でも特に command-index.json は、エージェントハーネス向けの測定済み契約として機能します。

Who it’s for

  • CLI Maintainers：リリース前にヘルプカバレッジ、診断情報、出力契約のギャップを特定・修正します。
  • Security Reviewers：安全であるべきコマンドに予期しないファイル書き込みやネットワーク動作がないか検出します。
  • Agent Harness Builders：エージェントに事前測定された CLI サーフェスマップを提供し、トークン消費を減らし信頼性を向上させます。

Highlights

  • Evidence-Based Indexing：手書きドキュメントではなく、ランタイム証拠に基づいて command-index.json を生成。
  • Black-Box Probing：バイナリを実行してコマンド形状を推測し、副作用を検出。
  • Role-Specific Reporting：メンテナ（修正キュー）、セキュリティ（副作用パケット）、ハーネス（ルーティング回答）向けにカスタマイズされたレポートを提供。
  • CI Integration：GitHub Action が組み込まれ、就緒性監査を自動化し、スコアカードに基づくリリースゲートを設定。
  • Surface Querying：ハーネスが cliare surface query を通じてタスクインテントを具体的で就緒状態のコマンドに解決できます。