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 とバックログアイテムの使い分け 要件の正(SSOT)をどこに置くかで、安定した業務仕様は Specification、変動する作業単位はバックログアイテム(ユーザーストーリー)に振り分ける比較図。 この要件の「正(SSOT)」をどこに置く? 安定した業務仕様? / 変動する作業単位? 安定・追跡性が要る 変動・進行中の調整 Specification(仕様) DCO で直接キャプチャ ・顧客と DCO セッションで合意 ・実装ルールにリンク=追跡性 ・向き:安定した業務仕様 ・SSOT を Pega 内に置く バックログアイテム ユーザーストーリー等 ・Agile Workbench で起票 ・Agile Studio で計画・進行 ・向き:変動する作業単位 ・SSOT はバックログ側 両方に同じ内容を持つと必ず同期がズレる ― どちらを正とするか1つに線引きする
図:安定していて実装への追跡性が要る要件は Specification、変動する作業単位はバックログアイテム。二重管理は同期ズレの原因になるため、要件ごとに SSOT を1つに定める。

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 StudioAgile 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・アサインメント・監査履歴の扱い、段階移行とビッグバンの判断を、失敗例とともに整理する。

記事を読む

設計標準と設計レビューのご相談

判断の理由と適用範囲まで書いた設計標準をもとに、設計レビューと内製化を支援しています。