specdojo 0.2.1 → 0.3.1

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 (242) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +298 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/catalog-build-references.js +144 -0
  8. package/dist/catalog-build-render.js +144 -0
  9. package/dist/catalog-build.js +13 -290
  10. package/dist/catalog-generate.js +6 -9
  11. package/dist/catalog-plan-generate.js +2 -2
  12. package/dist/catalog-plan.js +6 -6
  13. package/dist/catalog-scaffold.js +4 -4
  14. package/dist/catalog.js +2 -2
  15. package/dist/dashboard-exec-records.js +105 -0
  16. package/dist/dashboard-routines.js +255 -0
  17. package/dist/dashboard-shared.js +14 -0
  18. package/dist/dashboard-timeline.js +175 -0
  19. package/dist/dashboard.js +31 -444
  20. package/dist/deliverable-trash.js +3 -3
  21. package/dist/devcontainer-command.js +43 -0
  22. package/dist/devcontainer-scaffold.js +165 -0
  23. package/dist/doc-index.js +3 -3
  24. package/dist/exec-agent-config.js +107 -9
  25. package/dist/exec-agent-git-state.js +18 -0
  26. package/dist/exec-agent-protected-config.js +46 -8
  27. package/dist/exec-commands.js +557 -0
  28. package/dist/exec-core.js +457 -0
  29. package/dist/exec-evidence.js +254 -11
  30. package/dist/exec-handoff.js +336 -0
  31. package/dist/exec-parent-validation.js +317 -43
  32. package/dist/exec-pipeline-state.js +74 -9
  33. package/dist/exec-plans-core.js +693 -0
  34. package/dist/exec-plans-generation.js +206 -0
  35. package/dist/exec-plans-storage.js +131 -0
  36. package/dist/exec-plans.js +3 -1016
  37. package/dist/exec-protection-handoff.js +43 -2
  38. package/dist/exec-provider-scaffold.js +247 -15
  39. package/dist/exec-register-resume.js +65 -19
  40. package/dist/exec-register.js +9 -3
  41. package/dist/exec-repo-integration-git.js +23 -0
  42. package/dist/exec-repo-integration-sync.js +264 -0
  43. package/dist/exec-repo-integration.js +534 -0
  44. package/dist/exec-repo-trace.js +182 -0
  45. package/dist/exec-reporter-output.js +206 -0
  46. package/dist/exec-reporter.js +525 -248
  47. package/dist/exec-results.js +103 -71
  48. package/dist/exec-run-agent-pipeline.js +256 -0
  49. package/dist/exec-run-agent.js +531 -0
  50. package/dist/exec-run-in-place.js +541 -0
  51. package/dist/exec-run-job.js +717 -0
  52. package/dist/exec-run-lifecycle-commands.js +522 -0
  53. package/dist/exec-run-lock.js +110 -107
  54. package/dist/exec-run-mode-shared.js +140 -0
  55. package/dist/exec-run-register-command.js +244 -0
  56. package/dist/exec-run-register-core.js +386 -0
  57. package/dist/exec-run-register-mode.js +206 -0
  58. package/dist/exec-run-register-resume.js +393 -0
  59. package/dist/exec-run-register-state.js +322 -0
  60. package/dist/exec-run-register-worktree.js +509 -0
  61. package/dist/exec-run-schedule-mode.js +294 -0
  62. package/dist/exec-run-schedule-prepare.js +353 -0
  63. package/dist/exec-run-schedule-task.js +572 -0
  64. package/dist/exec-run-shared.js +399 -0
  65. package/dist/exec-run.js +11 -4953
  66. package/dist/exec-shared.js +9 -2
  67. package/dist/exec-slot-lock.js +242 -0
  68. package/dist/exec-task-repos.js +415 -0
  69. package/dist/exec-trial-commands.js +558 -0
  70. package/dist/exec-trial-core.js +371 -0
  71. package/dist/exec-trial.js +2 -895
  72. package/dist/exec-worktree-command.js +87 -43
  73. package/dist/exec-worktree-ops-commit.js +707 -0
  74. package/dist/exec-worktree-ops-lifecycle.js +292 -0
  75. package/dist/exec-worktree-ops-merge.js +303 -0
  76. package/dist/exec-worktree-ops.js +3 -847
  77. package/dist/exec-worktree.js +146 -31
  78. package/dist/exec.js +2 -999
  79. package/dist/frontmatter-namespace.js +2 -2
  80. package/dist/grade-apply.js +734 -0
  81. package/dist/grade-command-apply.js +250 -0
  82. package/dist/grade-command-inspect.js +138 -0
  83. package/dist/grade-command-plan.js +101 -0
  84. package/dist/grade-command-shared.js +68 -0
  85. package/dist/grade-core.js +307 -0
  86. package/dist/grade-markdown.js +274 -0
  87. package/dist/grade-pipeline-state.js +184 -0
  88. package/dist/grade-plan.js +507 -0
  89. package/dist/grade-result.js +133 -5
  90. package/dist/grade-target-discovery.js +265 -0
  91. package/dist/grade-targets.js +432 -0
  92. package/dist/grade.js +14 -2451
  93. package/dist/init-command.js +443 -0
  94. package/dist/job-definition.js +670 -0
  95. package/dist/job.js +64 -578
  96. package/dist/kata-command.js +2 -2
  97. package/dist/orchestrator.js +213 -0
  98. package/dist/register-command-types.js +1 -0
  99. package/dist/register-core.js +363 -0
  100. package/dist/register-create-commands.js +245 -0
  101. package/dist/register-event-merge.js +169 -0
  102. package/dist/register-events.js +4 -4
  103. package/dist/register-item.js +13 -7
  104. package/dist/register-maintenance-commands.js +187 -0
  105. package/dist/register-migration.js +268 -0
  106. package/dist/register-renumber.js +314 -0
  107. package/dist/register-transition-commands.js +248 -0
  108. package/dist/register-update.js +230 -0
  109. package/dist/register-views.js +256 -0
  110. package/dist/register.js +175 -1975
  111. package/dist/review-grade.js +252 -0
  112. package/dist/review-plan.js +114 -4
  113. package/dist/review-types.js +40 -1
  114. package/dist/routine-definition.js +401 -0
  115. package/dist/routine.js +73 -402
  116. package/dist/schedule-approach.js +2 -2
  117. package/dist/schedule-build.js +2 -2
  118. package/dist/schedule-strategy-generate-document.js +273 -0
  119. package/dist/schedule-strategy-generate-scope.js +199 -0
  120. package/dist/schedule-strategy-generate.js +9 -473
  121. package/dist/schedule.js +19 -6
  122. package/dist/specdojo-config.js +465 -20
  123. package/dist/specdojo-gitignore.js +135 -0
  124. package/dist/specdojo.js +6 -0
  125. package/dist/viewpoint-document-kinds-check.js +128 -0
  126. package/dist/yaml-pages.js +4 -4
  127. package/dist/yaml.js +28 -0
  128. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  129. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  130. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  131. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  132. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  133. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  134. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  135. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  136. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  137. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  138. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  139. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  140. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  141. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  142. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  143. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  144. package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
  145. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  146. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  147. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  148. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
  149. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  150. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  151. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  152. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  153. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  154. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  155. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  156. package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
  157. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  158. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  159. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  160. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  161. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  162. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  163. package/docs/ja/specdojo/index.md +2 -2
  164. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  165. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  166. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  167. package/docs/ja/specdojo/references/command-reference.md +335 -92
  168. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  169. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  170. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  171. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  172. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  173. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  174. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  175. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  176. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  177. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  178. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  179. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  180. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  181. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  182. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  183. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  184. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  185. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  186. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  187. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  188. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  189. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  190. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  191. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  192. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  193. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  195. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  196. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  197. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  198. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  199. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  200. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  201. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  202. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  203. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  204. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  205. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  206. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  207. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  208. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  209. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  210. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  211. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  212. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  213. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  214. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  215. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  216. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  217. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  218. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  219. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  220. package/package.json +17 -12
  221. package/templates/antigravity/README.md +29 -4
  222. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  223. package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
  224. package/templates/antigravity/orchestrator.md +18 -7
  225. package/templates/antigravity/settings.global.json +55 -0
  226. package/templates/claude/agents/claude-executor.md +14 -0
  227. package/templates/claude/agents/claude-reporter.md +16 -0
  228. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  229. package/templates/claude/settings.edit.json +27 -1
  230. package/templates/codex/README.md +5 -4
  231. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  232. package/templates/codex/orchestrator.md +18 -7
  233. package/templates/copilot/README.md +7 -5
  234. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  235. package/templates/devcontainer/devcontainer.json +27 -0
  236. package/templates/devcontainer/emacs/init.el +88 -0
  237. package/templates/devcontainer/post-create.sh +62 -0
  238. package/templates/init-agent-members.yaml +200 -0
  239. package/templates/init-exec-defaults.yaml +74 -0
  240. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  241. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  242. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -154,53 +154,92 @@ severity_levels:
