specdojo 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,67 @@
1
+ _FRONTMATTER_
2
+
3
+ # Review 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
+ - `overview`: _DELIVERABLE_OVERVIEW_
14
+ - `path`: `_DELIVERABLE_PATH_`
15
+ - `rulebook`: `_RULEBOOK_REF_`
16
+ - 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
17
+ - `result`: `_RESULT_REF_`
18
+
19
+ _PROJECT_CONTEXT_
20
+
21
+ ## 3. レビュー観点
22
+
23
+ <!-- markdownlint-disable MD055 MD056 -->
24
+
25
+ <!-- prettier-ignore-start -->
26
+ | ID | ロール | viewpoint_id | 確認基準 |
27
+ | --- | ------ | ------------ | -------- |
28
+ _REVIEW_VIEWPOINT_ROWS_
29
+ <!-- prettier-ignore-end -->
30
+
31
+ <!-- markdownlint-enable MD055 MD056 -->
32
+
33
+ _REVIEW_VIEWPOINT_DETAILS_
34
+
35
+ owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
36
+
37
+ ## 4. 進め方
38
+
39
+ - exec plan frontmatter の `approach` を確認する。
40
+ - `approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、確認の向きを「成果物 → 対象の実践の型」に切り替え、対象の実践の型が見直しに値するかを確認する。
41
+ - それ以外の場合は、対象成果物に紐づく rulebook / recipe / sample / template の有無を確認し、`approach` に応じて確認の基準を決める。
42
+ - `fully-guided`: rulebook の必須要素・禁止事項、recipe の問いとレビュー観点、sample の粒度・文体、template の章構成との整合を確認する(プレースホルダが残っていないことも確認する)。`併せて適用する rulebook` が `_MISSING_` でない場合は、その記法などのルールとの整合も確認する。
43
+ - `recipe-guided`: recipe の問いとレビュー観点に照らして確認する(rulebook / sample / template の構造・文体は基準にしない)。
44
+ - `freeform`: 実践の型より、類似成果物の実例やプロジェクト文脈との整合を確認する。
45
+ - 未指定の場合は、存在するすべての実践の型をそれぞれの役割に沿って確認の基準にする。
46
+ - 複数の文書間で記述に矛盾がある場合、確認の基準に rulebook を含む `approach`(`fully-guided` など)では rulebook を正とする。
47
+ - `freeform` と実践の型メンテナンス系(`*-maintenance`)を除く `approach` では、確認に用いてよい文書をこの plan に記載されたもの(対象成果物に紐づく rulebook / 併せて適用する rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキスト)に限定する。クロス文書整合のレビュー観点では `depends_on` 成果物を読み込んで対象成果物と突き合わせ、目的整合の判断ではプロジェクトコンテキストを参照する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
48
+ - `freeform` を除く `approach` では、対象成果物中のファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述が、確認に用いてよい文書で裏付けられているかを確認する。裏付けが確認できない具体的な記述は、正確性を検証できないため該当レビュー観点を unclear とし、findings に記録する。もっともらしく具体的に見えることは裏付けの代わりにならない。
49
+ - evidence・notes は、対象成果物・実践の型を実際に読んで得た具体的な観察に限る。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱わない。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先し findings に記録する。
50
+ - 存在しない、または確認の基準から外れた文書がある場合は、他に存在する文書、類似成果物、対象領域の慣行と整合しているかを確認し、判断の根拠を review result に残す。
51
+
52
+ 詳細は [[specdojo:ryu-guide]] を参照する。
53
+
54
+ ## 5. 完了手順
55
+
56
+ 1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
57
+ 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
58
+ 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
59
+ 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
60
+
61
+ ## 6. 異常終了の条件
62
+
63
+ - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
64
+ - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
65
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
66
+
67
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,7 @@
1
+ ### _VP_ID_(_VP_ROLES_: _VP_VIEWPOINT_)
2
+
3
+ **確認基準**: _VP_CRITERION_
4
+
5
+ _VP_COVERAGE_**チェック観点:** _VP_CHECK_
6
+
7
+ **エビデンス例:** _VP_EVIDENCE_
@@ -0,0 +1,21 @@
1
+ _FRONTMATTER_
2
+
3
+ # Review Result
4
+
5
+ ## 1. レビュー観点別結果
6
+
7
+ 各 RVP セクションの `result` / `evidence` / `notes` を記入する。`evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載し、行番号アンカーや絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
8
+
9
+ _REVIEW_RESULT_SECTIONS_
10
+
11
+ ## 2. findings
12
+
13
+ _TODO_: 問題点・指摘事項を記入する(なければ削除)。
14
+
15
+ ## 3. 実践の型との整合確認
16
+
17
+ _TODO_: `approach` に従ってどう確認したか(`fully-guided` で rulebook の必須要素・禁止事項、recipe の作り方、sample の粒度・文体、template の章構成との整合、`recipe-guided` で recipe のみを基準にした確認、`freeform` で実践の型より優先した実例やプロジェクト文脈との整合、`retrofit` で実際に参照した実装パス・成果物との対応判定・乖離ごとの修正対象候補・未確認範囲、`rulebook-maintenance` などの maintenance 系で見直した実践の型とその根拠、など)を記入する。複数文書間に矛盾があり rulebook を正として判定した箇所、確認の基準から外れていた文書とその代わりに根拠にした内容があれば、あわせて記録する。
18
+
19
+ ## 4. decision
20
+
21
+ - recommendation: _TODO_(approve / revise / reject)
@@ -0,0 +1,7 @@
1
+ ### _VP_ID_(_VP_ROLES_: _VP_VIEWPOINT_)
2
+
3
+ **確認基準**: _VP_CRITERION_
4
+
5
+ - result: _TODO_(pass / fail / unclear)
6
+ - evidence: _TODO_
7
+ - notes: _TODO_
@@ -0,0 +1,354 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:branch-workflow-guide
4
+ type: guide
5
+ status: ready
6
+ based_on:
7
+ - specdojo:git-branching-standard
8
+ ---
9
+
10
+ # ブランチワークフローガイド
11
+
12
+ Branch Workflow Guide
13
+
14
+ [Git ブランチ運用標準](../standards/git-branching-standard.md) に従い、project `develop`、feature、exec worktree を作成・同期・統合・終了する手順を説明します。対象読者は、複数の `prj-xxxx` と Git worktree を同じリポジトリで運用する開発者・運用者です。
15
+
16
+ **対象読者**
17
+
18
+ - project、feature、exec の各ブランチと Git worktree を運用する開発者、実行管理者
19
+
20
+ **この文書で分かること**
21
+
22
+ - 標準ブランチ構成、project `develop` の準備、feature・exec の開始から統合・終了までの手順
23
+
24
+ **次に読む文書**
25
+
26
+ - exec の実行経路は [exec運用ガイド](exec-operation-guide.md)、worktree の分割操作は [exec worktree運用ガイド](exec-worktree-guide.md) を参照してください。
27
+
28
+ ## 1. 前提と全体像
29
+
30
+ 作業を始める前に、対象 project ID、現在ブランチ、作業ツリーの状態を確認します。
31
+
32
+ ```bash
33
+ git branch --show-current
34
+ git status --short
35
+ ```
36
+
37
+ 標準の変更経路は次のとおりです。
38
+
39
+ ```text
40
+ main
41
+ └─ project/prj-0001/develop
42
+ ├─ feature/prj-0001/<topic>
43
+ └─ exec/prj-0001-<task-id>
44
+ ```
45
+
46
+ | ブランチ | 主な用途 | 主な操作主体 |
47
+ | -------------------------- | ----------------------------- | ---------------- |
48
+ | `main` | 安定した共有状態 | リポジトリ管理者 |
49
+ | `project/prj-0001/develop` | prj-0001 の変更統合と検証 | プロジェクト |
50
+ | `feature/prj-0001/<topic>` | 人が行う目的別の変更 | 開発者 |
51
+ | `exec/prj-0001-<task-id>` | task 単位の隔離された自動変更 | SpecDojo CLI |
52
+
53
+ 以降の例では project ID に `prj-0001` を使用します。
54
+
55
+ ## 2. project developを準備する
56
+
57
+ 新しい project の統合ブランチを作る場合は、更新済みの `main` を起点にします。
58
+
59
+ ```bash
60
+ git switch main
61
+ git pull --ff-only origin main
62
+ git switch -c project/prj-0001/develop
63
+ git push -u origin project/prj-0001/develop
64
+ ```
65
+
66
+ 既存の project `develop` で作業を再開する場合は、ブランチと同期状態を確認します。
67
+
68
+ ```bash
69
+ git switch project/prj-0001/develop
70
+ git status --short
71
+ git fetch origin
72
+ git merge origin/main
73
+ ```
74
+
75
+ 共有中の project `develop` では rebase せず、`main` を merge して履歴を維持します。リモートを使用しない環境では、取得済みのローカル `main` を merge 対象にします。
76
+
77
+ ## 3. featureブランチで作業する
78
+
79
+ ### 3.1. 通常の作業ツリーで開始する
80
+
81
+ 対象 project の `develop` を起点に、project ID を含む feature を作成します。複数人・複数 actor 運用では、先にリモートの更新を取り込み、ローカルの `develop` を push します。push 後の先端がリモートと一致することを確認してから feature を切ります。これにより、ローカルの `develop` にだけ存在する無関係な commit が Pull Request の差分へ混入することを防ぎます。
82
+
83
+ ```bash
84
+ git switch project/prj-0001/develop
85
+ git status --short
86
+ git fetch origin
87
+ git merge --ff-only origin/project/prj-0001/develop
88
+ git push origin project/prj-0001/develop
89
+ git rev-parse HEAD
90
+ git rev-parse origin/project/prj-0001/develop
91
+ git switch -c feature/prj-0001/branch-policy
92
+ ```
93
+
94
+ 2つの `git rev-parse` が同じ SHA を返さない場合は feature を切らず、未 push commit、リモートの更新、誤った分岐を確認します。リモートや Pull Request を使わない単独運用では fetch、push、リモートとの SHA 比較を省略できます。
95
+
96
+ 作業・検証・commitを終えたら、project `develop` へ統合します。共有リポジトリでは Pull Request を使い、ローカル統合する場合も統合前に差分と検証結果を確認します。
97
+
98
+ ```bash
99
+ git switch project/prj-0001/develop
100
+ git merge --no-ff feature/prj-0001/branch-policy
101
+ git branch -d feature/prj-0001/branch-policy
102
+ ```
103
+
104
+ ### 3.2. feature用worktreeを作る
105
+
106
+ main worktree を project `develop` に置いたまま並行作業する場合は、feature 専用 worktree を作成できます。
107
+
108
+ ```bash
109
+ git worktree add \
110
+ ../worktrees/prj-0001-branch-policy \
111
+ -b feature/prj-0001/branch-policy \
112
+ project/prj-0001/develop
113
+ ```
114
+
115
+ worktree 内でベースの最新変更を確認・取り込みするときは、project `develop` を明示します。
116
+
117
+ ```bash
118
+ npm run worktree:sync -- --base project/prj-0001/develop --dry-run
119
+ npm run worktree:sync -- --base project/prj-0001/develop
120
+ ```
121
+
122
+ 統合後に worktree と branch を片付けます。
123
+
124
+ ```bash
125
+ git worktree remove ../worktrees/prj-0001-branch-policy
126
+ git branch -d feature/prj-0001/branch-policy
127
+ ```
128
+
129
+ ### 3.3. Pull Requestの差分表示が更新されない場合
130
+
131
+ Pull Request の作成後に base の project `develop` を push しても、画面の Files changed がすぐに再計算されない場合があります。画面だけで判断せず、GitHub の compare API で base と head の実差分を確認します。次の `<owner>`、`<repo>`、branch 名、`<pr-number>` は対象に置き換えます。branch 名に含まれる `/` は compare API のパスでは `%2F` として指定します。
132
+
133
+ ```bash
134
+ gh api \
135
+ "/repos/<owner>/<repo>/compare/project%2Fprj-0001%2Fdevelop...feature%2Fprj-0001%2Fbranch-policy" \
136
+ --jq '{status, ahead_by, files: [.files[].filename]}'
137
+ gh pr view <pr-number> --json files --jq '.files[].path'
138
+ ```
139
+
140
+ compare API のファイル一覧が期待どおりで、Pull Request の Files changed だけが古い場合は、レビュー中の操作がないことを確認してから Pull Request を close / reopen し、表示の再計算を促します。
141
+
142
+ ```bash
143
+ gh pr close <pr-number>
144
+ gh pr reopen <pr-number>
145
+ ```
146
+
147
+ 再度 Files changed を確認し、compare API の一覧と一致するまで merge しません。close / reopen 後は、必須 CI、review、conversation の状態も再確認します。compare API にも無関係な差分がある場合は表示の問題ではないため、base の push 状態と feature の分岐元を修正します。
148
+
149
+ ## 4. SpecDojo execを実行する
150
+
151
+ SpecDojo exec は task ID から `exec/<project-id>-<task-id>` を作成します。作成元と統合先を一致させるため、実行前に main worktree を対象 project の `develop` に切り替えます。
152
+
153
+ ```bash
154
+ git switch project/prj-0001/develop
155
+ git branch --show-current
156
+ git status --short
157
+ ```
158
+
159
+ 自動実行では、SpecDojo が worktree の準備、agent 実行、commit、現在ブランチへの統合、状態更新を行います。
160
+
161
+ worktree 実行の `prepare execution` / `apply task changes` と実行管理の記帳は exec ブランチに保持されます。成功時に project `develop` の first-parent へ追加されるのは `--no-ff` の merge commit 1件だけで、subject は Schedule タスクなら `exec(<task-id>): <task name>`、register 項目なら `exec(register <PJR-ID>): <title>` です。register 実行では `start → review` の遷移をこの merge commit に同梱し、失敗時は `start → waiting` の遷移、plan、result を `wait` commit 1件にまとめます(worktree は再開のため保持します)。再開後に成功した場合も merge commit 1件です。squash / rebase は使わず、既存履歴は書き換えません。
162
+
163
+ ```bash
164
+ specdojo exec run \
165
+ --project prj-0001 \
166
+ --task <task-id> \
167
+ --worktree
168
+ ```
169
+
170
+ 段階ごとに確認する場合は [exec worktree運用ガイド](exec-worktree-guide.md) の分割手順を使います。特に `worktree merge` の直前には、root worktree が対象 project の `develop` であることを再確認します。
171
+
172
+ ```bash
173
+ git branch --show-current
174
+ specdojo exec worktree merge \
175
+ --project prj-0001 \
176
+ --task <task-id>
177
+ ```
178
+
179
+ ## 5. mainの更新を取り込む
180
+
181
+ project の作業期間中は、`main` の更新を project `develop` へ定期的に取り込みます。
182
+
183
+ ```bash
184
+ git fetch origin
185
+ git switch project/prj-0001/develop
186
+ git status --short
187
+ git merge origin/main
188
+ ```
189
+
190
+ 取り込み後は、変更対象に必要な test、build、schema 検証を実行します。生成物を持つ構成では、必要に応じて再生成も行います。
191
+
192
+ feature または exec worktree 側へ project `develop` の更新を取り込む場合は、worktree 内でベースを明示します。
193
+
194
+ ```bash
195
+ npm run worktree:sync -- --base project/prj-0001/develop
196
+ ```
197
+
198
+ ## 6. project developをmainへ統合する
199
+
200
+ project の変更が受入可能になったら、次の順序で `main` への統合を準備します。
201
+
202
+ 1. project `develop` に未統合の feature / exec がないか確認します。
203
+ 2. 最新の `main` を project `develop` へ mergeします。
204
+ 3. project 全体に必要な test、build、schema 検証を実行します。
205
+ 4. project register、exec result、未解決事項を確認します。
206
+ 5. project `develop` から `main` への Pull Request を作成します。
207
+ 6. レビューとCIが成功した後、merge commit を作る方式で統合します。squash merge と rebase merge は選びません。
208
+
209
+ 昇格前に、最新の `main` を取り込んだ `develop` の先端 SHA を記録します。次の `<promoted-develop-sha>` にはこの値を使います。
210
+
211
+ ```bash
212
+ git fetch origin
213
+ git switch project/prj-0001/develop
214
+ git status --short
215
+ git merge origin/main
216
+ git rev-parse HEAD
217
+ git log --oneline main..project/prj-0001/develop
218
+ git diff --stat main...project/prj-0001/develop
219
+ git branch --no-merged project/prj-0001/develop
220
+ ```
221
+
222
+ Pull Request の head は project `develop`、base は `main` とします。一時ブランチで commit を並べ替えたり、squash や rebase で履歴を作り直したりしません。exec の記帳(register の `start` / `review` 遷移、plan、result)は task ごとの merge commit または `wait` commit に同梱されているため、昇格時に除外する commit はありません。統合後は `main` を取得し、昇格した `develop` の先端が祖先になったことと、first-parent 上で昇格が1件の merge commit として見えることを確認します。
223
+
224
+ ```bash
225
+ git fetch origin
226
+ git merge-base --is-ancestor <promoted-develop-sha> origin/main
227
+ git log --first-parent --oneline origin/main
228
+ ```
229
+
230
+ `git merge-base --is-ancestor` が終了コード0にならない場合、squash merge または rebase merge により祖先関係が失われた可能性があります。次の昇格を進めず、使用した merge 方式と Pull Request を確認します。push 済み履歴を rebase や force-push で直してはいけません。
231
+
232
+ `git log --first-parent --oneline origin/main` の出力に exec / register の遷移 commit が並ぶ区間があっても、本手順の適用前に行った昇格の区間であれば異常ではありません。過去に merge の向きが逆(`develop` 上で `main` を取り込み、`main` を fast-forward)だった場合、その区間の first-parent 系列は `develop` の詳細 commit を辿ります。押し込み済みの履歴は書き換えないため、そのまま残します。確認するのは、**本手順で行った昇格が1件の merge commit として見えているか**です。
233
+
234
+ project `develop` を引き続き使う場合は、昇格後の `main` を取り込みます。fast-forward になる場合も、分岐して merge commit が作られる場合もあります。
235
+
236
+ ```bash
237
+ git switch project/prj-0001/develop
238
+ git merge origin/main
239
+ git log --oneline origin/main..project/prj-0001/develop
240
+ ```
241
+
242
+ 同期直後の最後のコマンドは出力なしになります。その後の出力は次回昇格の新しい commit だけであり、過去の昇格済み commit は再表示されません。project 完了後に `develop` を削除する場合は、祖先確認と未退避作業の確認を終えてから行います。
243
+
244
+ ## 7. 承認方式を使い分ける
245
+
246
+ 登録項目の承認は、既定で commit(register の状態遷移とチケット個票の承認節)で残し、PR 承認は強制する 3 ケースに限定します。判定条件は [Git ブランチ運用標準](../standards/git-branching-standard.md) の `承認ゲートと PR 強制条件`、type 別の承認フローは [登録簿運用ガイド](register-operation-guide.md) の `承認フローと承認者` を参照します。
247
+
248
+ この承認方式は register 項目の正式な承認証跡を選ぶものです。人または対話型 agent が内容を書いた変更を feature Pull Request で事前レビューする経路とは別に判定します。PR 強制3ケース以外でも内容変更は feature Pull Request で統合し、register 項目の正式承認は commit とチケット個票へ残します。
249
+
250
+ commit ベースで承認する場合(`decision` / `risk` / `question` / `issue` / `todo` の通常運用)は、チケット個票の承認節と register の状態遷移で承認事実を残します。
251
+
252
+ ```bash
253
+ specdojo register close \
254
+ --project prj-0001 \
255
+ --id PJR-0005 \
256
+ --conclusion "回答者・回答日を承認節に記入し decided へ遷移"
257
+ ```
258
+
259
+ PR 承認を強制する 3 ケース(`develop → main` 昇格 / `change-request` 承認 / 不可逆・高リスク・framework schema 破壊的変更)では、承認対象の差分を Pull Request として作成し、承認者が approve します。作成者自身の承認は職務分離のためカウントしません。
260
+
261
+ ```bash
262
+ git switch project/prj-0001/develop
263
+ git switch -c feature/prj-0001/schema-change
264
+ # 変更を commit した後に PR を作成する
265
+ gh pr create --base project/prj-0001/develop --title "PJR-XXXX schema 破壊的変更" --body "対象個票: prj-0001:pjr-xxxx-topic"
266
+ ```
267
+
268
+ merge 後は、承認者・承認日・承認対象・証跡(PR URL・merge SHA)をチケット個票の承認節へ書き戻します。`main` と `project/<project-id>/develop` の承認者は `CODEOWNERS` と branch protection で強制します。
269
+
270
+ ### 7.1. CODEOWNERS と branch protection を設定する
271
+
272
+ `CODEOWNERS` は PR の base branch にあるファイルが評価されます。保護ルールを有効にする前に、`.github/CODEOWNERS` を `main` と保護対象の `project/<project-id>/develop` へ反映し、指定した user または team にリポジトリへの明示的な write 権限があることを確認します。
273
+
274
+ リポジトリ管理者は GitHub の `Settings` → `Branches` で、次の branch protection rule を設定します。ruleset を使う場合も、同等の条件を設定します。
275
+
276
+ | 対象 branch | 必須設定 |
277
+ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
278
+ | `main` | Pull Request 経由、承認 1 件以上、Code Owners のレビュー、新規 commit 時の古い承認無効化、未解決 conversation の解消、必須 CI、管理者を含む bypass・force-push・削除の禁止 |
279
+ | `project/<project-id>/develop` | Pull Request 経由、承認 1 件以上、Code Owners のレビュー、新規 commit 時の古い承認無効化、未解決 conversation の解消、統合専用 actor 以外の bypass・force-push・削除の禁止 |
280
+
281
+ `project/<project-id>/develop` では通常の自動 `exec → develop` 統合を止めないように、SpecDojo の統合専用 GitHub App または service account だけを bypass actor に指定します。人の管理者や承認者へ広い bypass を付与してはいけません。統合専用 actor を分離できない間は develop の保護を有効化せず、その未設定期間を project register で追跡します。`main` の保護は自動統合の bypass 対象にしません。
282
+
283
+ 設定後、管理者は次を確認します。
284
+
285
+ 1. `main` を base にした PR で `@naoji3x` が Code Owner として review request される。
286
+ 2. 未承認、作成者自身の操作、古い承認、未成功の必須 CI の各状態では `main` へ merge できない。
287
+ 3. PR 強制ケースの差分を base にした `project/<project-id>/develop` 向け PR で、Code Owner の承認なしに merge できない。
288
+ 4. 統合専用 actor による通常の `exec → develop` だけが bypass でき、人の変更は bypass できない。
289
+
290
+ ### 7.2. 独立した承認者がいない期間を扱う
291
+
292
+ PR の作成者と独立した Code Owner がいない場合、PR 強制 3 ケースは「承認待ち」とし、作成者自身の approve、管理者権限、または bypass を承認として記録しません。独立した承認者が参加して approve するまで merge と承認対象チケットの close を保留します。
293
+
294
+ 緊急対応で管理者 bypass による merge が不可避な場合は、承認済みとは扱わず、例外として対象、理由、実施者、期間、PR URL、merge SHA、復帰条件を project register に記録します。独立した承認者が参加した後に差分を遡及レビューし、その結果を同じ登録項目へ追記します。
295
+
296
+ ## 8. 複数projectを並行する
297
+
298
+ `worktree:sync` は既定で main worktree が checkout しているブランチをベースにします。複数 project の worktree が同時に存在する場合は、対象 project の `develop` を毎回明示します。
299
+
300
+ ```bash
301
+ npm run worktree:sync -- --base project/prj-0001/develop
302
+ ```
303
+
304
+ | 状況 | 対応 |
305
+ | ----------------------------------------- | ------------------------------------------------------ |
306
+ | main worktree が対象 project の `develop` | 自動判定を利用できるが、実行前に現在ブランチを確認する |
307
+ | main worktree が別 project の `develop` | `--base project/<project-id>/develop` を指定する |
308
+ | 定型コマンドや自動実行から同期する | `SPECDOJO_WORKTREE_BASE_BRANCH` でベースを固定する |
309
+ | 複数 project が同じ共通ファイルを変更する | 統合順序を決め、共通変更を `main` 経由で同期する |
310
+
311
+ 環境変数で固定する例:
312
+
313
+ ```bash
314
+ export SPECDOJO_WORKTREE_BASE_BRANCH=project/prj-0001/develop
315
+ npm run worktree:sync
316
+ ```
317
+
318
+ ## 9. 既存featureブランチを移行する
319
+
320
+ 未公開または単独作業中の `feature/<topic>` は、project ID を含む名前へ変更できます。
321
+
322
+ ```bash
323
+ git branch -m \
324
+ feature/branch-policy \
325
+ feature/prj-0001/branch-policy
326
+ ```
327
+
328
+ 現在 checkout 中の branch を変更する場合:
329
+
330
+ ```bash
331
+ git branch -m feature/prj-0001/branch-policy
332
+ ```
333
+
334
+ リモート公開済みの場合は、新しい名前を公開して追跡先を設定した後、利用者と Pull Request への影響を確認して旧名を削除します。
335
+
336
+ ```bash
337
+ git push -u origin feature/prj-0001/branch-policy
338
+ git push origin --delete feature/branch-policy
339
+ ```
340
+
341
+ レビュー中または共同作業中の branch は無理に改名せず、完了後に新しい命名へ切り替える方が安全です。
342
+
343
+ ## 10. 作業前後のチェックリスト
344
+
345
+ | 時点 | 確認内容 |
346
+ | -------------------- | -------------------------------------------------------------------- |
347
+ | 分岐前 | 対象 project ID、現在ブランチ、未commit変更、分岐元の同期状態 |
348
+ | worktree作成後 | branch 名、worktree パス、ベース commit |
349
+ | 同期前 | worktree が clean であること、取り込み元 branch |
350
+ | feature / exec統合前 | 統合先が対象 project の `develop` であること、検証結果、未commit変更 |
351
+ | main統合前 | 最新 `main` の取り込み、project全体の検証、レビュー対象、未解決事項 |
352
+ | 削除前 | 統合済みであること、未退避のcommit・変更・resultがないこと |
353
+
354
+ 誤ったブランチから作業を始めた場合は、そのまま統合せず、現在の commit と正しいベースとの差分を確認します。修正方法を決められない場合は branch と worktree を保持し、変更を失う操作を行わずにレビューを依頼します。