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
@@ -50,6 +50,20 @@ export const STRATEGY_PHASE_SETS = {
50
50
  "無条件に合わせず result に記録する。",
51
51
  },
52
52
  ],
53
+ "context-pass": [
54
+ {
55
+ id: "context",
56
+ name: "雛形作成・文脈の記入",
57
+ task_suffix: "010",
58
+ duration_days: 0.25,
59
+ execution: "human",
60
+ mode: "edit",
61
+ approach: "draft",
62
+ description: "人が exec claim で着手を記録し、deliverable scaffold --project <project-id> --target <doc-id> で" +
63
+ "雛形を作成する。既存成果物は上書きせず、本文に `_CONTEXT_:` を付けて固定前提、制約、調査・選定を" +
64
+ "任せる範囲を記入する。result に対象と記入内容を記録し、exec complete で draft へ渡す。",
65
+ },
66
+ ],
53
67
  "guided-pass": [
54
68
  {
55
69
  id: "draft",
@@ -58,7 +72,7 @@ export const STRATEGY_PHASE_SETS = {
58
72
  duration_days: 0.5,
59
73
  execution: "agent",
60
74
  mode: "edit",
61
- approach: "fully-guided",
75
+ approach: "draft",
62
76
  pipeline: NORMAL_PIPELINE,
63
77
  description: "必要と宣言され、整備済みの rulebook / recipe / sample / template に沿って草案を作成する。" +
64
78
  "利用可能な実践の型を正本とし、根拠を確認できない内容は書かずに result へ確認事項として残す。",
@@ -157,6 +171,7 @@ export const STRATEGY_PHASE_SETS = {
157
171
  export const PHASE_SET_ORDER = [
158
172
  "bootstrap-pass",
159
173
  "retrofit-pass",
174
+ "context-pass",
160
175
  "guided-pass",
161
176
  "recipe-guided-pass",
162
177
  "freeform-pass",
@@ -200,6 +215,11 @@ export const STRATEGY_PROFILES = {
200
215
  phase_sets: ["guided-pass", "refine-pass", "review-pass", "finalize-pass"],
201
216
  finalize_approach: "finalize",
202
217
  },
218
+ draft: {
219
+ approach: "draft",
220
+ phase_sets: ["context-pass", "guided-pass", "refine-pass", "review-pass", "finalize-pass"],
221
+ finalize_approach: "finalize",
222
+ },
203
223
  "recipe-guided": {
204
224
  approach: "recipe-guided",
205
225
  phase_sets: ["recipe-guided-pass", "refine-pass", "review-pass", "finalize-pass"],
@@ -250,7 +270,7 @@ export const STRATEGY_PROFILES = {
250
270
  };
251
271
  export function profileFor(approach) {
252
272
  if (!(approach in STRATEGY_PROFILES)) {
253
- throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring approaches are register-only`);
273
+ throw new Error(`Approach "${approach}" has no schedule strategy profile; declare phases explicitly or select a supported generated profile`);
254
274
  }
255
275
  return STRATEGY_PROFILES[approach];
256
276
  }
@@ -1,4 +1,6 @@
1
- // タスクの進め方プロファイル。前3者は成果物作業で参考資料をどの程度参照するかを表し、
1
+ // タスクの進め方プロファイル。draft は文脈で任された範囲を調べて下書きし、
2
+ // fully-guided は宣言された参照だけで既存成果物を磨き込む。
3
+ // fully-guided / recipe-guided / freeform は参考資料をどの程度参照するかを表し、
2
4
  // <kind>-maintenance は成果物や finding が指す規範を根拠に対象の参考資料を見直す進め方
3
5
  // (参照の向きが逆転する)。
4
6
  // bootstrap は成果物とその参考資料一式(rulebook/recipe/sample/template)を一貫した一組として
@@ -7,11 +9,15 @@
7
9
  // cross-deliverable-dedup は明示した成果物群を横断して正本を選び、重複を要約と参照へ置換する。
8
10
  // finalize は human が成果物のみを最終確認して status を ready へ確定する進め方、
9
11
  // bootstrap-finalize は bootstrap と対になり、成果物と参考資料一式をまとめて確定する進め方。
12
+ // catalog-planning / strategy-planning は register の domain / track 単位で計画を生成する。
10
13
  export const APPROACHES = [
14
+ "draft",
11
15
  "fully-guided",
12
16
  "recipe-guided",
13
17
  "freeform",
14
18
  "bootstrap",
19
+ "catalog-planning",
20
+ "strategy-planning",
15
21
  "rulebook-authoring",
16
22
  "recipe-authoring",
17
23
  "sample-authoring",
@@ -0,0 +1,26 @@
1
+ import { gitResult } from "./git.js";
2
+ import { validateCommitMessageTemplate } from "./commit-message-template.js";
3
+ export const DEFAULT_BRANCH_TEMPLATE = "exec/{project}-{id}";
4
+ export function isValidBranchName(cwd, branch) {
5
+ return (gitResult(cwd, ["check-ref-format", "--branch", branch]).status === 0 &&
6
+ gitResult(cwd, ["check-ref-format", `refs/heads/${branch}`]).status === 0);
7
+ }
8
+ export function validateBranchTemplate(value, at, cwd) {
9
+ if (value === undefined)
10
+ return [];
11
+ const errors = validateCommitMessageTemplate(value, at);
12
+ if (typeof value !== "string")
13
+ return errors;
14
+ if (!/\{(?:id|topic)\}/.test(value))
15
+ errors.push(`${at} must contain {id} or {topic}`);
16
+ if (/\{(?:branch|target)\}/.test(value))
17
+ errors.push(`${at}: {branch} and {target} are not supported`);
18
+ const sample = value.replace(/\{[^{}]*\}/g, "value");
19
+ if (!isValidBranchName(cwd, sample)) {
20
+ errors.push(`${at} is not a valid Git branch template`);
21
+ }
22
+ return errors;
23
+ }
24
+ export function expandBranchTemplate(template, variables) {
25
+ return template.replace(/\{([^{}]+)\}/g, (_placeholder, key) => variables[key]);
26
+ }
@@ -0,0 +1,38 @@
1
+ /** Variables shared by product commit and merge message templates. */
2
+ export const COMMIT_MESSAGE_VARIABLES = [
3
+ "id",
4
+ "project",
5
+ "topic",
6
+ "type",
7
+ "scope",
8
+ "title",
9
+ "branch",
10
+ "target",
11
+ ];
12
+ /** Validate before a run starts; braces are reserved for the supported placeholders. */
13
+ export function validateCommitMessageTemplate(value, at) {
14
+ if (value === undefined)
15
+ return [];
16
+ if (typeof value !== "string" || !value.trim())
17
+ return [`${at} must be a non-empty string`];
18
+ if (value.includes("\0"))
19
+ return [`${at} must not contain NUL`];
20
+ const errors = [];
21
+ const rest = value.replace(/\{([^{}]*)\}/g, (placeholder, key) => {
22
+ if (!COMMIT_MESSAGE_VARIABLES.includes(key)) {
23
+ errors.push(`${at}: unknown variable ${placeholder}`);
24
+ }
25
+ return "";
26
+ });
27
+ if (/[{}]/.test(rest))
28
+ errors.push(`${at}: malformed placeholder`);
29
+ return errors;
30
+ }
31
+ /** Expand once so placeholder-like text in a title is kept literally. */
32
+ export function expandCommitMessageTemplate(template, variables) {
33
+ const errors = validateCommitMessageTemplate(template, "commit message template");
34
+ if (errors.length > 0)
35
+ throw new Error(errors.join("; "));
36
+ const effective = variables.scope ? template : template.replaceAll("({scope})", "");
37
+ return effective.replace(/\{([^{}]+)\}/g, (_placeholder, key) => variables[key]);
38
+ }
@@ -0,0 +1,15 @@
1
+ /** Commit types supported by register items and their configured defaults. */
2
+ export const VALID_COMMIT_TYPES = [
3
+ "feat",
4
+ "fix",
5
+ "docs",
6
+ "refactor",
7
+ "test",
8
+ "chore",
9
+ "perf",
10
+ "build",
11
+ "ci",
12
+ "style",
13
+ "revert",
14
+ ];
15
+ export const COMMIT_SCOPE_RE = /^[a-z0-9][a-z0-9-]*$/;
@@ -1,8 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
- import { existsSync, readFileSync } from "node:fs";
3
- import { join, resolve } from "node:path";
2
+ import { existsSync, readFileSync, realpathSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve, sep } from "node:path";
4
4
  import { load } from "./yaml.js";
5
- import { getProjectExecutionPath, loadConfig, specdojoRootDir } from "./specdojo-config.js";
5
+ import { getProjectExecutionPath, loadConfig, resolveRepoRoot, specdojoRootDir, } from "./specdojo-config.js";
6
6
  const DOCUMENT_ID_RE = /^[a-z0-9][a-z0-9-:]*$/;
7
7
  export const SEVERITIES = ["blocker", "major", "minor", "note"];
8
8
  function isRecord(value) {
@@ -24,7 +24,7 @@ export function markdownDocumentId(content, path) {
24
24
  return id;
25
25
  }
26
26
  export function resolveGradeResultsDirectory(projectOption, rootDir = specdojoRootDir()) {
27
- const { config } = loadConfig();
27
+ const { config } = loadConfig(rootDir);
28
28
  if (!config)
29
29
  throw new Error("grade commands require .specdojo/specdojo.config.json");
30
30
  const projectId = projectOption?.trim() || config.current_project || Object.keys(config.projects)[0] || "";
@@ -48,7 +48,25 @@ export function gradeResultPathForDocument(opts) {
48
48
  const rootDir = opts.rootDir ?? specdojoRootDir();
49
49
  const absolute = resolve(rootDir, opts.documentPath);
50
50
  const content = readFileSync(absolute, "utf8");
51
- return gradeResultPath(resolveGradeResultsDirectory(opts.project, rootDir), markdownDocumentId(content, opts.documentPath));
51
+ const { config } = loadConfig(rootDir);
52
+ const projectId = opts.project?.trim() || config?.current_project || Object.keys(config?.projects ?? {})[0];
53
+ const project = projectId ? config?.projects[projectId] : undefined;
54
+ const documentRealPath = realpathSync(absolute);
55
+ // 宣言済み repo の実体で判定し、相対・絶対パスや worktree の配置によらず同じ場所を使う。
56
+ const repo = (project?.repos ?? [])
57
+ .map((entry) => {
58
+ const root = resolveRepoRoot(rootDir, entry);
59
+ return { name: entry.name, root: existsSync(root) ? realpathSync(root) : root };
60
+ })
61
+ .sort((a, b) => b.root.length - a.root.length)
62
+ .find(({ root }) => {
63
+ const rel = relative(root, documentRealPath);
64
+ return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
65
+ });
66
+ const resultsDirectory = opts.resultsDirectory
67
+ ? resolve(rootDir, opts.resultsDirectory)
68
+ : resolveGradeResultsDirectory(opts.project, rootDir);
69
+ return gradeResultPath(repo ? join(resultsDirectory, repo.name) : resultsDirectory, markdownDocumentId(content, opts.documentPath));
52
70
  }
53
71
  export function parseGradeResult(content, path) {
54
72
  const parsed = load(content);
@@ -0,0 +1,38 @@
1
+ import { existsSync, readdirSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { dump } from "js-yaml";
4
+ // Keep the fallback result check and every scaffold on the same document rules.
5
+ export const DEFAULT_MARKDOWNLINT_CONFIG = {
6
+ MD013: false,
7
+ MD024: false,
8
+ MD033: false,
9
+ MD036: false,
10
+ MD041: false,
11
+ MD060: false,
12
+ };
13
+ // These are the project files read by markdownlint-cli (CLI2 uses a separate config).
14
+ export function hasMarkdownlintConfig(repoRoot) {
15
+ if (["jsonc", "json", "yaml", "yml"].some((ext) => existsSync(join(repoRoot, `.markdownlint.${ext}`))))
16
+ return true;
17
+ // markdownlint-cli also discovers .markdownlintrc in parent directories.
18
+ for (let dir = repoRoot;; dir = dirname(dir)) {
19
+ if (existsSync(join(dir, ".markdownlintrc")))
20
+ return true;
21
+ if (dirname(dir) === dir)
22
+ return false;
23
+ }
24
+ }
25
+ export function ensureMarkdownlintConfig(repoRoot, dryRun) {
26
+ const hasExistingConfig = readdirSync(repoRoot).some((file) => file.startsWith(".markdownlint.") || file.startsWith(".markdownlint-cli2."));
27
+ if (hasMarkdownlintConfig(repoRoot) || hasExistingConfig) {
28
+ process.stdout.write("Kept existing markdownlint settings.\n");
29
+ return;
30
+ }
31
+ const content = dump(DEFAULT_MARKDOWNLINT_CONFIG);
32
+ if (dryRun) {
33
+ process.stdout.write(`[dry-run] would write: .markdownlint.yaml\n${content}`);
34
+ return;
35
+ }
36
+ writeFileSync(join(repoRoot, ".markdownlint.yaml"), content, { encoding: "utf8", flag: "wx" });
37
+ process.stdout.write("Written: .markdownlint.yaml\n");
38
+ }
@@ -2,14 +2,7 @@ import { existsSync } from "node:fs";
2
2
  import { readdir, writeFile } from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { dump } from "js-yaml";
5
- const BASE_CONFIG = {
6
- MD013: false,
7
- MD024: false,
8
- MD033: false,
9
- MD036: false,
10
- MD041: false,
11
- MD060: false,
12
- };
5
+ import { DEFAULT_MARKDOWNLINT_CONFIG } from "./markdownlint-config.js";
13
6
  // Slide boundaries and per-slide frontmatter interrupt normal Markdown blocks.
14
7
  // Each slide may start with its own H1 or use a heading level chosen for its layout.
15
8
  const SLIDEV_CONFIG = {
@@ -24,7 +17,7 @@ export async function writeMarkdownlintConfigs(opts) {
24
17
  const legacyConfigs = files.filter((file) => file.startsWith(".markdownlint."));
25
18
  const cli2Configs = files.filter((file) => file.startsWith(".markdownlint-cli2."));
26
19
  const hasRc = existsSync(path.join(opts.repoRoot, ".markdownlintrc"));
27
- const rcContent = `${JSON.stringify(BASE_CONFIG, null, 2)}\n`;
20
+ const rcContent = `${JSON.stringify(DEFAULT_MARKDOWNLINT_CONFIG, null, 2)}\n`;
28
21
  const cli2Content = dump({
29
22
  config: { extends: ".markdownlintrc" },
30
23
  ...(opts.slidevKataPatterns?.length
@@ -1,11 +1,15 @@
1
1
  import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
2
2
  import { basename, dirname, isAbsolute, join, posix, relative, resolve } from "node:path";
3
3
  import dotenv from "dotenv";
4
+ import { validateBranchTemplate } from "./branch-template.js";
5
+ import { VALID_COMMIT_TYPES } from "./commit-types.js";
6
+ import { validateCommitMessageTemplate } from "./commit-message-template.js";
4
7
  import { dump, load } from "./yaml.js";
5
8
  import Ajv2020Module from "ajv/dist/2020.js";
6
9
  import { runProviderScaffold, specdojoPackageRootDir } from "./provider-scaffold.js";
7
10
  import { runWorkspaceScaffold } from "./workspace-scaffold.js";
8
11
  import { runLefthookScaffold } from "./lefthook-scaffold.js";
12
+ import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
9
13
  import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
10
14
  import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
11
15
  /** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
@@ -254,9 +258,28 @@ export function getProjectRepos(project) {
254
258
  function isRecord(value) {
255
259
  return typeof value === "object" && value !== null && !Array.isArray(value);
256
260
  }
257
- const REPO_KEYS = new Set(["name", "path", "integration_branch", "setup"]);
261
+ const REPO_KEYS = new Set([
262
+ "name",
263
+ "path",
264
+ "integration_branch",
265
+ "integration_strategy",
266
+ "branch_template",
267
+ "setup",
268
+ "commit_types",
269
+ "commit_subject_template",
270
+ "merge_message_template",
271
+ ]);
258
272
  const REPO_SETUP_KEYS = new Set(["install", "build"]);
259
273
  const EXTERNAL_PROJECT_KEYS = new Set(["path", "project_id"]);
274
+ function validateCommitTypes(value, at) {
275
+ if (value === undefined)
276
+ return [];
277
+ if (!isRecord(value))
278
+ return [`${at} must be an object mapping item types to commit types`];
279
+ return Object.entries(value).flatMap(([itemType, commitType]) => typeof commitType === "string" && VALID_COMMIT_TYPES.includes(commitType)
280
+ ? []
281
+ : [`${at}.${itemType} must be one of: ${VALID_COMMIT_TYPES.join(", ")}`]);
282
+ }
260
283
  /** Resolve a configured external-project repository from the SpecDojo root. */
261
284
  export function resolveExternalProjectRoot(rootDir, project) {
262
285
  return resolve(rootDir, project.path);
@@ -338,6 +361,11 @@ export function validateProjectRepos(projectId, project, projectIds, rootDir) {
338
361
  if (!REPO_KEYS.has(key))
339
362
  errors.push(`${at}: unknown key "${key}"`);
340
363
  }
364
+ errors.push(...validateCommitTypes(repo.commit_types, `${at}.commit_types`));
365
+ for (const key of ["commit_subject_template", "merge_message_template"]) {
366
+ errors.push(...validateCommitMessageTemplate(repo[key], `${at}.${key}`));
367
+ }
368
+ errors.push(...validateBranchTemplate(repo.branch_template, `${at}.branch_template`, rootDir));
341
369
  const name = repo.name;
342
370
  if (typeof name !== "string" || !REPO_NAME_PATTERN.test(name)) {
343
371
  errors.push(`${at}.name must match ${String(REPO_NAME_PATTERN)} (got ${JSON.stringify(name)})`);
@@ -381,6 +409,12 @@ export function validateProjectRepos(projectId, project, projectIds, rootDir) {
381
409
  !isOmittedOrNonEmptyString(repo.integration_branch)) {
382
410
  errors.push(`${at}.integration_branch must be a non-empty string when present`);
383
411
  }
412
+ if (repo.integration_strategy !== undefined &&
413
+ repo.integration_strategy !== "merge" &&
414
+ repo.integration_strategy !== "branch-only" &&
415
+ repo.integration_strategy !== "ff") {
416
+ errors.push(`${at}.integration_strategy must be "merge", "branch-only" or "ff" when present`);
417
+ }
384
418
  const setup = repo.setup;
385
419
  if (setup !== undefined) {
386
420
  if (!isRecord(setup)) {
@@ -679,7 +713,10 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
679
713
  const rootDir = dirname(dirname(configPath));
680
714
  const repoErrors = projectIds
681
715
  .sort()
682
- .flatMap((projectId) => validateProjectRepos(projectId, parsed.projects[projectId], projectIds, rootDir));
716
+ .flatMap((projectId) => [
717
+ ...validateCommitTypes(parsed.projects[projectId].commit_types, `projects.${projectId}.commit_types`),
718
+ ...validateProjectRepos(projectId, parsed.projects[projectId], projectIds, rootDir),
719
+ ]);
683
720
  const externalProjectErrors = validateExternalProjects(parsed.external_projects, projectIds, rootDir);
684
721
  const configErrors = [...repoErrors, ...externalProjectErrors];
685
722
  if (configErrors.length > 0) {
@@ -727,11 +764,12 @@ export function registerConfigCommands(program) {
727
764
  cfg
728
765
  .command("init")
729
766
  .description("Create .specdojo/specdojo.config.json template (does not overwrite existing) " +
730
- "and add the lines excluding specdojo outputs to .gitignore")
731
- .option("--dry-run", "Show the planned config and .gitignore lines without writing", false)
767
+ "and initialize .gitignore and markdownlint settings")
768
+ .option("--dry-run", "Show the planned config, .gitignore and markdownlint settings without writing", false)
732
769
  .action((opts) => {
733
770
  const dryRun = !!opts.dryRun;
734
771
  const { configPath, config } = loadConfig();
772
+ ensureMarkdownlintConfig(specdojoRootDir(), dryRun);
735
773
  if (config) {
736
774
  process.stdout.write(`Already exists: ${configPath}\n`);
737
775
  writeGitignoreForConfig(config, dryRun);
@@ -10,6 +10,10 @@ export const DEFAULT_GITIGNORE_PATTERNS = [
10
10
  "docs/**/generated/*",
11
11
  "!docs/**/generated/.gitkeep",
12
12
  "docs/**/execution/exec/.locks/",
13
+ "/.vitepress/dist/",
14
+ "/.vitepress/cache/",
15
+ "/.vitepress/mermaid/",
16
+ "/.vitepress/kata-staging/",
13
17
  ];
14
18
  // repo-root 相対の posix パスへ正規化する。リポジトリ外(絶対パス・`..`)や root 自身は
15
19
  // 除外対象にできないため undefined を返す。
@@ -0,0 +1,24 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_ カタログの判定計画と生成
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ 対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
10
+
11
+ - result: `_RESULT_REF_`
12
+
13
+ ## 2. 完了手順
14
+
15
+ 1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
16
+ 2. 共通規約に従って必要な整形・静的検査を行う。
17
+ 3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
18
+
19
+ ## 3. 異常終了の条件
20
+
21
+ - 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
22
+ - 登録簿と個票のステータスを変更しない。
23
+
24
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,93 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 対象成果物
10
+
11
+ - `name`: _DELIVERABLE_NAME_
12
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
16
+ - `overview`: _DELIVERABLE_OVERVIEW_
17
+ - `path`: `_DELIVERABLE_PATH_`
18
+ - `result`: `_RESULT_REF_`
19
+
20
+ _PROJECT_CONTEXT_
21
+
22
+ ## 3. owner ロールとしての記述ポイント
23
+
24
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
25
+
26
+ - owner role: **_OWNER_ROLE_LABEL_**
27
+ - 責務: _OWNER_ROLE_NOTE_
28
+
29
+ このロールが重視するレビュー観点:
30
+
31
+ _OWNER_ROLE_VIEWPOINTS_
32
+
33
+ ## 4. 進め方
34
+
35
+ draft は、文脈で任された範囲を調べて成果物を下書きする進め方である。雛形に人が記入した文脈を読み、調査・選定を任された範囲と、既に決まっている前提を区別する。未作成なら template を骨組みにし、既存の下書きがあればそれを尊重して加筆する。必要な型の新規整備は本タスクの範囲に含めず、申し送る。
36
+
37
+ 人による文脈の記入が無い場合も、未作成なら template から下書きする。rulebook / recipe / sample と宣言された先行成果物・前提で根拠を確認できる内容を埋め、文脈が無いことを調査・選定の委任とは解釈しない。根拠のない値や未委任の判断は _TODO_ / _ASSUMPTION_ と次のアクションを残す。
38
+
39
+ ### 4.1. 参照範囲
40
+
41
+ 次の文書・情報を実際に読み込む。宣言の無い項目は推測で補わない。
42
+
43
+ - rulebook(構造・必須要素・禁止事項): `_RULEBOOK_REF_`
44
+ - 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
45
+ - recipe(問い・組み立て方): `_RECIPE_REF_`
46
+ - sample(完成例の粒度・文体・表現): `_SAMPLE_REF_`
47
+ - template(開始時の雛形): `_TEMPLATE_REF_`
48
+ - 対象成果物の `depends_on` 成果物と frontmatter の `based_on`(「対象成果物」に表示)。
49
+ - プロジェクトコンテキスト(`project_context`)。
50
+ - 個票の `入力` とカタログの `brief`(「対象成果物」に表示。値が無いときは載せない)。
51
+ - 対象成果物内の文脈(`_CONTEXT_:` など、人が記入した指示)。
52
+ - 文脈で任された調査・選定に必要な外部の情報(出典つき)。
53
+
54
+ rulebook を構造の基準とし、文書間に矛盾がある場合は rulebook を正とする。sample は形式の参考とし、その業務内容・固有名詞・値を対象成果物の事実として転記しない。`_MISSING_` は未宣言・未整備または非適用を示す。必要な型の欠落や内容の薄さは result に記録し、存在する型・対象成果物・上記の文脈を用いて進める。
55
+
56
+ ### 4.2. 調査・下書きと具体化の許可
57
+
58
+ 1. 文脈から、対象成果物の責務、固定された前提、調査・選定を任された範囲を特定する。指示が曖昧なら、任されていない範囲まで選定を広げない。
59
+ 2. 文脈で任された範囲に限り「根拠のない具体化の禁止」を外し、外部の情報を調べて値を決めてよい。技術・設定値などを選ぶ場合は、出典を確認し、対象の前提と選定理由を説明する。
60
+ 3. 選んだ値は成果物で「提案」と分かる形で示す。既存の決定事項や実装済みの事実として断定しない。出典と選定理由を result の `進め方と実践の型の適用` セクションに残す。
61
+ 4. 任されていない範囲は従来どおり _TODO_ / _ASSUMPTION_ で残し、不足する根拠と次のアクションを記録する。外部調査で得た情報を理由に、未委任の業務判断や将来方針を決めない。
62
+ 5. 成果物内の `_CONTEXT_:` は、指示を本文へ反映したら目印と元の指示を消し、元の指示を result に写す。元の指示と反映箇所を対にして記録する。executor / reporter pipeline では、元の指示と反映箇所を報告の `handoff` に書き、reporter と runner が result へ転記する。反映できない指示は削除せず、未反映の理由と次の行動を記録する。
63
+
64
+ ### grade result から展開された finding
65
+
66
+ _GRADE_FINDINGS_
67
+
68
+ plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result に記録する。grade result サイドカーは本タスクでは直接編集しない。
69
+
70
+ ### 4.3. 判断根拠の記録
71
+
72
+ result の `進め方と実践の型の適用` セクションに、任された範囲、参照した型と文脈、選んだ提案値ごとの出典と選定理由、本文へ反映した元の指示、未決事項を記録する。外部の情報には URL・文書名など、後から出典へ到達できる情報を付ける。下書きの後は fully-guided で磨き込み、finalize で人が確定する。
73
+
74
+ ## 5. 完了の狙い
75
+
76
+ この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って実践の型に沿って記述する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
77
+
78
+ _DONE_CRITERIA_GOALS_
79
+
80
+ ## 6. 完了手順
81
+
82
+ 1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
83
+ 2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
84
+ 3. 共通規約に従って、必要な整形・静的検査を実行する。
85
+ 4. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
86
+
87
+ ## 7. 異常終了の条件
88
+
89
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
90
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
91
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
92
+
93
+ _COMMON_CONVENTIONS_
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
10
10
 
11
11
  - `name`: _DELIVERABLE_NAME_
12
12
  - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
13
16
  - `overview`: _DELIVERABLE_OVERVIEW_
14
17
  - `path`: `_DELIVERABLE_PATH_`
15
18
  - `result`: `_RESULT_REF_`
@@ -29,6 +32,10 @@ _OWNER_ROLE_VIEWPOINTS_
29
32
 
30
33
  ## 4. 進め方
31
34
 
35
+ fully-guided は既存成果物の磨き込み専用である。雛形からの下書きや、調査して新しい値を選ぶ作業は draft で行う。対象成果物が未作成、または文脈だけの状態なら、下書きが必要なことを result に記録し、draft へ申し送る。
36
+
37
+ 成果物内に `_CONTEXT_:` が残っている場合は、その指示を本文へ反映・削除せず、元の指示、未反映の箇所、必要な下書きを論点として result の `進め方と実践の型の適用` セクションに残し、draft へ申し送る。executor / reporter pipeline では報告の `handoff` に記載し、reporter と runner が result へ転記する。
38
+
32
39
  対象成果物に必要と宣言された rulebook / recipe / sample は、指定されたファイルを実際に読み込んだうえで、次の役割に沿って参照する。読み込まずに記憶や推測で代替しない。
33
40
 
34
41
  参照ファイル(成果物カタログの rulebook ID と rulebook frontmatter から解決。`_MISSING_` は `undecided`、`not-needed`、未整備、または `kind: generated` による非適用を表す。fully-guided では通常 `not-needed` の項目だけが該当する):
@@ -51,7 +58,7 @@ _GRADE_FINDINGS_
51
58
 
52
59
  plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
53
60
 
54
- 参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / 併せて適用する rulebook / recipe / sample、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。成果物の作成・更新は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
61
+ 参照してよい文書は、宣言された文書だけに限る。具体的には、対象成果物、本セクションの rulebook / 併せて適用する rulebook / recipe / sample、`対象成果物` セクションの `depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief` である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。磨き込みは宣言された資料とこの plan 自身の記述(フェーズ説明・完了の狙い)だけを根拠に行い、不足があっても未宣言の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
55
62
 
56
63
  本タスクの実行に必要な fully-guided の参照方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
57
64
 
@@ -79,7 +86,7 @@ plan に展開された finding は、message と同じ viewpoint ID の判定
79
86
 
80
87
  ### 4.3. 根拠のない具体化の禁止
81
88
 
82
- - ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けが取れる場合に限る。sample は別文脈の完成例であり、対象成果物の具体的な記述の裏付けにしない。
89
+ - ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの宣言された参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、`based_on`、プロジェクトコンテキスト、個票の `入力`、カタログの `brief`)で裏付けが取れる場合に限る。sample は別文脈の完成例であり、対象成果物の具体的な記述の裏付けにしない。
83
90
  - 既存記述が曖昧・不完全(ファイル名のみでパスが無い、値が未確定など)であっても、裏付けが無ければ推測で具体化しない。完成度を上げる目的だけで、もっともらしい値を断定的に書き加えない。
84
91
  - 裏付けが無く判断できない箇所は、既存の曖昧な記述を残したまま _TODO_ / _ASSUMPTION_ として論点を残す。
85
92
 
@@ -18,6 +18,8 @@ _PJR_DESCRIPTION_
18
18
  - `個票`: _PJR_TICKET_REF_
19
19
  - `result`: `_RESULT_REF_`
20
20
 
21
+ _REGISTER_INPUT_
22
+
21
23
  ## 3. 進め方
22
24
 
23
25
  1. 個票(存在する場合)を読み、問い・リスク内容・判断に必要な条件を把握する。登録簿の一覧は大きいため読まない。
@@ -18,6 +18,8 @@ _PJR_DESCRIPTION_
18
18
  - `個票`: _PJR_TICKET_REF_
19
19
  - `result`: `_RESULT_REF_`
20
20
 
21
+ _REGISTER_INPUT_
22
+
21
23
  ## 3. 進め方
22
24
 
23
25
  1. 個票(存在する場合)を読み、目的・完了条件・制約を把握する。登録簿の一覧は大きいため読まない。
@@ -0,0 +1,24 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_ Schedule strategy と track の生成
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ 対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
10
+
11
+ - result: `_RESULT_REF_`
12
+
13
+ ## 2. 完了手順
14
+
15
+ 1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
16
+ 2. 共通規約に従って必要な整形・静的検査を行う。
17
+ 3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
18
+
19
+ ## 3. 異常終了の条件
20
+
21
+ - 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
22
+ - 登録簿と個票のステータスを変更しない。
23
+
24
+ _COMMON_CONVENTIONS_
@@ -15,6 +15,8 @@ done_criteria の各項目を確認し、満たしていればチェックを付
15
15
 
16
16
  _DONE_CRITERIA_CHECKLIST_
17
17
 
18
+ - [ ] 確定対象の成果物と実践の型の本文に未反映の `_CONTEXT_:` が残っていない(残っていれば承認せず、draft へ差し戻す)
19
+
18
20
  ## 3. 実践の型の確認
19
21
 
20
22
  実践の型を種別ごとに確認し、満たしていればチェックを付ける。「確定対象」に無い種別はスキップし、行を削除する。
@@ -0,0 +1,23 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Result
4
+
5
+ この human タスクは雛形作成と文脈の記入を担当する。plan は生成せず、claim / complete で状態を記録する。対象は frontmatter の `targets` を成果物カタログで確認する。
6
+
7
+ 1. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成する。既存ファイルは上書きしない。`--force` は指定しない。
8
+ 2. 対象本文の必要な箇所に `_CONTEXT_:` を付け、固定前提・制約・調査や選定を任せる範囲を記入する。例: `_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。`
9
+ 3. 以下へ対象ファイルと記入した文脈を記録し、`specdojo exec complete --project <project-id> --task <task-id> --by <human>` で完了する。後続の agent が draft で文脈を下書きへ反映する。
10
+
11
+ ## 1. 実施内容
12
+
13
+ _TODO_: 雛形の作成有無と記入した文脈を記録する。
14
+
15
+ ## 2. 変更ファイル
16
+
17
+ _TODO_: 雛形を作成した、または文脈を記入した成果物のパスを記録する。
18
+
19
+ ## 3. 申し送り
20
+
21
+ _TODO_: 後続の draft へ渡す前提・委任範囲・確認事項を記録する(なければ削除)。
22
+
23
+ _APPROACH_SECTION_
@@ -15,6 +15,8 @@ done_criteria の各項目を確認し、満たしていればチェックを付
15
15
 
16
16
  _DONE_CRITERIA_CHECKLIST_
17
17
 
18
+ - [ ] 確定対象の本文に未反映の `_CONTEXT_:` が残っていない(残っていれば承認せず、draft へ差し戻す)
19
+
18
20
  ## 3. 確定対象
19
21
 
20
22
  最終確認と frontmatter の `status` の `ready` への昇格が済んだ対象にチェックを付ける。