154
154
  - id: note
155
155
  description: 改善提案、将来検討、補足コメント。
156
156
 
157
+ # review がタスクの完了可否を表す唯一の語彙。review result の verdict と同じ値を使い、
158
+ # bps-task-completion の検証・受入観点 6 区分と一対一に対応する(PJR-XTAN)。
159
+ # 旧値の pass / conditional_pass / changes_requested / blocked と、xrr-template.md の旧
160
+ # decision.recommendation(approve / revise / reject)は読み込み時に移行先を示して拒否する。
161
+ # revise は incomplete へ移す。grade の文書 verdict(pass / needs-work / fail)は成果物の品質を
162
+ # 判定する別の語彙であり、ここへは統一しない。
157
163
  verdict_definitions:
158
- - id: pass
159
- description: 対象 Role code の観点では修正不要。次の Role code または PO 判断へ進める。
160
- - id: conditional_pass
161
- description: 軽微な修正または PO 判断待ちを条件に進めてよい。条件を明記し、必要に応じて minor 指摘を残す。
162
- - id: changes_requested
163
- description: 修正後の再レビューが必要。修正担当 Role code と再レビュー観点を明記する。
164
- - id: blocked
165
- description: 前提不足、依存成果物未整備、重大矛盾によりレビュー継続不可。PJR 登録または PO 判断を依頼する。
164
+ - id: complete
165
+ description: 最新の grade・finding があり、変更内容が plan と完了条件を満たし、完了を妨げる未充足事項がない。完了の決定と完了記録へ進める。
166
+ - id: complete-with-findings
167
+ description: 最新の評価結果に finding があるが、今回のタスク範囲と完了条件は満たしている。finding が完了を妨げない理由と、必要な改善指示を記録して完了へ進める。
168
+ - id: incomplete
169
+ description: plan または完了条件に未充足事項がある。完了記録を作らず、未充足事項と改善指示を含む再計画要求を引き渡す。
170
+ - id: grade-stale
171
+ description: 評価結果がない、現在の成果物と content_hash が一致しない、または評価コンテキストの変化が未反映である。review は再評価せず、grade の確定後に再開する。
172
+ - id: grade-unavailable
173
+ description: 成果物評価が評価不能で grade・finding を確定できない。完了を推測せず保留し、評価不能の理由・不足情報・補完担当・再開条件を記録する。
174
+ - id: changed-during-review
175
+ description: review 開始後に成果物が変更され、固定した評価結果の content_hash と一致しなくなった。verdict と完了記録を確定せず、変更後の grade の確定を待って再開する。
166
176
 
