angel291592/Intent-Router

解決する課題

AIエージェントによくある「推測」や「終わりのない質問」を排除します。エージェントが意図を推測したり何度も質問したりする代わりに、このツールはコンパイラがコードを扱うように意図を処理します。既存のデータ（コード、ドキュメント、チケット）を探索して曖昧さを解消し、人間の判断が真に必要とされる質問のみを一度だけ行い、リクエストが曖昧すぎる場合は実行を拒否します。

仕組み

リクエストを3つのステップで処理します：

1. 解析 (Parse)：リクエストをドラフトの IntentSpec（構造化された計画）に変換し、不足している情報を特定します。
2. 解決 (Resolve)：不足している情報を分類します。リポジトリ、ドキュメント、ログに答えがある場合は自動的に探索します。人間の判断（トレードオフや不可逆的な操作など）が必要な場合は、正確に一度だけ質問します。
3. 型チェックと出力 (Typecheck & Emit)：リクエストが不十分な場合は停止します。続行する場合は、機械可読な IntentSpec ファイルを保存します。これは将来のセッションのための契約として機能し、エージェントが決定事項を「忘れる」ことを防ぎます。

対象ユーザー

既存のプロジェクト制約を尊重し、不要なユーザーへの割り込みを避け、セッション間で決定事項の永続的かつ検証可能な記録を維持する、より信頼性の高いAIエージェントを構築したい開発者やチーム。

ハイライト

• 自動探索 (Automated Probing)：リポジトリ、git履歴、ドキュメントを自動的に検索して質問に回答し、ユーザーの手を煩わせません。
• 永続的な契約 (Persistent Contracts)：すべての意図を .intent.yaml ファイルとして保存し、将来のエージェントやチームメンバーがゼロからではなく、確立された決定事項から作業を開始できるようにします。
• 安全ゲート (Safety Gates)：リクエストが曖昧な場合や不可逆的な境界に触れる場合は実行を拒否し、エージェントが危険な「推測」を行うことを防ぎます。
• 検証 (Verification)：最終的な成果物を元の IntentSpec と照らし合わせ、エージェントが合意された制約に従っていることを確認します。
• ゼロインストール (Zero-Install)：複雑なインフラなしで既存のエージェントワークフローに追加できる、ポータブルなスキルとして設計されています。