AIエージェントに「今のプロジェクト名」を書くと失敗する

AIエージェントを業務に組み込むようになると、誰でも一度はぶつかる設計の失敗があります。「とりあえず今扱っているプロジェクトの情報も書いておけば、判断材料が増えるはず」という直感が、長期的にはエージェントを使い捨てに変えてしまいます。

「使い捨て」エージェントの症状

AIエージェントを定義していくと、こんな書き方になりがちです。

• 「あなたは新規プロジェクト◯◯のプロダクトプランナーです」
• 「協業相手は未経験のメンバーなので、丁寧な説明を心がけてください」
• 「現在は要件定義フェーズ、来週レビューがあります」

一見、状況に最適化されています。けれどこの書き方には共通の問題があります。プロジェクトは終わる。協業相手は変わる。フェーズは進む。その都度エージェント定義を書き直す運用は、3つ4つのプロジェクトを並行で抱えた瞬間に破綻します。エージェントは現プロジェクト専用のツールになり、新しい仕事が始まるたびに似たような定義を再生産することになります。

これは個別の「書き方が悪い」話ではありません。変わるものと変わらないものを、同じレイヤーに混ぜているだけです。

三層に分けて整理する

混在を解くために、エージェント周りの情報を3つの層に分けて考えます。

L1は「プロダクトプランナーとはどんな視点で動く役割か」のように、5年経っても変わらない汎用定義。L2は「未経験者と一緒に作業を進めるときの基本ステップ」のように、特定プロジェクトに紐付かない運用ルール。L3は「今このプロジェクトのフェーズはどこか、来週のレビューは何時か」のように、状況とともに変わる現在地。

エージェント定義(L1)にL3の情報を入れた瞬間、それはL3の寿命に引きずられます。プロジェクトが終われば、エージェントも陳腐化します。

どこに書くかの判断

書きたいものを目の前にして、どの層に置くべきか迷うことがあります。シンプルな問いで仕分けできます。

これは1年後、1ヶ月後、誰が見ても正しい言明か。

Yesなら L1。「プロダクトプランナーは仮説検証を回す役割を持つ」のような不変の役割定義です。Noなら、L3かL2のどちらか。状況の記述ならL3(タスク管理ツール、プロジェクト管理基盤)、「こういう状況ではこう動く」というルールならL2(運用ドキュメント、SOP)です。

この判定を習慣化すると、エージェント定義にL3を紛れ込ませる失敗が激減します。

レイヤを跨ぐ参照のルール

3層を分けたうえで、どの層が他の層を参照してよいかにもルールを設けます。

L1はL2やL3を直接参照しません。エージェント定義に「現プロジェクトのレビュー予定」を書いたら、その時点でL1がL3を引き込んでいます。L2もL3を参照しません。運用SOPに「協業相手Aさんとの進め方」を書いたら、そのSOPはAさんに依存します。L3からL1やL2を参照するのはOK。プロジェクトの計画書に「このプロジェクトは⟨L1のエージェント定義⟩と⟨L2の運用SOP⟩に従って進める」と書けます。

参照は下から上に流れる。これだけで、上層が下層の変化に揺さぶられなくなります。

「変わるもの」と「変わらないもの」を分ける

三層分離は技術的なテクニックではありません。「変わるもの」と「変わらないもの」を別の場所に置く、それだけの話です。AIエージェント設計に限らず、組織のドキュメント設計、コードベースの構造、運用ルール、すべてに通じます。

エージェントの世界では、これを怠ると「プロジェクトの数だけエージェントが増える」状態になります。逆に正しく分離すると、不変のL1はだんだん効いてきます。プロジェクトが何個増えても、L1の役割定義とL2の運用SOPは使い回せる。新規プロジェクトのセットアップは「L3にどんな状況情報を入れるか」だけの作業になります。

典型例: Script・AI・Humanの業務フロー

下図は、AIを業務に組み込むときの典型的な役割分担です。Script が再現性と検証可能性、AI が生成・推論・探索、Human が判断・品質・背景知を担う3ノード構成。HumanからScriptへの戻りで、書き直された手順が次の周回に取り込まれていきます。

三層分離の観点で読み直すと、どのノードに何の責任を持たせるかというルール自体はL1(永続)に書くべきもの。各プロジェクトでどのノードに具体的に何を任せたかはL3(状態)に書くもの。Scriptのテンプレートや Human → Script のフィードバック手順はL2(運用SOP)に書くもの、と分かれます。

レイヤを混ぜず、それぞれを正しい場所に置く。そうすると図の中の循環は、組織で再利用できる知識として残ります。混ぜると、プロジェクトごとに同じ手順を毎回作り直すことになります。

下の図は実際に操作できます。各ノードをクリックすると、そのノードが担う責任の説明が現れます。自分たちのエージェント設計でL1、L2、L3のどこにこのノードを置いているか、一度照らし合わせてみてください。