PJR-ZA91 STSD と CSTD を STSD へ統合し状態一覧と状態遷移図を 1 文書で扱う
1. 概要
ステータス定義（STSD）と概念状態遷移図（CSTD）は、どちらも「1 対象 = 1 ファイル」で常に 1:1 に対応し、CSTD の必須章「状態の説明」が STSD の状態定義と重複している。分けたままでは片方が空洞化するか二重管理になるため、状態一覧と状態遷移図を STSD 1 文書で扱う形へ統合する。
統合先を STSD（stsd-<term>）とする理由は次のとおり。
stsdは Status Definition（ステータス定義）で、文書の役割（対象の状態を定義する）を表す。cstdは Conceptual State Transition Diagram で、表現形式（図）を指すため、状態一覧を同居させると名前と内容がずれる。- カタログでは
dct-data-model-stsdの 5 件がdct-data-model-cstdの 4 件を包含しており、STSD を正本にすると変更量が少ない。
1.1. 決定事項
- 統合後の STSD の本文構成は「概要 / 状態一覧 / 状態遷移図 / 遷移の説明 / 今後の検討メモ」とする。状態一覧は状態名・通称・意味・成立条件・管理場所を持つ。
stsd-rulebookは現行cstd-rulebook（grade 98）の内容を土台に書き直し、ID 規約のstl-不整合と sample の blocker 指摘も解消する。cstd-rulebook/cstd-sampleは deprecated とする。cstd-mermaid-rulebookは Mermaid 記法の参照として残し、stsd-mermaid-rulebookへ改名する。dct-data-model-cstd.yamlを廃止し、dct-data-model-stsd.yamlの 5 件（register-entry / task-execution / deliverable / routine-run / job-run）へ統合する。- CDFD（
cdfd-<group>/cdfd-uc-<case>）の「状態遷移の参照」表は「対象 / 状態を変えるプロセス / 状態定義（STSD）」の 1 参照列とする。 - CDFD が参照する対象と STSD の対応は次のとおりとする。登録項目 →
stsd-register-entry、タスク・Schedule（track）のタスク →stsd-task-execution、文書・成果物 →stsd-deliverable、実行記録 →stsd-job-run。Kata・稼働構成（Onboarding）は状態を持たない扱いとし、参照表は「該当なし」と根拠を記す。
2. 完了条件
stsd-rulebookが統合後の本文構成を定義し、stsd-sample/ template / recipe が rulebook と整合している。cstd-rulebook/cstd-sampleがdeprecatedになり、Mermaid 記法の rulebook がstsd-mermaid-rulebookとして参照されている。dct-data-model-cstd.yamlが廃止され、dct-data-model-stsd.yamlの 5 件に統合内容が反映され、specdojo catalog validateが通過している。cdfd-rulebook/cdfd-uc-rulebook/ template / sample /cdfd-overviewと、data-flow-pdcaの 8 文書の「状態遷移の参照」が STSD 単一参照になり、参照 ID が上記の対応表と一致している。deliverables-reference/id-and-file-naming-standard/directory-layout-referenceの CSTD 行が統合後の記述に改まっている。npm run lint:mdとspecdojo catalog validateが通過している。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | stsd-rulebook を cstd-rulebook の内容を土台に統合構成へ改訂し、sample / template / recipe を整合させる | ARC | done | 統合構成と完成例、作成手順、雛形を追加 |
| 2 | cstd-rulebook / cstd-sample を deprecated にし、cstd-mermaid-rulebook を stsd-mermaid-rulebook へ改名する | ARC | done | CSTD は移行方針だけを残し、Mermaid 記法を STSD 配下へ移行 |
| 3 | dct-data-model-cstd.yaml を dct-data-model-stsd.yaml へ統合し、参照・標準 3 文書の CSTD 行を更新する | ARC | done | 5 件の STSD に状態遷移観点を統合 |
| 4 | cdfd-rulebook / cdfd-uc-rulebook / template / sample / cdfd-overview の「状態遷移の参照」を単一参照へ更新する | ARC | done | CDFD の状態責務を STSD 単一参照へ統一 |
| 5 | data-flow-pdca の 8 文書の「状態遷移の参照」を単一参照へ書き換え、参照 ID を決定事項の対応表に揃える | ARC | done | 登録項目・タスク・成果物・実行記録の対応 ID を反映 |
| 6 | PJR-ZFFZ の作業 1（移設先の要否と ID 確定）を本決定で更新する | ARC | done | CSTD を作らず STSD へ統合する方針を反映 |
4. 対応結果
STSD の rulebook、sample、template、recipe を、状態一覧・状態遷移図・遷移説明を一文書で扱う構成へ統合した。旧 CSTD の rulebook と sample は deprecated とし、Mermaid 記法は stsd-mermaid-rulebook へ移行した。
データモデルカタログは独立した CSTD 4 件を廃止し、STSD 5 件へ遷移観点と PO・設計・テスト・実装の完了条件を統合した。CDFD の rulebook、recipe、template、sample、全体概要、および data-flow-pdca の 8 文書は STSD 単一参照へ変更し、登録項目、タスク、成果物、実行記録の参照 ID を決定事項へ揃えた。Kata と稼働構成は状態を持たない根拠を明記した。
参照・命名・ディレクトリの 3 文書と PJR-ZFFZ の移設判断も統合方針へ更新した。残課題はなく、検証結果は exec result へ記録する。