167
- # grade と review が共有する離散ルーブリック。review の blocked は判定不能を表すため
168
- # level へ写像せず、根拠が揃った判定だけを pass / conditional_pass / changes_requested へ対応させる。
177
+ # grade と review が共有する離散ルーブリック。review_verdict は grade の level を review の入力に
178
+ # する規則であり、review が完了可否の判断を始める起点の verdict を示す(review-guide.md の
179
+ # 「grade の結果を review の入力にする規則」)。grade の level からは品質しか分からないため、写像先は
180
+ # complete / complete-with-findings / incomplete の 3 値に限る。鮮度・評価不能・review 中の変更は
181
+ # level から決まらないため写像しない。
182
+ # v2 で全観点を grade の対象にし、weights を 9 category へ広げた(PJR-K351)。
183
+ # v1 の score とは母集団の category が異なるため比較できない。id を改めて区別する。
184
+ # pass_score は level 3(軽微な課題・実務上そのまま利用できる)の score 75 に合わせる。
185
+ # major がない限り各観点の level は 3 以上であるため、75 は「全 category が level 3 以上」の
186
+ # 下限と一致し、category の数や重みを変えても意味が変わらない。v1 の 70 は category 数に
187
+ # 依存しない根拠を持たなかったため改める。
169
188
  grade_rubric:
170
- id: grade-rubric-v1
171
- pass_score: 70
189
+ id: grade-rubric-v2
190
+ pass_score: 75
172
191
  levels:
173
192
  - level: 0
174
193
  name: 不成立
175
194
  description: blocker があり、その観点で文書が機能していない。
176
- review_verdict: changes_requested
195
+ review_verdict: incomplete
177
196
  - level: 1
178
197
  name: 不十分
179
198
  description: major が複数、または観点の目的をほぼ果たしていない。
180
- review_verdict: changes_requested
199
+ review_verdict: incomplete
181
200
  - level: 2
182
201
  name: 要改善
183
202
  description: major があり、誤用・誤読を招く箇所がある。
184
- review_verdict: changes_requested
203
+ review_verdict: incomplete
185
204
  - level: 3
186
205
  name: 軽微な課題
187
206
  description: minor のみで、実務上はそのまま利用できる。
188
- review_verdict: conditional_pass
207
+ review_verdict: complete-with-findings
189
208
  - level: 4
190
209
  name: 良好
191
210
  description: 指摘なし、または note のみである。
192
- review_verdict: pass
211
+ review_verdict: complete
212
+ # 重みは合計 100。文書に適用される観点がない category は、その文書の加重平均から外す。
213
+ # v1 の 4 category の相対比を保ったまま縮め、空いた分を新たに加わる 5 category へ配る。
193
214
  weights:
215
+ # kata(rulebook / template など実践の型)は、成果物を作る土台としての構造・検証可能性・
216
+ # 使いやすさが主である。v1 の 4 category を 70 に縮め、残り 30 を配る。型が何のために
217
+ # あるか(purpose)と、型どおりに作れるか(implementation)を厚くし、運用上の責任分界
218
+ # (operations)を続ける。計画(planning)と業務価値(business)は個別の成果物で
219
+ # 問われるため最も薄くする。
194
220
  kata:
195
- architecture: 20
196
- consistency: 20
197
- quality: 35
198
- usability: 25
221
+ quality: 25
222
+ usability: 18
223
+ architecture: 14
224
+ consistency: 13
225
+ purpose: 8
226
+ implementation: 6
227
+ operations: 6
228
+ planning: 5
229
+ business: 5
230
+ # 成果物は、目的・業務価値・実装可能性がプロジェクト固有に問われる。v1 の 4 category を
231
+ # 65 に縮め、kata より多い 35 を配る。目的(purpose)と業務価値(business)を最も厚く
232
+ # し、実装可能性(implementation)、計画(planning)、公開・運用(operations)の順に置く。
199
233
  deliverable:
200
- architecture: 20
201
- consistency: 25
202
- quality: 30
203
- usability: 25
234
+ quality: 20
235
+ consistency: 16
236
+ usability: 16
237
+ architecture: 13
238
+ purpose: 8
239
+ business: 8
240
+ implementation: 7
241
+ planning: 6
242
+ operations: 6
204
243
 
205
244
  viewpoints:
206
245
  - id: vp-po-purpose-alignment
@@ -218,8 +257,7 @@ viewpoints:
218
257
  - scope_boundary
219
258
  - traceability
220
259
  default_severity: major
221
- evaluation: human
222
- continuous: false
260
+ evaluation: referential
223
261
  - id: vp-po-decision-readiness
224
262
  role: PO
225
263
  category: purpose
@@ -231,8 +269,7 @@ viewpoints:
231
269
  - permission
232
270
  - auditability
233
271
  default_severity: major
234
- evaluation: human
235
- continuous: false
272
+ evaluation: discretionary
236
273
  - id: vp-po-publication-accountability
237
274
  role: PO
238
275
  category: operations
@@ -244,8 +281,7 @@ viewpoints:
244
281
  - operations
245
282
  - auditability
246
283
  default_severity: blocker
247
- evaluation: human
248
- continuous: false
284
+ evaluation: referential
249
285
  - id: vp-pm-plan-feasibility
250
286
  role: PM
251
287
  category: planning
@@ -253,8 +289,7 @@ viewpoints:
253
289
  check: 成果物の内容がタスク化、順序付け、所要時間見積もり、進捗確認に使える粒度になっているか。
