specdojo 0.8.0 → 0.9.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 (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -18,7 +18,7 @@ specdojo:
18
18
 
19
19
  Project Register Documentation Rules
20
20
 
21
- 本ドキュメントは、プロジェクト登録簿の個別登録項目(`pjr-XXXX-<topic>.md`)、項目別イベントログ、そこから生成する一覧・派生ビューの記述ルールです。現在値の正本は個票の Frontmatter、監査履歴の正本は項目別イベントログとし、一覧は表示専用の生成物として扱います。
21
+ 本ドキュメントは、プロジェクト登録簿の個別登録項目(`pjr-XXXX-<topic>.md`)、項目別イベントログ、そこから生成する一覧・派生ビューの記述ルールです。
22
22
 
23
23
  ## 1. 全体方針
24
24
 
@@ -28,8 +28,10 @@ Project Register Documentation Rules
28
28
  - 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
29
29
  - `generated/pjr-index.md` とすべての派生ビューは個票から `register build` で生成し、直接編集しない。
30
30
  - `<project-id>:pjr-index` は `generated/pjr-index.md` の文書 ID とする。`controls/**/generated/` はdoc-indexの限定走査対象とし、`register build` の後に `index build` を実行する。
31
- - 一覧と個票で同じ構造化フィールドを保持・同期する規則は設けない。
32
- - type 別テンプレートの選択と初期生成は `register add` が担うため、本 rulebook は単一の template を参照しない。
31
+ - 本書で登録項目の分類を指すときは `item_type` と書き、文書種別の `type`(`project`)と区別する。CLI の `--type` は `item_type` を指定する。
32
+ - 個票の template は `item_type` ごとに異なり、`register add` が `本文構成(標準テンプレ)` の表に従って選ぶ。Frontmatter の `template` は 1 件しか宣言できないため `not-needed` とし、対応は同表を正とする。
33
+ - 値の型と enum は `docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml`(個票)と `docs/specdojo/schemas/v1/register-events.schema.yaml`(イベント)、コマンドの選び方と例は [[specdojo:register-operation-guide|登録簿運用ガイド]] を正本とし、本書で言い直さない。
34
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。個票の `status` は register コマンドが `個票 status の遷移基準` に従って更新する。文書の整形・lint はリポジトリの検証で扱い、個票の完了条件に含めない。
33
35
 
34
36
  ## 2. ファイル命名・ID規則
35
37
 
@@ -50,82 +52,88 @@ Project Register Documentation Rules
50
52
  - 項目別イベントログは同ディレクトリの `events/` 配下に置き、個票 1 件につき 1 ファイルとする。
51
53
  - 登録項目一覧は `docs/ja/projects/<project-id>/controls/project-register/generated/pjr-index.md` に生成する。
52
54
  - 状態別・優先度別・担当者別の補助一覧と、元の項目から派生先を辿る一覧は同じ `generated/` 配下に生成する。
53
- - controls 全体の type 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
55
+ - controls 全体の `item_type` 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
54
56
 
55
57
  ## 3. 推奨 Frontmatter 項目
56
58
 
57
- 個票には `register-item-frontmatter.schema.yaml` が定義する次の項目を置く。未定の担当、期限、完了日時、結論は表用のプレースホルダを保存せず、該当キーを省略する(期限なしだけは `due_on: null`)。
58
-
59
- | 項目 | 説明 | 必須 |
60
- | ----------------- | ----------------------------------------------------------------- | ----------- |
61
- | `id` | `<project-id>:pjr-XXXX-<topic>` | ○ |
62
- | `type` | `project` | ○ |
63
- | `status` | 文書成熟度。`draft` / `ready` / `deprecated` | ○ |
64
- | `rulebook` | `specdojo:pjr-rulebook` | ○ |
65
- | `part_of` | `<project-id>:pjr-index` を要素に持つ配列 | ○ |
66
- | `item_type` | 登録項目の分類 | ○ |
67
- | `track` | epic が担う track。ほかの type では指定しない | epic で必須 |
68
- | `domains` | epic が対象とする domain の文字列配列。ほかの type では指定しない | 任意 |
69
- | `item_status` | 登録項目の処理状態 | ○ |
70
- | `priority` | 対応優先度 | ○ |
71
- | `difficulty` | agent 振り分け用の作業難易度 | 任意 |
72
- | `owner` | 主担当者または役割 | 任意 |
73
- | `registered_at` | 起票日時 | 任意 |
74
- | `due_on` | 対応期限または判断期限 | 任意 |
75
- | `start_on` | epic の予定開始日。ほかの type では指定しない | 任意 |
76
- | `completed_at` | 完了・却下・決定日時 | 条件 |
77
- | `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
78
- | `conclusion` | 終端時の結論要約 | 任意 |
79
- | `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
80
- | `depends_on` | 実行前に完了しているべき先行の登録項目 ID の配列 | 任意 |
81
- | `approach` | 対象を作成・修正するときの進め方 | 任意 |
82
- | `target_path` | カタログなしで作成する成果物のリポジトリ相対パス | 任意 |
83
- | `target_rulebook` | 対象成果物の rulebook ID | 任意 |
84
- | `targets` | 変更対象文書の doc id リスト | 任意 |
85
-
86
- - `epic` は track ごとの全体計画の正本であり、自身は実行しない。`track` は英小文字・数字・ハイフンの識別子とし、先頭は英小文字または数字にする。同じ project 内の epic どうしで track を重複させない。旧 `tml-index.yaml` への登録は不要とする。
87
- - `register add --type epic --track <track> --domain <domain>` で起票し、`register update --track <track> --domain <domain>` で変更する。epic の `track` は削除できない。`--domain` は反復指定で一覧を置き換え、update の `--domain -` 単独で削除する。`domains` を省略した場合だけ互換用 timeline へ範囲の解決を委ね、空配列は対象なしの明示指定とする。変更はイベントに残す。
88
- - 全体計画の順序は epic 間の `depends_on`、範囲は `domains`、期間は `start_on`・着手・完了の記録と `due_on` から導く。開始日は `start_on`、epic 自身の最初の着手 event、先行 epic の最も遅い終了日の翌稼働日の順に使い、どれもなければ未定とする。子 todo の着手や起票日では補わない。`register build` は epic の依存循環と track の重複を拒否し、`start_on` が `due_on` より後なら警告する。この場合は期間を未定とする。epic のない track は全体計画へ出さない。生成は [[specdojo:register-operation-guide|登録簿運用ガイド]] に従う。
89
- - `register add` / `update` の `--start-on <YYYY-MM-DD>` で予定開始日を設定し、`--start-on -` で省略・削除する。ほかの type への指定と、実在しない日付や形式不正は記帳前に拒否し、変更は event に残す。
59
+ 個票には schema が定義する次の項目を置く。未定の担当、期限、完了日時、結論はプレースホルダ(`_TODO_` など)を保存せず、該当キーを省略する(期限なしだけは `due_on: null`)。
60
+
61
+ | 項目 | 説明 | 必須 |
62
+ | ----------------- | ------------------------------------------------------------------------ | ----------- |
63
+ | `id` | `<project-id>:pjr-XXXX-<topic>` | ○ |
64
+ | `type` | `project` | ○ |
65
+ | `status` | 文書成熟度。`draft` / `ready` / `deprecated` | ○ |
66
+ | `rulebook` | `specdojo:pjr-rulebook` | ○ |
67
+ | `part_of` | `<project-id>:pjr-index` を要素に持つ配列 | ○ |
68
+ | `item_type` | 登録項目の分類 | ○ |
69
+ | `track` | epic が担う track。ほかの `item_type` では指定しない | epic で必須 |
70
+ | `domains` | epic が対象とする domain の文字列配列。ほかの `item_type` では指定しない | 任意 |
71
+ | `item_status` | 登録項目の処理状態 | ○ |
72
+ | `priority` | 対応優先度 | ○ |
73
+ | `difficulty` | agent 振り分け用の作業難易度 | 任意 |
74
+ | `owner` | 主担当者または役割 | 任意 |
75
+ | `registered_at` | 起票日時 | 任意 |
76
+ | `due_on` | 対応期限または判断期限 | 任意 |
77
+ | `start_on` | epic の予定開始日。ほかの `item_type` では指定しない | 任意 |
78
+ | `completed_at` | 完了・却下・決定日時 | 条件 |
79
+ | `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
80
+ | `conclusion` | 終端時の結論要約 | 任意 |
81
+ | `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
82
+ | `depends_on` | 実行前に完了しているべき先行の登録項目 ID の配列 | 任意 |
83
+ | `approach` | 対象を作成・修正するときの進め方 | 任意 |
84
+ | `target_path` | カタログなしで作成する成果物のリポジトリ相対パス | 任意 |
85
+ | `target_rulebook` | 対象成果物の rulebook ID | 任意 |
86
+ | `targets` | 変更対象文書の doc id リスト | 任意 |
87
+
90
88
  - `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
91
- - `item_type`、`item_status`、`priority`、`difficulty` の値は schema の enum だけを使用する。`difficulty` は `hard` / `medium` / `easy` のいずれかとし、省略時は従来の agent 自動選択を使う。
92
- - `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
93
- - Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
94
- - `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。未設定の project は拒否する。別 project の存在確認は、その project のローカル統合ブランチを正とする。
95
- - `depends_on` は実行順序、`derived_from` は起票の由来を表す。両者を相互に推測・転記しない。参照書式と別 project の存在確認は `derived_from` と同じ規則を使い、存在しない ID、自己参照、project をまたぐ循環を記帳前と `register build` で拒否する。
96
- - `register add` / `update` の `--depends-on <ID>` は反復指定でき、一覧を置換する。`--depends-on -` は依存を削除し、ほかの ID と併用しない。変更は event に記録する。
97
- - すべての先行項目が `done` / `decided` のときだけ実行を許可する。`rejected` / `deferred` は依存を満たさない。直接の `exec run --register` は未完了の先行 ID と状態を示して停止し、routine の sweep(`--register-filter`)と夜間 queue は理由を記録して対象を飛ばす。依存を理由に状態を自動で `waiting` へ変更しない。
89
+ - `difficulty` を省略した場合は agent を自動で選ぶ。
90
+ - `epic` は track ごとの全体計画の正本であり、自身は実行しない。`track` は英小文字・数字・ハイフンの識別子とし、先頭は英小文字または数字にする。同じ project 内の epic どうしで track を重複させず、epic の `track` は削除できない。`domains` を省略した場合だけ互換用 timeline へ範囲の解決を委ね、空配列は対象なしの明示指定とする。
91
+ - 全体計画の順序は epic 間の `depends_on`、範囲は `domains`、期間は `start_on`・着手・完了の記録と `due_on` から導く。epic 間の依存は循環させない。開始日・終了日の決め方は登録簿運用ガイドの `全体計画を確認する` に従う。
92
+ - `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`block_reason` は `waiting` 以外へ遷移すると現在値から削除され、削除前の理由はイベントログに残る。
93
+ - `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目、未設定の project は使用しない。別 project の存在確認は、その project のローカル統合ブランチを正とする。
94
+ - `depends_on` は実行順序、`derived_from` は起票の由来を表す。両者を相互に推測・転記しない。参照書式と存在確認は `derived_from` と同じとし、存在しない ID、自己参照、project をまたぐ循環を記帳前と `register build` で拒否する。
95
+ - すべての先行項目が `done` / `decided` のときだけ実行を許可する。`rejected` / `deferred` は依存を満たさない。依存を理由に状態を自動で `waiting` へ変更しない。
98
96
 
99
97
  ### 3.1. 日時と日付の使い分け
100
98
 
101
- - 起票と終端は瞬間として記録し、`registered_at` / `completed_at` に UTC の RFC 3339・秒精度(`YYYY-MM-DDTHH:MM:SSZ`)で保存する。
99
+ - 起票と、完了・決定・却下による終端は瞬間として記録し、`registered_at` / `completed_at` に UTC の RFC 3339・秒精度(`YYYY-MM-DDTHH:MM:SSZ`)で保存する。`deferred` は `completed_at` を持たない。
102
100
  - 予定開始日と期限は瞬間ではなくプロジェクトタイムゾーン上の暦日であるため、`start_on` と `due_on` は `YYYY-MM-DD` のまま保持する。未定の `start_on` は省略する。
103
101
  - 一覧・派生ビューの「登録日」「完了日」は、保存した日時をプロジェクトの登録日タイムゾーンへ変換して導出する表示値であり、個票へ日付として重複保存しない。
104
- - 日時は register コマンドが記録する。手書きで日時を入力する場合も、タイムゾーンを含む値から UTC へ変換した値だけを保存する。
102
+ - 日時は register コマンドが記録し、後追いの入力もタイムゾーン付きの値から UTC へ変換して保存する。
105
103
 
106
104
  ### 3.2. Register event と責務境界
107
105
 
108
- - 個票の現在値は `item_status` などの Frontmatter フィールド、変更履歴は `events/pjr-XXXX.yaml`、保存・配布・差分レビューは Git が担う。Git コミットはイベントの発生単位ではなく、履歴再構成の正本にしない。
109
- - イベントファイルのルートは YAML 配列とし、イベントを古い順に追記する。項目ごとの配置により、イベントごとの追加ファイルを作らず、異なる項目を並行更新したときの共有ログ競合を避ける。
110
- - 各イベントは version、イベント ID、UTC 発生日時、action、actor、遷移前後の `item_status`、reason、変更フィールド、直前イベント ID を保持する。Git から移行したイベントだけは移行元 commit も保持できる。
111
- - action は `add` / `start` / `wait` / `review` / `close` / `reject` / `defer` / `reopen` / `update` / `renumber` / `migrate` のいずれかとする。詳細な型と enum は `register-events.schema.yaml` を正本とする。
106
+ - 保存・配布・差分レビューは Git が担うが、Git コミットを履歴再構成の正本にしない。
107
+ - イベントファイルのルートは YAML 配列とし、イベントを古い順に追記する。項目ごとに配置し、異なる項目の並行更新で共有ログが競合しないようにする。
108
+ - イベントの項目と action は register-events schema に従い、各イベントは遷移前後の `item_status` と直前イベント ID で前のイベントにつなぐ。
109
+ - actor には、決定・承認した人の nickname、実行した agent、または予約 actor を記録する。`PO` などの Role code を actor にせず、`specdojo-orchestrator` で人の判断主体を代替しない。受け付ける名前は登録簿運用ガイドに従う。
110
+ - 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。既存イベントの置換や削除で重複を解消しない。
112
111
  - `register build` は個票とイベントファイルの 1 対 1 対応、イベント ID の一意性、時刻順、直前イベント参照、遷移前後状態の連鎖、最新イベントの状態と個票の `item_status` の一致を検証する。不正なイベントを無視して一覧を生成しない。
113
112
 
114
113
  ## 4. 本文構成(標準テンプレ)
115
114
 
116
115
  ### 4.1. 個別登録項目
117
116
 
118
- | 順序 | 内容 | 必須 | 説明 |
119
- | ---- | ---------------- | ---- | -------------------------------------- |
120
- | 1 | type 固有の記録 | ○ | 対象、背景、評価、対応・判断、結果など |
121
- | 末尾 | 関連ドキュメント | ○ | 根拠、影響先、追跡先を文書 ID で示す |
122
-
123
117
  - H1 は `PJR-XXXX <タイトル>` 形式とする。
124
- - 実行対象の `todo`・`issue`・`change-request`・`question`・`risk` の個票は、対話で得た前提・制約・委任範囲を箇条書きで残す `入力` 節を持つ。入力がない場合は `-` とする。完了条件・回答の確定条件とは分ける。既存個票に節がなくても読み込め、初回の入力更新時に節を追加する。
125
- - `epic` は概要、範囲(track と domain)、完了の判断の基準、子項目、対応結果、関連ドキュメントを持つ。範囲には domain と境界、完了の基準には子項目と schedule を確認する判断条件、対応結果には人が完了を判断した根拠を記録する。
126
- - 子 todo は `--from <epic-id>` で起票する。`derived_from` を逆引きした epic 別ビューは直接の子を type と状態付きで表示し、子がない epic も表示する。別 project の子は project 修飾 ID で識別する。孫を再帰的に含めず、状態の自動集約や自動 close は行わない。
127
- - type 固有の構成は `todo` の概要・完了条件・作業内容・対応結果など、各 type 用テンプレートに従う。
128
- - ID、分類、処理状態、優先度、担当、期限、完了日時は本文へ重複記載せず、Frontmatter を参照する。
118
+ - 本文は `item_type` ごとの template の節(必須節)をこの順ですべて持つ。該当する内容がない節は削らず `-` を書く。
119
+ - 必須節を満たす判定は、本文のコード(インラインコード・コードブロック)の外に `_TODO_` が残っていないことである。`register close` はこの判定で `ready` へ昇格させるかを決める。
120
+
121
+ | `item_type` | template | 必須節 |
122
+ | ---------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ |
123
+ | `epic` | `specdojo:pjr-epic-template` | 概要、範囲(track と domain)、完了の判断の基準、子項目、対応結果、関連ドキュメント |
124
+ | `todo` | `specdojo:pjr-todo-template` | 概要、入力、完了条件、作業内容、対応結果、関連ドキュメント |
125
+ | `question` | `specdojo:pjr-question-template` | 確認事項、入力、背景、回答候補、回答・結論、承認、関連ドキュメント |
126
+ | `decision` | `specdojo:pjr-decision-template` | 背景、検討した選択肢、決定内容、採択理由、承認、影響範囲とフォローアップ、関連ドキュメント |
127
+ | `note` | `specdojo:pjr-note-template` | メモ、背景・文脈、フォローアップ、関連ドキュメント |
128
+ | `risk` | `specdojo:pjr-risk-template` | リスク内容、入力、影響評価、対応方針、モニタリング、関連ドキュメント |
129
+ | `issue` | `specdojo:pjr-issue-template` | 課題内容、入力、影響範囲、対応方針、対応結果、関連ドキュメント |
130
+ | `change-request` | `specdojo:pjr-change-request-template` | 変更要求、入力、影響評価、審査・決定、実施追跡、関連ドキュメント |
131
+
132
+ - `入力` 節には対話で得た前提・制約・委任範囲を箇条書きで残し、入力がない場合は `-` とする。完了条件・回答の確定条件とは分け、完了条件へ転記しない。既存個票に節がなくても読み込め、初回の入力更新時に節を追加する。
133
+ - 承認の節には承認者・承認方式・証跡を記録する。承認方式の選び方は登録簿運用ガイドに従う。
134
+ - `epic` の範囲には domain と境界、完了の判断の基準には子項目と schedule を確認する判断条件、対応結果には人が完了を判断した根拠を記録する。
135
+ - 子 todo は epic から起票し、`derived_from` に epic を記録する。epic 別ビューは直接の子だけを表示し、状態の自動集約や自動 close は行わない。
136
+ - 関連ドキュメントには、根拠、影響先、追跡先を文書 ID で示す。
129
137
  - 終端前に未確定の結果・結論がある場合は、`-` または共通ラベルを用い、確定済みの記述と混在させない。
130
138
 
131
139
  ### 4.2. 生成一覧と派生ビュー
@@ -139,11 +147,10 @@ Project Register Documentation Rules
139
147
  | `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
140
148
  | `generated/pjr-epic-items.md` | epic ごとの直接の子項目と状態 | 不可 |
141
149
  | `generated/pjr-dependent-items.md` | 先行項目から後続項目を逆引きする一覧 | 不可 |
142
- | `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
150
+ | `controls/generated/pm-*.md` | `item_type` 別の管理ビュー | 不可 |
143
151
 
144
152
  - 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票、`depends_on` とする。
145
- - タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。
146
- - 登録日と完了日の列は、`registered_at` / `completed_at` をプロジェクトの登録日タイムゾーンへ変換した暦日として生成する。
153
+ - タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。登録日と完了日は `日時と日付の使い分け` に従って導出する。
147
154
  - 生成ビューに独自の詳細情報や手作業の修正を追加しない。修正は個票に行い、`register build` を再実行する。
148
155
 
149
156
  ## 5. 記述ガイド
@@ -154,36 +161,22 @@ Project Register Documentation Rules
154
161
  - 評価や選択肢には、比較可能な観点と根拠を記載し、結論だけを先に固定しない。
155
162
  - 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
156
163
  - 結果・結論には、完了を判定した根拠と後続対応を記載する。
157
- - 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
158
164
  - 実行中に問題や後続作業を見つけて別の登録項目を起票するときは、起票元を `derived_from` に必ず記録する。decision から todo を起票する場合も同じ関係を使い、decision 本文へ追跡先を重複記載しない。既存本文の追跡先は移行のために書き換えない。
159
- - 本項目の実施において確実に変更する対象文書が分かっている場合は、その文書 ID を Frontmatter の `targets` 配列へ宣言する。宣言した `targets` は agent 実行時の変更網羅検証(target coverage)に用いられる。未知の場合や対象を固定しない場合は宣言を省略する。
160
- - `approach` を宣言する場合、`targets` は 1 件だけ必須とする。成果物の対象はカタログを優先して解決する。`cross-deliverable-dedup` はカタログを必須とする。それ以外の成果物の approach(`fully-guided`・`condense`・`recipe-guided`・`freeform`・`bootstrap`・`retrofit`・`finalize`・`bootstrap-finalize`)は、カタログなしでも既存文書の索引と `specdojo.rulebook`、または個票の `target_path` と `target_rulebook` から解決できる。新規文書は両フィールドを必須とし、リポジトリ外のパスや別文書との衝突、既存文書と指定の不一致は認めない。カタログ設定済みで対象が未登録の場合も両フィールドがある場合だけ同じ解決を使う。`rulebook-maintenance`・`recipe-maintenance`・`sample-maintenance`・`template-maintenance` の対象は、名前に対応する種別の kata の doc id とし、文書索引で解決する。対応する正本で解決できない ID や、`approach` と種別が合わない対象は使用しない。
161
-
162
- - `condense` は既存成果物 1 件の冗長さを直す edit とし、未作成の対象は認めない。
163
- - カタログなしの完了基準は個票の完了条件と rulebook とする。recipe・sample・template は rulebook frontmatter から辿り、`not-needed` のものを対象に含めない。`fully-guided` の必要な一式、`recipe-guided` の recipe が不足する場合は起票・更新を拒否する。
164
- - カタログなしの `bootstrap` は `target_path`、新しい `target_rulebook`、設定の `kata_authority` を必須とする。既存 rulebook を再利用しない。rulebook の名前部分から recipe・sample・template の ID を導出し、`docs/ja/specdojo/<kind>s/<kata_authority>/` に配置する候補を plan へ示す。成果物には新しい `specdojo.rulebook` を記録する。
165
- - `finalize`・`bootstrap-finalize` は既存成果物だけを対象にし、カタログなしでは個票の完了条件を確認チェック表にする。後者は成果物と frontmatter から辿る kata 一式を確定対象とする。
166
-
167
- - 対話で得た前提は `register add --input <text>` で個票本文の `入力` へ記録する。繰り返し指定した順に箇条書きとし、`register update --input` は指定した一覧で置換する。追記する場合は既存分を含めて渡し、`--input -` 単独で全削除する。未指定時は保持する。空文字、削除指定と他の入力の混在、add での削除指定は拒否する。
168
- - 入力の変更は event の `input` フィールドへ変更前後の JSON 配列として記録し、値がない場合は `-` とする。register 経由の plan は approach の有無を問わず、入力がある場合だけ「個票の入力(前提)」に展開する。入力を完了条件へ転記しない。
165
+ - 確実に変更する対象文書が分かっている場合は、その文書 ID を `targets` へ宣言する。`targets` は agent 実行時の変更網羅検証(target coverage)に使う。未知の場合や対象を固定しない場合は省略する。
166
+ - `approach` を宣言する場合、`targets` は 1 件だけ必須とする。成果物の対象はカタログを優先して解決し、カタログにない新規文書は `target_path` と `target_rulebook` を両方記録する。`*-maintenance` の対象は名前に対応する種別の kata の doc id とする。解決できない ID や、`approach` と種別が合わない対象は使用しない。approach ごとのカタログなしでの解決と拒否の条件は [[specdojo:ryu-guide|実践の進め方ガイド]] の `成果物カタログなしで進める` と [[specdojo:command-reference|CLIコマンドリファレンス]] に従う。
169
167
 
170
168
  ### 5.2. 構造化フィールドと生成
171
169
 
172
- - 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
173
- - 担当・期限・結論・topic・`derived_from`・`approach`・`targets` などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。`register add` と `register update` では、起票元に繰り返し指定できる `--from`、進め方に `--approach`、対象に繰り返し指定できる `--target`、成果物の配置と rulebook に `--target-path` と `--target-rulebook` を使う。配置と rulebook の明示指定もそれぞれ `-` で削除できる。起票元、`approach`、対象を削除するときは、それぞれ `--from -`、`--approach -`、`--target -` を指定する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
174
- - `register build` は個票を読み取り、一覧・派生ビューを再生成する。`generated/pjr-derived-items.md` では `derived_from` を逆引きし、元の項目から派生先を辿れるようにする。一覧を編集して個票へ反映する経路はない。
175
- - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時は予約 actor の `SpecDojo` を記録する。
176
- - `--by` に指定できるのは、project の `pm-members.yaml` にある人の nickname、repository の `.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` に限る。agent の alias は実体の nickname に解決して記録し、名簿にも予約一覧にもない値は書き込み前に拒否する。
177
- - 決定・承認を記録する actor には、`PO` などの Role code や予約 actor ではなく、決定・承認した人の nickname を使う。`specdojo-orchestrator` は対話型オーケストレーター自身の操作だけに使い、人の判断主体を代替しない。
178
- - 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
179
- - ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。
180
- - 主題の変化に伴う `<topic>` の変更は `register update --topic` で行う。個票のファイル名と Frontmatter の文書 ID、他文書中の旧文書 ID 参照を同時に更新し、生成ビューを再生成する。
170
+ - 新しい項目は `register add` で作成し、全 `item_type` で個票を省略しない。
171
+ - 構造化フィールドは `register update`、処理状態は状態遷移コマンドで変更する。
172
+ - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを項目別ログへ記録する。一覧を編集して個票へ反映する経路はない。
173
+ - ID の変更は `register renumber`、主題の変化に伴う `<topic>` の変更は `register update --topic` で行い、個票のファイル名・文書 ID・他文書の参照と生成ビューを整合させる。
181
174
 
182
175
  ### 5.3. 登録項目の item_status 遷移基準
183
176
 
184
177
  #### 5.3.1. item_type 別の item_status 終端基準
185
178
 
186
- `item_status` の通常終端は、登録した目的を達成したときに使用する。type ごとの通常終端と判定基準は次のとおりとする。
179
+ `item_status` の通常終端は、登録した目的を達成したときに使用する。
187
180
 
188
181
  | `item_type` | 通常終端 | 遷移条件 | `conclusion` に残す内容 |
189
182
  | ---------------- | --------- | ---------------------------------------------------------------------- | ---------------------------- |
@@ -196,12 +189,8 @@ Project Register Documentation Rules
196
189
  | `issue` | `done` | 問題を解消し、必要な確認を終えた | 解決内容と確認結果 |
197
190
  | `change-request` | `done` | 採択した変更を対象へ反映し、必要な確認を終えた | 反映内容と確認結果 |
198
191
 
199
- - `question` / `decision` の通常終端に `done` を使わず、回答・決定が確定したことを示す `decided` を使う。
200
- - `epic` / `todo` / `risk` / `issue` / `change-request` の通常終端に `decided` を使わず、対応または追跡が完了したことを示す `done` を使う。
201
- - `epic` は todo と同じ処理状態と例外終端(`rejected` / `deferred`)を使用する。`exec run --register` の実行対象にはせず、filter と夜間 queue も飛ばす。具体的な作業は子 todo で実行する。
202
- - `note` の `open` は未対応を意味しない。内容を継続して更新できる、生きている記録であることを示す。
203
- - `note` から対応・回答・判断が必要になった場合は、`todo` / `question` / `decision` など目的に合う別項目を起票し、note 自体は `open` のまま参照元として保持する。
204
- - `note` の内容が陳腐化または置換された場合は、その事実と参照先を本文へ追記する。`done` / `decided` / `rejected` / `deferred` へ遷移させて閉じない。
192
+ - `epic` は todo と同じ処理状態と例外終端を使用する。`exec run --register` の実行対象にはせず、filter と夜間 queue も飛ばす。具体的な作業は子 todo で実行する。
193
+ - `note` の `open` は未対応を意味せず、継続して更新できる記録であることを示す。対応・回答・判断が必要になった場合は目的に合う別項目を起票し、陳腐化・置換された場合はその事実と参照先を追記する。note 自体は終端させない。
205
194
 
206
195
  #### 5.3.2. 例外的な追跡終了
207
196
 
@@ -212,30 +201,26 @@ Project Register Documentation Rules
212
201
  | `rejected` | 対応・回答・判断の対象外、前提不成立、または変更を採択しないことが確定した | 採択しない理由と、必要なら代替の追跡先を記録する |
213
202
  | `deferred` | 現時点の追跡を停止し、再開条件または再評価時期を定めた | 再開条件または再評価時期を記録する |
214
203
 
215
- - `rejected` は完了・決定の代用にせず、実施または採択しない判断が確定した場合だけ使う。
216
- - `deferred` は状態遷移上の終端だが、完了を意味せず `completed_at` を持たない。再開するときは `register reopen` を使う。
217
- - `question` / `decision` で回答または決定を得た場合は `rejected` ではなく `decided` を使う。問い・判断自体が不要になった場合だけ `rejected` を使う。
204
+ - `rejected` は完了・決定の代用にせず、実施または採択しない判断が確定した場合だけ使う。`question` / `decision` で回答・決定を得た場合は `decided` とし、問い・判断自体が不要になった場合だけ `rejected` を使う。
205
+ - `deferred` は状態遷移上の終端だが、完了を意味しない。再開するときは `register reopen` を使う。
218
206
  - `risk` を受容して監視を終える場合は、受容判断と残存影響を `conclusion` に記録したうえで `done` とする。リスクの前提が誤りだった場合は `rejected` とする。
219
207
 
220
208
  #### 5.3.3. 中間状態を経ない終端
221
209
 
222
210
  終端への遷移は、`in-progress` / `waiting` / `review` を経ていることを前提としない。`open` から直接終端させてよい。
223
211
 
224
- - 人または対話型 orchestrator が対応した項目では、着手を記録する前に完了することがある。形式を揃えるために `start` を遡って記録すると、実際には行われていない時点の遷移がイベントログに残る。事実と異なる記録を避けるため、直接の終端を許す。
225
- - agent が `exec run` で実行する項目は runner が `start` を記録するため、この経路では中間状態が必ず残る。
226
- - 中間状態を経ない場合は、誰がどの経路で対応したかを終端イベントの `reason` へ記録する。exec の plan / result / evidence が存在しないため、実施内容と検証結果は個票の対応結果へ残す。
227
- - 実行していない主体を actor とする遷移を、記録の体裁を整える目的で追加しない。
212
+ - 人または対話型 orchestrator が着手を記録する前に完了した項目で、`start` を遡って記録しない。`exec run` の項目は runner が `start` を記録する。
213
+ - 中間状態を経ない場合は、誰がどの経路で対応したかを終端イベントの `reason` へ記録し、実施内容と検証結果を個票の対応結果へ残す(exec の plan / result / evidence がないため)。
228
214
 
229
215
  ### 5.4. 個票 status の遷移基準
230
216
 
231
- | `status` | 意味 | 遷移させる時点 |
232
- | ------------ | ------------------------------------------------- | ------------------------------------------------- |
233
- | `draft` | 作成直後。type 固有の必須節が未確定 | `register add` で個票を生成した時点 |
234
- | `ready` | type 固有の必須節が固まり `_TODO_` が残っていない | `register close` 時に必須節を満たすと判定した時点 |
235
- | `deprecated` | 却下・破棄され成熟度を追う必要がない | `register reject` 時点 |
217
+ | `status` | 意味 | 遷移させる時点 |
218
+ | ------------ | -------------------------------------- | ------------------------------------------------- |
219
+ | `draft` | 作成直後。必須節が未確定 | `register add` で個票を生成した時点 |
220
+ | `ready` | 必須節が固まり `_TODO_` が残っていない | `register close` 時に必須節を満たすと判定した時点 |
221
+ | `deprecated` | 却下・破棄され成熟度を追う必要がない | `register reject` 時点 |
236
222
 
237
- - 遷移は register コマンドが担い、個票 Frontmatter を直接手書きで書き換えない。
238
- - `ready` への昇格には、type 固有の必須節に `_TODO_` が残っていないことを要する。
223
+ - 必須節とその判定は `個別登録項目` に従う。
239
224
  - `reopen` は過去の結果を消さず、再開理由と新しい対応状況を個票本文へ追記する。
240
225
 
241
226
  ## 6. 禁止事項
@@ -243,9 +228,9 @@ Project Register Documentation Rules
243
228
  - 生成された `pjr-index.md`、補助一覧、controls 全体の派生ビューを直接編集しない。
244
229
  - 一覧と個票の同期、一覧から個票への書き戻し、または個票を作るかどうかの分離基準を設けない。
245
230
  - 構造化フィールドを個票本文や別の正本へ重複管理しない。
246
- - `type` / `item_status` / `priority` に schema 未定義の値を使用しない。
231
+ - `item_type` / `item_status` / `priority` / `difficulty` に schema 未定義の値を使用しない。
247
232
  - `registered_at` / `completed_at` に、UTC 以外のオフセットやタイムゾーンを伴わない値、暦日だけの値を保存しない。
248
233
  - 個票の文書 ID から `<topic>` を省略したり、ファイル名と異なるローカル ID を使用したりしない。
249
- - type 固有の必須内容を、見出しだけ残した空欄のまま終端状態にしない。
234
+ - 必須節を、見出しだけ残した空欄のまま終端状態にしない。
250
235
  - 実行していない主体を actor とする状態遷移を、記録の体裁を揃える目的で追加しない。
251
236
  - `events/pjr-XXXX.yaml` を手書きで追加・修正・並べ替え・削除しない。履歴補正が必要な場合も register コマンドを使い、監査イベントを破壊しない。
@@ -16,31 +16,24 @@ Change Request Log Documentation Rules
16
16
 
17
17
  ## 1. 全体方針
18
18
 
19
- - 変更要求の申請から審査、決定、実施追跡までを判定可能な形で管理する。
20
- - 変更要求ごとに識別子、影響評価、決定結果、責任者、期限を明記する。
21
- - 曖昧表現を避け、承認可否や実施条件が判断できる記述にする。
19
+ - 変更要求ごとに、申請から影響評価、審査・決定、実施追跡までを判定できる形で残す。
20
+ - 審査は `pm-plan` のスコープと優先順位に照らして行い、その対応を決定の根拠に書く。
21
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
22
22
 
23
- ## 2. 位置づけと用語定義(必要に応じて)
23
+ ## 2. 位置づけ
24
24
 
25
- - `pm-plan`: プロジェクト全体の管理方針。
26
- - `pm-issue-log`: 顕在化した課題の管理。
27
- - `pm-risk-register`: 潜在リスクの管理。
28
- - `pm-change-request-log`: 変更要求の審査・決定と実施追跡。
25
+ - プロジェクト登録簿を使うプロジェクトでは、変更要求 1 件を `item_type: change-request` の個票に書き、`controls/generated/pm-change-request-log.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
26
+ - 本書の章ごとの判断基準は、個票の同名の節と、登録簿を使わない単独の変更要求ログの両方に適用する。
27
+ - 変更から生じたリスク・課題は `pm-risk-register`・`pm-issue-log` 側の項目として起票し、関連ドキュメントで結ぶ。
29
28
 
30
29
  ## 3. ファイル命名・ID規則
31
30
 
32
- - `id` は `<project-id>:pm-change-request-log` を使用する。
33
- - ファイル名は `pm-change-request-log-変更要求ログ.md` など、プロジェクト内で一意にする。
31
+ - `id` は `<project-id>:pm-change-request-log`、ファイル名は `pm-change-request-log.md` とする。
32
+ - 変更 ID は登録簿では `PJR-XXXX`、単独のログでは `CR-NNN` とし、再利用しない。
34
33
 
35
34
  ## 4. 推奨 Frontmatter 項目
36
35
 
37
- | 項目 | 説明 | 必須 |
38
- | ---------- | ------------------------------------ | ---- |
39
- | id | `<project-id>:pm-change-request-log` | ○ |
40
- | type | `project` 固定 | ○ |
41
- | status | `draft` / `ready` / `deprecated` | ○ |
42
- | based_on | 根拠仕様ID(配列) | 任意 |
43
- | supersedes | 置換関係ID(配列) | 任意 |
36
+ - 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
44
37
 
45
38
  ## 5. 本文構成(標準テンプレ)
46
39
 
@@ -61,35 +54,33 @@ Change Request Log Documentation Rules
61
54
 
62
55
  ### 6.2. 変更要求一覧
63
56
 
64
- - 変更 ID、要求内容、申請者、申請日、状態を一覧化する。
65
-
66
- 推奨フォーマット(表):
67
-
68
- | 変更ID | 要求内容 | 申請者 | 申請日 | 状態 |
69
- | ------ | -------- | ------ | ------ | ---- |
57
+ - 変更 ID、要求内容、申請者、申請日、状態に加え、変更理由(応える業務課題・期待価値)を書く。
58
+ - 要求内容は「何を・どう変えるか」が 1 文で分かる形にする(例: 「日次売上CSVの列順を会計ソフトの取込順に変える」)。
70
59
 
71
60
  ### 6.3. 影響評価
72
61
 
73
- - 影響範囲(スコープ、工数、品質、納期)と評価根拠を明記する。
62
+ - スコープ・工数・品質・納期の観点ごとに、影響の有無と量(人日・日数など)と根拠を書く。
63
+ - 採否の判断材料として、見送ったときの影響と期待効果を書く。
74
64
 
75
65
  ### 6.4. 審査・決定
76
66
 
77
- - 審査結果、決定日、承認者、実施条件を明記する。
67
+ - 審査結果は「承認・条件付き承認・却下・保留」のいずれかとし、決定者・決定日・実施条件と、`pm-plan` のスコープ・優先順位との対応を書く。
78
68
 
79
69
  ### 6.5. 実施追跡
80
70
 
81
- - 実施担当、期限、進捗、完了条件を明記する。
71
+ - 実施担当、期限、進捗、完了条件を書く。完了条件は確認の手段と合格の基準で書く(例: 「受入テストで新しい列順を会計ソフトへ取り込めること」)。
82
72
 
83
73
  ### 6.6. 関連ドキュメント
84
74
 
85
- - `pm-plan`、`pm-issue-log`、`pm-risk-register` との導線を記載する。
86
- - 関連がない場合でも `(本書のみ)` を明記する。
75
+ - 根拠(`pm-plan` など)、影響先、変更から起票したリスク・課題を文書 ID で示す。関連がない場合は `(本書のみ)` と書く。
87
76
 
88
77
  ## 7. 禁止事項
89
78
 
90
- | 禁止事項 | 理由 |
91
- | -------------------------------------- | ------------------------ |
92
- | 変更IDを未採番で記録する | 追跡不能になるため |
93
- | 影響評価なしで承認可否を記載する | 判断根拠が欠落するため |
94
- | 決定者・決定日を省略する | 監査性が失われるため |
95
- | 実装詳細やコード差分を本文に貼り付ける | 管理対象が肥大化するため |
79
+ | 禁止事項 | 理由 |
80
+ | -------------------------------------------- | -------------------------- |
81
+ | 変更IDを未採番で記録する | 追跡不能になるため |
82
+ | 影響評価なしで承認可否を記載する | 判断根拠が欠落するため |
83
+ | 決定者・決定日を省略する | 監査性が失われるため |
84
+ | 実装詳細やコード差分を本文に貼り付ける | 管理対象が肥大化するため |
85
+ | 個人情報・認証情報を要求内容や根拠に書き写す | 公開範囲を超えて広がるため |
86
+ | 生成された `pm-change-request-log.md` を直す | 再生成で修正が失われるため |
@@ -16,102 +16,79 @@ specdojo:
16
16
 
17
17
  Communication Plan Documentation Rulebook
18
18
 
19
- 関係者が必要な時点で判断・確認・共有できるよう、コミュニケーション機会と証跡を最小構成で定義するルールです。ステークホルダー情報や会議・報告・チャネルを重複管理しません。
19
+ 判断・確認・共有のためのコミュニケーション機会と証跡を定義する基準です。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - ステークホルダー登録簿の情報要求から、実際に必要なコミュニケーションだけを抽出します。
24
- - 会議体、報告、通知を別々に網羅せず、「誰に何をいつ伝えるか」の一表へ統合します。
25
- - 定例会議は必須とせず、非同期確認で成立する場合は証跡だけを定めます。
26
- - 関係者の期待・懸念・影響度、Role code の定義、個人連絡先は本書へ複製しません。
27
- - 重要判断、当事者確認、費用・負荷の合意、公開判断が伝達漏れにならないことを優先します。
28
- - AI Agent は草案や整理を支援できますが、合意・承認・公開判断は人間が行います。
23
+ - 重要判断、当事者確認、費用・負荷の合意、公開判断の伝達漏れを防ぎます。
24
+ - 会議・報告・通知は一表へ統合し、定例会議は必須とせず、非同期確認を選べます。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
29
26
 
30
- ## 2. 位置づけと用語定義
27
+ ## 2. 位置づけ
31
28
 
32
- | 用語 | 定義 |
33
- | ---------------------- | ------------------------------------------------------------ |
34
- | コミュニケーション機会 | 判断、確認、共有、相談が必要になるイベントまたは作業節目 |
35
- | 対象 | 情報を受け取り、確認または判断する関係者・Role code |
36
- | 証跡 | 合意、判断、確認結果を後から追跡できる記録 |
37
- | エスカレーション | 所定の条件で、一次対応から人間の最終判断者へ判断を上げること |
29
+ 管理計画の判断ゲートとステークホルダー登録簿の情報要求を、報告・連絡・会議へ具体化します。担当者は作業節目や問題発生時に、伝達先・時期・判断経路・記録先を本計画で確認します。関係者の期待・懸念・影響度は登録簿、Role code はロール定義を正とします。
38
30
 
39
31
  ## 3. ファイル命名・ID規則
40
32
 
41
33
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-communication-plan.md` を推奨します。
42
- - ID は `<project-id>:pm-communication-plan`、ファイル名は `pm-communication-plan.md` とします。
43
-
34
+ - ID は `<project-id>:pm-communication-plan` とします。
44
35
  - 関係者はステークホルダー ID、責任主体は採用済み Role code で記述します。
45
36
 
46
37
  ## 4. 推奨 Frontmatter 項目
47
38
 
48
- | 項目 | 説明 | 必須 |
49
- | ---------- | ----------------------------------------- | ---- |
50
- | id | `<project-id>:pm-communication-plan` | ○ |
51
- | type | `project` | ○ |
52
- | status | `draft` / `ready` / `deprecated` | ○ |
53
- | rulebook | `specdojo:pm-communication-plan-rulebook` | ○ |
54
- | based_on | 管理計画、ステークホルダー登録簿などの ID | 任意 |
55
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
39
+ 共通項目はドキュメントメタ情報標準に従います。
40
+
41
+ - `type`: `project`
42
+ - `rulebook`: `specdojo:pm-communication-plan-rulebook`
43
+ - `based_on`: 管理計画・ステークホルダー登録簿など、直接の根拠
56
44
 
57
45
  ## 5. 本文構成(標準テンプレ)
58
46
 
59
- | 番号 | 見出し | 必須 | 内容 |
60
- | ---- | ---------------------- | ---- | -------------------------------------------- |
61
- | 1 | 方針と適用範囲 | ○ | 対象、目的、同期・非同期方針、人と AI の境界 |
62
- | 2 | コミュニケーション機会 | ○ | 対象、情報、タイミング、手段、責任、証跡 |
63
- | 3 | エスカレーション | ○ | 条件、一次対応、最終判断、証跡 |
64
- | 4 | 情報管理と公開 | ○ | 情報区分、取扱い、記録先 |
65
- | 5 | 見直し条件と未決事項 | 任意 | 見直しトリガー、未決論点、判断者 |
47
+ | 章 | 必須 | 内容・受入条件 |
48
+ | ---------------------- | ---- | ------------------------------------------------ |
49
+ | 方針と適用範囲 | ○ | 対象・目的と同期・非同期の選択が分かること |
50
+ | コミュニケーション機会 | ○ | 情報要求に対応する実施機会と結果を追跡できること |
51
+ | エスカレーション | ○ | 条件に応じた判断経路を辿れること |
52
+ | 情報管理と公開 | ○ | 情報区分ごとの共有範囲と記録先が分かること |
53
+ | 見直し条件と未決事項 | 任意 | 見直しトリガー、未決論点と影響 |
66
54
 
67
55
  ## 6. 記述ガイド
68
56
 
69
57
  ### 6.1. 方針と適用範囲
70
58
 
71
- - 対象プロジェクト、主要な関係者、必要な合意の種類を要約します。
72
- - 常設会議を置くか、作業節目の非同期確認を基本とするかを示します。
73
- - 個人名や連絡先ではなく、ステークホルダー ID または Role code を使います。
59
+ 対象プロジェクト、主要な関係者、必要な合意の種類を要約し、常設会議か作業節目の非同期確認かを示します。
74
60
 
75
61
  ### 6.2. コミュニケーション機会
76
62
 
77
63
  | 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
78
64
  | ---------- | -------------------- | ---------- | ---- | ---- | ---- |
79
65
 
80
- - ステークホルダー登録簿の情報要求を転記せず、実施する機会へ変換します。
81
- - 会議、報告、通知を同じ表で扱い、同じ内容を複数行へ重複させません。
82
- - 対象者が判断または確認できる内容と、結果の記録先を明記します。
66
+ 登録簿の情報要求を判断・確認・共有・相談の機会へ変換し、対象者が判断できる内容と結果の記録先を明記します。
83
67
 
84
68
  ### 6.3. エスカレーション
85
69
 
86
70
  | 条件 | 一次対応 | 最終判断 | 証跡 |
87
71
  | ---- | -------- | -------- | ---- |
88
72
 
89
- - 目的・スコープ、当事者価値、費用・負荷、品質・安全、公開・権利など判断者が変わる条件を分けます。
90
- - 緊急度よりも、誰の判断が必要かを基準にします。
91
- - Agent 出力の疑義は人間の成果物責任者または最終判断者へ上げます。
73
+ 目的・スコープ、当事者価値、費用・負荷、品質・安全(Agent 出力の疑義を含む)、公開・権利など、判断者が変わる条件を分けます。緊急度よりも、誰の判断が必要かを基準にします。
92
74
 
93
75
  ### 6.4. 情報管理と公開
94
76
 
95
77
  | 情報区分 | 取扱い | 記録先 |
96
78
  | -------- | ------ | ------ |
97
79
 
98
- - 公開、限定共有、記録禁止など、必要な区分だけを定義します。
99
- - 個人情報、秘密情報、認証情報を公開記録や Agent 入力へ含めません。
100
- - 正本と生成ビューがある場合は、正本側で更新して再生成します。
80
+ 公開、限定共有、記録禁止など必要な区分を定義し、各手段で扱える情報と記録先を対応させます。
101
81
 
102
82
  ### 6.5. 見直し条件と未決事項
103
83
 
104
84
  - ステークホルダー、判断ゲート、公開方針、連絡手段が変わった場合に見直します。
105
- - 未決事項は _UNDECIDED_: とし、決定時期と判断者を添えます。
106
- - 日常的に追跡する課題は本書ではなく登録簿へ移します。
85
+ - 未決事項は `_UNDECIDED_` を付し、論点と伝達先・時期・手段への影響を示します。
107
86
 
108
87
  ## 7. 禁止事項
109
88
 
110
- | 禁止事項 | 理由 |
111
- | -------------------------------------------------- | -------------------------------------- |
112
- | ステークホルダー登録簿やRole code一覧を再掲する | 正本が分散するため |
113
- | 会議体、報告、チャネルへ同じ情報を重複記載する | 更新漏れと過剰な運用を招くため |
114
- | 目的や証跡のない定例会議を必須にする | コミュニケーション自体が負荷になるため |
115
- | エスカレーション条件を「必要に応じて」とだけ書く | 判断時点が不明になるため |
116
- | Agent に合意、承認、公開判断を委ねる | 人間の判断責任を代替するため |
117
- | 個人名、連絡先、秘密・認証情報、実装詳細を記載する | 公開適性と文書責務に反するため |
89
+ | 禁止事項 | 理由 |
90
+ | ------------------------------------------------ | -------------------------------------- |
91
+ | ステークホルダー登録簿やRole code一覧を再掲する | 正本が分散するため |
92
+ | 会議体、報告、チャネルへ同じ情報を重複記載する | 更新漏れと過剰な運用を招くため |
93
+ | 目的や証跡のない定例会議を必須にする | コミュニケーション自体が負荷になるため |
94
+ | エスカレーション条件を「必要に応じて」とだけ書く | 判断時点が不明になるため |