specdojo 0.1.0 → 0.2.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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,323 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:document-metadata-standard
4
+ type: standard
5
+ status: draft
6
+ ---
7
+
8
+ # ドキュメントメタ情報標準
9
+
10
+ Document Metadata Standard
11
+
12
+ Markdown の Frontmatter と YAML・JSON の構造化メタデータに関する共通原則、および成果物ドキュメントの記述ルールを定義します。
13
+
14
+ ## 1. 適用範囲
15
+
16
+ - 共通原則: Frontmatter を持つすべての Markdown ドキュメント
17
+ - 独立 YAML データファイル向け規約: SpecDojo スキーマ(`docs/specdojo/schemas/v1/`)を持つ YAML 成果物(`dct-*.yaml` / `pm-*.yaml` / `sch-*.yaml` / `bdd-*.yaml` など)
18
+ - JSON データファイル向け規約: SpecDojo が管理する JSON 文書、実行イベント、設定、インデックス、生成物
19
+ - 成果物向け詳細規約: `project` / `flow` / `rule` / `data` / `ui` / `api` / `architecture` / `test` / `operations` / `template` / `sample`
20
+ - 成果物スキーマ: [deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
21
+
22
+ `rulebook` / `recipe` / `guide` / `reference` / `standard` / `philosophy` は専用スキーマを持つため、成果物向け詳細規約の対象外とします。それぞれの追加規約は次を正本とします。
23
+
24
+ - rulebook: [rulebook-authoring-standard.md](rulebook-authoring-standard.md) の `Frontmatter 規約`
25
+ - recipe: [recipe-authoring-standard.md](recipe-authoring-standard.md) の `Frontmatter 規約`
26
+ - guide: [guide-authoring-standard.md](guide-authoring-standard.md) の `Frontmatter 規約`
27
+ - reference: [reference-authoring-standard.md](reference-authoring-standard.md) の `Frontmatter 規約`
28
+ - standard: [standard-authoring-standard.md](standard-authoring-standard.md) の `Frontmatter 規約`
29
+ - philosophy: [philosophy-authoring-standard.md](philosophy-authoring-standard.md) の `Frontmatter 規約`
30
+
31
+ ## 2. 共通原則
32
+
33
+ - Markdown はファイル先頭に YAML Frontmatter を置く。
34
+ - SpecDojo が所有する項目はすべて `specdojo:` 名前空間(ネストしたオブジェクト)配下に置く。トップレベルは他フレームワーク(VitePress 等)の項目に明け渡し、SpecDojo は直接使わない。
35
+ - `id` / `type` / `status` は全種別で必須とし、`specdojo:` 配下に置く。
36
+ - `id` は共通スキーマの `idRef` に従い、`^[a-z0-9][a-z0-9-:]*$` に一致させる。
37
+ - npm package が所有する実践体系文書の `id` は `<authority>:<local-id>` とし、SpecDojo core は `specdojo:` を使用する。これは Frontmatter の親キー `specdojo:` とは別に、ID値の所有元を表す namespace である。
38
+ - `type` は各ドキュメント種別のスキーマに定義された値を使用する。
39
+ - `status` は `draft` / `ready` / `deprecated` のいずれかとする。
40
+ - ドキュメント名は Frontmatter ではなく本文先頭の H1 に記述する。
41
+ - `specdojo:` 名前空間の対象は Markdown Frontmatter のみとする。独立 YAML データファイル(`dct-*.yaml` / `pm-*.yaml` / `sch-*.yaml` など)は Markdown ではなく他ツールとの同居も無いため、名前空間化せずトップレベルに項目を置く。
42
+ - JSON データファイルは Frontmatter を持たず、用途別のスキーマまたは実装契約が定めるトップレベル項目にメタデータを置く。Markdown の `specdojo:` 名前空間や `id` / `type` / `status` の共通必須条件を一律には適用しない。
43
+
44
+ ```yaml
45
+ ---
46
+ specdojo:
47
+ id: prj-scope
48
+ type: project
49
+ status: ready
50
+ rulebook: specdojo:prj-scope-rulebook
51
+ ---
52
+ ```
53
+
54
+ ### 2.1. テンプレート自身のメタ情報と生成物 Frontmatter の分離
55
+
56
+ 成果物テンプレート自身のメタ情報と、テンプレートから生成される成果物の Frontmatter は明確に分離する。
57
+
58
+ - `docs/ja/specdojo/templates/` 配下の成果物テンプレートは実践の型であり、ファイル自身のメタ情報も `specdojo:` 配下に置く。`id` / `type` / `status` は実値で記述して通常のメタ情報制約に従う。例: `specdojo.id: specdojo:dct-project-management-template`、`specdojo.type: template`、`specdojo.status: draft`。
59
+ - `docs/ja/specdojo/exec-templates/` 配下の exec / result テンプレートは、plan / result 生成処理が消費する内部テンプレートである。実践の型の `type: template` 文書ではないため、ファイル自身の Frontmatter は持たない。本文先頭に `_FRONTMATTER_` を置き、生成処理が `specdojo:` 名前空間形の Frontmatter を注入する。
60
+ - 生成される成果物の Frontmatter は、テンプレート自身の Frontmatter とは別に、生成物側の雛形として表現する。表現方法はテンプレート種別ごとに次のいずれかとする。
61
+ - Markdown 成果物テンプレートは、自身 Frontmatter の `specdojo:` 配下に置いた `frontmatter_template` フィールドに、生成物 Frontmatter の雛形(`specdojo:` ラッパー込み)を記述する(本標準 `生成物 Frontmatter 雛形`)。
62
+ - YAML catalog テンプレート(`dct-*`)は独立 YAML データファイルであり名前空間化しない。生成物側フィールドを平坦に記述し、生成処理(`specdojo scaffold`)が `id` / `type` などを変換する。
63
+ - YAML catalog 以外の独立 YAML データファイルのテンプレート(`pm-members-template.yaml` 等)は、自身のメタ情報をトップレベルに実値で記述し、生成物のメタ情報はトップレベルの `metadata_template` フィールドに雛形として記述する(本標準 `生成物メタ情報雛形(metadata_template)`)。
64
+ - 生成時に置換する値は `_UPPER_SNAKE_` 形式のプレースホルダで表す。ただし `type: template` を理由に、すべての Frontmatter 項目や ID で大文字・アンダースコアを使用できるわけではない。
65
+ - プレースホルダは、個別スキーマが許可したフィールドだけで使用する。許可していないフィールドでは、共通スキーマや成果物スキーマの通常の値制約を適用する。
66
+ - プレースホルダを置換して生成した成果物は、生成後のドキュメント種別に対応する通常のスキーマを満たさなければならない。
67
+
68
+ 例えば [dct.schema.yaml](../../../specdojo/schemas/v1/dct.schema.yaml) は、テンプレートの `part_of` などで参照する `DocId` に大文字とアンダースコアを許可し、`local_id` では `_NNNN_` や `_TERM_` を含む値を許可しています。一方、生成後の project 文書には `StrictDocId` と kebab-case の `local_id` が適用されます。
69
+
70
+ ```yaml
71
+ id: specdojo:dct-project-management-template
72
+ type: template
73
+ status: draft
74
+ part_of:
75
+ - _PROJECT_ID_:dct-index
76
+ ```
77
+
78
+ プレースホルダの命名と雛形での使い方は [template-authoring-standard.md](template-authoring-standard.md) を参照してください。
79
+
80
+ ### 2.2. 生成物 Frontmatter 雛形(`frontmatter_template`)
81
+
82
+ Markdown 成果物テンプレートは、生成物の Frontmatter を自身 Frontmatter の `specdojo:` 配下に置いた `frontmatter_template` フィールドに雛形として記述する。
83
+
84
+ - `frontmatter_template` の内容は、生成物の Frontmatter そのもの(`specdojo:` ラッパー込み)とし、生成物のドキュメント種別に対応するスキーマ(成果物なら [deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml))を満たす形にする。
85
+ - 生成時に置換する値には生成時プレースホルダ(本標準 `生成時プレースホルダと記入プレースホルダ`)を使う。
86
+ - 生成処理は、`frontmatter_template` の生成時プレースホルダを置換した結果を生成物の Frontmatter として出力し、テンプレート自身の Frontmatter(`specdojo.id: *-template` 等)は出力しない。
87
+
88
+ ```yaml
89
+ ---
90
+ specdojo:
91
+ id: specdojo:pm-plan-template
92
+ type: template
93
+ status: draft
94
+ frontmatter_template:
95
+ specdojo:
96
+ id: _PROJECT_ID_:pm-plan
97
+ type: project
98
+ status: ready
99
+ rulebook: specdojo:pm-plan-rulebook
100
+ based_on:
101
+ - _PROJECT_ID_:pm-organization
102
+ - _PROJECT_ID_:pm-roles
103
+ supersedes: []
104
+ ---
105
+ ```
106
+
107
+ ### 2.3. 生成時プレースホルダと記入プレースホルダ
108
+
109
+ プレースホルダは、置換される時点で 2 種類に分ける。
110
+
111
+ | 区分 | 置換する主体 | 置換タイミング | 例 |
112
+ | -------------------- | -------------------- | ---------------------------- | ---------------------- |
113
+ | 生成時プレースホルダ | 生成(scaffold)処理 | テンプレート展開時に機械置換 | `_PROJECT_ID_` |
114
+ | 記入プレースホルダ | 作成者 / AI Agent | 生成後の本文記入時 | _TODO_, `_RISK_TITLE_` |
115
+
116
+ - 生成時プレースホルダは `frontmatter_template` と本文の相互参照の両方に現れ、生成処理が一括置換する。
117
+ - 記入プレースホルダは生成物に残し、recipe に従って作成者が埋める。生成処理は置換しない。
118
+
119
+ ## 3. 独立 YAML データファイルのメタ情報
120
+
121
+ 独立 YAML データファイルは Frontmatter を持たないため、ファイル先頭のトップレベル項目でメタ情報を表す。
122
+
123
+ - 名前空間化せず、トップレベルに項目を置く(共通原則を参照)。
124
+ - `id` / `type` / `status` は Markdown Frontmatter と同じ制約に従う。
125
+ - `title` を必須とし、ドキュメント名を記述する。Markdown における本文先頭の H1 に相当し、表示ページ生成(`specdojo yaml-pages build`)が生成ページの H1 として使用する。
126
+ - `rulebook` を必須とし、準拠する rulebook の ID を指定する。該当する rulebook がない場合のみ `none` を許可する(成果物の必須項目と同じ制約)。
127
+ - YAML catalog テンプレート(`dct-*-template.yaml`)では、`title` / `rulebook` は生成物側フィールドとして生成物の値を平坦に記述する(テンプレート自身のメタ情報と生成物 Frontmatter の分離を参照)。それ以外のテンプレート(`*-template.yaml`)では、`title` はテンプレート自身の名前を実値で記述し、生成物のメタ情報は `metadata_template` に記述する(本標準 `生成物メタ情報雛形(metadata_template)`)。
128
+ - 上記以外の項目(`based_on` / `supersedes` / `version` / `project_id` など)の許可項目と型は各スキーマを正本とする。
129
+ - OpenAPI / AsyncAPI など外部標準形式の YAML(`ifx-*` 等)は本規約の対象外とし、`info.title` や `x-spec-meta` など各形式の慣行に従う。
130
+
131
+ ```yaml
132
+ id: prj-0001:pm-roles
133
+ type: project
134
+ status: draft
135
+ title: ロール一覧
136
+ rulebook: specdojo:pm-roles-rulebook
137
+ version: 1
138
+ project_id: prj-0001
139
+ ```
140
+
141
+ ### 3.1. 生成物メタ情報雛形(`metadata_template`)
142
+
143
+ YAML catalog(`dct-*`)を除く独立 YAML データファイルのテンプレート(`pm-members-template.yaml` 等)は、生成物のメタ情報をトップレベルの `metadata_template` フィールドに雛形として記述する。Markdown 成果物テンプレートの `frontmatter_template` に対応する仕組みである。
144
+
145
+ - テンプレート自身のメタ情報はトップレベルに実値で記述する。`id` / `type` / `status` は通常のメタ情報制約に従い(例: `id: specdojo:pm-members-template`、`type: template`)、`title` はテンプレート自身の名前を記述する。`rulebook` はテンプレート自身が準拠する rulebook が無いため `none` とする。
146
+ - `metadata_template` の内容は、生成物のトップレベルメタ情報そのもの(`id` / `type` / `status` / `title` / `rulebook` / `based_on` / `version` / `project_id` など)とし、生成物のスキーマが定めるメタ項目の制約を満たす形にする。
147
+ - 生成時に置換する値には生成時プレースホルダ(本標準 `生成時プレースホルダと記入プレースホルダ`)を使う。
148
+ - 生成処理は、`metadata_template` の生成時プレースホルダを置換した内容をトップレベルに平坦化して出力し、続けて本文キー(テンプレート自身のメタ情報 `id` / `type` / `status` / `title` / `rulebook` と `metadata_template` を除いたトップレベルキー)を出力する。テンプレート自身のメタ情報は出力しない。
149
+
150
+ ```yaml
151
+ id: specdojo:pm-roles-template
152
+ type: template
153
+ status: draft
154
+ title: ロール一覧テンプレート
155
+ rulebook: none
156
+ metadata_template:
157
+ id: _PROJECT_ID_:pm-roles
158
+ type: project
159
+ status: draft
160
+ title: ロール一覧
161
+ rulebook: specdojo:pm-roles-rulebook
162
+ version: 1
163
+ project_id: _PROJECT_ID_
164
+
165
+ # 以下、本文キー(roles など雛形本体)が続く
166
+ ```
167
+
168
+ ## 4. JSONデータファイルのメタ情報
169
+
170
+ JSON データファイルは Frontmatter を持たないため、トップレベルの構造化項目でメタデータを表す。
171
+ JSON オブジェクトのプロパティ順序には意味がないため、メタデータ項目を表示上ファイル先頭へ置く場合でも、その順序を識別や検証の条件にしない。
172
+
173
+ JSON は用途によって責務と必要な識別情報が異なるため、Markdown や独立 YAML 成果物の `id` / `type` / `status` を一律の必須項目としない。
174
+
175
+ | 区分 | メタデータの例 | 正本 |
176
+ | ------------------ | ------------------------------------------ | -------------------------------------------- |
177
+ | JSON 成果物・定義 | `id`、`type`、`status`、スキーマバージョン | 対応する成果物スキーマ、rulebook |
178
+ | 実行イベント | `v`、`ts`、`type`、`task_id`、`by` | イベント形式のスキーマまたは実装上の検証契約 |
179
+ | 設定・インデックス | バージョン、対象、生成元など | 各ファイル形式のスキーマ |
180
+ | 生成物・派生ビュー | スキーマバージョン、生成元、対象など | 生成処理と出力形式のスキーマ |
181
+
182
+ - JSON 成果物として文書IDや状態を管理する場合は、対応するスキーマで `id` / `type` / `status` の必須性と値制約を定義する。
183
+ - イベントの `type` など、同名でも文書種別とは意味が異なる項目があるため、項目名だけで共通メタデータと判断しない。
184
+ - スキーマバージョンの項目名は、既存形式との互換性を維持するため、用途別スキーマが定める `v`、`version`、`schema_version` などを使用する。
185
+ - 自動生成される JSON のメタデータは生成元から導出し、生成物を直接編集して同期しない。
186
+ - JSON Lines(`.jsonl`)は複数の JSON 値を行単位で格納する形式であり、各レコードのスキーマまたは生成処理の契約に従う。
187
+
188
+ 例として、exec イベントではイベント形式の契約に従い、次のようにバージョン、発生日時、イベント種別、対象タスクをトップレベル項目で表す。
189
+
190
+ ```json
191
+ {
192
+ "v": 1,
193
+ "ts": "2026-07-16T11:06:10Z",
194
+ "type": "claim",
195
+ "task_id": "T-LAUNCH-prj-charter-140",
196
+ "by": "agent",
197
+ "msg": "claim task"
198
+ }
199
+ ```
200
+
201
+ ## 5. 成果物の必須項目
202
+
203
+ | 項目 | 説明 |
204
+ | -------- | ----------------------- |
205
+ | id | ドキュメント ID |
206
+ | type | ドキュメント種別 |
207
+ | status | ドキュメント状態 |
208
+ | rulebook | 準拠する rulebook の ID |
209
+
210
+ - `rulebook` は `none` または `*-rulebook` 形式の ID を指定する。
211
+ - 該当する rulebook がない場合のみ `rulebook: none` を許可する。
212
+
213
+ ## 6. 成果物の任意項目
214
+
215
+ | 項目 | 説明 |
216
+ | ---------- | ---------------------------------- |
217
+ | part_of | 一覧・親ドキュメントへの所属 |
218
+ | based_on | 作成時に直接の根拠とした文書 |
219
+ | supersedes | 置き換え対象ドキュメント |
220
+ | relations | 充足・検証・実装を表す型付きID参照 |
221
+
222
+ 成果物種別によって追加項目を使用できる場合があります。正確な許可項目と型は成果物スキーマを正本とします。
223
+
224
+ ### 6.1. 型付き参照(`relations`)
225
+
226
+ `based_on` は作成時に参照した直接の根拠を表し、要求の充足や検証を意味しません。要求・仕様・テスト・実装の追跡には `relations` を使用します。
227
+
228
+ | 関係 | 参照元の意味 | 主な参照先 |
229
+ | ------------ | -------------------------------------- | ------------------------ |
230
+ | `satisfies` | この成果物が要求・要件・条件を充足する | 要求、要件、受入条件のID |
231
+ | `verifies` | この成果物が対象を検証する | 要求、仕様、受入条件のID |
232
+ | `implements` | この成果物が仕様・設計を実現する | 仕様、設計のID |
233
+
234
+ ```yaml
235
+ ---
236
+ specdojo:
237
+ id: atc-order-registration
238
+ type: test
239
+ status: ready
240
+ rulebook: specdojo:atc-rulebook
241
+ based_on:
242
+ - tsp-index
243
+ relations:
244
+ verifies:
245
+ - req-order-registration
246
+ - bac-order-registration
247
+ ---
248
+ ```
249
+
250
+ 参照の正本は各成果物の `relations` とします。要求から仕様・テストへの対応表、カバレッジ、未充足項目はこれらの参照から導出する派生ビューであり、独立した手編集のSSOTを作りません。成果物本文に項目単位のトレース列を持つ場合も、安定したIDを記載し、同じ関係を別の状態情報として重複管理しないようにします。
251
+
252
+ ### 6.2. 継続品質評価(`grade`)
253
+
254
+ Markdown 文書の最新の継続品質評価は、プロジェクトの `<execution_path>/grade/results/<doc-id>.yaml` にサイドカーとして記録します。成果物の Frontmatter と本文には grade や finding を書き込みません。サイドカーは最新状態のスナップショットであり、`specdojo grade apply` は文書 ID ごとの同じファイルを冪等に上書きします。履歴は Job Run と evidence、合意形成は review result が担います。成果物の現在品質を参照するときは、サイドカーの `content_hash` が現在のファイル全体と一致することを確認します。
255
+
256
+ | 項目 | 意味 |
257
+ | ---------------- | ---------------------------------------------------------------------------- |
258
+ | `rubric` | 判定に使った共通 rubric の版 |
259
+ | `target` | `kata` または `deliverable` |
260
+ | `verdict` | `pass` / `needs-work` / `fail` |
261
+ | `score` | category の重み付き総合点(0-100) |
262
+ | `graded_at/by` | 評価日時と `pm-members.yaml` の判定主体 nickname |
263
+ | `content_hash` | 成果物ファイル全体の SHA-256 |
264
+ | `categories` | category 別 score |
265
+ | `viewpoints` | viewpoint 別 level / score |
266
+ | `finding_counts` | `blocker` / `major` / `minor` / `note` の件数 |
267
+ | `findings` | `id` / `severity` / `rule` / `line` / `anchor` / `message` の指摘一覧 |
268
+ | `done_criteria` | 成果物カタログの完了条件の充足数・総数、未充足条件の担当 Role code、詳細参照 |
269
+
270
+ `target: deliverable` で成果物カタログに `done_criteria` がある場合、サイドカーに要約を記録します。条件文、条件ごとの判定、不足理由は `<execution_path>/grade/criteria/` 配下の成果物ごとの YAML に記録し、`detail_ref` から参照します。同じ成果物の詳細ファイルは再評価ごとに上書きします。`satisfied` / `total` と総合 `score` / `verdict` は独立した評価軸であり、一方の値から他方を補完・上書きしません。
271
+
272
+ 未充足条件がある場合だけ `done_criteria.unsatisfied` を置き、条件 ID をキー、その条件の `roles` を値として記録します。これにより詳細を grade result へ複製せず、次の確認担当を特定できます。詳細 YAML は `grade-done-criteria.schema.yaml` に従い、成果物と同じ `content_hash` を持ちます。
273
+
274
+ `findings[].line` は Frontmatter を除く本文での指摘行(1始まり)、`anchor` は評価時点の該当行の引用です。本文編集で行番号がずれた場合は `anchor` を照合に使います。`grade validate` はサイドカーの文書 ID・対象・件数・内容ハッシュを成果物と突き合わせます。
275
+
276
+ 再評価で同じ message の finding が残る場合は未解消として扱い、severity を前回より引き下げません。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の message に severity を引き下げる根拠を含めます。
277
+
278
+ サイドカーは `grade-result.schema.yaml` に従います。現在の評価対象は Markdown 文書であり、YAML / JSON を対象へ指定した場合はエラーとします。
279
+
280
+ ## 7. 成果物の値制約
281
+
282
+ - `type` は `適用範囲` に列挙した成果物種別のいずれかとする。
283
+ - `specdojo:` 配下では未定義プロパティを使用しない(`unevaluatedProperties: false`)。トップレベルには他フレームワークの項目を置いてよい。
284
+ - 配列項目は重複させない。
285
+ - 項目ごとの型、列挙値、パターンは成果物スキーマに従う。
286
+ - `status` の値は `draft` / `ready` / `deprecated` で共通だが、意味の重みは成果物カタログの `kind` によって異なる。
287
+ - `kind: work`(人や agent が書く成果物): `ready` は内容を確認して確定したことを表す。`ready` への昇格は人だけが行い、agent の実行では行わない。
288
+ - `kind: generated`(コマンドが再生成する成果物): `ready` はその生成物を運用に使える状態であることを表す。再生成のたびに内容が変わることは正常であり、`ready` のまま内容が更新されてよい。
289
+ - 生成コマンドは、既存ファイルの `status` を書き換えない。新規作成時に `draft` を書き、以後の昇格と降格は人の判断に委ねる。生成対象が複数のファイルから集約される場合も、特定の入力ファイルの `status` を集約ファイルへ反映しない。
290
+
291
+ ## 8. 成果物の記述例
292
+
293
+ ```yaml
294
+ ---
295
+ specdojo:
296
+ id: imp-business
297
+ type: project
298
+ status: draft
299
+ rulebook: specdojo:imp-business-rulebook
300
+ part_of: []
301
+ based_on: []
302
+ supersedes: []
303
+ ---
304
+ ```
305
+
306
+ ## 9. バリデーション
307
+
308
+ - `npm run -s lint:md` で Markdown を検証する。
309
+ - Frontmatter の機械検証では、ドキュメント種別に対応するスキーマを使用する。
310
+ - 成果物には `deliverable-frontmatter.schema.yaml` を使用する。
311
+ - 独立 YAML データファイルは、ファイル形式に対応するスキーマで検証する。
312
+ - JSON データファイルは、用途別の JSON Schema または実装上の検証契約で必須項目、型、列挙値を検証する。
313
+ - JSON に対応するスキーマがない場合でも、JSON 構文として読み込めることを検証する。
314
+ - YAML データファイルのスキーマ対応は、各 YAML 先頭の
315
+ `# yaml-language-server: $schema=<schema-path>` modeline を正本とする。スキーマを追加したときは、
316
+ 対象 YAML または template の modeline を更新する。Frontmatter 用スキーマの場合は
317
+ `.remarkrc.yaml` の `remark-frontmatter-ajv2020` の `schemaRules` へ対象 glob を追加する。
318
+ - `docs/specdojo/schemas/v1/`(言語中立。YAML データファイルと Frontmatter 用): YAML データファイルでは modeline、Frontmatter 用スキーマでは `.remarkrc.yaml` の `schemaRules` を更新する。
319
+ - `docs/ja/specdojo/schemas/v1/`(言語別。Markdown 本文の構成検証用): `.remarkrc.yaml` の `remark-md-content` の `schemas` へ、スキーマと対象 glob の対応を追加する。
320
+ - `.remarkrc.yaml` の `schemaRules` は配列を上から評価し、最初に一致したスキーマだけを適用する。対象を追加するときは、より限定的な glob を先に置く。
321
+ - `.vscode/settings.json` の `yaml.schemas` へ YAML データファイルの対応表を重複管理しない。VS Code の YAML 拡張は modeline を読み、CLI 検証も同じ宣言を読む。
322
+ - schema 検証が不要な YAML には `# specdojo-schema: none reason=<reason>` を先頭コメントで明示する。template のように modeline は必要だが完成前プレースホルダにより検証対象外とする YAML には `# specdojo-schema: validate=false reason=template` を併記する。
323
+ - スキーマの適用状況は、対象ファイルへ一時的に不正なキー(YAML データファイル・Frontmatter)や不足した章(Markdown 本文)を作り、エディタまたは検証コマンドがエラーを報告するかで確認できる。エラーが出ない場合は、意図したスキーマが適用されていない。
@@ -0,0 +1,75 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:exec-human-finalize-standard
4
+ type: standard
5
+ status: ready
6
+ ---
7
+
8
+ # Human Finalize 実行標準
9
+
10
+ Human Finalize Execution Standard
11
+
12
+ `execution: human` の finalize タスクを result 単体で実行・確定するための記録、対象範囲、状態更新の規範を定義します。
13
+
14
+ ## 1. 目的・適用範囲
15
+
16
+ - `execution: human` かつ `approach: finalize` または `bootstrap-finalize` のタスクに適用します。
17
+ - human タスクの作業指示と確認記録を result に一元化し、plan との二重管理を防ぎます。
18
+ - human が確定する文書の対象範囲、検証、`ready` 昇格、差し戻しの判定基準を統一します。
19
+
20
+ ## 2. 基本方針
21
+
22
+ - human タスクでは plan を生成せず、claim 時に生成する result を作業と記録の正本とします。
23
+ - commit 対象は checkpoint 済み result frontmatter の `targets` から導出します。
24
+ - `done_criteria` の確認、確定対象、確定判断、備考は一つの result に記録します。
25
+
26
+ ## 3. Result の規範
27
+
28
+ ### 3.1. Frontmatter
29
+
30
+ | 項目 | 必須 | 規範 |
31
+ | ----------- | ---- | --------------------------------------------------------------- |
32
+ | `execution` | ○ | `human` とする |
33
+ | `task_id` | ○ | claim した schedule task ID と一致させる |
34
+ | `mode` | ○ | task の mode と一致させる |
35
+ | `approach` | ○ | `finalize` または `bootstrap-finalize` とする |
36
+ | `targets` | ○ | 主成果物を先頭にし、確定対象となる実践の型を続ける |
37
+ | `plan_ref` | - | human task では plan が存在しないため記載しない |
38
+ | `status` | ○ | claim 時は `in_progress`、完了結果に応じて lifecycle が更新する |
39
+
40
+ ### 3.2. 本文
41
+
42
+ - 「確認チェックリスト」には catalog の全 `done_criteria` を重複なく展開します。
43
+ - 「確定対象」には `targets` から解決した実在文書を列挙し、確認と `ready` 昇格後にチェックします。
44
+ - 「確定判断」は承認または差し戻しのどちらかを実値で記録し、プレースホルダを残しません。
45
+ - `bootstrap-finalize` では実践の型の種別別確認を追加し、対象に存在しない種別の行は削除します。
46
+
47
+ ## 4. 対象範囲と確定の判定基準
48
+
49
+ | 判定対象 | 承認できる条件 | 差し戻す条件 |
50
+ | --------------- | ------------------------------------------------------- | -------------------------------------------------- |
51
+ | `done_criteria` | 全項目について完成版の充足を確認した | 未充足または確認不能の項目が一つ以上ある |
52
+ | 確定対象 | `targets` の全対象を確認し、必要な `ready` 昇格を終えた | 対象解決不能、未確認、未昇格が一つ以上ある |
53
+ | 実践の型 | 対象種別の確認が完了し、成果物との整合が取れている | 再利用性の劣化または成果物との不整合がある |
54
+ | 検証 | 対象形式に必要な整形、静的検査、schema 検証が成功した | 必要な検証が未実施またはエラーのままである |
55
+ | result 記録 | チェック、判断、必要な備考が実際の結果で埋まっている | プレースホルダ、未記入、判断とチェックの矛盾がある |
56
+
57
+ ## 5. 文書状態と記法
58
+
59
+ - 承認する場合は、確定対象の frontmatter `status` を `ready` に更新します。
60
+ - 差し戻す場合は未確定対象を `ready` に昇格させず、理由と次の行動を result に記録します。
61
+ - 既存文書への参照は `[[id|title]]` とし、表セル内では `[[id\|title]]` と記載します。
62
+ - 存在しない文書は wikilink にせず、ID またはファイル名をバッククォートで仮置きします。
63
+
64
+ ## 6. 禁止事項
65
+
66
+ - human task 用 plan を生成または作業の正本として維持しません。result との二重管理を生むためです。
67
+ - `targets` に含まれない文書を、根拠なく commit または `ready` 昇格の対象へ追加しません。
68
+ - 未確認のチェック項目、`_TODO_`、空の確定判断を残したまま承認しません。
69
+ - agent 実行を human 確定の代替にしません。`ready` 昇格は human の判断ゲートだからです。
70
+
71
+ ## 7. 運用・見直しルール
72
+
73
+ - result の項目を変更するときは、exec result schema、human result template、commit scope 解決を同時に確認します。
74
+ - `done_criteria` の展開規則を変更するときは、catalog と finalize result の対応が一対一か検証します。
75
+ - human と agent の実行境界を変更するときは、`ready` 昇格ガードと脅威モデルの記述を見直します。