Agent プラン（MVC）

SDD の詳細については Spec-Driven Development をご覧ください。

成熟度: 成熟

概要

Agent プランは、Markdown ドキュメントを格納する新しいワークアイテムウィジェットです。SDD フローの中核アーティファクトであり、人間とエージェントによって形成され、その後 Duo Developer、Duo Review、またはその他の AI エージェントに下流で利用されます。

Epic: ワークストリーム 0 — Agent プラン

データモデル

Agent プランは、work_item_id によってワークアイテムと結合された専用テーブル（work_item_work_plans）に格納されます。issues テーブルは大きすぎて直接拡張できないため、プランデータは専用テーブルに保存され、ウィジェットがリクエストされた際に JOIN を通じて取得されます。MVC では、テーブルに単一の Markdown テキスト列が格納されます。ウィジェットはすべてのワークアイテムタイプに追加されますが、フィーチャーフラグによってゲートされます。

Agent プランは、既存のウィジェットパターンと新しい features フィールドの両方を通じてクエリ可能です：

fragment BaseWorkItemWidgets on WorkItemWidget {
  ... on WorkItemWidgetAgentPlan {
    content
  }
}

fragment BaseWorkItemFeatures on WorkItemFeatures {
  agentPlan {
    content
  }
}

ドラフト MR: BE、AI Assist

ウィジェットのレンダリング

ウィジェットには 3 つの状態があります：

1. 空 — プランを生成または記述するプロンプトが含まれたプレースホルダー。
2. 読み取り — レンダリングされた Markdown プレビュー。
3. 編集 — プレーンテキストエディター（Markdown プレビュー切り替え付き）。

AI がツール呼び出しを通じてプランを生成または更新すると、ウィジェットは新しいコンテンツを表示する読み取り状態に遷移します。

AI による生成

プランは、AI Gateway のワークアイテムツールを使用して同期 Duo Chat を通じて生成・改善されます。

• 新規または拡張されたツールが、ワークアイテムの説明ではなく Agent プランウィジェットに専用で書き込みます。
• 生成のために組み立てられるコンテキスト: ワークアイテムの説明、コメント、ラベル、Decision Log のエントリ。
• エージェントはプランコンテンツの部分的な更新またはフル書き換えを実行できます。
• 出力は、プロジェクトで設定されている場合、ワークアイテムテンプレートに準拠します。

API サーフェス

Agent プランは標準のワークアイテムウィジェット GraphQL API パターンを通じて公開されます。外部ツール（curl、glab、IDE 拡張機能）がプランを読み書きできるよう、REST でも利用可能です。

ライフサイクル

ドラフト -> エージェント準備完了。卒業基準は プラン準備スコアリング で定義されています。

意思決定

権限とフィーチャーゲーティング

ディスカッション: MR !231689 スレッド

Agent プランウィジェットの可視性は複数のレイヤーで制御されています：

1. フィーチャーフラグ（WIP） — WIP フィーチャーフラグ agent_plan は、機能が開発中の間、バックエンドとフロントエンドの両方でウィジェットをゲートします。フロントエンドフラグにより、チームは露出リスクなしに複数の MR にまたがってリリースできます。開発完了後、チームは beta としてリリースするか、フロントエンドフラグを削除してバックエンドフラグのみに依存するかを再検討します。
2. ライセンス機能 — ウィジェットは EE 機能です（少なくとも Premium 以上）。SDD 専用のライセンス機能が後で設けられない限り、既存のライセンス機能（ai_workflows または ai_features）を再利用します。
3. Duo 利用可能性（AI クイックアクションのみ） — ウィジェット自体はフィーチャーフラグ + ライセンスを通じてアクセス可能なすべてのユーザーに表示されます。プランを生成する Duo Chat クイックアクションには、さらに Duo Chat の利用可能性（duoChatAvailable GraphQL クエリ）とエージェンティックモード（Ruby の tanuki_bot.agentic_mode_available?）が必要です。Classic Chat が廃止されると、duoChatAvailable チェックだけで十分になります。
4. カスケードネームスペース設定（将来） — 管理者/グループオーナーがネームスペースレベルで機能をオフにするためのトグル。MVC1 には含まれませんが、外部ロールアウト前に必要です。

ウィジェットデータに対するバックエンド権限（userPermissions フィールド）と設定可能なワークアイテムタイプを通じたより厳格なゲーティングは延期され、GA 前に再検討されます。

アクティブな Issue

• フィーチャーフラグ + プレースホルダー UI
• ワークアイテムツールを Agent プランで更新
• Agent プランウィジェット UI
• Agent プランウィジェット API

ページのソースコードを見る - ページの編集 - please contribute.