specdojo 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +100 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/generate.js +144 -13
  5. package/dist/commands/agent.js +33 -0
  6. package/dist/commands/init.js +2 -0
  7. package/dist/commands/orchestrator.js +10 -1
  8. package/dist/deliverable/deliverable.js +77 -4
  9. package/dist/devcontainer/command.js +18 -0
  10. package/dist/devcontainer/host-script.js +21 -0
  11. package/dist/devcontainer/scaffold.js +4 -3
  12. package/dist/exec/antigravity-session.js +154 -0
  13. package/dist/exec/core.js +1 -0
  14. package/dist/exec/parent-validation.js +14 -0
  15. package/dist/exec/plan-markdownlint.js +89 -0
  16. package/dist/exec/plans-core.js +46 -1
  17. package/dist/exec/plans-generation.js +45 -5
  18. package/dist/exec/plans-planning.js +1 -1
  19. package/dist/exec/plans-storage.js +1 -0
  20. package/dist/exec/product-branch-records.js +105 -0
  21. package/dist/exec/product-branches.js +52 -0
  22. package/dist/exec/register-product-message.js +50 -0
  23. package/dist/exec/register-resume.js +28 -0
  24. package/dist/exec/register.js +6 -0
  25. package/dist/exec/repo-integration-sync.js +4 -2
  26. package/dist/exec/repo-integration.js +41 -4
  27. package/dist/exec/repo-trace.js +2 -0
  28. package/dist/exec/results.js +9 -5
  29. package/dist/exec/run/lifecycle-commands.js +85 -16
  30. package/dist/exec/run/register-command.js +22 -0
  31. package/dist/exec/run/register-resume.js +11 -1
  32. package/dist/exec/run/register-worktree.js +29 -8
  33. package/dist/exec/run/schedule-mode.js +22 -2
  34. package/dist/exec/run/schedule-prepare.js +49 -4
  35. package/dist/exec/run/schedule-task.js +3 -0
  36. package/dist/exec/strategy.js +2 -1
  37. package/dist/exec/task-repos.js +78 -16
  38. package/dist/exec/worktree-command.js +2 -2
  39. package/dist/exec/worktree-ops-commit.js +1 -13
  40. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  41. package/dist/exec/worktree.js +3 -3
  42. package/dist/register/core.js +5 -0
  43. package/dist/register/create-commands.js +54 -2
  44. package/dist/register/deliverable-target.js +24 -17
  45. package/dist/register/event-merge.js +4 -0
  46. package/dist/register/events.js +6 -0
  47. package/dist/register/external-project.js +2 -0
  48. package/dist/register/input.js +168 -0
  49. package/dist/register/item.js +61 -0
  50. package/dist/register/register.js +33 -25
  51. package/dist/register/renumber.js +4 -0
  52. package/dist/register/update.js +6 -0
  53. package/dist/schedule/approach.js +9 -0
  54. package/dist/schedule/strategy-profiles.js +22 -2
  55. package/dist/shared/agent-types.js +4 -1
  56. package/dist/shared/branch-template.js +26 -0
  57. package/dist/shared/commit-message-template.js +38 -0
  58. package/dist/shared/commit-types.js +15 -0
  59. package/dist/shared/git.js +7 -0
  60. package/dist/shared/provider-scaffold.js +2 -0
  61. package/dist/shared/specdojo-config.js +35 -4
  62. package/dist/shared/specdojo-gitignore.js +1 -0
  63. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  64. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  65. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  66. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  67. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  68. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  69. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  70. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  71. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  72. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  73. package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
  74. package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
  75. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  76. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  77. package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
  78. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  79. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  80. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  81. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  82. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  83. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  84. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  85. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  86. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  87. package/docs/ja/specdojo/references/command-reference.md +111 -46
  88. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  89. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  90. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  91. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  92. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  93. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  94. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  95. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  96. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  97. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  98. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  99. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  100. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  101. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  102. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  103. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  104. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  105. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  106. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  107. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  108. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  109. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  110. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  111. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  112. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  113. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  114. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  115. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  116. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
  117. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  118. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  119. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  120. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
  121. package/package.json +6 -2
  122. package/templates/antigravity/README.md +19 -46
  123. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  124. package/templates/antigravity/orchestrator.md +2 -0
  125. package/templates/antigravity/settings.edit.json +73 -0
  126. package/templates/antigravity/settings.orchestrator.json +15 -0
  127. package/templates/antigravity/settings.report.json +7 -0
  128. package/templates/antigravity/settings.review.json +7 -0
  129. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  130. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  131. package/templates/codex/orchestrator.md +2 -0
  132. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  133. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
  134. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  135. package/templates/init-agent-members.yaml +1 -0
  136. package/templates/init-exec-defaults.yaml +1 -1
  137. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -19,33 +19,23 @@ _TODO_: 対象の業務または運用が何を扱うかを一文で定義する
19
19
 
20
20
  ## 1. 目的
21
21
 
22
- _TODO_: 全体像を整理する目的と、後続のプロセスグループ別 CDFD・ユースケース別 CDFD の位置付けを明確にすることを一文で書く。対象者と利用場面は次のとおり。
23
-
24
- - _ROLE_ は、_TODO_: 対象範囲と領域分割を承認する、詳細化する、設計入力として使う、重複・欠落を確認する、のように利用結果を判定できる形で書く。
25
- - _ROLE_ は、_TODO_
26
- - _ROLE_ は、_TODO_
22
+ _TARGET_NAME_ の業務または運用の全体像として、_TODO_: プロセス領域のまとまりと、それらが読み書きするデータの関係を 1〜2 文で示す。
27
23
 
