Pega 要件管理の設計|Specification とユーザーストーリーの使い分けと DCO の落とし穴
「要件はどこが正か?」——Pega では DCO で仕様(Specification)を直接キャプチャしてルールにリンクできる一方、Agile Workbench や Agile Studio ではユーザーストーリーとしてバックログ管理する。両方に書けば同期がズレ、DCO で作った仕様は放置されて化石化する。本記事は Specification とバックログの役割を分け、要件の SSOT をどう1つに定めるかという設計判断を扱う。
結論から:要件の SSOT を1つに定め、Specification とバックログの役割を分ける
Pega のプロジェクトで必ず起きるのが「要件(要求仕様)を、どこに残すのが正なのか」という迷いです。Pega には DCO(Directly Capture Objectives)で顧客と直接キャプチャする Specification(仕様) があり、一方で Agile Workbench や Agile Studio では ユーザーストーリー としてバックログに積む仕組みもあります。どちらも「要件を書く場所」に見えるため、気づけば同じ内容が両方に散らばっている——これが手戻りの温床です。
結論を先に言うと、判断の核はたった1つです。
その要件の「正(SSOT)」をどこに置くかを、要件の性質ごとに明示的に決める。安定していて実装ルールへの追跡性が要るものは Specification、変動する作業単位はバックログアイテム(ユーザーストーリー)に寄せる。両方に同じ内容を二重に持たせない。
「重要な要件だから念のため両方に書いておく」は、最も避けるべき運用です。二重管理は必ず同期がズレ、どちらが最新か分からなくなります。本記事では、この線引きを具体的な判断分岐に落とし込みます。
Specification と DCO — 実装への追跡性が本質
Specification は、Pega が要件(要求仕様)を表現するために持っているルールです。最大の特徴は、DCO(Directly Capture Objectives)を使って顧客・業務側と直接その場でキャプチャできること、そして書いた仕様を実装ルール(ケースのステージ・ステップ、フロー、UI など)にリンクできることにあります。
ここが、Word や Excel、外部の設計書に要件を書くのとの決定的な違いです。外部ドキュメントは実装と物理的に切り離されており、実装が変わっても文書は自動では追随しません。対して Specification は、「この仕様が、どの実装ルールで実現されているか」という追跡性(トレーサビリティ)をアプリケーション内で保持できます。1つの仕様を、プロセス全体・フロー内の特定ステップ・代替パスといった複数の実装ルールに関連づけられるため、監査や仕様レビュー、影響範囲の調査で「この要件はどこに効いているか」を辿れます。これは長期運用する業務アプリでは大きな資産になります。
言い換えると、Specification は「顧客と合意した業務仕様を、実装とひも付けたまま Pega の中に正として置いておく」ための仕組みです。安定していて、後から「これは合意済みの仕様だ」と参照したいものほど、Specification に置く価値が高くなります。
バージョン注記:DCO は本来「業務と IT が最初から最後まで協業して要件を Pega に直接取り込む」という進め方の総称で、Specification(仕様)はそこで生まれる成果物の1つです(バックログやユーザーストーリーの取り込みも DCO の一部として扱われます)。また、仕様を取り込む具体的な手段は版によって進化しており、Infinity 世代では Pega Blueprint / Infinity Studio 経由の取り込みも用意されています。「Specification をルールにリンクして追跡性を保つ」という考え方自体は変わりませんが、実際の操作手順や利用できるツールは、プロジェクトで使う版の公式ドキュメントで確認してください。
Agile Workbench と Agile Studio — 役割の異なる2つのツール
Pega で要件・作業を扱うもう一方の系統が、アジャイル管理ツールです。名前が似ていて混同されがちですが、Agile Workbench と Agile Studio は役割がまったく異なります。
- Agile Workbench — Dev Studio / App Studio に組み込まれた軽量ツール。開発や構成の作業コンテキストの中から、ユーザーストーリー・バグ・フィードバックをその場で起票できます。「今見ている画面に対する指摘やタスク」を、コンテキストを離れずに拾い上げるためのものです。
- Agile Studio — バックログ・スプリント・ボードなどを扱う独立したスクラム管理アプリケーション。プロジェクト全体の作業計画、優先順位づけ、進行管理を担います。チームの計画ツールとしての位置づけです。
ざっくり言えば、Agile Workbench は「作業中にサッと起票する入口」、Agile Studio は「積まれたバックログを計画・運用する場」です。どちらも扱うのは基本的にユーザーストーリーやバグといった作業単位であり、これは Specification が表現する「合意済みの業務仕様」とは性質が違います。なお、Agile Workbench で起票したストーリーやバグを Agile Studio と同期させる連携も用意されています。
バージョン注記:Agile Workbench / Agile Studio の名称・同梱の有無・外部の課題管理ツール(Jira 等)との連携方式は、Pega の版によって異なります。プロジェクトで使う版の公式ドキュメントで、実際に利用できる構成を必ず確認してください。
判断軸:SSOT をどちらに置くか
Specification とバックログアイテムは「どちらが優れているか」ではなく、要件の性質で使い分けます。表で整理します。
| 判断ポイント | Specification(DCO) | バックログアイテム(ユーザーストーリー) |
|---|---|---|
| 主な役割 | 合意済みの業務仕様を保持 | 変動する作業単位を管理 |
| 起票・管理の場 | DCO セッション/App Studio | Agile Workbench で起票 → Agile Studio で計画 |
| 実装との関係 | 実装ルールにリンク(追跡性あり) | 作業の進行を追う(実装リンクは主目的でない) |
| 変化の頻度 | 安定・低頻度で改訂 | スプリント単位で頻繁に増減 |
| 寿命 | 長い(運用中も参照される) | 短い(完了すれば消化される) |
| 向く対象 | 安定した業務ルール・仕様 | 追加機能・改修・不具合・調整 |
| SSOT としての適性 | 追跡性が要る仕様の正 | 作業計画・進行の正 |
同じ要件を Specification とバックログの両方に「正」として置かないことが鉄則です。片方を正(SSOT)と決めたら、もう片方はあくまで作業のための派生・リンクにとどめます。
実務での線引き — 何を Specification に、何をバックログに
実案件では、次のように振り分けると運用が破綻しにくくなります。
- 安定した業務仕様で、実装への追跡性を残したいもの → Specification に置く。例:承認の条件、SLA の定義、業務ルールの根拠など、「合意済みでこの先も参照する」ものです。
- 変動する作業単位・進行中の調整 → バックログアイテムに置く。例:「この画面にフィルタを追加する」「この不具合を直す」といった、着手して完了すれば消化されるタスクです。
そのうえで、どちらを正とするかをプロジェクトの運用ルールとして明文化します。たとえば「業務仕様の SSOT は Pega 内の Specification。バックログのストーリーはその実装作業を管理するもので、仕様そのものの正本ではない」と決めておく。逆に、要件の入口を外部のバックログ(Jira 等)に一本化する方針なら、Pega 内に仕様を二重に持たず、Specification は使わないか、リンク参照にとどめる、という割り切りもあり得ます。
重要なのは「両方に同じ内容が同じ権威で存在する状態」を作らないことです。SSOT が2つあると、それは SSOT ではありません。
よくある失敗 — DCO で作った仕様が化石化する
このテーマで最も典型的な失敗が、DCO で立派に作った Specification が、その後まったく更新されず化石化するというものです。
プロジェクト初期の DCO セッションでは、顧客と一緒に仕様を洗い出し、Specification として気持ちよく整備します。ところが実装フェーズに入ると、日々の変更はバックログのユーザーストーリー側で回り始めます。仕様変更もストーリーの中で吸収され、Specification に反映されないまま実装だけが先へ進む。結果、数か月後には「仕様書(Specification)は初期のまま、実際の挙動は別物」という状態になり、追跡性という Specification 最大の価値が失われます。
原因ははっきりしていて、SSOT を最初に1つに決めていないからです。Specification を正とすると宣言したなら、仕様変更のたびに Specification を更新し、実装リンクを保つ運用が要ります。それをやらないなら、そもそも Specification に正を置くべきではありません。「作ったけれど維持しない仕様」は、無いよりたちが悪い——古い情報を信じて設計判断を誤らせるからです。
もう一方の失敗は、同じ内容を Specification とバックログの両方に書いて、同期を人手で頑張ろうとするパターンです。当初は同期できても、変更が積み重なれば必ずズレます。二重管理は「頑張れば維持できる」ものではなく、構造的に破綻します。
回避策はシンプルです。安定した業務仕様でトレーサビリティ対象とするものを Specification に、変動する作業単位をバックログアイテムに割り当て、どちらを正とするかを明示的に線引きする。 そして、正と決めた側だけを更新し続ける規律を運用に組み込みます。
まとめ
- Pega の要件管理は「Specification(DCO)」と「バックログアイテム(ユーザーストーリー)」の2系統があり、役割が異なる
- Specification の本質は、DCO で顧客と直接キャプチャし実装ルールにリンクして追跡性を持てること。外部ドキュメントとの決定的な差はここにある
- Agile Workbench(作業コンテキスト内での軽量な起票)と Agile Studio(独立したスクラム管理アプリ)は役割が違う。混同しない
- 判断の核は 要件の SSOT を1つに定めること。安定・追跡性が要る仕様は Specification、変動する作業単位はバックログへ
- よくある失敗は、DCO で作った Specification が更新されず化石化すること、そして二重管理による同期ズレ。どちらも「正を1つに決めていない」ことが根本原因
要件をどこに残すかは、単なるツールの好みではなく、追跡性と保守性を左右する設計判断です。プロジェクトの最初に線引きを明文化しておくことが、後工程での「仕様と実装の乖離」という手戻りを防ぎます。
Pega の設計・実装でお困りの際は、Pega Platform 開発支援 や 無料相談 をご利用ください。Pega 認定資格の最高位 LSA(Lead System Architect)を保有するコンサルタントが、要件管理の設計からご支援します。
関連リンク
このテーマの記事をまとめて読む: Pega 導入プロジェクトの進め方 用語は Pega 用語集 で引けます
関連記事
Pega Process AI の予測をケースに組み込む判断|適応モデルと決定ルールの使い分け
ケースの振り分けや優先度づけを「予測に任せるか、ルールで決め切るか」は、多くの実装で迷う分岐点です。本記事では Pega Process AI の予測をどこに、どう組み込むべきかを、モデル選定・フォールバック設計・運用監視の観点から整理し、実装者が具体的に判断できる形にまとめます。
記事を読むPega 日時・タイムゾーン設計|DateTime と Date の使い分けと UTC 保存の落とし穴
「登録日が1日ずれる」「バッチの集計時刻が合わない」——多言語・多地域展開の Pega アプリで LSA が必ず直面するのが日時とタイムゾーンの設計だ。DateTime を UTC で保存し表示で現地時刻へ変換するモデルを理解せず、暦上の日付まで DateTime にしてしまうと、タイムゾーン変換で日付が前後する。プロパティ型の選択基準から整理する。
記事を読むPega ケース移行の設計判断|進行中ケースを移すか切替後に新規作成か
「旧システムの進行中案件をPegaへそのまま移せますか?」— レガシー移行で必ず出るこの問いに、LSAは安易に頷けない。過去フローの完全再現はほぼ不可能で、現在ステージと業務データの再現に絞るのが定石だ。本記事はオープンケース移行と切替後新規作成の分岐、SLA・アサインメント・監査履歴の扱い、段階移行とビッグバンの判断を、失敗例とともに整理する。
記事を読む