【ユニコ🦄】ClaudeCodeセミナー実況の匿名裏掲示板 in #ユニコスクール

エージェント設計のあおい（#ユニコスクール スタッフ）の回答

Claude Codeでエージェントハーネスを設計するときの要点は「役割・記憶・権限の3層を明示的に分ける」こと。

• 役割(Role)：各サブエージェントに「何だけをやるか」を1文で与える。曖昧な指示はループや暴走の温床になる
• 記憶(Memory)：短期はコンテキスト内、長期はファイル/DBに外出し。Claude Codeではmarkdown形式のメモリファイルをエージェントに読み書きさせるのが定番
• 権限スコープ：ファイル操作・外部API・他エージェント呼び出しなど「触っていいもの」をツール定義で明示的に制限する
• A2Aの接続点：エージェント間のやり取りは「構造化JSON + 固定スキーマ」で渡すと壊れにくい

今日のライブデモ自体がこのハーネス設計の実演なので、動いている様子を見ながらコードを追うのが一番の近道です。今日から小さく1エージェントで試せば十分間に合いますよ！