概念データフロー図（登録簿ライフサイクル）: SpecDojo
本書は、[[prj-0001:cdfd-overview|概念データフロー図（全体概要）]] が定める P-02 登録簿ライフサイクル の境界を引き継ぎ、立ち上げ時の未整理事項と運用中の計画外事項を、個票の起票から対応、審査、終了、再開、派生生成、履歴確認、例外復旧まで継続管理する概念仕様である。BA が登録簿と Schedule の境界を整理し、PO、ARC、QE が人間の判断責任、正本、状態遷移、主要例外を同じ表と図から確認するために使用する。
1. 目的
- BA とプロジェクト参加者が、七つの登録 type の選択基準、計画済み作業との境界、起票後の利用場面を確認できるようにする。
- PO と type 別承認者が、
reviewから終了・却下・延期・待機へ進む判断、commit と PR の適用境界、終了後の再開条件を承認できるようにする。 - ARC が個票正本から状態、日時、結論、派生ビュー、実行記録、変更履歴へ至る入出力を、QE が Agent 実行失敗、ID 競合、worktree 失敗の停止範囲と再開条件を後続設計・検証へ引き渡せるようにする。
2. 適用範囲
- 対象は、計画外事項または判断事項の発生から、type を選んだ個票の起票、担当・期限・対応方針の設定、人または AI Agent による対応、審査、終了・保留・再開、派生ビュー生成、個票 event からの変更履歴再構成、ID 競合復旧までである。
- 登録簿は
todo、question、risk、issue、change-request、decision、noteを扱う。計画済み作業の実行は対象外とし、P-03 計画展開とP-04 タスク実行に委譲する。 - 正本は一項目一ファイルの個票 Frontmatter と本文である。登録項目一覧、状態別・優先度別・担当者別ビュー、リスク・課題・変更要求・決定の管理ビューは正本から再生成する派生物であり、直接編集しない。
list、historyの絞り込み、dry-run、検証など、正本を変更しない補助操作は独立プロセスにしない。worktree 運用は 概念データフロー図（複数プロジェクト・ブランチ並行処理）、派生ビュー生成は 概念データフロー図（成果物・派生ビュー・索引生成） に委譲し、本領域では登録項目へ返る状態、result、再開条件だけを扱う。- AI Agent は対応・調査と検証を支援できるが、項目を終端化しない。内容承認、却下、延期、再開、公開・高リスク変更の最終判断は、人と AI Agent の責任分担を定める プロジェクト概要 に従い人間が担う。
2.1. 登録判断と Schedule との境界
type 別の登録判断と、計画済み作業を扱う Schedule との境界は [[prj-0001:cdsd-planning|概念データストア定義（プロジェクトの立上と計画）]] の「登録簿と Schedule の管理区分」を正とする。計画済み作業は P-03 で計画し P-04 で実行するため、登録簿へ重複登録しない。
2.2. 状態・日時・結論の記録規則
登録項目の状態一覧、状態遷移、登録日時・完了日時・結論の記録規則は [[prj-0001:stsd-register-entry|ステータス定義（登録項目個票）]] を正とする。
2.3. type 別の審査と承認方式
type 別の審査・承認者、審査待ち後に到達できる状態、既定の証跡は [[prj-0001:stsd-register-entry|ステータス定義（登録項目個票）]] の「type 別の審査・承認と到達できる状態」を正とする。note は審査・終了の対象外であり、open のまま記録を更新し続ける。PR 承認を強制する範囲の詳細は 登録簿運用ガイド と Git ブランチ運用標準 を正とする。
3. 領域内プロセス一覧
| プロセス ID | プロセス | 業務目的 | 主な担当 | 起動条件 | 必須性 |
|---|---|---|---|---|---|
P-02-01 | 登録判断・個票起票 | 追跡が必要な計画外事項・判断を適切な type で識別し、引き継げる正本を作る。 | BA、PM、提起者 | 計画外事項、未整理事項、判断要求、または追跡が必要な気づきが発生した | 必須 |
P-02-02 | 担当・対応方針設定 | 項目の担当、期限、対応経路を定め、着手・待機・審査へ進められる状態にする。 | 項目 owner、PM | open の項目が起票された、または再開された | 必須 |
P-02-03 | 人による対応・調査 | 人間の知識と責任が必要な対応・調査を行い、審査可能な結果と判断材料を整える。 | 項目 owner、専門担当 | 対応方針で人による対応・調査を選択した | 条件付き。非選択時は Agent 対応または人間の直接判断へ進む |
P-02-04 | AI Agent による対応・調査 | 実行可能な type の項目を plan と result に展開し、検証可能な対応結果を人間の審査へ渡す。 | AI Agent、実行担当 | 活動中の todo・issue・change-request・question・risk について Agent 利用を選択した | 条件付き。非選択時と decision・note は人が扱う |
P-02-05 | 審査・終了判断 | 対応結果または判断内容を権限者が確認し、終了・却下・延期・待機の扱いと証跡を確定する。 | type 別承認者、レビュー担当 | 対応・調査結果がそろい review になった、または人間の終了判断が必要になった | 必須 |
P-02-06 | 終了項目の再開 | 終了後に前提・状況が変わった項目を、過去の結論を参照できる活動中の状態へ戻す。 | 項目 owner、type 別承認者 | done・decided・rejected・deferred の再評価条件が成立した | 条件付き。条件不成立時は終了状態を維持する |
P-02-07 | 登録簿ビュー生成 | 個票正本の現在値を、利用者が一覧・状態・優先度・担当・type 別に確認できる派生ビューへ展開する。 | BA、運用担当 | 個票が作成・更新された、または派生ビューの再生成が要求された | 必須。個票更新ごとに正本から再生成する |
P-02-08 | 登録項目履歴再構成 | 個票内の追記型 event から、追加・変更・状態遷移を項目単位で監査できる履歴へ戻す。event が無い個票だけ Git 履歴へ戻る。 | PM、監査・確認担当 | 期間レビュー、監査、経緯確認が必要になった | 条件付き。確認要求がなければ履歴出力を作らない |
P-02-09 | ID 競合・参照復旧 | 重複 ID または個票ファイル名と文書 ID の不整合を解消し、個票と参照を一貫した ID へ戻す。 | PM、ARC | 検証または派生生成で ID 重複・命名不整合を検出した | 条件付き。不整合がなければ再採番しない |
P-02-04 の実行対象外である decision と note は、人間が P-02-03 で内容を整える。P-02-07 と P-02-08 は参照・監査を可能にするが、個票正本の値を独自に変更しない。
4. 概念データフロー
個票ごとに必要となる起票・方針設定・審査・派生生成、選択によって起動する対応・調査、終了後にだけ起動する再開・監査・ID復旧では性質が異なるため、フローを三図に分ける。
4.1. 必須プロセスのフロー
凡例: ノード形状・線種・色・絵文字は [[prj-0001:cdfd-overview|概念データフロー図（全体概要）]] の「凡例（本プロダクト共通）」に従う。P-03 計画展開 は委譲先を示す領域外の代表ノードであり、内部処理は本図の対象外とする。本図は現物の流れを扱わない。
4.2. 対応・調査のフロー
凡例: P-02-02 と P-02-05 は必須プロセスのフロー（4.1）と同一のプロセスを指す。ノード形状・線種・色・絵文字は [[prj-0001:cdfd-overview|概念データフロー図（全体概要）]] の「凡例（本プロダクト共通）」に従う。P-06 並行処理 は委譲先を示す領域外の代表ノードであり、内部処理は本図の対象外とする。本図は現物の流れを扱わない。
4.3. 再開・監査・ID復旧のフロー
凡例: P-02-02 は必須プロセスのフロー（4.1）および対応・調査のフロー（4.2）と同一のプロセスを指す。ノード形状・線種・色・絵文字は [[prj-0001:cdfd-overview|概念データフロー図（全体概要）]] の「凡例（本プロダクト共通）」に従う。本図は現物の流れを扱わない。
5. 個別プロセス主要入出力
登録項目個票は Frontmatter の構造化フィールド、H1 のタイトル、本文の説明・判断材料を合わせた正本である。プロセス ID、業務目的、主な担当、起動条件、必須性は「領域内プロセス一覧」を参照する。
5.1. 必須プロセス（P-02-01・P-02-02・P-02-05・P-02-07）
個票の登録判断から担当・対応方針、権限者の終了判断、正本更新後の派生ビュー生成まで、登録した各項目で必要となる処理を扱う。
| プロセス ID | プロセス | 主要入力 | 主要出力 | データストア |
|---|---|---|---|---|
P-02-01 | 登録判断・個票起票 | 事項の内容、影響、提起者の期待、Schedule 登録状況 | open の登録項目、登録日時、type、優先度、担当・期限の初期値、計画側への移管判断 | 登録項目個票、Schedule |
P-02-02 | 担当・対応方針設定 | 個票、影響、優先度、担当候補、外部依存 | 担当・期限・説明、in-progress または waiting、人・Agent・直接判断の対応経路 | 登録項目個票 |
P-02-05 | 審査・終了判断 | 個票、対応結果、検証結果、承認条件、commit または PR の証跡 | done / decided / rejected / deferred / waiting、結論、必要な完了日時・承認証跡 | 登録項目個票、Git / PR 履歴 |
P-02-07 | 登録簿ビュー生成 | 全登録項目個票、表示タイムゾーン、ビュー雛形 | 登録項目一覧、状態別・優先度別・担当者別ビュー、リスク・課題・変更要求・決定ビュー | 登録項目個票、登録簿派生ビュー |
5.2. 対応・調査プロセス（P-02-03・P-02-04）
対応手段（人・AI Agent）の選択によってだけ起動する処理を扱う。
| プロセス ID | プロセス | 主要入力 | 主要出力 | データストア |
|---|---|---|---|---|
P-02-03 | 人による対応・調査 | 個票、関連成果物、判断材料、承認条件 | 対応結果、回答案、対応方針、審査要求 | 登録項目個票、関連成果物 |
P-02-04 | AI Agent による対応・調査 | 個票、実行 plan、関連成果物、実行条件 | 成功時は対応結果・result と review、失敗時は失敗理由・result と waiting | 登録項目個票、関連成果物、登録項目の実行 plan / result |
5.3. 再開・監査・ID復旧プロセス（P-02-06・P-02-08・P-02-09）
終了後の状況変化、監査要求、ID 不整合の検出によってだけ起動する処理を扱う。
| プロセス ID | プロセス | 主要入力 | 主要出力 | データストア |
|---|---|---|---|---|
P-02-06 | 終了項目の再開 | 個票、旧結論、新事実、再開理由、担当・期限 | open / in-progress / waiting / review、削除した完了日時、再開後の対応条件 | 登録項目個票 |
P-02-08 | 登録項目履歴再構成 | 個票内の追記型 event（未移行分は Git commit 履歴）、対象 ID・期間・状態条件、表示タイムゾーン | 古い順の登録項目変更イベント、状態遷移履歴、actor・reason・event ID | 登録項目個票、Git 履歴、register history |
P-02-09 | ID 競合・参照復旧 | 競合した個票、未使用 ID、参照文書、登録項目の実行 plan / result | 再採番した個票、更新した文書 ID・wikilink・targets、再生成した派生ビュー | 登録項目個票、参照文書、登録項目の実行 plan / result、派生ビュー、Git 履歴 |
6. 主要例外と領域外への委譲
6.1. 主要例外
| 例外 ID | 対象プロセス | 検出条件 | 本領域での扱い | 継続・再開条件 |
|---|---|---|---|---|
E-01 | P-02-01、P-02-07、P-02-09 | type・状態・日時・期限が不正、個票 Frontmatter が読めない、ファイル名と文書 ID が一致しない | 正本の確定または派生生成を停止し、不正な個票と項目を特定する。生成済みビューを正本として補正せず、ID 重複・命名不整合は P-02-09 で復旧する | 個票の値・命名・文書 ID が規約に一致し、全個票の検証が成功する |
E-02 | P-02-04 | Agent 実行、検査、result 作成、または項目単位 commit が失敗した | 項目を終端化せず waiting とし、サニタイズした失敗理由と result、commit の未完了状態を残す。後続項目の停止・継続判断を示す | 原因を解消し、保持した成果物・result を確認したうえで再実行または人対応を選ぶ |
E-03 | P-02-04 | worktree 経路が失敗し、成果物を統合先へ確定できない | 統合済みと扱わず、当該項目を waiting にして失敗段階、未統合 result、再開条件を記録する。分離・同期・統合時の保持対象と復旧順は 複数プロジェクト・ブランチ並行処理 を参照する | 並行処理側で統合可能と確認され、返却された成果物・result を人間が審査できる |
E-04 | P-02-05 | 審査材料、権限者、回答、承認証跡、または終了に必要な結論が不足している | review から終端化せず waiting へ戻し、不足情報、取得責任者、再審査条件を記録する | 不足情報と必要な commit / PR 証跡がそろい、権限者が再審査できる |
E-05 | P-02-09 | 個票の表示 ID が重複する、再採番先が使用済み、または個票ファイル名と文書 ID が一致しない | 書き換え前に個票、再採番先、参照文書、実行記録の対象を検証し、不整合があれば書き込みを始めない。未使用 ID と変更対象は dry-run で確認する | 個票・文書 ID・wikilink・targets を一貫して更新でき、派生生成と検証が成功する |
6.2. 領域外への委譲
| 委譲先 | 委譲する事項 | 引き渡す情報 | 本領域へ戻す条件 |
|---|---|---|---|
P-03 計画展開（カタログ〜計画展開） | 登録事項を成果物カタログ・Schedule の計画済み作業へ展開する | 確定した制約・決定、対象成果物、依存、優先度、登録項目の移管結論 | 計画化前に追加判断が必要、または計画の前提が変わり計画外事項が生じる |
P-04 タスク実行（タスク実行ライフサイクル） | Schedule で管理する計画済みタスクを実行する | Schedule task、plan、対象成果物、登録簿から引き継いだ前提 | 実行中に新しい計画外事項・判断要求・変更要求が生じる |
P-06 並行処理（複数プロジェクト・ブランチ並行処理） | 登録項目の worktree 分離、同期、統合を管理する | 対象項目、分離条件、統合先、成果物、commit・検証結果 | 同期・統合の成否を登録項目の review / waiting と result へ反映するとき |
P-08 派生生成（成果物・派生ビュー・索引生成） | 派生ビューの生成順、生成先の所有権、部分失敗後の再生成 | 個票正本、表示タイムゾーン、ビュー雛形、生成対象 | 生成失敗が個票の不正または登録簿の運用判断に起因すると判明する |
| Git / PR 運用（Git ブランチ運用標準） | commit と限定された PR による証跡・職務分離を強制する | 個票差分、承認対象、承認者、検査結果、PR URL・merge commit | 証跡を個票の結論・承認節へ反映するとき |