親のコンテキストを軽くするサブエージェント設計 — 定義ファイルは「削る」ために書く

Claude Codeのサブエージェントは、.claude/agents/にMarkdownを1枚置けば作れる。作るのは簡単だが、呼ばれず、呼んでも親のコンテキストが重いままになりやすい。この記事は、サブエージェントを出す狙いを2つに分ける。実時間を縮めることと、親のコンテキストに過程を積まないことだ。並列に投げれば速くなるが、完了報告のたびに親は積み上がった履歴を送り直すため、親を軽くする目的には逆効果になる。親を軽くしたいなら、分割せず同種の作業は1本にまとめるべきだと筆者は整理する。 面白いのは、定義ファイルを書くものではなく削るものとして捉えている点だ。tools欄を省略すると、そのサブエージェントは親と同じ道具をすべて持つ。つまりtoolsは能力を与える欄ではなく、能力を削る欄になる。ビルド係に編集の道具を持たせなければ、頼まれていない修正が勝手に入る事故は起きない。プロンプトに「直さないこと」と書くのが お願い なら、道具を外すのは物理的な制約だ。AIエージェントの安全は、指示文の丁寧さより、何を持たせないかで決まるという地味だが大事な話である。 最も効くのはdescriptionの書き方だ。親が呼ぶかどうかを判断する材料は、本文ではなくdescriptionだけだからだ。能力の紹介ではなく、いつ呼ぶかを書く。「方針が決まったあとに使う」と書けば、検討中に呼ばれる事故も減る。判断は親の高いモデル、手順は子の安いモデルと分ければ、コストも抑えられる。中小企業の現場で言えば、業務を任せる手順書を書くときに、何をするかより、どの場面で使うかを先に書けということだ。