254
290
  evidence: 依存関係、作業単位、完了条件、担当 Role code、期限または判断タイミング。
255
291
  default_severity: major
256
- evaluation: human
257
- continuous: false
292
+ evaluation: discretionary
258
293
  - id: vp-pm-dependency-risk
259
294
  role: PM
260
295
  category: planning
@@ -262,8 +297,7 @@ viewpoints:
262
297
  check: 後続成果物、Schedule、PJR に影響する依存、リスク、課題、変更要求が識別されているか。
263
298
  evidence: depends_on、関連文書、未決事項、PJR 登録候補、スケジュール影響。
264
299
  default_severity: major
265
- evaluation: human
266
- continuous: false
300
+ evaluation: referential
267
301
  - id: vp-pm-control-reporting
268
302
  role: PM
269
303
  category: planning
@@ -271,13 +305,12 @@ viewpoints:
271
305
  check: 進捗、課題、リスク、変更要求、決定記録へ転記すべき事項が分離されているか。
272
306
  evidence: PJR 転記候補、報告先、対応方針、担当 Role code。
273
307
  default_severity: minor
274
- evaluation: human
275
- continuous: false
308
+ evaluation: referential
276
309
  - id: vp-ba-business-value
277
310
  role: BA
278
311
  category: business
279
312
  title: 業務価値との対応
280
- check: 業務価値を定義・展開する成果物で、主要な定義・判断がどの対象者のどの業務課題・期待価値に応えるかを説明でき、主要な成果・方針がその目的に対応しているか。構造・設定中心の成果物では、上位目的への参照と下流利用の整合を確認し、業務上の Why の詳細な再掲を要求しない。
313
+ check: 主要な定義・判断がどの対象者のどの業務課題・期待価値に応えるかを説明でき、主要な成果・方針がその目的に対応しているか。
281
314
  evidence: 対象者、業務課題、放置時の影響、期待価値・効果、成功基準、判断理由、主要な成果・方針との対応、上位文書への参照。
282
315
  # 業務上の Why の充足と主要な What / How との対応を確認し、対象者・課題・期待価値の不足、
283
316
  # 上位目的との矛盾、対応先のない成果・方針を finding として説明できる範囲に絞る。
@@ -287,8 +320,120 @@ viewpoints:
287
320
  - business_goal
288
321
  - traceability
289
322
  default_severity: major
290
- evaluation: human
291
- continuous: false
323
+ evaluation: discretionary
324
+ document_kinds:
325
+ exclude:
326
+ - specdojo:bdd-rulebook
327
+ - specdojo:dct-index-rulebook
328
+ - specdojo:dct-rulebook
329
+ - specdojo:gl-rulebook
330
+ - specdojo:ifx-api-rulebook
331
+ - specdojo:ifx-cmd-rulebook
332
+ - specdojo:ifx-index-rulebook
333
+ - specdojo:ifx-msg-rulebook
334
+ - specdojo:pm-members-rulebook
335
+ - specdojo:pm-roles-rulebook
336
+ - specdojo:sch-rulebook
337
+ - specdojo:tml-rulebook
338
+ unclassified: include
339
+ # 既定(適用する)のままと判断した rulebook。判断漏れの検証(PJR-VJP8)用の記録で、
340
+ # 適用判定には影響しない。rulebook を追加したら exclude かここのどちらかへ載せる。
341
+ confirmed_default:
342
+ - specdojo:atc-index-rulebook
343
+ - specdojo:atc-rulebook
344
+ - specdojo:bac-rulebook
345
+ - specdojo:bds-rulebook
346
+ - specdojo:bes-index-rulebook
347
+ - specdojo:bes-rulebook
348
+ - specdojo:bps-rulebook
349
+ - specdojo:br-rulebook
350
+ - specdojo:ccd-mermaid-rulebook
351
+ - specdojo:cdfd-mermaid-rulebook
352
+ - specdojo:cdfd-overview-rulebook
353
+ - specdojo:cdfd-rulebook
354
+ - specdojo:cdfd-uc-rulebook
355
+ - specdojo:cdsd-rulebook
356
+ - specdojo:cld-rulebook
357
+ - specdojo:cnd-mermaid-rulebook
358
+ - specdojo:cnd-rulebook
359
+ - specdojo:cop-index-rulebook
360
+ - specdojo:cop-rulebook
361
+ - specdojo:cpd-mermaid-rulebook
362
+ - specdojo:cpd-rulebook
363
+ - specdojo:cstd-rulebook
364
+ - specdojo:cxd-mermaid-rulebook
365
+ - specdojo:cxd-rulebook
366
+ - specdojo:dec-rulebook
367
+ - specdojo:dmd-index-rulebook
368
+ - specdojo:dmd-rulebook
369
+ - specdojo:etc-index-rulebook
370
+ - specdojo:etc-rulebook
371
+ - specdojo:ifd-mermaid-rulebook
372
+ - specdojo:ifx-file-rulebook
373
+ - specdojo:imp-business-rulebook
374
+ - specdojo:imp-data-rulebook
375
+ - specdojo:imp-interface-rulebook
376
+ - specdojo:imp-operations-rulebook
377
+ - specdojo:imp-test-rulebook
378
+ - specdojo:itc-index-rulebook
379
+ - specdojo:itc-rulebook
380
+ - specdojo:mip-index-rulebook
381
+ - specdojo:mm-rulebook
382
+ - specdojo:mtp-rulebook
383
+ - specdojo:nfr-availability-rulebook
384
+ - specdojo:nfr-index-rulebook
385
+ - specdojo:nfr-integrity-rulebook
386
+ - specdojo:nfr-maintainability-rulebook
387
+ - specdojo:nfr-operations-rulebook
388
+ - specdojo:nfr-performance-rulebook
389
+ - specdojo:nfr-reliability-rulebook
390
+ - specdojo:nfr-security-safety-rulebook
391
+ - specdojo:nfr-usability-rulebook
392
+ - specdojo:ntp-rulebook
393
+ - specdojo:opd-index-rulebook
394
+ - specdojo:opd-rulebook
395
+ - specdojo:opr-index-rulebook
396
+ - specdojo:opr-rulebook
397
+ - specdojo:otp-index-rulebook
398
+ - specdojo:otp-rulebook
399
+ - specdojo:pjr-rulebook
400
+ - specdojo:pm-change-request-log-rulebook
401
+ - specdojo:pm-communication-plan-rulebook
402
+ - specdojo:pm-issue-log-rulebook
403
+ - specdojo:pm-organization-rulebook
404
+ - specdojo:pm-plan-rulebook
405
+ - specdojo:pm-quality-management-plan-rulebook
406
+ - specdojo:pm-raci-rulebook
407
+ - specdojo:pm-risk-register-rulebook
408
+ - specdojo:pr-rulebook
409
+ - specdojo:prj-assumptions-constraints-dependencies-rulebook
410
+ - specdojo:prj-charter-rulebook
411
+ - specdojo:prj-comparison-of-alternatives-rulebook
412
+ - specdojo:prj-issues-and-approach-rulebook
413
+ - specdojo:prj-overview-rulebook
414
+ - specdojo:prj-scope-rulebook
415
+ - specdojo:prj-stakeholder-register-rulebook
416
+ - specdojo:prj-success-criteria-and-acceptance-criteria-rulebook
417
+ - specdojo:sac-rulebook
418
+ - specdojo:sf-index-rulebook
419
+ - specdojo:sf-rulebook
420
+ - specdojo:sld-rulebook
421
+ - specdojo:stc-index-rulebook
422
+ - specdojo:stc-rulebook
423
+ - specdojo:stsd-mermaid-rulebook
424
+ - specdojo:stsd-rulebook
425
+ - specdojo:sysd-critical-flows-rulebook
426
+ - specdojo:sysd-cross-cutting-policy-rulebook
427
+ - specdojo:sysd-index-rulebook
428
+ - specdojo:sysd-rulebook
429
+ - specdojo:trc-requirements-to-specs-rulebook
430
+ - specdojo:trc-requirements-to-tests-rulebook
431
+ - specdojo:tsd-index-rulebook
432
+ - specdojo:tsd-rulebook
433
+ - specdojo:tsp-index-rulebook
434
+ - specdojo:uis-rulebook
435
+ - specdojo:utc-index-rulebook
436
+ - specdojo:utc-rulebook
292
437
  - id: vp-ba-requirements-completeness
