Usecase Design Doc を厚く書き、実装の「お世話」をやめる
AI エージェントに実装を任せるほど、毎回の詳細プロンプトとセッション監視が辛くなる。ユースケース単位の設計書（サマリー・CRUD・シーケンス・型・API・変更箇所・チェックリスト）を先に固め、未実装の最上段だけをエージェント（例: Devin）に渡して PR まで非同期で作らせる。CADDi では1日にマージする PR が約2倍になった。
解決する問題
- 「〇〇を実装して」では品質が出ず、その都度長い指示が必要
- 並列で5つ以上動かすと、許可待ち・コンテキスト切れ・worktree 管理で認知負荷が爆発する
Usecase Design Doc に書くもの
- サマリー（アクター・対象・操作）
- 関連テーブルの CRUD 表
- シーケンス図（トランザクション境界つき）
- 主要ドメインの型とファクトリ
- API の入出力
- レイヤーごとの既存コード変更点
- 実装状況チェックリスト（集約・レイヤー単位）
PR はだいたい 200〜300 行になるよう、レイヤー／集約／同期・非同期で割る。
委譲の流れ
- チェックリストの未実装の一番上を今日のタスクにする
- 関連コードを検索させてから実装→PR
- CI 上の自動レビューに任せ、人は設計と PR レビューに集中する
- お昼に投入して午後に見る、のような非同期サイクルにする
注意点
- 設計書の小さな誤りが実装で増幅する。インターフェースは人がレビューしてから流す
- 実装が速くなると、設計と PR レビューがボトルネックになる
- 使うエージェントは Devin である必要はない。同じ「厚い設計→薄い指示」なら Claude Code／Codex でもよい
関連
出典
- @majimaccho_ · 2026-04-07
- CADDi Tech Blog: caddi.tech/2026/04/07/110000