AIエージェントチームを「育てて守る」実践AgentOps:レトロスペクティブ・モノレポ管理・4層セキュリティ組み込みログ
前回の記事 で構築した「AI経営ボード(6人の専門役員)」と「AI開発部隊(4人の実装エンジニア)」を、実際のプロダクト開発(PayRoute)に投入しました。
今回は、1周目のスプリントを回して見えてきたリアルな課題(レトロスペクティブ)をどうプラグインにフィードバックしたか、そして複数プラグインのモノレポ管理と4層セキュリティ基準の組み込みを行った実践ログをまとめます。
1. 背景と課題:AIチームは「作って終わり」では育たない
AIエージェントチームを立ち上げて最初の開発スプリントを回したところ、ファイル競合ゼロで33ファイル・28本の単体テストまで一気に組み上がる一方、運用面で次の3つの課題が見えてきました。
- 並列エージェント間の「契約ズレ」:アプリ側の実装担当とメディア記事担当を同時に走らせた結果、リンク先URLのスラッグ名に一部ズレが生じ、統合時に修正する手戻りが発生。
- プロンプト・スキルのバージョン管理:2つのプラグインをまたいでルールを改善するとき、実行ディレクトリ直下では他社製プラグインと同居しており、Git管理がしづらい。
- 個人開発におけるセキュリティの担保:ホスティング(Cloudflare Pages)、コード管理(GitHub)、AIエージェント(プロンプトインジェクション等)の4領域で、最低限守るべき基準を毎回手動で確認するのは限界がある。
2. 設計・アプローチ:モノレポ管理 × 4層セキュリティの仕組み化
① 自作プラグイン統合モノレポ(Index型)とワンコマンド同期
自作プラグイン(indie-exec-board と indie-dev-squad)は、作業用ワークスペース内に専用のモノレポ(agent-plugins)を作ってGit管理し、同期スクリプト(sync-plugins.ps1)で Antigravity の実行ディレクトリへ反映する構成を採用しました。
flowchart LR Repo["📦 agent-plugins (Gitモノレポ)\nプロンプト・スキル・ルールをバージョン管理"] Sync["🔄 sync-plugins.ps1\nワンコマンドで安全にミラー同期"] Runtime["⚡ 実行環境 (~/.gemini/config/plugins/)\n外部プラグインと干渉せず自動ロード"] Repo --> Sync --> Runtime
- メリット:経営ボード側と開発部隊側のルールを1コミットで同時に整合性を保って更新でき、別PCへの移行や過去の変更追跡も容易になります。
② ポートフォリオ横断の可視化スキル(status-board)の追加
「今どのアプリがどこまで進んでいて、メディア記事とアプリのリンクは一致しているか」を一瞬で把握できるよう、全リポジトリのGit状態・ADR(意思決定ログ)・記事スラッグを横断スキャンしてMermaid図と表で出力する status-board スキルを追加しました。
③ 個人開発向け「4層セキュリティベースライン」の組み込み
ガイドラインはドキュメントに書くだけでは形骸化するため、以下の4層基準を策定し、AIチームの実装ルールとリリース前監査(release-gate)の両方に直接組み込みました。
- 第1層(アカウント&認証基盤):MFA(パスキー/TOTP)必須、トークンの最小権限と期限設定、コードへの直書き禁止。
- 第2層(コード管理&サプライチェーン):
.gitignoreでの.env除外徹底、npm audit --audit-level=highのリリース前実行。 - 第3層(Webアプリ&Cloudflare Pages):
public/_headers(CSP /X-Frame-Options/nosniff)の標準配置、dangerouslySetInnerHTML原則禁止、URLフラグメント(#data=)の入力検証、外部リンクのrel="noopener noreferrer"。 - 第4層(AIエージェント&開発環境):外部テキストからのプロンプトインジェクション警戒、プラグイン内への秘密情報・個人メールアドレス記載禁止。
3. ハマったポイントと解決策(リアルな知見)
ハマり①:同期スクリプトの robocopy がサンドボックス環境で無言ハング
最初はWindowsの robocopy /MIR で同期スクリプトを書きましたが、実行環境の権限境界とリトライ待機(デフォルト設定)が噛み合い、バックグラウンドで進まなくなる事象に遭遇しました。
- 解決策:
Remove-Item+Copy-ItemによるシンプルなPowerShell標準コマンドレットへ置き換え、権限境界の設計も整理したことで、数秒で確実に同期できるようになりました。
ハマり②:並列起動時のURLスラッグ契約ズレと npm run dev の引数トラップ
- URLスラッグズレ:
dev-sprintスキルに「Phase 1の並列起動前に、両エージェントが参照するURLスラッグ一覧をテックリードが完全一致で固定して渡す(Step 0)」を追記して再発を防止しました。 - ローカルサーバー404:Windows(PowerShell)環境で
npm run dev -- --port 5173を渡した際、Viteが5173をルートディレクトリと解釈して404になる事象が発生。これも「基本はオプションなしのnpm run devを使う」という知見としてスキルに組み込みました。
4. まとめ・今後の展望
AIエージェントチームは、「実戦投入 → ログで振り返り(レトロスペクティブ) → プラグイン(プロンプト・スキル)を修正してGitコミット」というサイクルを回すことで、使うほど自分の開発スタイルに合った頼もしいチームへ進化していきます。
次回は、人間側で定期的に確認すべき「アカウント・インフラの10分セキュリティ点検チェックリスト」も整備し、攻め(機能開発・マネタイズ)と守り(品質・セキュリティ)の両輪をさらに強化していく予定です。