293
438
  role: BA
294
439
  category: business
@@ -306,8 +451,7 @@ viewpoints:
306
451
  - acceptance
307
452
  - traceability
308
453
  default_severity: major
309
- evaluation: human
310
- continuous: false
454
+ evaluation: discretionary
311
455
  - id: vp-ba-stakeholder-clarity
312
456
  role: BA
313
457
  category: business
@@ -319,8 +463,7 @@ viewpoints:
319
463
  - use_case
320
464
  - permission
321
465
  default_severity: minor
322
- evaluation: human
323
- continuous: false
466
+ evaluation: discretionary
324
467
  - id: vp-arc-document-structure
325
468
  role: ARC
326
469
  category: architecture
@@ -329,20 +472,31 @@ viewpoints:
329
472
  evidence: id、path、rulebook、based_on、見出し、相対リンク、成果物カタログ。
330
473
  default_severity: major
331
474
  evaluation: deterministic
332
- continuous: true
333
475
  - id: vp-arc-cross-document-consistency
334
476
  role: ARC
335
477
  category: consistency
336
478
  title: 成果物間整合
337
- check: 成果物カタログ、Schedule、RACI、組織定義、メンバー定義、生成物と矛盾していないか。
338
- evidence: local_id、depends_on、owner、roles、RACI、関連文書、生成元。
479
+ check: >-
480
+ 成果物について、成果物カタログ、Schedule、RACI、組織定義、メンバー定義、生成物と矛盾していないか。不整合の finding は突き合わせ先の文書 ID またはパスと、双方の相反する記述を特定する。rulebook、recipe、sample、template の内部・相互・適用先との整合は vp-qe-kata-conformance で判定し、この観点では扱わない。
481
+ evidence: >-
482
+ local_id、depends_on、owner、roles、RACI、関連文書、生成元、finding ごとの突き合わせ先の文書 ID またはパスと双方の該当箇所。
339
483
  coverage_types:
340
484
  - permission
341
485
  - traceability
342
486
  - auditability
343
487
  default_severity: major
344
- evaluation: agent
345
- continuous: true
488
+ evaluation: referential
489
+ grade_targets: [deliverable]
490
+ # 突き合わせ先の変更を grade list --changed-only の再評価契機にする(PJR-Z47X)。
491
+ # 生成物は生成元(カタログ・メンバー定義など)の変更として検出する。
492
+ comparison_sources:
493
+ - catalog-entry
494
+ - dependencies
495
+ - schedule
496
+ - members
497
+ - roles
498
+ - deliverable:pm-raci
499
+ - deliverable:pm-organization
346
500
  - id: vp-arc-technical-constraints
347
501
  role: ARC
348
502
  category: architecture
@@ -355,28 +509,139 @@ viewpoints:
355
509
  - integration
356
510
  - non_functional
357
511
  default_severity: major
358
- evaluation: human
359
- continuous: false
512
+ evaluation: discretionary
360
513
  - id: vp-arc-conciseness
361
514
  role: ARC
362
515
  category: usability
