はじめに
最近はClaude Codeなど、AIエージェントを使った開発が当たり前になってきました。
しかし実際に使っていると、
- 同じ依頼なのに毎回少し違う結果になる
- 前回は出来たのに今回は失敗する
- チームで使うと品質がバラバラ
など、この様な「AIのブレ」が気になっていました。
そこで調べてみると、「Agent SOP」という考え方があることを知りました。
今回はその内容を、AIに聞きながらまとめます。
Agent SOPとは
SOP は、Standard Operating Procedure（標準作業手順書） の事です。
「作業手順書」や「運用マニュアル」、「チェックリスト」などをAIエージェント向けにしたものになります。
Agent SOPでは、下記を明確に定義します。
- 何をするか
- どんな順番で行うか
- 判断基準
- エラー時の対応
- 人へ引き継ぐ条件
なぜ必要なのか
AIは優秀ですが、"毎回少し違う判断" をします。
例えば、「Spring BootのAPIを追加して」と依頼すると、
ある日は、Controller, Service, Repository まで作ります。
別の日は、Controller だけ作るかもしれません。
Agent SOP は、この「暗黙の判断」を無くします。
プロンプトとの違い
| プロンプト | Agent SOP |
|---|---|
| 単発の指示 | 継続的なルール |
| その場限り | チーム全体で共有可能 |
| 人によって書き方が違う | 標準化できる |
| 再利用しにくい | 何度でも利用できる |
Claude Code で考える Agent SOP
例えば新しいAPIを作る場合、
これまでは
APIを作って
だけでしたが、
Agent SOP では、
API追加時
1. API仕様を確認
2. Controller作成
3. Service作成
4. Repository作成
5. DTO作成
6. テスト作成
7. OpenAPI更新
8. エラーハンドリング確認
9. ログ確認
10. 実装内容をまとめる
になります。
これなら「誰が使っても」AIがほぼ同じ流れで実装できます。
おわりに
AI進化のスピードはすごいですね。AIがどんどん賢くなってます。
だからこそ、"AIをどう動かすかを設計する（考える）”が、大事になってくると強く思いました。
参考（感謝）