下流の利用者
SDD の詳細は、Spec-Driven Developmentを参照してください。
成熟度:定義中
概要
Workplan の価値は、下流のエージェントがそれを使用することで生まれます。このページでは、Duo Developer が Workplan に基づいてどのように実装するかと、将来、Workplan に照らした検証をどのように行えるかを説明します。
Duo Developer への引き渡し
Workplan が存在するとき、ユーザーは Implementation ウィジェットまたは Workplan パネルで Implement を選択します。これにより、Duo Chat を開かずに、Duo Developer フロー(developer/v1)が非同期に開始します(Issue 628801)。
Duo Developer は、Workplan を主要な仕様として扱います。ワークアイテムの説明とコメントは、追加の背景情報としてのみ使用します。
前提条件として、Duo Agent Platform のリモートフローを有効にする必要があります。Developer フローが設定されていない場合、Implement ボタンは無効になり、ツールチップが表示されます(Issue 629904)。
クローズされたワークアイテムでは、ウィジェットと Workplan パネルの両方で Implement ボタンを非表示にします(マージリクエスト 261747)。Developer フローの開始には CI フローの権限も必要です。ワークアイテムのアクション権限との整合は、Issue 634208で追跡しています。
Implementation ウィジェットに実装フェーズとマージリクエストのステータスを表示する作業は、Issue 628976で引き続き未解決です。実行中の Implement の繰り返しクリックに対処しつつ、意図的な再実行を可能にすることも、この進行中の設計作業に含まれます。
Duo Review による検証(先送り)
Duo Review エージェントは、元の Workplan を評価基準として使用し、マージリクエストの変更をそれに照らして検証できる可能性があります。これは、ワークアイテムとマージリクエストの関係に依存します。現在のエピックには含まれません。
MR のマージチェック(先送り)
マージ時に、マージチェックとして Workplan を検証することは、現在のエピックには含まれません。SDD の代わりに、Code Review Lifecycle Transformationの取り組みで扱う可能性があります。
API サーフェス
下流のエージェントは、ワークアイテムの GraphQL API と MCP ワークアイテムツールを通じて Workplan を読み取ります。Workplanを参照してください。
構造化形式と生の Markdown
下流のエージェントは、生の Markdown として Workplan を使用します。Workplan が、セクション、受け入れ基準、テストケースなどのより豊富な構造に発展した場合、シリアライゼーションと後方互換性への対応が必要になります。
決定
| 日付 | 決定 | 決定者 |
|---|---|---|
| 2026-04-17 | 下流のエージェントが使用する Workplan の形式は Markdown です(YAML や構造化 JSON ではありません)。Markdown は人が読みやすく、すでに GitLab の説明で一般的に使われている形式であり、利用側のシリアライゼーションのオーバーヘッドを回避できます。 | @fredericcaplette |
| 2026-09-23 | Implement は、Duo Chat を開く代わりに、Duo Developer を非同期に実行します。 | WS-7 |
5d840611)