1. これは何の話？
Claude Codeの開発に携わるThariq（@trq212）氏が、X Articleとして「Lessons from Building Claude Code: Seeing like an Agent」と題した長文考察を公開した。AIエージェント向けのツール設計を実際に改善してきた経験をまとめたものだ。
「エージェントみたいに考える（Seeing like an Agent）」という概念が核心にある。ツールはユーザーが使いやすいように設計するのではなく、AIエージェントが使いやすいように設計する必要があるという視点だ。これはエージェントアーキテクチャを設計する開発者が直面する実践的な課題だ。
2. 何がわかったか
著者が挙げた主な教訓は5つの方向性に整理できる。
第一に「AskUserQuestion」と名付けた専用ツールの導入だ。従来は単純なテキストでユーザーに質問していたが、それでは情報の引き出し方が曖昧になると気づき、構造化された質問として投げる専用ツールを作った。エージェントが何を知りたいのかを明示することで、ユーザーの回答精度が上がる。
第二にTodoリストからTask Toolへの進化だ。以前はTodoリストで進捗管理していたが、サブエージェント間の連携が視野に入ると、より明確なタスク単位での管理が必要になった。
第三に検索インターフェースの転換だ。RAGによるコンテキストの受動的な提供から、エージェント自身がGrepやウェブ検索を使って能動的にコンテキストを構築する形態へ移行した。
第四に段階的開示（Progressive Disclosure）の採用だ。一度に多数のツールを持たせるのではなく、必要な時に必要なドキュメントや機能を読み込ませる設計にした。
3. 他とどう違うのか
従来のエージェント設計では、人間のUX原則をそのままAIアシスタントに適用することが多かった。シンプルなAPI、少ない選択肢、わかりやすい応答形式などだ。Thariq氏の主張は、AIエージェントが情報を処理する方法と人間とでは根本的に違うため、ツール設計も別の原則に従う必要があるというものだ。
特にAskUserQuestionツールの発想は、「エージェントが何を聞くか」をシステムレベルで構造化することで、曖昧な往復コミュニケーションを減らす効果を狙っている。人間向けのUXデザインにはほとんど存在しない発想だ。
4. なぜこれが重要か
AIエージェントが複雑なコーディングタスクをこなせる時代に、ボトルネックはモデルの能力よりもツール設計の質に移りつつある。適切に設計されたツールはエージェントの能力を引き出し、不適切なツールはモデルの限界以前に失敗を生む。
Claude Codeの実開発経験に基づいた知見は、エージェントフレームワークを構築する開発者にとって実装の参照基準になる。
5. 未来の展開・戦略性
サブエージェント間のTask Tool連携が実用的になると、人間が介在せずにエージェント同士がタスクを委譲・実行するフローが広がる。AskUserQuestionの発想をさらに推し進めれば、エージェントが人間に質問する頻度や内容を最適化するメカニズムへと発展するかもしれない。
段階的開示の設計原則は、大規模なツール群を持つエンタープライズ向けエージェントの設計にも応用できる。ツールのカタログを全て見せるのではなく、タスクに応じて必要なツールセットを動的に提示する仕組みだ。
6. どう考え、どう動くか
エージェントを構築または活用する立場であれば、まず「自分が設計したツールはエージェントの視点から見て使いやすいか」を問い直すのが出発点になる。人間向けのUIデザインとエージェント向けのツール設計は同じではない。
指針：
- 自社のエージェントが何度もユーザーに問い直す場面を観察し、AskUserQuestion的な構造化を試みる。
- ツールを1つ増やすたびにエージェントの動作テストをする習慣をつけ、ツール数と精度のトレードオフを計測する。
- claude-code-seeing-like-agentの観点で、自社ツール設計のドキュメントをレビューする機会を設ける。
次の一歩：
- 今日やること：自社エージェントに提供しているツールリストと、実際に使われている頻度を確認する。
- 今週やること：最も使われていないツールを1つ削除し、エージェントの動作が変わるか記録する。
7. 限界と未確定
- 著者はX Articleで知見を共有しているが、定量的な評価データ（ツール改善前後の精度比較等）は公開されていない。
- Claude Code固有の設計を他のエージェントフレームワークにそのまま適用できるかは検証が必要だ。
- AskUserQuestionツールの具体的な実装方法や、内部でどう機能するかの詳細は公開されていない。
8. 用語ミニ解説
- 情報を最初から全て表示せず、利用者の操作や状況に応じて段階的に追加情報を見せる設計手法。（段階的開示 / Progressive Disclosure）
9. 出典と日付
Thariq @trq212（公開日：2026-02-28）：https://x.com/trq212/status/2027463795355095314
