AIエージェントチームを「育てて守る」実践AgentOps:レトロスペクティブ・モノレポ管理・4層セキュリティ組み込みログ

前回の記事 で構築した「AI経営ボード(6人の専門役員)」と「AI開発部隊(4人の実装エンジニア)」を、実際のプロダクト開発(PayRoute)に投入しました。

今回は、1周目のスプリントを回して見えてきたリアルな課題(レトロスペクティブ)をどうプラグインにフィードバックしたか、そして複数プラグインのモノレポ管理と4層セキュリティ基準の組み込みを行った実践ログをまとめます。


1. 背景と課題:AIチームは「作って終わり」では育たない

AIエージェントチームを立ち上げて最初の開発スプリントを回したところ、ファイル競合ゼロで33ファイル・28本の単体テストまで一気に組み上がる一方、運用面で次の3つの課題が見えてきました。

  1. 並列エージェント間の「契約ズレ」:アプリ側の実装担当とメディア記事担当を同時に走らせた結果、リンク先URLのスラッグ名に一部ズレが生じ、統合時に修正する手戻りが発生。
  2. プロンプト・スキルのバージョン管理:2つのプラグインをまたいでルールを改善するとき、実行ディレクトリ直下では他社製プラグインと同居しており、Git管理がしづらい。
  3. 個人開発におけるセキュリティの担保:ホスティング(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. 第1層(アカウント&認証基盤):MFA(パスキー/TOTP)必須、トークンの最小権限と期限設定、コードへの直書き禁止。
  2. 第2層(コード管理&サプライチェーン):.gitignore での .env 除外徹底、npm audit --audit-level=high のリリース前実行。
  3. 第3層(Webアプリ&Cloudflare Pages):public/_headers(CSP / X-Frame-Options / nosniff)の標準配置、dangerouslySetInnerHTML 原則禁止、URLフラグメント(#data=)の入力検証、外部リンクの rel="noopener noreferrer"。
  4. 第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分セキュリティ点検チェックリスト」も整備し、攻め(機能開発・マネタイズ)と守り(品質・セキュリティ)の両輪をさらに強化していく予定です。