28
24
  ## 2. 適用範囲
29
25
 
30
26
  - 対象は、_TODO_: 開始点、終了点、対象業務、組織またはシステム境界を書く。
31
- - 本書が扱うのは、プロセス領域の分割と、領域間・データストア間の受け渡しまでである。各領域の内部(_TODO_: 操作手順、更新内容、処理の分岐、状態を変える処理と起点イベント、例外時の復旧手順など)は対象外とし、プロセスグループ別 CDFD で詳細化する。状態の定義と遷移はステータス定義(Status Definition: STSD、`specdojo:stsd-rulebook`)を正本とし、詳細 CDFD は参照に留める。
27
+ - 本書が扱うのは、プロセス領域の分割と、領域間・データストア間の受け渡しまでである。各領域の内部(_TODO_: 操作手順、更新内容、処理の分岐、状態を変える処理と起点イベント、例外時の復旧手順など)は対象外とし、選択した方式の詳細 CDFD で詳細化する。状態の定義と遷移はステータス定義(Status Definition: STSD、`specdojo:stsd-rulebook`)を正本とし、詳細 CDFD は参照に留める。
32
28
  - _TODO_: 一覧、検索、状態参照、検証などの補助操作を列挙し、独立した業務フローに含めず各領域を支える操作として扱うことを書く。
33
29
  - 人間と AI Agent の責任分担は、_TODO_: 対応する方針文書があれば `[[_AUTHORITY_:prj-overview|プロジェクト概要]]` のように参照し、なければ「承認・完了判断は人間が担い、作成・評価は人が担うほか AI Agent へ委譲できる」のように原則を一文で書く。
34
30
 
35
31
  ## 3. プロセス領域
36
32
 
37
- 業務は _AREA_COUNT_ のプロセス領域に分かれ、_GROUP_COUNT_ のプロセスグループにまとめる。領域の分割と領域間の受け渡しは本書を正本とし、領域内の詳細はプロセスグループ別 CDFD を正本とする。各グループの主要入力・主要出力・データストアは「概念データフロー(概要)」のエッジの根拠である。
33
+ 業務は _AREA_COUNT_ のプロセス領域を _GROUP_COUNT_ のプロセスグループまたは区分にまとめる。領域の定義は本書の表、受け渡しは本書の図、領域内部は選択した方式の詳細 CDFD を正本とする。
38
34
 
39
- <!-- プロセスグループごとに 3.n の節を繰り返す。グループ数は 8 以下。1 領域だけのグループも可。 -->
35
+ <!-- 今の方式ではプロセスグループ、系統の関係を描く方式では区分ごとに 3.n の節を繰り返す。8 以下とし、各節は領域表だけにする。PDCA(Plan、Do、Check、Action、全体など)は任意の列として追加できる。 -->
40
36
 
41
37
  ### 3.1. _PROCESS_GROUP_NAME_(_PROCESS_AREA_ID_〜_PROCESS_AREA_ID_)
42
38
 
43
- _TODO_: グループの役割と、グループ内の領域がどう連携するかを 1〜3 文で要約する。
44
-
45
- - **主要入力**: _TODO_: 他グループからの要求、外部主体からの入力、参照するデータストアの内容を名詞で列挙する。
46
- - **主要出力**: _TODO_: 更新・生成するデータストアの内容、他グループへの要求を名詞で列挙する。
47
- - **データストア**: _TODO_: 「データストア」と同じ名称で、参照・更新するデータストアを列挙する。
48
-
49
39
  <!-- prettier-ignore -->
50
40
  | 領域 ID | プロセス領域 | 業務目的 | 主な担当 | 起点イベント |
51
41
  | --- | --- | --- | --- | --- |
@@ -54,12 +44,6 @@ _TODO_: グループの役割と、グループ内の領域がどう連携する
54
44
 
55
45
  ### 3.2. _PROCESS_GROUP_NAME_(_PROCESS_AREA_ID_)
56
46
 
57
- _TODO_
58
-
59
- - **主要入力**: _TODO_
60
- - **主要出力**: _TODO_
61
- - **データストア**: _TODO_
62
-
63
47
  <!-- prettier-ignore -->
64
48
  | 領域 ID | プロセス領域 | 業務目的 | 主な担当 | 起点イベント |
65
49
  | --- | --- | --- | --- | --- |
