specdojo 0.4.7 → 0.6.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 (312) hide show
  1. package/.github/agents/specdojo-orchestrator.md +16 -9
  2. package/CHANGELOG.md +106 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +4 -0
  5. package/dist/commands/night-orchestrator.js +33 -4
  6. package/dist/dashboard/dashboard.js +5 -6
  7. package/dist/dashboard/timeline-build.js +5 -1
  8. package/dist/dashboard/timeline.js +6 -3
  9. package/dist/deliverable/deliverable.js +77 -4
  10. package/dist/docs/yaml-pages.js +17 -17
  11. package/dist/exec/core.js +3 -0
  12. package/dist/exec/parent-validation.js +7 -0
  13. package/dist/exec/pipeline-state.js +5 -2
  14. package/dist/exec/plans-core.js +49 -3
  15. package/dist/exec/plans-generation.js +48 -8
  16. package/dist/exec/plans-grade-findings.js +16 -0
  17. package/dist/exec/plans-planning.js +43 -0
  18. package/dist/exec/plans-storage.js +6 -2
  19. package/dist/exec/product-branch-records.js +105 -0
  20. package/dist/exec/product-branches.js +52 -0
  21. package/dist/exec/register-product-message.js +50 -0
  22. package/dist/exec/register.js +22 -1
  23. package/dist/exec/repo-integration-sync.js +11 -0
  24. package/dist/exec/repo-integration.js +58 -6
  25. package/dist/exec/repo-trace.js +19 -4
  26. package/dist/exec/results.js +11 -5
  27. package/dist/exec/run/register-command.js +16 -0
  28. package/dist/exec/run/register-core.js +11 -0
  29. package/dist/exec/run/register-mode.js +19 -1
  30. package/dist/exec/run/register-resume.js +33 -1
  31. package/dist/exec/run/register-worktree.js +52 -8
  32. package/dist/exec/run/schedule-prepare.js +7 -3
  33. package/dist/exec/strategy.js +4 -1
  34. package/dist/exec/task-repos.js +92 -16
  35. package/dist/exec/worktree-command.js +2 -2
  36. package/dist/exec/worktree-ops-commit.js +7 -1
  37. package/dist/exec/worktree.js +3 -3
  38. package/dist/grade/apply.js +6 -2
  39. package/dist/grade/markdown.js +7 -2
  40. package/dist/grade/plan.js +6 -4
  41. package/dist/register/approach.js +19 -0
  42. package/dist/register/catalog-status.js +49 -0
  43. package/dist/register/core.js +8 -0
  44. package/dist/register/create-commands.js +86 -4
  45. package/dist/register/deliverable-target.js +24 -17
  46. package/dist/register/dependency.js +123 -0
  47. package/dist/register/derivation.js +2 -2
  48. package/dist/register/epic.js +42 -0
  49. package/dist/register/event-merge.js +9 -2
  50. package/dist/register/events.js +10 -0
  51. package/dist/register/external-project.js +6 -0
  52. package/dist/register/input.js +168 -0
  53. package/dist/register/item.js +71 -0
  54. package/dist/register/maintenance-commands.js +7 -1
  55. package/dist/register/planning.js +37 -0
  56. package/dist/register/register.js +7 -3
  57. package/dist/register/renumber.js +16 -4
  58. package/dist/register/update.js +6 -0
  59. package/dist/register/views.js +55 -4
  60. package/dist/schedule/approach.js +9 -0
  61. package/dist/schedule/schedule.js +3 -1
  62. package/dist/schedule/strategy-generate-scope.js +5 -1
  63. package/dist/schedule/strategy-generate.js +1 -0
  64. package/dist/schedule/strategy-profiles.js +22 -2
  65. package/dist/shared/agent-types.js +7 -1
  66. package/dist/shared/branch-template.js +26 -0
  67. package/dist/shared/commit-message-template.js +38 -0
  68. package/dist/shared/commit-types.js +15 -0
  69. package/dist/shared/grade-result.js +23 -5
  70. package/dist/shared/markdownlint-config.js +38 -0
  71. package/dist/shared/markdownlint-scaffold.js +2 -9
  72. package/dist/shared/specdojo-config.js +42 -4
  73. package/dist/shared/specdojo-gitignore.js +4 -0
  74. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  75. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  76. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  77. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  78. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  79. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  80. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  81. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  82. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  83. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  84. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  85. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  86. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  87. package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
  88. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  89. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  90. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  91. package/docs/ja/specdojo/guides/register-operation-guide.md +58 -16
  92. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  93. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  94. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  95. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  96. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  97. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  98. package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
  99. package/docs/ja/specdojo/references/command-reference.md +86 -15
  100. package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -8
  101. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  104. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  105. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  106. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  107. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  108. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  109. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  110. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  116. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  117. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  118. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  120. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  121. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  122. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  123. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  124. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  125. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  126. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  127. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -0
  128. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  129. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  130. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  131. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  134. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  135. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  136. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  137. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  138. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  139. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  140. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  148. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  150. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  151. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  152. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  153. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  154. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  155. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  156. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  157. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  158. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  159. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  160. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  161. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  165. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +54 -36
  167. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  168. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  173. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  174. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  176. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  178. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  179. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  180. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  181. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  182. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  183. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  184. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  185. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  186. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  187. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +4 -1
  188. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  189. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  190. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  191. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  192. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  193. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  194. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  195. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  196. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  197. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  198. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  199. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  200. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  201. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  202. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  203. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  204. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  205. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  206. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  207. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  208. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  212. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  227. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  232. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  234. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  235. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  236. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  237. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  238. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  241. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  242. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  243. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  244. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  245. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  246. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  247. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  248. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  249. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  250. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  251. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  252. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  253. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  254. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  255. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  256. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  257. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  258. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  259. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  260. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  261. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  262. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  263. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  264. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  265. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  266. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  267. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  268. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  269. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  270. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  271. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  272. package/docs/ja/specdojo/standards/document-metadata-standard.md +44 -3
  273. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  274. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  275. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  276. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  277. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  278. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
  279. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  280. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  281. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  282. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  283. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  284. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  285. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  286. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  287. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  288. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  289. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  290. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  291. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  292. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  293. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  294. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  295. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  296. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  297. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  298. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  299. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  300. package/docs/specdojo/schemas/v1/register-events.schema.yaml +21 -0
  301. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
  302. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  303. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  304. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
  305. package/package.json +4 -3
  306. package/templates/antigravity/orchestrator.md +16 -9
  307. package/templates/claude/agents/specdojo-orchestrator.md +16 -9
  308. package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
  309. package/templates/codex/orchestrator.md +16 -9
  310. package/templates/copilot/README.md +2 -1
  311. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  312. package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
