実践！マルチエージェント・デザインパターン：AntigravityとCursorで実現する自律型開発の型

こんにちは、みねです。

第1回（自動化戦略）、第2回（思考転換）に続き、今回はシリーズ完結編として**「具体的な実装パターン」**を解説します。

「エージェントに任せたいけど、リポジトリをどう整えればいいかわからない」というエンジニアのために、私が実際に notionnext-blog で採用しているディレクトリ構成と運用ルールを公開します。

1. エージェントが迷わない「地図」を作る (Directory Structure)

エージェントが迷う最大の原因は「どこを見ればいいかわからない」ことです。これを防ぐために、物理的な配置で役割を定義します。

憲法を守る砦 .agents/

.agents ディレクトリを作り、ここに「絶対的なルール」を集約します。

.agents/
 ├─ RULES.md        # エージェントへの禁止事項（node_modules触るな、等）
 ├─ PRINCIPLES.md   # プロジェクトの思想（品質基準、SEO方針）
 └─ DEFINITIONS.md  # 完了の定義 (Definition of Done)

これを置くだけで、AntigravityやCursorのエージェントは「あ、自分はこの憲法に従えばいいんだ」と理解し、暴走を防ぐガードレールが機能し始めます。

戦術を集める plans/

エージェントへの指示（Prompt）をその場限りのチャットで終わらせず、plans/ ディレクトリにMarkdownとして保存します。

• 良い点：エージェントが「前回の計画」を参照して自律的に動ける。
• 良い点：人間が後から「なぜこの実装にしたか」を追える。

2. エージェントに道具を渡す (Skill Definition)

エージェントは何でもできるわけではありません。「何をしていいか」を定義した道具（Skill）が必要です。

Scripts as Skills

例えば、npm run gen というコマンドがあるなら、それを「記事の骨子を作るスキル」としてエージェントに認識させます。

「新しい記事を書きたい」と言われたら、まずは npm run gen を実行してJSONを得ること。

このように自然言語でラップしてあげるだけで、エージェントはCLIツールを「自分の手足」として使いこなします。

3. 【実践】記事自動生成システムの裏側公開

本ブログの自動運用も、実はこのパターンで動いています。

1. User: 「自動化の記事書きたい」と投げる。
2. Plan Agent: .agents/PRINCIPLES.md を読み、「一次情報が必要ですね」と判断して構成案を作成。
3. Writer Agent: plans/ の構成案に従い執筆。
4. Review Agent: .agents/DEFINITIONS.md のDoD（完了条件）に基づき、SEOや誤字をチェック。

これらが、私がコーヒーを飲んでいる間に並行して行われます。私がやるのは、最後の「承認ボタン（Merge）」を押すことだけです。

4. まとめ：あなたのリポジトリをエージェントの「住処」にする

エージェントエンジニアリングとは、「人間が読みやすいコード」を書くことから、「エージェントが動きやすい環境」を作ることへのシフトです。

まずは .agents/RULES.md を1つ作ることから始めてみてください。あなたのリポジトリが、単なるコード置き場から、エージェントたちが生き生きと働く「オフィス」へと変わるはずです。

---

このシリーズ記事（全3回）は、マルチエージェントシステムによって企画・執筆・レビューされました。