@@ -89,37 +73,66 @@ _TODO_: 区分の意味、パスの略記(例: `<project-id>` が指す範囲
89
73
 
90
74
  ## 5. 概念データフロー(概要)
91
75
 
92
- プロセスは _GROUP_COUNT_ のプロセスグループの代表ノード、データストアは「データストア」の各行をノードとして示す。矢印は情報または実行要求の受け渡しであり、実行順や毎回の通過を意味しない。更新のエッジは更新前の参照を含む。_TODO_: 対象範囲内の参加者を外部主体として描かないこと、外部主体を描く場合はその範囲を一文で書く。
93
-
94
- <!-- ノード総数(代表ノードとデータストアの合計)が 16 以下なら以下の 1 図を使う。16 を超える場合は、この図を削除して「5.1. トランザクションデータの流れ」「5.2. マスタ・構成データの流れ」の節に分け、各節に図と注記を置く。両図で名称を統一し、グループ間の要求はトランザクションの図にだけ描く。 -->
95
-
96
- ```mermaid
97
- flowchart LR
98
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
99
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
100
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
101
- classDef actor fill:#f5f7fa,stroke:#607d8b,color:#000
102
-
103
- _PROCESS_GROUP_NODE_ID_("_PROCESS_GROUP_NAME_<br>_PROCESS_AREA_ID_〜_PROCESS_AREA_ID_")
104
- _MASTER_STORE_NODE_ID_[("_DATA_STORE_NAME_")]
105
- _TRANSACTION_STORE_NODE_ID_[("_DATA_STORE_NAME_")]
106
-
107
- _MASTER_STORE_NODE_ID_ -->|"_INPUT_LABEL_"| _PROCESS_GROUP_NODE_ID_
108
- _PROCESS_GROUP_NODE_ID_ -->|"_OUTPUT_LABEL_"| _TRANSACTION_STORE_NODE_ID_
109
-
110
- class _PROCESS_GROUP_NODE_ID_ process
111
- class _MASTER_STORE_NODE_ID_ storeMaster
112
- class _TRANSACTION_STORE_NODE_ID_ storeTransaction
76
+ _TODO_: 採用する構成方式(今の方式、または系統の関係を描く方式)と、この章で示す関係を 1〜2 文で書く。
77
+
78
+ <!-- 以下は今の方式の 1 図の雛形。16 ノードを超える場合はデータストアの区分または使い方の流れで節に分ける。系統の関係を描く方式では区分を代表ノードにし、データの種類で分けた図の間で位置をそろえ、受け渡しの線のない区分は省く。各区分はいずれかの図に必ず出す。調整役(Orchestrator)はデータの図に置かず、必要なら指示の図を別に置く。調整役は直接読み書きするストアだけにつなぎ、CLI 経由の読み書きはデータの図の該当区分から描く。区分間の実行要求は名詞のラベルで描いてよい。全図で名称を統一し、同じストアの再掲を認める。 -->
79
+
80
+ <!-- 複数図の場合は、例えば「5.1. PDCA のプロセスとデータの関係」「5.2. プロセスを実行する設定・構成情報の流れ」「5.3. Orchestrator による PDCA の調整」のように業務の言葉で題を付け、各節に図と読み取れることを 1 文で置く。 -->
81
+
82
+ _TODO_: 図の題を業務の言葉で書く。
83
+
84
+ ```d2
85
+ direction: down
86
+
87
+ classes: {
88
+ process: {
89
+ shape: rectangle
90
+ style: {
91
+ border-radius: 8
92
+ fill: "#e3f2fd"
93
+ stroke: "#1e88e5"
94
+ font-color: "#000000"
95
+ }
96
+ }
97
+ store_master: {
98
+ shape: cylinder
99
+ style: {
100
+ fill: "#e8f5e9"
101
+ stroke: "#43a047"
102
+ font-color: "#000000"
103
+ }
104
+ }
105
+ store_transaction: {
106
+ shape: cylinder
107
+ style: {
108
+ fill: "#c8e6c9"
109
+ stroke: "#2e7d32"
110
+ font-color: "#000000"
111
+ }
112
+ }
113
+ }
114
+
115
+ process_group: "_PROCESS_GROUP_NAME_\n_PROCESS_AREA_ID_〜_PROCESS_AREA_ID_" {
116
+ class: process
117
+ }
118
+ master_store: "_DATA_STORE_NAME_" {
119
+ class: store_master
120
+ }
121
+ transaction_store: "_DATA_STORE_NAME_" {
122
+ class: store_transaction
123
+ }
124
+
125
+ master_store -> process_group: "_INPUT_LABEL_"
126
+ process_group -> transaction_store: "_OUTPUT_LABEL_"
113
127
  ```
114
128
 
115
- 凡例は「凡例(本プロダクト共通)」に従う。`-->` は情報の流れであり、_TODO_: 物の流れ(`==>`)を使う場合はその旨、使わない場合は「本図は物の流れを対象外とする」と書く。各領域の起点イベントと担当は「プロセス領域」の表に記載し、本図では省略する。_TODO_: 外部主体の有無を書く。
129
+ _TODO_: この図から読み取れる業務上の関係を 1 文で書く。作図の約束は凡例にまとめる。
116
130
 
117
131
  ## 6. 詳細 CDFD 一覧
118
132
 
119
- 本書の詳細化先は、プロセスグループ別 CDFD とユースケース別 CDFD の 2 種類である。役割分担は次のとおり。
133
+ _TODO_: 採用した方式の詳細化先を簡潔に示す。状態の定義と遷移は STSD を正本とし、詳細 CDFD は参照に留める。
120
134
 
121
- - プロセスグループ別 CDFD は、グループに属する領域の内部プロセス、起点イベント、例外・復旧、データストアの読み書きを定める正本である。状態の定義と遷移は STSD を正本とし、プロセスグループ別 CDFD は参照に留める。各領域はちょうど一つのプロセスグループ別 CDFD に属する。
122
- - ユースケース別 CDFD は、複数のプロセスグループをまたぐ順序と引き渡し条件だけを定める。グループ内部のプロセスは再掲せず、プロセスグループ別 CDFD を参照する。単一のグループに閉じる業務はユースケース別 CDFD を作らない。
135
+ <!-- 今の方式では、以下の 2 表を使う。プロセスグループ別 CDFD はグループ内部のプロセス・起点イベント・例外・復旧・ストアの読み書きを定め、ユースケース別 CDFD は複数グループ間の順序と引き渡し条件だけを定める。系統の関係を描く方式では、6.1 の表を省略するか移行期・非推奨の記録とし、6.2 の表を各系統の流れを領域単位で詳細化する一覧に置き換える。列はケース ID、ユースケース(系統名)、業務目的、対象系統・領域、ユースケース別 CDFD とする。 -->
123
136
 
124
137
  ### 6.1. プロセスグループ別 CDFD
125
138
 
@@ -131,7 +144,7 @@ flowchart LR
131
144
 
132
145
  ### 6.2. ユースケース別 CDFD
133
146
 
134
- _TODO_: 複数のプロセスグループを横断し、順序と引き渡し条件を定める必要がある業務だけを載せる旨と、単一グループに閉じる業務は必要になった時点で追加する旨を書く。
147
+ _TODO_: 今の方式では、複数グループを横断する順序と引き渡し条件を扱う旨を書く。系統の関係を描く方式では、各系統の入口・引き渡し・終了のイベントとストアの読み書きを領域単位で定める旨を書く。
135
148
 
136
149
  <!-- prettier-ignore -->
137
150
  | ケース ID | ユースケース | 業務目的 | 横断するプロセスグループ | ユースケース別 CDFD |
@@ -142,51 +155,116 @@ _TODO_: 複数のプロセスグループを横断し、順序と引き渡し条
142
155
 
143
156
  <!-- 詳細 CDFD が複数存在し、共通のノード形状・色・絵文字を使う場合に設ける。単一の CDFD しかない場合は章ごと削除し、以降の章番号を詰める。 -->
144
157
 
145
- 本プロダクトの全 CDFD(本書、プロセスグループ別 CDFD、ユースケース別 CDFD)が共通して参照するノード形状・色・絵文字の対応を示す。個々の CDFD は、以下の定義を再掲せず、本章への参照に留める。
146
-
147
- ```mermaid
148
- flowchart LR
149
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
150
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
151
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
152
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
153
- classDef actor fill:#f5f7fa,stroke:#607d8b,color:#000
154
-
155
- 外部主体["🧑 外部主体"]
156
- 起点イベント{{"⚡ 起点イベント"}}
157
- プロセス("⚙️ プロセス/プロセスグループ")
158
- マスタ構成データ[("🗄️ マスタ・構成データ")]
159
- トランザクションデータ[("🗄️ トランザクションデータ")]
160
- 物理保管(["🏬 物理保管"])
161
-
162
- 外部主体 -->|"情報の流れ"| プロセス
163
- 起点イベント -->|"起動条件"| プロセス
164
- プロセス -->|"参照・更新"| マスタ構成データ
165
- プロセス -->|"更新"| トランザクションデータ
166
- プロセス ==>|"物の流れ"| 物理保管
167
-
168
- class プロセス process
169
- class 起点イベント event
170
- class マスタ構成データ storeMaster
171
- class トランザクションデータ,物理保管 storeTransaction
172
- class 外部主体 actor
158
+ 本プロダクトの全 CDFD が共通して参照するノード形状・色・絵文字の対応を示す。個々の CDFD は、以下の定義を再掲せず、本章への参照に留める。
159
+
160
+ 図の記法には D2([[specdojo:cdfd-d2-rulebook|D2 記法ルール]])を採用し、`direction: down` で縦に配置する。矢印は情報または実行要求の受け渡しであり、実行順や毎回の通過を意味しない。更新の線は更新前の参照を含む。`->`(戻りは `<-`)の通常線は情報、`material_flow` class の太線は物の流れを表す。配置制御用の非表示の線は受け渡しを表さない。
161
+
162
+ _TODO_: 外部主体と起点イベントを図に置くか省くか、およびその理由を書く。複数の代表ノードは上から下へ読める順に並べ、戻りの線は `<-` で書く。並びを固定する非表示の線を使う場合は、直前に「配置制御用(受け渡しではない)」とコメントする。
163
+
164
+ ```d2
165
+ direction: down
166
+
167
+ classes: {
168
+ process: {
169
+ shape: rectangle
170
+ style: {
171
+ border-radius: 8
172
+ fill: "#e3f2fd"
173
+ stroke: "#1e88e5"
174
+ font-color: "#000000"
175
+ }
176
+ }
177
+ event: {
178
+ shape: hexagon
179
+ style: {
180
+ fill: "#fff3e0"
181
+ stroke: "#fb8c00"
182
+ font-color: "#000000"
183
+ }
184
+ }
185
+ store_master: {
186
+ shape: cylinder
187
+ style: {
188
+ fill: "#e8f5e9"
189
+ stroke: "#43a047"
190
+ font-color: "#000000"
191
+ }
192
+ }
193
+ store_transaction: {
194
+ shape: cylinder
195
+ style: {
196
+ fill: "#c8e6c9"
197
+ stroke: "#2e7d32"
198
+ font-color: "#000000"
199
+ }
200
+ }
201
+ physical_store: {
202
+ shape: rectangle
203
+ style: {
204
+ border-radius: 20
205
+ fill: "#c8e6c9"
206
+ stroke: "#2e7d32"
207
+ font-color: "#000000"
208
+ }
209
+ }
210
+ actor: {
211
+ shape: rectangle
212
+ style: {
213
+ fill: "#f5f7fa"
214
+ stroke: "#607d8b"
215
+ font-color: "#000000"
216
+ }
217
+ }
218
+ material_flow: {
219
+ style: {
220
+ stroke-width: 3
221
+ }
222
+ }
223
+ }
224
+
225
+ actor_node: "🧑 外部主体" {
226
+ class: actor
227
+ }
228
+ event_node: "⚡ 起点イベント" {
229
+ class: event
230
+ }
231
+ process_node: "⚙️ プロセス/プロセスグループ/区分" {
232
+ class: process
233
+ }
234
+ master_store: "🗄️ マスタ・構成データ" {
235
+ class: store_master
236
+ }
237
+ transaction_store: "🗄️ トランザクションデータ" {
238
+ class: store_transaction
239
+ }
240
+ physical_store_node: "🏬 物理保管" {
241
+ class: physical_store
242
+ }
243
+
244
+ actor_node -> process_node: "情報の流れ"
245
+ event_node -> process_node: "起動条件"
246
+ process_node -> master_store: "参照・更新"
247
+ process_node -> transaction_store: "更新"
248
+ process_node -> physical_store_node: "物の流れ" {
249
+ class: material_flow
250
+ }
173
251
  ```
174
252
 
175
253
  <!-- prettier-ignore -->
176
254
  | 概念 | 形状 | 色 | 絵文字例 |
177
255
  | --- | --- | --- | --- |
178
- | プロセス/プロセスグループ | 角丸長方形 | 青(`#e3f2fd` / `#1e88e5`) | 業務内容が伝わる絵文字(例: ⚙️) |
179
- | 起点イベント | 六角形 | 橙(`#fff3e0` / `#fb8c00`) | 出来事が伝わる絵文字(例: 🚦) |
180
- | データストア(マスタ・構成データ) | 円柱 | 濃い緑(`#a5d6a7` / `#1b5e20`) | 保管物が伝わる絵文字(例: 📐) |
181
- | データストア(トランザクションデータ) | 円柱 | 薄い緑(`#e8f5e9` / `#43a047`) | 保管物が伝わる絵文字(例: 📒) |
182
- | 物理保管 | スタジアム形 | 薄い緑(トランザクションデータと同じ) | 保管場所が伝わる絵文字(例: 🏬) |
183
- | 外部主体 | 四角 | グレー(`#f5f7fa` / `#607d8b`) | 主体が伝わる絵文字(例: 👤) |
184
- | 情報の流れ | ラベル付き `-->` | — | — |
185
- | 物の流れ | ラベル付き `==>` | — | — |
256
+ | プロセス/プロセスグループ/区分 | 角丸四角形(`style.border-radius: 8`) | 青(`#e3f2fd` / `#1e88e5`) | 業務内容が伝わる絵文字(例: ⚙️) |
257
+ | 起点イベント | 六角形(`shape: hexagon`) | 橙(`#fff3e0` / `#fb8c00`) | 出来事が伝わる絵文字(例: 🚦) |
258
+ | データストア(マスタ・構成データ) | 円柱(`shape: cylinder`) | 薄い緑(`#e8f5e9` / `#43a047`) | 保管物が伝わる絵文字(例: 📐) |
259
+ | データストア(トランザクションデータ) | 円柱(`shape: cylinder`) | 中間の緑(`#c8e6c9` / `#2e7d32`) | 保管物が伝わる絵文字(例: 📒) |
260
+ | 物理保管 | 大角丸四角形(`style.border-radius: 20`) | 中間の緑(トランザクションデータと同じ) | 保管場所が伝わる絵文字(例: 🏬) |
261
+ | 外部主体 | 四角形(`shape: rectangle`) | グレー(`#f5f7fa` / `#607d8b`) | 主体が伝わる絵文字(例: 👤) |
262
+ | 情報の流れ | ラベル付き通常線 `->`(戻りは `<-`) | — | — |
263
+ | 物の流れ | ラベル付き太線 `->`(`material_flow` class) | — | — |
186
264
 
187
265
  データストアの色分けは、大分類「データストア」の中の業務上のサブ分類を表す。マスタ・構成データは、他のプロセスから参照される比較的安定した基準情報を指す。トランザクションデータは、業務活動に伴い都度更新される記録を指す。物理保管は現物の保管先であり、いずれの区分にも属さないため、便宜上トランザクションデータと同じ色を用いる。
188
266
 
189
- ノード形状・線種そのものの記法は `specdojo:cdfd-mermaid-rulebook` に従う。本章は、その記法に基づき _TARGET_NAME_ が実際に採用する色・絵文字の割り当てを固定する。
267
+ ノード形状・線種そのものの記法は [[specdojo:cdfd-d2-rulebook|D2 記法ルール]] に従う。本章は、その記法に基づき _TARGET_NAME_ が実際に採用する色・絵文字の割り当てを固定する。
190
268
 
191
269
  <!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。本文中の未確定箇所には _UNDECIDED_ を付け、表の論点と対応させる。
192
270
 
@@ -16,133 +16,170 @@ specdojo:
16
16
 
17
17
  # 概念データフロー図(ユースケース別): _USE_CASE_NAME_
18
18
 
19
- _TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースと、複数のプロセスグループを横断して定める目的を一文で記述する。
19
+ _TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースまたは系統を一文で示す。
20
20
 
21
21
  ## 1. 目的
22
22
 
23
- _TODO_: 対象者ごとに、横断順序、引き渡し条件、例外時の戻り先を承認・設計・確認する利用結果を記述する。
24
-
25
- - _ROLE_ は、_TODO_: グループの通過順と責任境界を承認する。
26
- - _ROLE_ は、_TODO_: 引き渡す情報と条件を後続設計へ利用する。
27
- - _ROLE_ は、_TODO_: 引き渡しと戻り経路の重複・欠落を確認する。
23
+ _TODO_: その業務が何のためにあるか、どの出来事からどの成果までを成立させるかを 1〜2 文で書く。読み手の承認・設計・確認作業は書かない。
28
24
 
29
25
  ## 2. 適用範囲
30
26
 
31
- - ケース: `_CASE_ID_` _USE_CASE_NAME_。_TODO_: `cdfd-overview` と同じケース ID、名称、業務目的を書く。
32
- - 開始イベント: _START_EVENT_。_TODO_: 最初のグループが動き始める出来事を書く。
33
- - 終了条件: _END_CONDITION_。_TODO_: 最後のグループが成果を利用可能と判断できる条件を書く。
34
- - 横断するプロセスグループ: _PROCESS_GROUP_NAME_ → _PROCESS_GROUP_NAME_。_TODO_: 正常系の通過順で二つ以上を書く。
35
- - 組織境界: _TODO_: 引き渡し可否、戻し、再開を判断するロールと、対象範囲外の主体を書く。
36
- - システム境界: _TODO_: 横断条件の判定と情報・物の引き渡しまでを対象とし、画面・保存方式などの実装詳細を対象外とする旨を書く。
37
- - 対象外: グループ内部の領域・プロセス・主要例外・補助操作は各 `cdfd-_GROUP_`、状態の定義と遷移は STSD を正本とし、本書では再掲しない。
38
- - 責任分担: _TODO_: 人間と AI Agent の責任分担を定める既存文書への参照を書く。参照先がない場合は、承認と最終判断を人間が担う原則を書く。
39
-
40
- ## 3. プロセス領域
41
-
42
- ケース `_CASE_ID_` は _GROUP_COUNT_ のプロセスグループを正常系の順序で横断する。グループ名、含む領域、業務目的は全体概要を正本とし、本章では各グループがこのユースケースで担う役割を定める。
43
-
44
- <!-- 正常系で通過するプロセスグループごとに 3.n の節を繰り返す。同じグループが再登場する場合は別の節とし、理由を書く。 -->
27
+ - **対象**: ケース `_CASE_ID_`「_USE_CASE_NAME_」の _START_EVENT_ から _END_EVENT_ まで、_TODO_: 参加単位と必要な組織・システム境界を 1 行で書く。
28
+ - **対象外**: _TODO_: rulebook の「描き方の選択」に従う対象外、補助操作・実装詳細、状態定義・遷移を委ねる STSD を 1 行で示し、共通の責任分担は全体概要を参照する。
45
29
 
46
- ### 3.1. _PROCESS_GROUP_NAME_(_AREA_ID_RANGE_)
30
+ <!-- based_on と本文では、有効な全体概要や後継文書を参照し、deprecated の文書は参照しない。既存文書は project 修飾 doc id の wikilink、未作成文書は ID のインラインコードにする。 -->
47
31
 
48
- _TODO_: 前段から何を受け取り、次段へ何を渡すかを 1〜3 文で要約する。
32
+ ## 3. プロセス領域
49
33
 
50
- - **主要入力**: _TODO_: 開始イベントまたは前段から受け取る情報・物を名詞で列挙する。
51
- - **主要出力**: _TODO_: 次段または終了側へ渡す情報・物を名詞で列挙する。
52
- - **データストア**: _TODO_: 引き渡す情報または条件判定に使う「データストア」の名称を列挙する。
34
+ _TODO_: ケース `_CASE_ID_` の正常系の順序を示す。名称・領域分割は全体概要、役割は本章の表、受け渡しは図を正本とする。
53
35
 
54
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
55
- | ---- | -------------------- | --------------- | ------------------------------ | -------------- |
56
- | 1 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
36
+ <!-- rulebook の「描き方の選択」に従い、全体概要と同じグループ・区分ごとに節を置く。各節には役割表だけを置き、主要入力・主要出力の箇条書きは置かない。以下はグループ代表ノードの例。領域単位の場合は「含む領域」を「プロセス領域」にし、P-xx 領域名を書く。PDCA は必要な場合だけ独立した列で追加し、グループ・区分の列に入れない。 -->
57
37
 
58
- ### 3.2. _PROCESS_GROUP_NAME_(_AREA_ID_RANGE_)
38
+ ### 3.1. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
59
39
 
60
- _TODO_
40
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
41
+ | ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
42
+ | 1 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
61
43
 
62
- - **主要入力**: _TODO_
63
- - **主要出力**: _TODO_
64
- - **データストア**: _TODO_
44
+ ### 3.2. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
65
45
 
66
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
67
- | ---- | -------------------- | --------------- | ------------------------------ | -------------- |
68
- | 2 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
46
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
47
+ | ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
48
+ | 2 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
69
49
 
70
50
  ## 4. データストア
71
51
 
72
- 全体概要の「データストア」から、引き渡す情報または引き渡し条件の判定に使う行だけを同じ名称・区分で示す。各行は概念データフローの同名ノードと対応する。
52
+ 全体概要から、このケースで参照・更新する正本だけを同じ名称・区分で示す。
73
53
 
74
54
  ### 4.1. マスタ・構成データ
75
55
 
76
- | データストア | 関連引き渡し | 横断上の利用 |
77
- | ----------------- | -------------- | ------------ |
78
- | _DATA_STORE_NAME_ | `_HANDOFF_ID_` | _USAGE_ |
56
+ | データストア | 関連する参加単位 | 横断上の利用 |
57
+ | ------------------- | ----------------------------- | ------------ |
58
+ | _MASTER_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
79
59
 
80
60
  ### 4.2. トランザクションデータ
81
61
 
82
- | データストア | 関連引き渡し | 横断上の利用 |
83
- | ----------------- | -------------- | ------------ |
84
- | _DATA_STORE_NAME_ | `_HANDOFF_ID_` | _USAGE_ |
62
+ | データストア | 関連する参加単位 | 横断上の利用 |
63
+ | ------------------------ | ----------------------------- | ------------ |
64
+ | _TRANSACTION_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
85
65
 
86
- <!-- 該当する行がない区分は節ごと削除する。新しい名称・区分は本書だけへ追加せず、先に全体概要を更新する。 -->
66
+ <!-- 該当する行がない区分は節ごと削除する。図のデータストアと対応させ、新しい名称・区分を本書だけへ追加しない。 -->
87
67
 
88
68
  ## 5. 概念データフロー
89
69
 
90
- _TODO_: 開始イベント、プロセスグループ代表ノード、引き渡し条件、関連データストア、終了条件だけを配置し、正常系の順序を左から右へたどれるようにする。内部領域・内部プロセス・状態名は描かない。
91
-
92
- ```mermaid
93
- flowchart LR
94
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
95
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
96
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
97
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
98
-
99
- _START_EVENT_NODE_ID_{{"_START_EVENT_"}}
100
- _SOURCE_GROUP_NODE_ID_("_SOURCE_GROUP_NAME_<br>_SOURCE_AREA_ID_RANGE_")
101
- _HANDOFF_EVENT_NODE_ID_{{"_HANDOFF_ID_ _HANDOFF_CONDITION_"}}
102
- _TARGET_GROUP_NODE_ID_("_TARGET_GROUP_NAME_<br>_TARGET_AREA_ID_RANGE_")
103
- _END_EVENT_NODE_ID_{{"_END_CONDITION_"}}
104
- _MASTER_STORE_NODE_ID_[("_MASTER_STORE_NAME_")]
105
- _TRANSACTION_STORE_NODE_ID_[("_TRANSACTION_STORE_NAME_")]
106
-
107
- _START_EVENT_NODE_ID_ -->|"起動条件"| _SOURCE_GROUP_NODE_ID_
108
- _MASTER_STORE_NODE_ID_ -->|"_CONDITION_INFORMATION_"| _SOURCE_GROUP_NODE_ID_
109
- _SOURCE_GROUP_NODE_ID_ -->|"_HANDOFF_ID_ _HANDOFF_INFORMATION_"| _HANDOFF_EVENT_NODE_ID_
110
- _HANDOFF_EVENT_NODE_ID_ -->|"起動条件"| _TARGET_GROUP_NODE_ID_
111
- _TARGET_GROUP_NODE_ID_ -->|"_RESULT_INFORMATION_"| _TRANSACTION_STORE_NODE_ID_
112
- _TARGET_GROUP_NODE_ID_ -->|"完了条件"| _END_EVENT_NODE_ID_
113
-
114
- class _SOURCE_GROUP_NODE_ID_,_TARGET_GROUP_NODE_ID_ process
115
- class _START_EVENT_NODE_ID_,_HANDOFF_EVENT_NODE_ID_,_END_EVENT_NODE_ID_ event
116
- class _MASTER_STORE_NODE_ID_ storeMaster
117
- class _TRANSACTION_STORE_NODE_ID_ storeTransaction
70
+ ### 5.1. _BUSINESS_FLOW_TITLE_
71
+
72
+ _TODO_: 図から読み取れる流れや関係を 1 文で書く。題は「起票から完了記録まで」のような業務の言葉にする。
73
+
74
+ <!-- 開始から終了まで上から下へ配置する。イベントは一ノード一出来事の短い文にし、長ければ原文を保って改行する。系統の入口は全体概要の表と同じ文言にし、複数の出来事は分ける。引き渡し条件のイベント・引き渡し ID・Orchestrator は置かない。以下は D2 の例。実際の記法・色は全体概要の凡例に合わせる。 -->
75
+
76
+ ```d2
77
+ direction: down
78
+
79
+ classes: {
80
+ process: {
81
+ shape: rectangle
82
+ style: {
83
+ border-radius: 8
84
+ fill: "#e3f2fd"
85
+ stroke: "#1e88e5"
86
+ font-color: "#000000"
87
+ }
88
+ }
89
+ event: {
90
+ shape: hexagon
91
+ style: {
92
+ fill: "#fff3e0"
93
+ stroke: "#fb8c00"
94
+ font-color: "#000000"
95
+ }
96
+ }
97
+ store_master: {
98
+ shape: cylinder
99
+ style: {
100
+ fill: "#e8f5e9"
101
+ stroke: "#43a047"
102
+ font-color: "#000000"
103
+ }
104
+ }
105
+ store_transaction: {
106
+ shape: cylinder
107
+ style: {
108
+ fill: "#c8e6c9"
109
+ stroke: "#2e7d32"
110
+ font-color: "#000000"
111
+ }
112
+ }
113
+ physical_store: {
114
+ shape: rectangle
115
+ style: {
116
+ border-radius: 20
117
+ fill: "#c8e6c9"
118
+ stroke: "#2e7d32"
119
+ font-color: "#000000"
120
+ }
121
+ }
122
+ material_flow: {
123
+ style: {
124
+ stroke-width: 3
125
+ }
126
+ }
127
+ }
128
+
129
+ start: "_START_EVENT_" { class: event }
130
+ source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
131
+ target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
132
+ end: "_END_EVENT_" { class: event }
133
+ master_store: "_MASTER_STORE_NAME_" { class: store_master }
134
+ transaction_store: "_TRANSACTION_STORE_NAME_" { class: store_transaction }
135
+
136
+ start -> source: "起動条件"
137
+ master_store -> source: "_REFERENCE_INFORMATION_"
138
+ source -> target: "_TRANSFER_INFORMATION_"
139
+ target -> transaction_store: "_RESULT_INFORMATION_"
140
+ target -> end: "_COMPLETION_INFORMATION_"
118
141
  ```
119
142
 
120
- _TODO_: 全体概要の「凡例(本プロダクト共通)」への参照、`-->` / `==>` のうち使用した線種、グループ内部を省略したこと、図に置いたデータストアと選定理由を書く。
143
+ _TODO_: 全体概要の「凡例(本プロダクト共通)」を参照する短い注記と、使用線種・省略事項・図を分ける場合の共有ノードを書く。
144
+
145
+ <!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class を使う。不要なノード・線・classes は削除する。読みづらい場合は連続する業務の範囲で分割し、同じ名称・領域 ID のノードで接続を追えるようにする。引き渡し ID は作らない。 -->
121
146
 
122
- <!-- 物を引き渡す場合は ==> を使用する。関連データストアがない場合は該当ノード、エッジ、class を削除する。グループや引き渡しが多く一図で追えない場合は 5.1、5.2 の連続する引き渡し単位へ分け、接続点に同じ引き渡し ID を置く。 -->
147
+ <!-- 業務上重要な戻りがある場合だけ以下の節を使い、不要なら節ごと削除する。「引き渡し」「例外時の戻り先」の章や条件表は設けない。 -->
123
148
 
124
- ## 6. 引き渡し
149
+ ### 5.2. 例外時の戻り
125
150
 
126
- | 引き渡し ID | 送り元グループ | 受け側グループ | 引き渡す情報 | 引き渡し条件 | 戻す条件 |
127
- | -------------- | -------------------- | -------------------- | --------------------- | ------------------- | ------------------ |
128
- | `_HANDOFF_ID_` | _PROCESS_GROUP_NAME_ | _PROCESS_GROUP_NAME_ | _HANDOFF_INFORMATION_ | _HANDOFF_CONDITION_ | _RETURN_CONDITION_ |
151
+ _TODO_: 不足や不一致をどこへ返すか、図から読み取れることを 1 文で書く。
129
152
 
130
- <!-- 引き渡し ID は正常順序に沿った H-01 形式にする。隣接する全グループ間の引き渡しを一行ずつ追加し、情報、引き渡し条件、戻す条件を空欄にしない。 -->
153
+ ```d2
154
+ direction: down
131
155
 
132
- ## 7. 例外時の戻り先
156
+ classes: {
157
+ process: {
158
+ shape: rectangle
159
+ style: {
160
+ border-radius: 8
161
+ fill: "#e3f2fd"
162
+ stroke: "#1e88e5"
163
+ font-color: "#000000"
164
+ }
165
+ }
166
+ }
133
167
 
134
- | 対象引き渡し | 条件不成立 | 戻り先グループ | 戻す情報 | 再開条件 |
135
- | -------------- | ------------------ | -------------------- | -------------------- | ------------------ |
136
- | `_HANDOFF_ID_` | _FAILED_CONDITION_ | _PROCESS_GROUP_NAME_ | _RETURN_INFORMATION_ | _RESUME_CONDITION_ |
168
+ source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
169
+ target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
170
+
171
+ source <- target: "_RETURN_INFORMATION_"
172
+ source -> target: "_CORRECTED_INFORMATION_"
173
+ ```
137
174
 
138
- <!-- 「引き渡し」の全 ID について戻す条件を確認する。戻り先はグループまでに留め、内部プロセス、内部例外、ログ、再試行手順を書かない。 -->
175
+ _TODO_: 全体概要の凡例を参照し、通常の図と共有する参加単位、省略事項、戻りが業務上重要な理由を短く注記する。
139
176
 
140
- <!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。
177
+ <!-- 戻りは補完・再判断を担う参加単位へ向け、返す情報と再提示する情報を名詞の線のラベルにする。条件イベントや内部の再試行手順は置かない。 -->
141
178
 
142
- ## 8. 未決事項
179
+ <!-- 未決事項がある場合だけ以下の章を使い、ない場合は章ごと削除する。 -->
143
180
 
144
- | 論点 | 影響するケース・引き渡し | 決定者 | 決定時期 |
145
- | ------------------- | ------------------------ | --------------- | ----------------- |
146
- | _UNDECIDED_: _TODO_ | `_CASE_ID_` / `_HANDOFF_ID_` | _DECISION_ROLE_ | _DECISION_TIMING_ |
181
+ ## 6. 未決事項
147
182
 
148
- -->
183
+ | 論点 | 影響するケース・参加単位 | 決定者 | 決定時期 |
184
+ | ------------------- | ------------------------------------------- | --------------- | ----------------- |
185
+ | _UNDECIDED_: _TODO_ | `_CASE_ID_` / _PARTICIPANT_NAME_OR_AREA_ID_ | _DECISION_ROLE_ | _DECISION_TIMING_ |
@@ -27,7 +27,13 @@ specdojo:
27
27
  | 申請日 | _TODO_ |
28
28
  | 変更理由 | _TODO_ |
29
29
 
30
- ## 2. 影響評価
30
+ ## 2. 入力
31
+
32
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
33
+
34
+ -
35
+
36
+ ## 3. 影響評価
31
37
 
32
38
  | 観点 | 影響 |
33
39
  | ------------ | ------ |
@@ -37,7 +43,7 @@ specdojo:
37
43
  | 品質 | _TODO_ |
38
44
  | 運用 | _TODO_ |
39
45
 
40
- ## 3. 審査・決定
46
+ ## 4. 審査・決定
41
47
 
42
48
  | 項目 | 内容 |
43
49
  | -------- | --------------------------------- |
@@ -46,7 +52,7 @@ specdojo:
46
52
  | 決定日 | _TODO_ |
47
53
  | 実施条件 | _TODO_ |
48
54
 
49
- ## 4. 実施追跡
55
+ ## 5. 実施追跡
50
56
 
51
57
  | 項目 | 内容 |
52
58
  | -------- | ------ |
@@ -55,6 +61,6 @@ specdojo:
55
61
  | 完了条件 | _TODO_ |
56
62
  | 対応結果 | _TODO_ |
57
63
 
58
- ## 5. 関連ドキュメント
64
+ ## 6. 関連ドキュメント
59
65
 
60
66
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。