@@ -16,7 +16,7 @@ Markdown の Frontmatter と YAML・JSON の構造化メタデータに関する
16
16
  - 共通原則: Frontmatter を持つすべての Markdown ドキュメント
17
17
  - 独立 YAML データファイル向け規約: SpecDojo スキーマ(`docs/specdojo/schemas/v1/`)を持つ YAML 成果物(`dct-*.yaml` / `pm-*.yaml` / `sch-*.yaml` / `bdd-*.yaml` など)
18
18
  - JSON データファイル向け規約: SpecDojo が管理する JSON 文書、実行イベント、設定、インデックス、生成物
19
- - 成果物向け詳細規約: `project` / `flow` / `rule` / `data` / `ui` / `api` / `architecture` / `test` / `operations` / `template` / `sample`
19
+ - 成果物向け詳細規約: `project` / `requirement` / `glossary` / `flow` / `rule` / `data` / `ui` / `api` / `architecture` / `test` / `operations` / `template`
20
20
  - 成果物スキーマ: [deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
21
21
 
22
22
  `rulebook` / `recipe` / `guide` / `reference` / `standard` / `philosophy` は専用スキーマを持つため、成果物向け詳細規約の対象外とします。それぞれの追加規約は次を正本とします。
@@ -36,6 +36,31 @@ Markdown の Frontmatter と YAML・JSON の構造化メタデータに関する
36
36
  - `id` は共通スキーマの `idRef` に従い、`^[a-z0-9][a-z0-9-:]*$` に一致させる。
37
37
  - npm package が所有する型(Kata)の文書の `id` は `<authority>:<local-id>` とし、SpecDojo core は `specdojo:` を使用する。これは Frontmatter の親キー `specdojo:` とは別に、ID値の所有元を表す namespace である。
38
38
  - `type` は各ドキュメント種別のスキーマに定義された値を使用する。
39
+ - 成果物の `type` は次の意味で選び、準拠する rulebook の `specdojo.deliverable_type` を正本とする。index も扱う内容と同じ分類にする。
40
+
41
+ | 値 | 意味 |
42
+ | -------------- | ---------------------------------------------------------------------------- |
43
+ | `project` | プロジェクトの計画・体制・登録簿・進捗・管理ビュー(prj・pm・dct・tml など) |
44
+ | `requirement` | システム機能、業務イベントの要求、非機能要件、業務・システムの受入基準 |
45
+ | `glossary` | 用語と定義を管理する用語集 |
46
+ | `flow` | 業務フロー・プロセス・概念データフロー |
47
+ | `rule` | 業務の判断条件・規則 |
48
+ | `data` | データ構造・概念モデル・状態・保管・データ移行設計 |
49
+ | `ui` | 画面・帳票の仕様 |
50
+ | `api` | API・コマンド・ファイル・メッセージなど外部 I/F の契約 |
51
+ | `architecture` | システム構成・設計・技術選定 |
52
+ | `test` | テスト戦略・設計・ケース・実施計画 |
53
+ | `operations` | 運用設計・手順・本番切替・運用移管 |
54
+
55
+ - `project` をプロダクト仕様の受け皿にしない。sample は見本にする成果物の `type` を使い、`id` とファイル名の `-sample` で識別する。`template` はテンプレート自身の種別であり、生成物の種別ではない。
56
+ - `lint:fm` の frontmatter 検査では、Markdown 成果物・sample の `specdojo.type` と、テンプレートの `specdojo.frontmatter_template.specdojo.type` をそれぞれの `rulebook` の宣言と照合する。宣言と異なる値(従来の `project` や `sample` を含む)は即時エラーとし、宣言された置き換え先を表示する。`rulebook: none` は照合対象外とする。
57
+ - 照合は主 rulebook の宣言を使い、`includes` はたどらない。rulebook は完全 ID で解決し、同じ ID のローカル文書を同梱文書より優先する。解決不能・曖昧・宣言欠落は検査エラーとする。未修飾 ID は一意に解決できる場合のみ許容する。
58
+ - `validate:schema:yaml`(`yaml-schema --modeline`)と `validate:schema:file` は、YAML 成果物・sample のトップレベルまたは `x-spec-meta` の `type` と、テンプレートの `metadata_template.type` を主 rulebook の宣言と照合する。`specdojo-schema: none` / `validate=false` は構造の検証だけを省略し、メタ情報の照合は省略しない。平坦な YAML catalog テンプレートは生成物のメタ情報雛形を持たないため、その `type: template` は照合しない。
59
+ - YAML メタ情報の旧値 `domain` / `command` / `message` は `rulebook: none` の場合もエラーとし、それぞれ `data` / `api` / `api` への置き換えを表示する。本文中のデータ型や CloudEvents のイベント種別は対象外とする。
60
+ - YAML の表示用ページ(`generated/` 配下)は元 YAML のトップレベルまたは `x-spec-meta` の `type` を引き継ぐ。配置パスから分類を補わず、欠落も補完しない。生成ページも `lint:fm` の宣言照合対象とする。ただし、ジョブ定義・評価記録など `type` を持たない YAML の表示用ページは成果物 Frontmatter を付けずに生成する。これらの表示ページは Markdown の Frontmatter 必須原則の対象外とし、正本 YAML の構造・メタ情報は対応する schema と YAML 検証を正本とする。
61
+ - 成果物として成り立つ文書の `type` は、中身の種類(`project` / `flow` / `data` など)を表す。成果物として成り立たない実践の型(rulebook / recipe / template など)の `type` は、その役割を表す。
62
+ - sample は完成した成果物の最小例であり、Markdown・YAML・JSON とも、`type` には見本にする成果物の type を書く。sample であることは `id` とファイル名の `-sample`、`samples/` への配置、対応 rulebook の `sample` 宣言で表す。
63
+ - sample のメタ情報と本文は成果物と同じ形式にし、文書索引で実物の成果物と衝突しないよう `id` を区別する。既存の `type: sample` は schema 上の互換値として保持するが、新規作成・更新では使用しない。rulebook を持つ Markdown・YAML sample は宣言との照合でエラーになるため、宣言された成果物の type へ移行する。
39
64
  - `status` は `draft` / `ready` / `deprecated` のいずれかとする。
40
65
  - ドキュメント名は Frontmatter ではなく本文先頭の H1 に記述する。
41
66
  - `specdojo:` 名前空間の対象は Markdown Frontmatter のみとする。独立 YAML データファイル(`dct-*.yaml` / `pm-*.yaml` / `sch-*.yaml` など)は Markdown ではなく他ツールとの同居も無いため、名前空間化せずトップレベルに項目を置く。
@@ -116,6 +141,22 @@ specdojo:
116
141
  - 生成時プレースホルダは `frontmatter_template` と本文の相互参照の両方に現れ、生成処理が一括置換する。
117
142
  - 記入プレースホルダは生成物に残し、recipe に従って作成者が埋める。生成処理は置換しない。
118
143
 
144
+ ### 2.4. 文脈の目印
145
+
146
+ - 本文の斜体は、共通の目印 `_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` / `_CONTEXT_` に限って使用する。
147
+ - `_CONTEXT_` は、成果物を下書きするために人が記入する前提や調査・選定の指示を示す。適用する場所の段落の先頭に `_CONTEXT_:` と書く。文書全体にかかる指示は先頭の章に置き、文脈専用の章は増やさない。
148
+ - 一つの指示は一つの段落にまとめる。記法の説明や元の指示の引用では、インラインコードまたはコードブロックを使い、未反映の指示と区別する。
149
+ - `draft` は指示を本文へ反映した後、その段落から目印と元の指示を消し、元の指示と反映箇所を result に記録する。反映できない指示は残し、理由と次の行動を記録する。executor / reporter pipeline では元の指示と反映箇所を executor の報告の `handoff` に記載し、reporter と runner が result へ転記する。
150
+ - `fully-guided` は残った指示を反映・削除せず、未反映の指示と必要な下書きを論点として result に記録し、`draft` へ申し送る。
151
+ - `finalize` / `bootstrap-finalize` は、確定対象に未反映の指示が残っていれば承認せず差し戻す。
152
+ - `lint:fm` の `remark-md-content` は、コード例を除き段落先頭の `_CONTEXT_:` を検出する。Frontmatter の `specdojo.status` が `ready` なら error、それ以外(状態の指定なしを含む)は情報とする。
153
+
154
+ ```markdown
155
+ ## 1. 概要
156
+
157
+ _CONTEXT_: 静的サイトに適した技術を調べ、候補と選定理由を提案する。
158
+ ```
159
+
119
160
  ## 3. 独立 YAML データファイルのメタ情報
120
161
 
121
162
  独立 YAML データファイルは Frontmatter を持たないため、ファイル先頭のトップレベル項目でメタ情報を表す。
@@ -126,7 +167,7 @@ specdojo:
126
167
  - `rulebook` を必須とし、準拠する rulebook の ID を指定する。該当する rulebook がない場合のみ `none` を許可する(成果物の必須項目と同じ制約)。
127
168
  - YAML catalog テンプレート(`dct-*-template.yaml`)では、`title` / `rulebook` は生成物側フィールドとして生成物の値を平坦に記述する(テンプレート自身のメタ情報と生成物 Frontmatter の分離を参照)。それ以外のテンプレート(`*-template.yaml`)では、`title` はテンプレート自身の名前を実値で記述し、生成物のメタ情報は `metadata_template` に記述する(本標準 `生成物メタ情報雛形(metadata_template)`)。
128
169
  - 上記以外の項目(`based_on` / `supersedes` / `version` / `project_id` など)の許可項目と型は各スキーマを正本とする。
129
- - OpenAPI / AsyncAPI など外部標準形式の YAML(`ifx-*` 等)は本規約の対象外とし、`info.title` や `x-spec-meta` など各形式の慣行に従う。
170
+ - OpenAPI / AsyncAPI など外部標準形式の YAML(`ifx-*` 等)は配置について各形式の慣行に従い、表題は `info.title`、`id` / `type` / `status` / `rulebook` は `x-spec-meta` に置く。`type` は主 rulebook の宣言と照合する。
130
171
 
131
172
  ```yaml
132
173
  id: prj-0001:pm-roles
@@ -251,7 +292,7 @@ specdojo:
251
292
 
252
293
  ### 6.2. 継続品質評価(`grade`)
253
294
 
254
- Markdown 文書の最新の継続品質評価は、プロジェクトの `<execution_path>/grade/results/<doc-id>.yaml` にサイドカーとして記録します。成果物の Frontmatter と本文には grade や finding を書き込みません。サイドカーは最新状態のスナップショットであり、`specdojo grade apply` は文書 ID ごとの同じファイルを冪等に上書きします。履歴は Job Run と evidence、合意形成は review result が担います。成果物の現在品質を参照するときは、サイドカーの `content_hash` が現在のファイル全体と一致することを確認します。
295
+ Markdown 文書の最新の継続品質評価は、プロジェクトの `<execution_path>/grade/results/` 配下にサイドカーとして記録します。本リポジトリの文書は `<doc-id>.yaml`、`project.repos` に宣言したリポジトリの文書は `<repo 名>/<doc-id>.yaml` に保存し、`<repo 名>` には `repos[].name`、ファイル名には文書 ID の `:` を `.` に置き換えた値を使います。成果物の Frontmatter と本文には grade や finding を書き込みません。サイドカーは最新状態のスナップショットであり、`specdojo grade apply` は同じリポジトリ・文書 ID のファイルを冪等に上書きします。履歴は Job Run と evidence、合意形成は review result が担います。成果物の現在品質を参照するときは、サイドカーの `content_hash` が現在のファイル全体と一致することを確認します。
255
296
 
256
297
  | 項目 | 意味 |
257
298
  | ------------------- | ------------------------------------------------------------------------------------ |
@@ -40,6 +40,7 @@ Human Finalize Execution Standard
40
40
  ### 3.2. 本文
41
41
 
42
42
  - 「確認チェックリスト」には catalog の全 `done_criteria` を重複なく展開します。
43
+ - 「確認チェックリスト」には、確定対象の本文に未反映の `_CONTEXT_:` が残っていないことを含めます。残っていれば承認せず、理由を result に記録して `draft` へ差し戻します。
43
44
  - 「確定対象」には `targets` から解決した実在文書を列挙し、確認と `ready` 昇格後にチェックします。
44
45
  - 「確定判断」は承認または差し戻しのどちらかを実値で記録し、プレースホルダを残しません。
45
46
  - `bootstrap-finalize` では実践の型の種別別確認を追加し、対象に存在しない種別の行は削除します。
@@ -104,6 +104,7 @@ specdojo:
104
104
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
105
105
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
106
106
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
107
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
107
108
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
108
109
 
109
110
  ## 7. 禁止事項
@@ -113,7 +114,7 @@ specdojo:
113
114
  - 規範(must ルール・規約)を guide で新規に定義しない。standard / rulebook を正本とする。
114
115
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
115
116
  - デッドリンクを記載しない。
116
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
118
  - `導入ブロック` の3ブロックを省略しない。ラベル名を変えない。順序を入れ替えない。
118
119
  - 全 guide / reference を並べた目的別の横断一覧を、`specdojo:specdojo-overview-guide` 以外に置かない。
119
120
 
@@ -442,6 +442,8 @@ IDには、次の情報を含めない。
442
442
  - `<subject>`: 文書の主題を表す名詞句
443
443
  - `<type-suffix>`: `guide`、`standard`、`reference`、`philosophy`、`rulebook`、`recipe`、`sample`、`template`
444
444
 
445
+ sample の種類の判定は `id` の local-id の末尾 `-sample` で行います。`type` は見本にする成果物の type とします(正本: [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]])。この規則は利用者の authority の sample にも適用します。
446
+
445
447
  - package の所有元は `specdojo:` のような authority で表し、local-id に `specdojo-` のような所属接頭辞を重ねない。
446
448
  - ただし SpecDojo 自体を主題とする文書は、主題語として `specdojo` を用いる。
447
449
 
@@ -95,6 +95,7 @@ specdojo:
95
95
  - 比較・対応・区別など、見比べる情報は表に置く。
96
96
  - 例を用いる場合は、[sample-authoring-standard.md](sample-authoring-standard.md) の `共通サンプル文脈` に合わせる。
97
97
  - 未確定事項や仮置き情報は、`_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` のラベルで記述する。
98
+ - 下書きへの指示には `_CONTEXT_:` を使う。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
98
99
 
99
100
  ## 7. 禁止事項
100
101
 
@@ -71,6 +71,7 @@ Recipe Authoring Standard
71
71
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
72
72
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
73
73
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
74
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
74
75
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
75
76
 
76
77
  ### 5.1. Why・What・How・Trace の共通原則
@@ -134,7 +135,7 @@ Why は What の必要性を説明し、What は How が満たすべき境界を
134
135
  - rulebook / recipe / sample / template の種別ごとの役割分担表を recipe 本文に置かない(実践の型全体の役割は [kata-guide.md](../guides/kata-guide.md) が扱う)。
135
136
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
136
137
  - recipe 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
137
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
139
 
139
140
  ## 8. 運用ルール
140
141
 
@@ -32,22 +32,26 @@ Rulebook Authoring Standard
32
32
  - ファイル名は `<prefix>-rulebook.md` とする。
33
33
  - `id` / `type` / `status` を必須とし、共通原則は [document-metadata-standard.md](document-metadata-standard.md) に従う。
34
34
  - `type` は `rulebook` 固定とする。
35
+ - `deliverable_type` は必須とし、扱う成果物の `type` を一つ宣言する。値の意味は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`template` / `sample` は成果物の分類ではないため宣言しない。
35
36
  - `id` はauthority、英小文字・数字・ハイフンで構成し、一意にする(正確な制約は参照スキーマに従う)。
36
37
  - `status` は `draft` / `ready` / `deprecated` のいずれかとする。
37
38
 
38
- | 項目 | 必須 | 説明 |
39
- | ------------- | ---- | ---------------------------------------------------------------------------------------------------- |
40
- | id | ○ | 同梱は `specdojo:<prefix>-rulebook`、利用者作成は `<kata_authority>:<prefix>-rulebook` 形式の一意 ID |
41
- | type | ○ | `rulebook` 固定 |
42
- | status | ○ | `draft` / `ready` / `deprecated` |
43
- | target_format | 任意 | 対象ドキュメントのフォーマット(`yaml` / `json` / `markdown`) |
44
- | recipe | 任意 | 対応する recipe の完全 ID、`undecided`、`not-needed` |
45
- | sample | 任意 | 対応する sample の完全 ID または ID 配列、上記2状態 |
46
- | template | 任意 | 対応する template の完全 ID、`undecided`、`not-needed` |
47
- | based_on | 任意 | 上位規約や根拠ドキュメント |
48
- | supersedes | 任意 | 置き換え関係 |
39
+ | 項目 | 必須 | 説明 |
40
+ | ------------------ | ---- | --------------------------------------------------------------------------------------------------------------------------------------- |
41
+ | id | ○ | 同梱は `specdojo:<prefix>-rulebook`、利用者作成は `<kata_authority>:<prefix>-rulebook` 形式の一意 ID |
42
+ | type | ○ | `rulebook` 固定 |
43
+ | `deliverable_type` | ○ | 成果物の種別。`project` / `requirement` / `glossary` / `flow` / `rule` / `data` / `ui` / `api` / `architecture` / `test` / `operations` |
44
+ | status | ○ | `draft` / `ready` / `deprecated` |
45
+ | target_format | 任意 | 対象ドキュメントのフォーマット(`yaml` / `json` / `markdown`) |
46
+ | recipe | 任意 | 対応する recipe の完全 ID、`undecided`、`not-needed` |
47
+ | sample | 任意 | 対応する sample の完全 ID または ID 配列、上記2状態 |
48
+ | template | 任意 | 対応する template の完全 ID、`undecided`、`not-needed` |
49
+ | based_on | 任意 | 上位規約や根拠ドキュメント |
50
+ | supersedes | 任意 | 置き換え関係 |
49
51
 
50
52
  - `target_format` が未記載の場合は markdown を対象とみなす。
53
+ - `deliverable_type` は format・成熟度によらず全 rulebook に必要とする。index は扱う内容で分類し、`project` はプロジェクトの管理文書に限る。Mermaid など `includes` で適用される記法部品も、扱う成果物の種別を宣言する。
54
+ - `lint:fm` は Markdown 成果物・sample・テンプレートの生成物 Frontmatter(`frontmatter_template`)を、主 rulebook の宣言と照合する。テンプレート自身の `type: template` は照合しない。宣言との不一致、宣言欠落、参照の解決不能・曖昧さはエラーとし、不一致には宣言値を示す。YAML 成果物・sample とテンプレートの `metadata_template` は YAML schema 検証時に同じ宣言と照合し、外部形式の `x-spec-meta` も対象とする。構造検証を省略する指示でも照合は省略しない。YAML の表示用ページは正本の `type` を引き継ぎ、`lint:fm` の照合対象とする。
51
55
  - `recipe` / `sample` / `template` は要否と所在の正本であり、`undecided` は要否未判断、項目省略は必要だが未整備、完全 ID は必要かつ整備済み、`not-needed` は不要を表す。
52
56
  - 完全 ID は `fully-guided` / `recipe-guided` の plan 生成で参照先パスの解決に使う(rulebook を参照ハブとする)。命名規約に従う場合も明示的に宣言し、宣言された参照先ファイルが存在しないと `exec validate` が警告する。`sample` の拡張子は `target_format` に従う。
53
57
  - 同じ rulebook 系統に複数の完成例がある場合、`sample` を ID 配列で宣言する。配列の先頭を既定例として使う。
@@ -60,6 +64,7 @@ Rulebook Authoring Standard
60
64
  specdojo:
61
65
  id: specdojo:imp-business-rulebook
62
66
  type: rulebook
67
+ deliverable_type: project
63
68
  status: draft
64
69
  ---
65
70
  ```
@@ -106,6 +111,7 @@ specdojo:
106
111
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
107
112
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
108
113
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
114
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
109
115
  - `サンプル` 章を置く場合は、最小例をコードブロックで本文内に自己完結して埋め込む。sample ファイルの要否と所在は Frontmatter の `sample` で宣言し、本文にリンクを記載しない。
110
116
  - template が不要な場合は Frontmatter へ `template: not-needed`、要否未判断なら `template: undecided` を宣言する。項目省略は必要だが未整備を表す。いずれも `deliverable scaffold` は最小雛形へ退避する。
111
117
 
@@ -126,7 +132,7 @@ specdojo:
126
132
  - 本文に sample / recipe / template への wikilink・リンク章を置かない。対応関係は Frontmatter の `sample` / `recipe` / `template` で示す。
127
133
  - rulebook 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
128
134
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
129
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
135
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
130
136
  - 確定済みの内容をラベル付きのまま放置したり、ラベルを本文の代替として多用したりしない。
131
137
 
132
138
  ## 8. 運用ルール
@@ -105,6 +105,7 @@ sample は実在プロジェクトの記録ではありません。記載値は
105
105
 
106
106
  - ファイル名は `<prefix>-sample.md` / `<prefix>-sample.yaml` / `<prefix>-sample.json` とし、対応 rulebook の `target_format` に合わせる。
107
107
  - `target_format` が未記載の場合は markdown を対象とみなす。
108
+ - [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、`type` は見本にする成果物の type とする。sample であることは `id` とファイル名の `-sample` で表す。
108
109
  - Markdown の場合、H1 はファイル内で 1 つだけとし、`id` / `type` / `status` / `rulebook` を含む Frontmatter を先頭に置く。
109
110
  - YAML / JSON の場合、対応 rulebook が定める先頭メタ項目・ルートキー・必須キーを満たす。
110
111
 
@@ -82,6 +82,7 @@ specdojo:
82
82
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
83
83
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
84
84
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
85
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
85
86
 
86
87
  ## 6. 内容充実化(薄いドキュメント防止)
87
88
 
@@ -99,7 +100,7 @@ specdojo:
99
100
  - 手順・操作・使い方など guide が担う説明を standard の主目的にしない。
100
101
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
101
102
  - schema で機械検証する制約を本文に二重定義し、両者を乖離させない。
102
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
104
 
104
105
  ## 8. 運用ルール
105
106
 
@@ -10,7 +10,7 @@ title: 外部コマンド連携仕様テンプレート
10
10
  rulebook: none
11
11
  metadata_template:
12
12
  id: ifx-cmd-_TERM_
13
- type: command
13
+ type: api
14
14
  status: draft
15
15
  title: _COMMAND_SPEC_TITLE_
16
16
  rulebook: specdojo:ifx-cmd-rulebook
@@ -27,7 +27,13 @@ specdojo:
27
27
  | 申請日 | _TODO_ |
28
28
  | 変更理由 | _TODO_ |
29
29
 
30
- ## 2. 影響評価
30
+ ## 2. 入力
31
+
32
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
33
+
34
+ -
35
+
36
+ ## 3. 影響評価
31
37
 
32
38
  | 観点 | 影響 |
33
39
  | ------------ | ------ |
@@ -37,7 +43,7 @@ specdojo:
37
43
  | 品質 | _TODO_ |
38
44
  | 運用 | _TODO_ |
39
45
 
40
- ## 3. 審査・決定
46
+ ## 4. 審査・決定
41
47
 
42
48
  | 項目 | 内容 |
43
49
  | -------- | --------------------------------- |
@@ -46,7 +52,7 @@ specdojo:
46
52
  | 決定日 | _TODO_ |
47
53
  | 実施条件 | _TODO_ |
48
54
 
49
- ## 4. 実施追跡
55
+ ## 5. 実施追跡
50
56
 
51
57
  | 項目 | 内容 |
52
58
  | -------- | ------ |
@@ -55,6 +61,6 @@ specdojo:
55
61
  | 完了条件 | _TODO_ |
56
62
  | 対応結果 | _TODO_ |
57
63
 
58
- ## 5. 関連ドキュメント
64
+ ## 6. 関連ドキュメント
59
65
 
60
66
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -0,0 +1,22 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:pjr-dependent-items-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _PROJECT_ID_:pjr-dependent-items
9
+ type: project
10
+ status: ready
11
+ rulebook: specdojo:pjr-rulebook
12
+ part_of:
13
+ - _PROJECT_ID_:pjr-index
14
+ ---
15
+
16
+ # 登録項目の実行依存
17
+
18
+ > このファイルは個票の `depends_on` から生成された派生ビューです。正本は個票の Frontmatter であり、このファイルは再生成可能です。
19
+
20
+ ## 1. 先行項目から後続項目を辿る
21
+
22
+ <!-- specdojo:view-slot=derived-items -->
@@ -0,0 +1,22 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:pjr-epic-items-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _PROJECT_ID_:pjr-epic-items
9
+ type: project
10
+ status: draft
11
+ rulebook: specdojo:pjr-rulebook
12
+ part_of:
13
+ - _PROJECT_ID_:pjr-index
14
+ ---
15
+
16
+ # epic ごとの子項目
17
+
18
+ > 個票の `derived_from` から生成した直接の子項目と現在の状態です。正本は個票の Frontmatter です。子の完了だけでは epic を自動 close しません。
19
+
20
+ ## 1. epic 別の一覧
21
+
22
+ <!-- specdojo:view-slot=epic-items -->
@@ -0,0 +1,44 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:pjr-epic-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _PJR_DOCUMENT_ID_
9
+ type: project
10
+ status: draft
11
+ rulebook: specdojo:pjr-rulebook
12
+ part_of:
13
+ - _PROJECT_ID_:pjr-index
14
+ item_type: epic
15
+ track: track-id
16
+ item_status: open
17
+ priority: medium
18
+ ---
19
+
20
+ # _PJR-XXXX_ _EPIC_TITLE_
21
+
22
+ ## 1. 概要
23
+
24
+ _TODO_: track で達成する目的と着手の理由を記載する。
25
+
26
+ ## 2. 範囲(track と domain)
27
+
28
+ _TODO_: Frontmatter の `track` が担う範囲と対象 domain、対象外の境界を記載する。
29
+
30
+ ## 3. 完了の判断の基準
31
+
32
+ - _TODO_: 子項目と schedule を確認して、人が完了を判断できる基準を記載する。
33
+
34
+ ## 4. 子項目
35
+
36
+ 子 todo は `register add --type todo --from <epic-id>` で起票する。現在の一覧と状態は `register build` が生成する epic 別ビューで確認する。
37
+
38
+ ## 5. 対応結果
39
+
40
+ _TODO_: 完了を判断した根拠と残課題を記載する。未完了の場合は `-` とする。
41
+
42
+ ## 6. 関連ドキュメント
43
+
44
+ - _TODO_: 根拠・影響先・追跡先を文書 ID で記載する。
@@ -27,8 +27,8 @@ Project Register
27
27
  ## 1. 登録項目一覧
28
28
 
29
29
  <!-- prettier-ignore -->
30
- | ID | ステータス | タイトル | 説明 | 分類 | 優先度 | 担当 | 登録日 | 期限 | 完了日 | 結論 | 個票 |
31
- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
30
+ | ID | ステータス | タイトル | 説明 | 分類 | 優先度 | 担当 | 登録日 | 期限 | 完了日 | 結論 | 個票 | `depends_on` |
31
+ | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
32
32
 
33
33
  ## 2. 派生ビュー
34
34
 
@@ -41,6 +41,8 @@ Project Register
41
41
  - [[pjr-views-by-priority|台帳ビュー(優先度別)]]
42
42
  - [[pjr-views-by-owner|台帳ビュー(担当者別)]]
43
43
  - [[pjr-derived-items|登録項目の派生関係]]
44
+ - [[_PROJECT_ID_:pjr-dependent-items|登録項目の実行依存]]
45
+ - [[_PROJECT_ID_:pjr-epic-items|epic ごとの子項目]]
44
46
 
45
47
  ### 2.2. controls 全体の派生管理ビュー
46
48
 
@@ -22,7 +22,13 @@ specdojo:
22
22
 
23
23
  _TODO_: すでに顕在化している問題、発生日、影響を記載する。
24
24
 
25
- ## 2. 影響範囲
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 影響範囲
26
32
 
27
33
  | 観点 | 影響 |
28
34
  | ------------ | ------ |
@@ -32,7 +38,7 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
32
38
  | 品質 | _TODO_ |
33
39
  | 関係者 | _TODO_ |
34
40
 
35
- ## 3. 対応方針
41
+ ## 4. 対応方針
36
42
 
37
43
  | 項目 | 内容 |
38
44
  | -------- | ------ |
@@ -41,10 +47,10 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
41
47
  | 依存事項 | _TODO_ |
42
48
  | 完了条件 | _TODO_ |
43
49
 
44
- ## 4. 対応結果
50
+ ## 5. 対応結果
45
51
 
46
52
  _TODO_: 解決内容、確認結果、再発防止策を記載する。未解決の場合は `-` とする。
47
53
 
48
- ## 5. 関連ドキュメント
54
+ ## 6. 関連ドキュメント
49
55
 
50
56
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,21 +22,27 @@ specdojo:
22
22
 
23
23
  _TODO_: 確認したい論点を、回答者が判断できる粒度で記載する。
24
24
 
25
- ## 2. 背景
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 背景
26
32
 
27
33
  _TODO_: この確認が必要になった背景、前提、制約を記載する。
28
34
 
29
- ## 3. 回答候補
35
+ ## 4. 回答候補
30
36
 
31
37
  | 候補 | 内容 | 利点 | 懸念 |
32
38
  | ---- | ------ | ------ | ------ |
33
39
  | A | _TODO_ | _TODO_ | _TODO_ |
34
40
 
35
- ## 4. 回答・結論
41
+ ## 5. 回答・結論
36
42
 
37
43
  _TODO_: 回答または採択した方針を記載する。未回答の場合は `-` とする。
38
44
 
39
- ## 5. 承認
45
+ ## 6. 承認
40
46
 
41
47
  | 項目 | 内容 |
42
48
  | -------- | ------ |
@@ -48,6 +54,6 @@ _TODO_: 回答または採択した方針を記載する。未回答の場合は
48
54
  - 承認方式は既定で `commit`(`register close` により `decided` へ遷移)を用いる。
49
55
  - 回答が不可逆・高リスク・framework schema 破壊的変更を伴う場合は `PR` 方式で承認し、証跡に PR URL と merge SHA を記載する。
50
56
 
51
- ## 6. 関連ドキュメント
57
+ ## 7. 関連ドキュメント
52
58
 
53
59
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,7 +22,13 @@ specdojo:
22
22
 
23
23
  _TODO_: 将来発生し得る不確実な事象と、その原因を記載する。
24
24
 
25
- ## 2. 影響評価
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 影響評価
26
32
 
27
33
  | 項目 | 評価 |
28
34
  | -------- | ------------------- |
@@ -31,7 +37,7 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
31
37
  | 影響範囲 | _TODO_ |
32
38
  | 兆候 | _TODO_ |
33
39
 
34
- ## 3. 対応方針
40
+ ## 4. 対応方針
35
41
 
36
42
  | 項目 | 内容 |
37
43
  | ------------------ | ------------------------- |
@@ -40,10 +46,10 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
40
46
  | トリガー | _TODO_ |
41
47
  | エスカレーション先 | _TODO_ |
42
48
 
43
- ## 4. モニタリング
49
+ ## 5. モニタリング
44
50
 
45
51
  _TODO_: 監視周期、確認方法、状態更新の条件を記載する。
46
52
 
47
- ## 5. 関連ドキュメント
53
+ ## 6. 関連ドキュメント
48
54
 
49
55
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,20 +22,26 @@ specdojo:
22
22
 
23
23
  _TODO_: 実施すべき作業と、その作業が必要になった理由を 1〜3 文で記載する。
24
24
 
25
- ## 2. 完了条件
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 完了条件
26
32
 
27
33
  - _TODO_: 完了と判断できる具体的な条件を記載する。
28
34
 
29
- ## 3. 作業内容
35
+ ## 4. 作業内容
30
36
 
31
37
  | No | 作業 | 担当 | 状態 | メモ |
32
38
  | --- | ------ | ------ | ---- | ---- |
33
39
  | 1 | _TODO_ | _TODO_ | open | - |
34
40
 
35
- ## 4. 対応結果
41
+ ## 5. 対応結果
36
42
 
37
43
  _TODO_: 完了時に、実施内容・成果物・残課題を記載する。未完了の場合は `-` とする。
38
44
 
39
- ## 5. 関連ドキュメント
45
+ ## 6. 関連ドキュメント
40
46
 
41
47
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -18,7 +18,7 @@ properties:
18
18
 
19
19
  type:
20
20
  type: string
21
- const: "domain"
21
+ const: "data"
22
22
 
23
23
  title:
24
24
  type: string
@@ -300,6 +300,15 @@ $defs:
300
300
  minLength: 1
301
301
  description: "One-sentence description of the deliverable's purpose."
302
302
 
303
+ brief:
304
+ type: string
305
+ minLength: 1
306
+ description: >
307
+ Optional assumptions or context passed continuously from outside the deliverable
308
+ (e.g., tech stack, architecture constraints, baseline policies).
309
+ Populates the plan's brief field for schedule and register paths.
310
+ Multiple deliverables may share a brief via YAML anchors (&anchor / *anchor).
311
+
303
312
  path:
304
313
  type: string
305
314
  pattern: "^[^\\s]+$"