タグ: エージェント設計
"エージェント設計" が付いた記事と Wiki ページ
作る役と確かめる役の分離(maker-checker)
成果物を作った主体に自分で採点させない原則。AI エージェントでは「エージェントを分ける」だけでは足りず、接続・規律・重み(モデル)の 3 層を塞いで初めて機能する
沈黙する失敗(成功に見える失敗)
終了コード 0・出力あり・手元では正常に見えるのに中身が壊れている失敗。エラーを出さないため、コマンドの成否やファイルの有無で検証すると全部すり抜ける
Claude Code のサブエージェントは定義しただけでは動かない — ファクトチェックを繋ぎ直した 3 つの穴
`.claude/agents/` の fact-checker が、どのスキルからも一度も呼ばれていなかった。定義しただけのサブエージェントは孤立ノードで存在しないこと、証拠カラムを強制しないと「自明だから」で素通りすること、model 未指定だと親の盲点を継承すること。Claude Code の検証トポロジーを繋ぎ直した 3 つの穴。
Video Use の「沈黙する失敗」— ffmpeg が成功しても動画が壊れる 5 つの罠と 12 の Hard Rules
browser-use/video-use の 4 か月分の修正は、ほぼ全部が ffmpeg 正常終了・ファイル生成済み・ローカル再生 OK なのに中身が壊れている「沈黙する失敗」だった。音声トラックの取り違え、HDR メタデータの残留、フレームレート固定、回転メタデータ誤判定、字幕のセーフゾーン侵入と、12 の Hard Rules を整理する。
サブエージェントの役割は tools で縛る — ECC の68体を数えて見えた設計と抜け穴
ECC(Everything Claude Code)の agent 定義68個を実際に集計した記録。68体中40体が Write / Edit を持たず、planner と architect は Bash すら持たない。役割をプロンプトではなく tools・model・防御前文の3軸で強制する設計と、その抜け穴、そして286スキルの description だけで2万トークンを占めるコンテキスト予算まで整理する。
Harness Engineering:AIエージェントを信頼性高く動かすランタイム設計の考え方
エージェントハーネスとユーザーハーネス — ハーネスエンジニアリングの全体像を正しく理解する