363
516
  title: 冗長性・簡潔性
364
- check: 各節が固有の判断または手順に寄与し、同じ主張の反復、一般論、正本の過剰な再掲がなく、必要な背景・制約・例外を保った必要十分な記述か。
517
+ check: >-
518
+ 各節が固有の判断または手順に寄与し、同じ主張の反復、一般論、表と本文の内容重複、正本からの過剰な再掲がないか。判断に必要な背景、制約、例外、done_criteria が残されていれば下限を満たしているとする。長さだけでは fail にせず、削除または統合しても判断情報を失わない箇所を具体的に特定できる場合のみ minor とする。
365
519
  evidence: 反復する段落、表と本文の重複、正本への参照で置換できる再掲、削除または統合しても判断情報を失わない箇所。
366
520
  default_severity: minor
367
- evaluation: agent
368
- continuous: true
521
+ evaluation: referential
369
522
  - id: vp-arc-single-responsibility
370
523
  role: ARC
371
524
  category: architecture
372
525
  title: 文書責務の単一性
373
526
  check: >-
374
- 文書の中心主題と責務境界が一つに定まり、各章がその責務に直接寄与しているか。独立して参照・更新できる主題が複数あり、対象読者・利用時点が異なる、または別々の sample・recipe・template に対応する場合は分割を検討する。分量や対応する実践の型の数だけでは不備とせず、複数主題の案内自体を責務とする index・catalog・overview は分割対象から除外する。同一主張の反復や正本の過剰な再掲は vp-arc-conciseness で判定し、この観点では扱わない。
527
+ 文書の中心主題と責務境界が一つに定まり、各章がその責務に直接寄与しているか。独立して参照・更新できる主題が複数あり、対象読者・利用時点が異なる、または別々の sample・recipe・template に対応する場合は分割を検討する。分量や対応する実践の型の数だけでは不備としない。同一主張の反復や正本の過剰な再掲は vp-arc-conciseness で判定し、この観点では扱わない。
375
528
  evidence: >-
376
- 文書の目的、章ごとの主題と相互依存、章が参照・更新される単位、対象読者、利用時点、対応する sample・recipe・template、index・catalog・overview としての集約責務、分割後も独立して成立する境界候補。分割が必要な finding には境界候補と参照・カタログへの影響を記録する。
529
+ 文書の目的、章ごとの主題と相互依存、章が参照・更新される単位、対象読者、利用時点、対応する sample・recipe・template、分割後も独立して成立する境界候補。分割が必要な finding には境界候補と参照・カタログへの影響を記録する。
377
530
  default_severity: major
378
- evaluation: agent
379
- continuous: true
531
+ evaluation: referential
532
+ document_kinds:
533
+ exclude:
534
+ - specdojo:atc-index-rulebook
535
+ - specdojo:bes-index-rulebook
536
+ - specdojo:cdfd-overview-rulebook
537
+ - specdojo:cop-index-rulebook
538
+ - specdojo:dct-index-rulebook
539
+ - specdojo:dmd-index-rulebook
540
+ - specdojo:etc-index-rulebook
541
+ - specdojo:ifx-index-rulebook
542
+ - specdojo:itc-index-rulebook
543
+ - specdojo:mip-index-rulebook
544
+ - specdojo:nfr-index-rulebook
545
+ - specdojo:opd-index-rulebook
546
+ - specdojo:opr-index-rulebook
547
+ - specdojo:otp-index-rulebook
548
+ - specdojo:prj-overview-rulebook
549
+ - specdojo:sf-index-rulebook
550
+ - specdojo:stc-index-rulebook
551
+ - specdojo:sysd-index-rulebook
552
+ - specdojo:tsd-index-rulebook
553
+ - specdojo:tsp-index-rulebook
554
+ - specdojo:utc-index-rulebook
555
+ unclassified: include
556
+ # 既定(適用する)のままと判断した rulebook。判断漏れの検証(PJR-VJP8)用の記録で、
557
+ # 適用判定には影響しない。rulebook を追加したら exclude かここのどちらかへ載せる。
558
+ confirmed_default:
559
+ - specdojo:atc-rulebook
560
+ - specdojo:bac-rulebook
561
+ - specdojo:bdd-rulebook
562
+ - specdojo:bds-rulebook
563
+ - specdojo:bes-rulebook
564
+ - specdojo:bps-rulebook
565
+ - specdojo:br-rulebook
566
+ - specdojo:ccd-mermaid-rulebook
567
+ - specdojo:cdfd-mermaid-rulebook
568
+ - specdojo:cdfd-rulebook
569
+ - specdojo:cdfd-uc-rulebook
570
+ - specdojo:cdsd-rulebook
571
+ - specdojo:cld-rulebook
572
+ - specdojo:cnd-mermaid-rulebook
573
+ - specdojo:cnd-rulebook
574
+ - specdojo:cop-rulebook
575
+ - specdojo:cpd-mermaid-rulebook
576
+ - specdojo:cpd-rulebook
577
+ - specdojo:cstd-rulebook
578
+ - specdojo:cxd-mermaid-rulebook
579
+ - specdojo:cxd-rulebook
580
+ - specdojo:dct-rulebook
581
+ - specdojo:dec-rulebook
582
+ - specdojo:dmd-rulebook
583
+ - specdojo:etc-rulebook
584
+ - specdojo:gl-rulebook
585
+ - specdojo:ifd-mermaid-rulebook
586
+ - specdojo:ifx-api-rulebook
587
+ - specdojo:ifx-cmd-rulebook
588
+ - specdojo:ifx-file-rulebook
589
+ - specdojo:ifx-msg-rulebook
590
+ - specdojo:imp-business-rulebook
591
+ - specdojo:imp-data-rulebook
592
+ - specdojo:imp-interface-rulebook
593
+ - specdojo:imp-operations-rulebook
594
+ - specdojo:imp-test-rulebook
595
+ - specdojo:itc-rulebook
596
+ - specdojo:mm-rulebook
597
+ - specdojo:mtp-rulebook
598
+ - specdojo:nfr-availability-rulebook
599
+ - specdojo:nfr-integrity-rulebook
600
+ - specdojo:nfr-maintainability-rulebook
601
+ - specdojo:nfr-operations-rulebook
602
+ - specdojo:nfr-performance-rulebook
603
+ - specdojo:nfr-reliability-rulebook
604
+ - specdojo:nfr-security-safety-rulebook
605
+ - specdojo:nfr-usability-rulebook
606
+ - specdojo:ntp-rulebook
607
+ - specdojo:opd-rulebook
608
+ - specdojo:opr-rulebook
609
+ - specdojo:otp-rulebook
610
+ - specdojo:pjr-rulebook
611
+ - specdojo:pm-change-request-log-rulebook
612
+ - specdojo:pm-communication-plan-rulebook
613
+ - specdojo:pm-issue-log-rulebook
614
+ - specdojo:pm-members-rulebook
615
+ - specdojo:pm-organization-rulebook
616
+ - specdojo:pm-plan-rulebook
617
+ - specdojo:pm-quality-management-plan-rulebook
618
+ - specdojo:pm-raci-rulebook
619
+ - specdojo:pm-risk-register-rulebook
620
+ - specdojo:pm-roles-rulebook
621
+ - specdojo:pr-rulebook
622
+ - specdojo:prj-assumptions-constraints-dependencies-rulebook
623
+ - specdojo:prj-charter-rulebook
624
+ - specdojo:prj-comparison-of-alternatives-rulebook
625
+ - specdojo:prj-issues-and-approach-rulebook
626
+ - specdojo:prj-scope-rulebook
627
+ - specdojo:prj-stakeholder-register-rulebook
628
+ - specdojo:prj-success-criteria-and-acceptance-criteria-rulebook
629
+ - specdojo:sac-rulebook
630
+ - specdojo:sch-rulebook
631
+ - specdojo:sf-rulebook
632
+ - specdojo:sld-rulebook
633
+ - specdojo:stc-rulebook
634
+ - specdojo:stsd-mermaid-rulebook
635
+ - specdojo:stsd-rulebook
636
+ - specdojo:sysd-critical-flows-rulebook
637
+ - specdojo:sysd-cross-cutting-policy-rulebook
638
+ - specdojo:sysd-rulebook
639
+ - specdojo:tml-rulebook
640
+ - specdojo:trc-requirements-to-specs-rulebook
641
+ - specdojo:trc-requirements-to-tests-rulebook
642
+ - specdojo:tsd-rulebook
643
+ - specdojo:uis-rulebook
644
+ - specdojo:utc-rulebook
380
645
  - id: vp-dev-implementation-readiness
