エージェント駆動開発（SDD/Batch）の実践ガイド：承認ゲート付きワークフローの使い方

TL;DR

• 人間が「審判（Approve）」、AI が「選手（Execution）」を担当する分離モデル
• implementation_plan.md による事前合意なしに AI はコードを書かない
• すべての変更はボトムアップ（Issue → Plan → PR）で管理される

ワークフローの 5 ステップ

1. Input (Issue): 記事作成依頼 Issue を作成し、DoD（完了定義）を明記します。
2. Planning: AI エージェントが依頼を分析し、修正内容をまとめた implementation_plan.md を作成。
3. Approval: 人間がプランを読み、問題なければコメント欄で承認（または修正指示）を行います。
4. Execution: エージェントが記事を執筆し、自動的に Pull Request を作成。
5. Review & Merge: 人間が最終的な PR を確認し、マージボタンを押します。

ステータス遷移図

graph LR
    A[Issue] --> B[Planning]
    B --> C{Human Review}
    C -->|Approved| D[Execution]
    C -->|Feedback| B
    D --> E[Pull Request]
    E --> F[Human Merge]

2 つの「安全弁（Safety Gates）」

私たちは AI の暴走を防ぎ、品質を維持するために 2 つのゲートを設けています。

• Plan Gate: プランの承認なしに、エージェントは 1 行のコードも書きません。変更の「理由」と「範囲」を事前に握ることが、不必要な修正を防ぎます。
• Merge Gate: エージェントは PR を自らマージすることはできません。最終的なデプロイ権限は常に人間にあります。

依頼のコツ：DoD を明確にする

Article Request (Auto) テンプレートを使用する際は、Acceptance Criteria セクションを具体的に書くのがポイントです。

- [ ] SDD の概念図を Mermaid で含めること
- [ ] 内部リンクを 4 つ以上設定すること
- [ ] TL;DR セクションを文頭に追加すること

References

• AIエージェントに「仕様書」を厳守させる SDD (Spec Driven Development)
• AIエージェント開発を支える「共通基盤（Infrastructure）」
• プロンプトからエージェントエンジニアリングへ
• GitHub Actions によるインフラ構築
• 思考プロセスのパッケージ化技術