modiqo/cliare

What it solves

CLIARE（CLI Agent Readiness Evaluation）は、コマンドラインインターフェースの実際の実行時動作がドキュメントやヘルプテキストと異なる「CLI ドリフト」の問題を解決します。このドリフトにより、AI エージェントはコマンドやフラグを試行錯誤で推測し続け、トークンとレイテンシを浪費します。また、セキュリティレビュー担当者が、見た目は安全な探索コマンド中に発生する未文書化の副作用（予期しないファイル書き込みなど）を特定するのにも役立ちます。

How it works

CLIARE は CLI バイナリをブラックボックスとして扱い、制限されたコントロール下でプローブします。静的ドキュメントに依存せず、さまざまなコンテキスト（クリーン、認証済み、またはフィクスチャベース）でバイナリを実行し、実際に存在するコマンド、どのフラグが安全か、出力が機械可読（JSON/YAML）かを記録します。その後、コマンドインデックスと一連のレポート（スコアカード、イシュー台帳、ペルソナ別パケット）を生成し、CLI の実際の表面をマッピングします。

Who it’s for

• CLI Maintainers：ヘルプカバレッジ、診断情報、出力契約のギャップを特定し、ツールをエージェントフレンドリーにします。
• Security Reviewers：バイナリを自律エージェントに公開する前に、未文書化の実行時動作や永続的な副作用を検出します。
• Agent Harness Builders：証拠に基づくコマンドインデックスを取得し、エージェントが試行錯誤で構文を再発見することなく正しいコマンドへルーティングできるようにします。

Highlights

• Evidence-Based Mapping：手書きドキュメントではなく、実行時証拠に基づいて command-index.json を生成します。
• Black-Box Probing：隔離環境またはホスト固有のコンテキストでバイナリを測定し、副作用を検出します。
• Agent-Ready Artifacts：AGENT_SKILL.md とペルソナレポートを生成し、エージェントの振る舞いをガイドします。
• Surface Querying：ハーネスが意図からコマンドへのルーティング回答を問い合わせるためのツールを提供します。
• CI Integration：GitHub Action を含み、就緒性監査を自動化し、リリースゲートを作成します。