381
646
  role: DEV
382
647
  category: implementation
@@ -389,8 +654,7 @@ viewpoints:
389
654
  - permission
390
655
  - acceptance
391
656
  default_severity: major
392
- evaluation: human
393
- continuous: false
657
+ evaluation: discretionary
394
658
  - id: vp-dev-change-impact
395
659
  role: DEV
396
660
  category: implementation
@@ -404,8 +668,7 @@ viewpoints:
404
668
  - operations
405
669
  - traceability
406
670
  default_severity: major
407
- evaluation: human
408
- continuous: false
671
+ evaluation: referential
409
672
  - id: vp-dev-testability
410
673
  role: DEV
411
674
  category: quality
@@ -413,8 +676,7 @@ viewpoints:
413
676
  check: 実装・設定変更後に確認すべき lint、schema、build、生成コマンドが分かるか。
414
677
  evidence: 検証コマンド、期待結果、対象ファイル、エラー時対応。
415
678
  default_severity: minor
416
- evaluation: human
417
- continuous: false
679
+ evaluation: referential
418
680
  - id: vp-qe-done-criteria
419
681
  role: QE
420
682
  category: quality
@@ -425,9 +687,10 @@ viewpoints:
425
687
  - acceptance
426
688
  - traceability
427
689
  default_severity: major
428
- evaluation: agent
429
- continuous: true
690
+ evaluation: referential
430
691
  grade_targets: [deliverable]
692
+ comparison_sources:
693
+ - catalog-entry
431
694
  - id: vp-qe-verifiability
432
695
  role: QE
433
696
  category: quality
@@ -440,8 +703,7 @@ viewpoints:
440
703
  - non_functional
441
704
  - acceptance
442
705
  default_severity: major
443
- evaluation: agent
444
- continuous: true
706
+ evaluation: referential
445
707
  - id: vp-qe-omissions-consistency
446
708
  role: QE
447
709
  category: consistency
@@ -452,8 +714,7 @@ viewpoints:
452
714
  # 必須要素の充足は check / evidence と各成果物の rulebook・schema で判定し、
453
715
  # 構造系成果物(pm-roles / pm-members / pm-raci など)への無関係な詳細流入を避ける。
454
716
  default_severity: major
455
- evaluation: agent
456
- continuous: true
717
+ evaluation: referential
457
718
  - id: vp-qe-config-validity
458
719
  role: QE
459
720
  category: quality
@@ -465,43 +726,44 @@ viewpoints:
465
726
  # 設定値の妥当性と schema 整合に絞る。
466
727
  default_severity: major
467
728
  evaluation: deterministic
468
- continuous: true
469
729
  grade_targets: [deliverable]
470
730
  - id: vp-qe-kata-conformance
471
731
  role: QE
