このシリーズについて
AIエージェントが自律的にコードを書き、テストを回し、PRを作成する世界。 そこで人間が担うべき役割は「ドライバー」から「技術編集長（Gatekeeper）」へと進化します。
AIによるコンテンツ生成は「全自動」を目指すべきではありません。 私たちが目指すのは、人間が戦略と品質の最終責任を持ち、AIがその手足となって動く「Human-in-the-Loop（人間がループの中心にいる）」ワークフローです。
本シリーズでは、実際にこのブログの記事作成プロセスを半自動化した知見をもとに、AIワーカーを「最小の科学」で制御するための3つのステップを解説します。
シリーズ構成
この親記事をハブとして、以下の3つの詳細記事で構成されています。
Part 1: 戦略編
「AIエージェントによるブログ自動運用の教科書」 なぜ「全自動」は失敗するのか？ 3レイヤー管理（憲法・戦略・実行）という概念を導入し、継続可能な運用の全体像を解説します。 👉 記事を読む
Part 2: 思考編
「プロンプトからエージェントへ」 AIに対するアプローチを「魔法の言葉を探す（Prompt）」から「自律的な仕組みを作る（Agent）」へと転換するためのマインドセットと、その設計軸である Context / Capability / Critical Thinking の 3 要素を定義します。 👉 記事を読む
Part 3: 実踐編
「マルチエージェント・デザインパターン」
実際にどのようなディレクトリ構成（.agents/など）やコードを用意すればよいか。notionnext-blog の裏側を公開しながら実装パターンを学びます。
👉 記事を読む
The Pain: AIの暴走を止めるコスト
AIエージェントに自律的にコーディングさせると、素晴らしい速度で機能を作ってくれますが、同時に**「あさっての方向」に全速力で走っていく**リスクもあります。
- 仕様無視: 「ライブラリ追加禁止」と言ったのに
npm installしてしまう。 - 命名規則違反: プロジェクトの
kebab-case規約を無視してcamelCaseでファイルを作る。 - 過剰エンジニアリング: シンプルな修正で済むのに、勝手にデザインパターンを導入して複雑化させる。
この修正（手戻り）コストが高ければ、結局「自分で書いたほうが早い」となってしまいます。
承認ベースのワークフロー (SDD)
SDDにおける人間の役割は、「ドライバー」から「ナビゲーター兼ゲートキーパー」に変わります。具体的には、2箇所の承認ゲートを設けます。
sequenceDiagram
participant User as Human (Editor)
participant AI as エージェント (Writer)
participant Spec as 仕様書 (Repo)
User->>AI: 1. Input (Issue)
AI->>Spec: 2. Plan (Update design.md)
Note right of AI: STOP (Wait for Approval)
AI-->>User: STOP: Planning Approval
User->>AI: 3. Approve 1 (LGTM)
AI->>Spec: 4. Code (Implement)
AI-->>User: STOP: Code Review (PR)
User->>Spec: 5. Approve 2 & Merge
- Gate 1: Planning Approval (作る前に承認)
- Gate 2: Code Review (マージする前に承認)
ワークフローの詳細
- Input: 人間（Editor）が Issue を作成。「これをやりたい」。
- Plan: エージェントが
spec/design.mdを更新し、実装計画を提案。- STOP: ここでエージェントは停止し、承認を待つ。
- Approve 1: 人間（Editor）が計画を確認。「OK」または「ここは直して」。
- Code: エージェントが実装。テストが通るまで試行錯誤。
- STOP: PRを作成して停止。
- Approve 2: 人間（Editor）がレビュー。「LGTM」。
- Merge: マージして完了。
このワークフローにおいて、人間（Editor）はプログラマーというより「技術編集長」や「CTO」に近い立ち位置になります。
Human-in-the-Loop の核心
このワークフローの核心は、人間を「ボトルネック」ではなく「ゲートキーパー」として定義することにあります。
- Plan (AI): 膨大なデータから構成案を提案する。
- Approve (Human): その構成が読者に価値があるか、私がGOサインを出す。
- Draft (AI): 承認された構成に基づき、高速に執筆する。
- Review (AI + Human): AIが技術チェックを行い、人間が最終的な熱量を吹き込む。
このループが回ることで、私たちは「執筆」という作業から解放され、「編集」と「戦略」に集中できるようになります。
Series C: プロンプトを「スキル」として資産化する技術
なぜ同じような指示をChatGPTに何度も入力してしまうのか？ プロンプトを「使い捨て」ではなく、バージョン管理可能な「スキル」として定義し、エージェントの自律性を引き出す手法を学びます。
Chapter 1: スキルを定義せよ
同じことを二度と言わないための「スキル定義ファイル」：プロンプトを再利用可能な資産にする
Chapter 2: 思考をパッケージせよ
「いい感じにお願い」からの脱却：思考プロセスをアルゴリズムとしてパッケージ化する技術
Chapter 3: 自律ループを回せ
道具を持たせれば自律する：SkillとToolを結合して「勝手に仕事を見つける」エージェントを作る
結論
AIを単なるチャット相手ではなく、信頼できる「エンジニアリング・パートナー」として扱うための第一歩が、この「承認ベースのワークフロー」と「スキル管理」です。
次のシリーズC（Agent Skills Hub）では、さらに進んで、このAIエージェント自体を賢くするための「スキル定義」の手法について解説します。
FAQ
Q. AIエージェントに自律的にコーディングさせると、どんな失敗が起きますか？ A. 記事では3つの典型を挙げています。「ライブラリ追加禁止」と指示したのに依存パッケージを勝手にインストールしてしまう仕様無視、プロジェクトの kebab-case 規約を無視して camelCase でファイルを作る命名規則違反、シンプルな修正で済むのに勝手にデザインパターンを導入して複雑化させる過剰エンジニアリングです。この手戻りコストが高いと、結局「自分で書いたほうが早い」に逆戻りしてしまいます。
Q. 承認ベースのワークフロー（SDD）では、承認ゲートをどこに置きますか？ A. 2箇所です。Gate 1 は Planning Approval で、エージェントが spec/design.md を更新して実装計画を提案した時点で停止し、人間が計画を承認します。Gate 2 は Code Review で、実装してPRを作成した時点で停止し、人間がレビューしてマージします。「作る前」と「マージする前」の2回止めることで、あさっての方向に全速力で走られる前に軌道修正できます。
Q. Human-in-the-Loop にすると、人間がボトルネックになりませんか？ A. 人間を「ドライバー」ではなく「ゲートキーパー（技術編集長）」として定義するのが核心です。AI が構成案を提案し（Plan）、人間はそれが読者に価値があるかだけを判断して GO を出します（Approve）。承認後の執筆（Draft）は AI が高速に回し、技術チェックも AI が担います。人間が引き受けるのは最終的な熱量と戦略判断なので、作業量ではなく判断の回数だけが人間側に残ります。