472
732
  category: quality
473
733
  title: 実践の型としての適合性
474
- check: rulebook、recipe、sample、template が種別ごとの責務を守り、相互参照と対象成果物への適用方法が矛盾なく定義されているか。
475
- evidence: authoring standard、rulebook の型宣言、recipe の問い、sample の完成例、template の骨組み、対象成果物との対応。
734
+ check: >-
735
+ rulebook、recipe、sample、template が種別ごとの責務を守り、Kata 内部、Kata 相互、および参照する組織定義や生成物を含む適用先との関係が矛盾なく定義されているか。Kata に関するこれらの整合はこの観点で判定し、vp-arc-cross-document-consistency では扱わない。
736
+ evidence: >-
737
+ authoring standard、rulebook の型宣言、recipe の問い、sample の完成例、template の骨組み、相互参照、組織定義や生成物を含む適用先との対応。
476
738
  coverage_types:
477
739
  - acceptance
478
740
  - traceability
479
741
  default_severity: major
480
- evaluation: agent
481
- continuous: true
742
+ evaluation: referential
482
743
  grade_targets: [kata]
483
744
  - id: vp-ux-readability
484
745
  role: UX
485
746
  category: usability
486
747
  title: 読みやすさ・理解しやすさ
487
748
  check: >-
488
- 説明を持つ成果物では、初見の読者が、成果物固有の目的または上位文書への参照からなぜ扱うかを把握し、目的と手段を区別して、対象、主要な判断、次に見る文書を理解できるか。そのうえで、同じ主張の反復、判断に不要な一般論、表と本文の内容重複、正本からの過剰な再掲がなく、必要な背景、判断理由、例外、制約、done_criteria を保った必要十分な記述になっているか。長さだけでは fail にせず、冗長箇所を特定できる場合は minor、冗長さによって主旨または主要な判断点を読み取れない場合は major とする。構造・設定中心の成果物では、名称、メタデータ、参照から役割と利用先を識別できるか。
749
+ 初見の読者が、成果物固有の目的または上位文書への参照、名称、メタデータから、なぜ扱うか、役割、利用先、対象、主要な判断、次に見る文書を理解できるか。主旨または主要な判断点を読み取れない箇所を特定できる場合は major とする。同一主張の反復や正本の過剰な再掲など冗長性の判定は vp-arc-conciseness で行い、この観点では扱わない。
489
750
  evidence: >-
490
- 導入文、目的・理由、主要な成果・方針との対応、上位文書への参照、見出し、表、用語、関連ドキュメント、補足説明、段落・箇条書きの長さと論点数、反復・重複箇所、表と本文の役割分担、正本への参照と再掲範囲、保持すべき背景・判断理由・例外・制約・done_criteria、削除候補・参照置換候補。
751
+ 導入文、目的・理由、主要な成果・方針との対応、上位文書への参照、見出し、表、用語、関連ドキュメント、補足説明、段落・箇条書きの長さと論点数、保持すべき背景・判断理由・例外・制約・done_criteria。
491
752
  # Why の内容の妥当性は PO / BA に委ね、ここでは必要性と主要な判断の関係を読み手が
492
753
  # 識別できるか、および手段だけが目的に見える表現になっていないかを判定する。
493
754
  default_severity: minor
494
- evaluation: agent
495
- continuous: true
755
+ evaluation: referential
756
+ document_kinds:
757
+ unclassified: include
496
758
  - id: vp-ux-user-flow
497
759
  role: UX
498
760
  category: usability
499
761
  title: 利用者導線
500
- check: 利用者や将来貢献者が迷わず必要情報へ到達できる構成になっているか。
762
+ check: >-
763
+ 利用者や将来貢献者が迷わず必要情報へ到達できる構成になっているか。目次から必要な章を見つけられるか、関連成果物への参照が適切な位置にあるか、前提から結論への説明順序が守られているかのいずれかの基準に照らして判定し、情報を見失う箇所を具体的に特定できる場合のみ不備とする。
501
764
  evidence: 目次、関連リンク、手順、参照先、サンプル、説明順序。
502
765
  default_severity: minor
503
- evaluation: agent
504
- continuous: true
766
+ evaluation: referential
505
767
  grade_targets: [deliverable]
506
768
  - id: vp-ux-language-consistency
507
769
  role: UX
@@ -510,8 +772,7 @@ viewpoints:
510
772
  check: 用語、Role code、成果物名、状態、ラベルが読み手を混乱させない形で統一されているか。
511
773
  evidence: 用語定義、表記ゆれ、Role code、local_id、status、ラベル。
512
774
  default_severity: minor
513
- evaluation: agent
514
- continuous: true
775
+ evaluation: referential
515
776
  - id: vp-ops-release-readiness
516
777
  role: OPS
517
778
  category: operations
@@ -524,8 +785,7 @@ viewpoints:
524
785
  - auditability
525
786
  - acceptance
526
787
  default_severity: major
527
- evaluation: human
528
- continuous: false
788
+ evaluation: discretionary
529
789
  - id: vp-ops-operability
530
790
  role: OPS
531
791
  category: operations
@@ -538,8 +798,7 @@ viewpoints:
538
798
  - auditability
539
799
  - non_functional
540
800
  default_severity: minor
541
- evaluation: human
542
- continuous: false
801
+ evaluation: discretionary
543
802
  - id: vp-ops-agent-boundary
544
803
  role: OPS
545
804
  category: operations
@@ -550,8 +809,7 @@ viewpoints:
550
809
  - permission
551
810
  - auditability
552
811
  default_severity: blocker
553
- evaluation: human
554
- continuous: false
812
+ evaluation: referential
555
813
 
556
814
  role_viewpoint_sets:
557
815
  - role: PO