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,280 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:directory-layout-reference
4
+ type: reference
5
+ status: draft
6
+ based_on:
7
+ - specdojo:docs-structure-guide
8
+ ---
9
+
10
+ # ディレクトリレイアウトリファレンス
11
+
12
+ Directory Layout Reference
13
+
14
+ SpecDojo Unit のプロジェクトドキュメントとプロダクトドキュメントの標準ディレクトリ構成を、ファイル単位で一覧します。
15
+
16
+ **対象範囲**
17
+
18
+ - `docs/ja/projects/<project-id>/` 配下のプロジェクトドキュメント構成
19
+ - `docs/ja/product/` 配下のプロダクトドキュメント構成
20
+ - 両者が共有する `docs/ja/specdojo/` 配下の実践体系ディレクトリ
21
+
22
+ **ここで引けるもの**
23
+
24
+ - 各ドメイン・横断領域のディレクトリと、そこへ置く代表ファイルの配置先
25
+
26
+ **詳細の参照先**
27
+
28
+ - 分類・ライフサイクル・命名規約・構成方針(なぜこの配置か)は [ドキュメント構成ガイド](../guides/docs-structure-guide.md) を正本とします。本リファレンスは配置の一覧に徹します。
29
+ - 各成果物の目的・推奨ファイル名は [成果物リファレンス](deliverables-reference.md)、CLI 視点のリポジトリ構成は [遂行の技活用ガイド](../guides/waza-guide.md) を参照してください。
30
+
31
+ 本リファレンスのツリーは代表例です。ディレクトリ名のプレフィックス番号や横断ディレクトリの扱いなどの方針は [ドキュメント構成ガイド](../guides/docs-structure-guide.md) の `ディレクトリ・ファイルの命名ルール` と `プロジェクトドキュメントの構成` を参照してください。実際のパスは `.specdojo/specdojo.config.json` の project 設定で変更できます。
32
+
33
+ ## 1. 既定のリポジトリ構成
34
+
35
+ 利用プロジェクトでは Detached Unit を既定とし、プロダクトの内容と同じ revision が必要な文書と、SpecDojo の運用記録を別リポジトリに置きます。
36
+
37
+ ```text
38
+ workspace/
39
+ ├── app1/ # プロダクトリポジトリ
40
+ │ ├── src/
41
+ │ └── docs/ja/product/ # プロダクトドキュメント
42
+ ├── app1-specdojo/ # SpecDojo 運用リポジトリ
43
+ │ ├── .specdojo/
44
+ │ │ └── specdojo.config.json
45
+ │ └── docs/ja/
46
+ │ ├── specdojo/ # 実践体系
47
+ │ └── projects/<project-id>/ # プロジェクト文書と実行記録
48
+ └── app1-worktrees/ # task 単位の worktree 置き場
49
+ ```
50
+
51
+ 以下のツリーは各リポジトリ内の配置を個別に示します。成果物と実装が常に同じ変更として動く Attached Unit を選ぶ場合は、両方のツリーを1つのリポジトリの `docs/ja/` 配下へ置けます。
52
+
53
+ ## 2. プロジェクトドキュメントの構成
54
+
55
+ ```text
56
+ docs/
57
+ ├── ja/ # 多言語化対応(将来: en/ など)
58
+ │ ├── specdojo/
59
+ │ │ ├── philosophy/ # 規約の前提となる方針・概念
60
+ │ │ ├── guides/ # ドキュメント作成ガイド
61
+ │ │ ├── references/ # 一覧・比較のためのリファレンス
62
+ │ │ ├── standards/ # 共通標準・メタ規約
63
+ │ │ ├── rulebooks/ # ドキュメント記述規約
64
+ │ │ ├── recipes/ # 成果物ごとの作成手順
65
+ │ │ ├── samples/ # 成果物の完成例
66
+ │ │ ├── templates/ # rulebook が宣言する成果物テンプレート
67
+ │ │ ├── exec-templates/ # plan/result 生成用の内部テンプレート
68
+ │ │ ├── schemas/ # 言語固有の文書構造スキーマ
69
+ │ │
70
+ │ ├── projects/
71
+ │ │ ├── prj-0001/ # プロジェクト(ID)
72
+ │ │ │ ├── 010-deliverables-catalog/ # 成果物カタログ
73
+ │ │ │ │ ├── dct-index.yaml # 成果物カタログ索引の宣言(正本)
74
+ │ │ │ │ ├── dct-project-definition.yaml # プロジェクト定義の成果物カタログ(正本)
75
+ │ │ │ │ ├── dct-project-management.yaml # プロジェクトマネジメントの成果物カタログ(正本)
76
+ │ │ │ │ ├── plans/ # agent判定結果(正本・カタログ生成の入力)
77
+ │ │ │ │ │ └── dct-plan-data-flow.yaml
78
+ │ │ │ │ └── generated/ # 正本から生成される補助一覧
79
+ │ │ │ │ ├── dct-index.md
80
+ │ │ │ │ ├── dct-project-definition.md
81
+ │ │ │ │ └── dct-project-management.md
82
+ │ │ │ │
83
+ │ │ │ ├── 020-project-definition/ # プロジェクト定義
84
+ │ │ │ │ ├── prj-overview.md # プロジェクト概要
85
+ │ │ │ │ ├── prj-stakeholder-register.md # ステークホルダー登録簿
86
+ │ │ │ │ ├── prj-charter.md # プロジェクト憲章
87
+ │ │ │ │ ├── prj-scope.md # プロジェクトスコープ
88
+ │ │ │ │ ├── prj-success-criteria-and-acceptance-criteria.md # 成功基準と受入条件
89
+ │ │ │ │ ├── prj-issues-and-approach.md # プロジェクト課題と解決アプローチ
90
+ │ │ │ │ ├── prj-assumptions-constraints-dependencies.md # 前提・制約・依存関係
91
+ │ │ │ │ └── prj-comparison-of-alternatives.md # 代替案の比較
92
+ │ │ │ │
93
+ │ │ │ ├── 030-project-management/ # プロジェクトマネジメント
94
+ │ │ │ │ ├── pm-plan.md # プロジェクト管理計画
95
+ │ │ │ │ ├── pm-communication-plan.md # コミュニケーション計画
96
+ │ │ │ │ ├── pm-quality-management-plan.md # 品質管理計画
97
+ │ │ │ │ ├── pm-review-viewpoints.yaml # レビュー観点
98
+ │ │ │ │ ├── pm-organization.md # 組織とロールの定義
99
+ │ │ │ │ ├── pm-roles.yaml # ロール定義
100
+ │ │ │ │ ├── pm-members.yaml # メンバー定義
101
+ │ │ │ │ └── pm-raci.md # 組織体制とRACI
102
+ │ │ │ │
103
+ │ │ │ ├── 040-current-state/ # 現状(必要な成果物だけを配置)
104
+ │ │ │ │ └── 010-business-specs/ # 現行の業務仕様(例)
105
+ │ │ │ │
106
+ │ │ │ ├── 050-impact-analysis/ # 影響調査
107
+ │ │ │ │ ├── imp-business.md # 業務影響
108
+ │ │ │ │ ├── imp-data.md # データ影響
109
+ │ │ │ │ ├── imp-interface.md # インターフェース影響
110
+ │ │ │ │ ├── imp-test.md # テスト影響
111
+ │ │ │ │ └── imp-operations.md # 運用影響
112
+ │ │ │ │
113
+ │ │ │ ├── 060-migration-planning/ # 移行計画
114
+ │ │ │ │ ├── mip-index.md # 移行計画
115
+ │ │ │ │ ├── dmd-index.md # データ移行設計
116
+ │ │ │ │ ├── mtp-index.md # 移行テスト計画(リハーサル計画)
117
+ │ │ │ │ ├── cop-index.md # カットオーバー計画(本番切替手順)
118
+ │ │ │ │ └── otp-index.md # 運用切替計画(ハイパーケア含む)
119
+ │ │ │ │
120
+ │ │ │ ├── ... # 050- 以降の成果物ドメイン
121
+ │ │ │ │
122
+ │ │ │ ├── controls/ # 管理台帳・管理ビュー(全ドメイン横断)
123
+ │ │ │ │ ├── project-register/ # 統合管理台帳(正本)
124
+ │ │ │ │ │ ├── pjr-0001-auth.md # 登録項目(認証)
125
+ │ │ │ │ │ ├── pjr-0002-payment.md # 登録項目(決済)
126
+ │ │ │ │ │ ├── events/ # 項目別の監査イベントログ
127
+ │ │ │ │ │ │ ├── pjr-0001.yaml # PJR-0001 のイベント配列
128
+ │ │ │ │ │ │ └── pjr-0002.yaml # PJR-0002 のイベント配列
129
+ │ │ │ │ │ └── generated/ # 正本から生成される補助一覧
130
+ │ │ │ │ │ ├── pjr-index.md # プロジェクト登録台帳・文書IDの解決先
131
+ │ │ │ │ │ ├── pjr-views-by-status.md # 台帳ビュー(状態別)
132
+ │ │ │ │ │ ├── pjr-views-by-priority.md # 台帳ビュー(優先度別)
133
+ │ │ │ │ │ └── pjr-views-by-owner.md # 台帳ビュー(担当者別)
134
+ │ │ │ │ │
135
+ │ │ │ │ ├── reviews/ # レビュー結果 ※成果物カタログ管理対象外
136
+ │ │ │ │ │
137
+ │ │ │ │ └── generated/ # type別の派生管理ビュー
138
+ │ │ │ │ ├── pm-risk-register.md # type=risk の抽出ビュー
139
+ │ │ │ │ ├── pm-issue-log.md # type=issue の抽出ビュー
140
+ │ │ │ │ ├── pm-change-request-log.md # type=change-request の抽出ビュー
141
+ │ │ │ │ ├── pm-decision-log.md # type=decision の抽出ビュー
142
+ │ │ │ │ └── traceability/ # ID参照から生成する任意のトレースビュー
143
+ │ │ │ │
144
+ │ │ │ ├── schedule/ # Schedule
145
+ │ │ │ │ ├── sch-milestones.yaml # マイルストーン定義
146
+ │ │ │ │ ├── sch-defaults.yaml # 共通デフォルト設定
147
+ │ │ │ │ ├── sch-track-<track>.yaml # トラックごとのSchedule定義
148
+ │ │ │ │ └── sch-strategy-<track>.yaml # intent とトラックごとのタスク生成戦略
149
+ │ │ │ │
150
+ │ │ │ ├── routines/ # 定期実行ルーチン ※成果物カタログ管理対象外
151
+ │ │ │ │ └── rtn-<name>.yaml # ルーチン定義
152
+ │ │ │ │
153
+ │ │ │ ├── jobs/ # 再利用可能なJob Definition ※成果物カタログ管理対象外
154
+ │ │ │ │ └── job-<name>.yaml # Job定義
155
+ │ │ │ │
156
+ │ │ │ ├── execution/ # 実行管理 ※成果物カタログ管理対象外
157
+ │ │ │ │ ├── exec/ # タスク実行ワークスペース
158
+ │ │ │ │ │ ├── plans/ # 実行プラン
159
+ │ │ │ │ │ ├── results/ # 実行結果
160
+ │ │ │ │ │ ├── events/ # イベントログ
161
+ │ │ │ │ │ └── .locks/ # 実行ロック
162
+ │ │ │ │ ├── jobs/ # Job Run履歴と派生state
163
+ │ │ │ │ │ ├── runs/ # 入力・task・attempt・結果
164
+ │ │ │ │ │ └── generated/ # checkpoint派生ビュー
165
+ │ │ │ │ ├── grade/ # 継続品質評価(最新状態)
166
+ │ │ │ │ │ ├── criteria/ # 成果物別のdone_criteria判定詳細
167
+ │ │ │ │ │ └── generated/ # 再生成可能な派生物(git管理外)
168
+ │ │ │ │ │ └── plans/ # 1文書単位の評価plan
169
+ │ │ │ │ │ ├── kata/ # Kata評価plan
170
+ │ │ │ │ │ └── deliverable/ # 成果物評価plan
171
+ │ │ │ │ └── generated/ # 自動生成成果物
172
+ │ │ │ │
173
+ │ │ │ └── reporting/ # レポート
174
+ │ │ │ ├── progress-reports/ # 進捗報告
175
+ │ │ │ │ ├── pr-2026-03-01-01.md # 進捗報告
176
+ │ │ │ │ └── pr-2026-03-08-01.md # 進捗報告
177
+ │ │ │ └── meeting-minutes/ # 議事録
178
+ │ │ │ ├── mm-2026-03-01-01.md # 議事録
179
+ │ │ │ └── mm-2026-03-08-01.md # 議事録
180
+ │ │ │
181
+ │ │ └── prj-0002/ ... # 他プロジェクト
182
+ │
183
+ └── en/ # 将来の英語ドキュメント用ディレクトリ
184
+ ```
185
+
186
+ ## 3. プロダクトドキュメントの構成
187
+
188
+ ```text
189
+ docs/
190
+ ├── ja/ # 多言語化対応(将来: en/ など)
191
+ │ └── product/
192
+ │ ├── 010-business-specs/ # 業務仕様
193
+ │ │ ├── 010-data-flow/ # データフロー
194
+ │ │ │ └── cdfd-sales.md # 概念データフロー図(プロセスグループ別の例:販売)
195
+ │ │ ├── 020-data-model/ # データモデル
196
+ │ │ │ ├── bdd-sales-management.md # 業務データ辞書(例:販売管理)
197
+ │ │ │ ├── cdsd-sales-management.md # 概念データストア定義(例:販売管理)
198
+ │ │ │ ├── sld-sales-management.md # 保管場所定義(例:倉庫・店舗)
199
+ │ │ │ ├── stsd-product-lifecycle.md # ステータス定義(状態一覧・状態遷移図の例:商品ライフサイクル)
200
+ │ │ │ ├── cld-product-category.md # 分類定義(例:商品カテゴリ)
201
+ │ │ │ └── ccd-sales-management.md # 概念クラス図(例:販売管理)
202
+ │ │ ├── 030-business-model/ # 業務モデル
203
+ │ │ │ ├── bps-sales-order-flow.md # 業務プロセス仕様(例:受注フロー)
204
+ │ │ │ ├── br-reorder-point.md # ビジネスルール(例:発注点判定)
205
+ │ │ │ ├── bes-index.md # 業務イベント仕様(全体構成)(例:販売管理)
206
+ │ │ │ └── bes-order-approved.md # 業務イベント仕様(個別)(例:受注承認)
207
+ │ │ ├── 040-user-interface-model/ # ユーザーインターフェースモデル
208
+ │ │ │ ├── uis-order-entry.md # 画面仕様(例:受注入力)
209
+ │ │ │ └── bds-order-summary.md # 帳票仕様(例:受注明細)
210
+ │ │ ├── 050-system-functions/ # システム化機能
211
+ │ │ │ ├── sf-index.md # システム化機能一覧(全体構成)
212
+ │ │ │ └── sf-order-entry.md # システム化機能(個別)(例:受注入力)
213
+ │ │ └── 060-glossary/ # 用語集
214
+ │ │ └── gl-sales-management.md # 用語集(例:販売管理)
215
+ │ │
216
+ │ ├── 020-external-interface-specs/ # 外部I/F仕様
217
+ │ │ ├── ifx-index.yaml # 外部システムI/F一覧
218
+ │ │ ├── ifx-api-supplier-system.yaml # 外部API仕様(例:仕入先システム)
219
+ │ │ ├── ifx-file-inventory-sync.yaml # 外部ファイル連携仕様(例:在庫同期)
220
+ │ │ └── ifx-msg-stock-changed.yaml # 外部メッセージ仕様(例:在庫変更通知)
221
+ │ │
222
+ │ ├── 030-architecture/ # アーキテクチャ
223
+ │ │ ├── 010-c4/ # C4(構造・依存関係)
224
+ │ │ │ ├── cxd-sales-management.md # C4コンテキスト図(例:販売管理)
225
+ │ │ │ ├── cnd-sales-management.md # C4コンテナ図(例:販売管理)
226
+ │ │ │ └── cpd-sales-management.md # C4コンポーネント図(例:販売管理)
227
+ │ │ └── 020-infrastructure/ # インフラ・技術選定
228
+ │ │ ├── ifd-production-environment.md # インフラ構成図(例:本番環境)
229
+ │ │ └── tsd-sales-management.md # 技術スタック一覧(例:販売管理)
230
+ │ │
231
+ │ ├── 040-system-design/ # システム設計
232
+ │ │ ├── sysd-index.md # 全体構成(リンク集)
233
+ │ │ ├── sysd-critical-flows.md # 重要フロー
234
+ │ │ └── sysd-cross-cutting-policy.md # 横断ルール
235
+ │ │
236
+ │ ├── 050-business-acceptance-criteria/ # 業務受入条件
237
+ │ │ └── bac-sales-order.md # 業務受入条件(例:受注)
238
+ │ │
239
+ │ ├── 060-non-functional-requirements/ # 非機能要件
240
+ │ │ ├── nfr-index.md # 非機能要件
241
+ │ │ ├── nfr-reliability.md # 非機能要件 / 信頼性
242
+ │ │ ├── nfr-availability.md # 非機能要件 / 可用性
243
+ │ │ ├── nfr-maintainability.md # 非機能要件 / 保守性
244
+ │ │ ├── nfr-integrity.md # 非機能要件 / 完全性
245
+ │ │ ├── nfr-security-safety.md # 非機能要件 / 機密性・安全性
246
+ │ │ ├── nfr-performance.md # 非機能要件 / 性能
247
+ │ │ ├── nfr-operations.md # 非機能要件 / 運用
248
+ │ │ └── nfr-usability.md # 非機能要件 / 操作性
249
+ │ │
250
+ │ ├── 070-system-acceptance-criteria/ # システム受入条件
251
+ │ │ └── sac-sales-management.md # システム受入条件(例:販売管理)
252
+ │ │
253
+ │ ├── 080-test-specs/ # テスト仕様
254
+ │ │ ├── 010-test-strategy-and-policy/ # テスト戦略・方針
255
+ │ │ │ └── tsp-index.md # テスト戦略・方針
256
+ │ │ ├── 020-unit-test-catalog/ # 単体テストカタログ
257
+ │ │ │ ├── utc-index.md # 単体テスト
258
+ │ │ │ └── utc-order-service.md # 単体テスト対象別(例:受注サービス)
259
+ │ │ ├── 030-internal-integration-test-catalog/ # 内部結合テストカタログ
260
+ │ │ │ ├── itc-index.md # 内部結合テスト
261
+ │ │ │ └── itc-order-flow.md # 内部結合テスト対象別(例:受注フロー)
262
+ │ │ ├── 040-external-integration-test-catalog/ # 外部結合テストカタログ
263
+ │ │ │ ├── etc-index.md # 外部結合テスト
264
+ │ │ │ └── etc-payment-gateway.md # 外部結合テスト対象別(例:決済GW)
265
+ │ │ ├── 050-system-test-catalog/ # 総合結合テストカタログ
266
+ │ │ │ ├── stc-index.md # 総合テスト
267
+ │ │ │ └── stc-order-to-settlement.md # 総合テスト対象別(例:受注〜決済)
268
+ │ │ └── 060-acceptance-test-catalog/ # 受入結合テストカタログ
269
+ │ │ ├── atc-index.md # 受入テスト
270
+ │ │ └── atc-store-operations.md # 受入テスト対象別(例:店舗運用)
271
+ │ │
272
+ │ └── 090-operations/ # 運用
273
+ │ ├── opd-index.md # 運用方針・設計
274
+ │ ├── opd-monitoring.md # 運用方針・設計(監視)(例:アラート運用)
275
+ │ ├── opr-index.md # 運用手順(例:全体手順)
276
+ │ ├── opr-incident.md # 運用手順(障害対応)(例:P1対応)
277
+ │ └── opr-backup-restore.md # 運用手順(バックアップ・リストア)(例:復旧演習)
278
+ │
279
+ └── en/ # 将来の英語ドキュメント用ディレクトリ
280
+ ```
@@ -0,0 +1,133 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:specdojo-config-reference
4
+ type: reference
5
+ status: draft
6
+ ---
7
+
8
+ # SpecDojo設定リファレンス
9
+
10
+ SpecDojo Configuration Reference
11
+
12
+ `.specdojo/specdojo.config.json` のキー、既定値、パスの基準、利用するコマンドを一覧します。設定の型とパス解決の正本は CLI 実装です。
13
+
14
+ **対象範囲**
15
+
16
+ - `.specdojo/specdojo.config.json` のトップレベル、project、`run` の設定キー
17
+
18
+ **ここで引けるもの**
19
+
20
+ - 各キーの役割、既定値、パスの基準、必要とする主なコマンド
21
+ - register だけの最小構成から catalog / schedule / exec へ進むときに追加するキー
22
+
23
+ **詳細の参照先**
24
+
25
+ - 初期導入の手順は [[specdojo:quick-start-guide|Quick Startガイド]]、agent と provider の設定は [[specdojo:exec-config-guide|exec設定ガイド]] を参照してください。
26
+ - 標準配置は [[specdojo:directory-layout-reference|ディレクトリレイアウトリファレンス]]、個別コマンドは [[specdojo:command-reference|CLIコマンドリファレンス]] を参照してください。
27
+
28
+ ## 1. 最小構成
29
+
30
+ `npx specdojo config init` は、register を開始できる次の最小構成を生成します。catalog や schedule の未使用キーは生成しません。
31
+
32
+ ```json
33
+ {
34
+ "version": 1,
35
+ "current_project": "prj-0001",
36
+ "projects": {
37
+ "prj-0001": {
38
+ "base_path": "docs/ja/projects/prj-0001",
39
+ "project_register_path": "controls/project-register",
40
+ "project_context": ["prj-overview"],
41
+ "run": {
42
+ "worktree_base": "../app1-worktrees"
43
+ }
44
+ }
45
+ }
46
+ }
47
+ ```
48
+
49
+ この構成では `config init`、`register scaffold` / `add` / `build`、`dashboard build`、`exec plan --register` を利用できます。catalog へ進むときは `catalog_path`、schedule へ進むときは後述の関連キーを段階的に追加します。
50
+
51
+ ## 2. トップレベルのキー
52
+
53
+ | キー | 必須 | 既定値 | 役割・利用箇所 |
54
+ | ----------------- | ---- | -------------------------------------- | ----------------------------------------------------------------------------------------------- |
55
+ | `version` | 必須 | なし。現行値は `1` | 設定形式のバージョンです。すべての config 利用コマンドが検証します。 |
56
+ | `current_project` | 任意 | コマンドにより `projects` の先頭を使用 | `--project` と `SPECDOJO_PROJECT` を省略したときの対象 project です。 |
57
+ | `projects` | 必須 | なし | project ID をキー、project 設定を値とするオブジェクトです。複数 project を1ファイルで扱えます。 |
58
+
59
+ 対象 project の一般的な解決順序は、`--project <id>`、`SPECDOJO_PROJECT`、`current_project`、`projects` の先頭です。一部のコマンドは `current_project` を参照せず `projects` の先頭へフォールバックするため、複数 project では `--project` を明示してください。
60
+
61
+ ## 3. projectのパスキー
62
+
63
+ `projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
64
+
65
+ | キー | 既定値 | 主な役割 | 必要とする主なコマンド |
66
+ | ----------------------- | ---------------- | -------------------------------------------------------- | ------------------------------------------------------------- |
67
+ | `base_path` | リポジトリルート | project 文書に共通するパス接頭辞 | project に紐づく各コマンド |
68
+ | `project_register_path` | なし | 個票、event、登録簿の配置先 | `register *`、`exec plan/run --register` |
69
+ | `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先 | `catalog *`、`deliverable scaffold`、catalog を使う grade 等 |
70
+ | `schedule_path` | `schedule` | strategy、track、Schedule の配置先 | `schedule *`、schedule 対象の `exec *` |
71
+ | `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先 | `exec *`、`grade *`、`job *`、`dashboard build` |
72
+ | `timeline_path` | `timeline` | Timeline の正本と生成物の配置先 | `timeline *`、`dashboard build`、`schedule strategy generate` |
73
+ | `members_path` | なし | 人・agent、ロール、provider を定義する `pm-members.yaml` | actor 検証、agent 実行、owner 検証、`grade apply --by` |
74
+ | `roles_path` | なし | role 定義ファイルの配置先 | `schedule strategy generate`、owner を解決する `exec plan` |
75
+ | `viewpoints_path` | なし | review / grade 観点ファイルの配置先 | `grade *`、review plan、`exec scaffold --project` |
76
+ | `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先 | `routine *`、routine を集約する `dashboard build` |
77
+ | `jobs_path` | なし | `job-*.yaml` の配置先 | `job *`、`exec run --job` |
78
+
79
+ `schedule_path`、`execution_path`、`timeline_path` には解決時の既定値があります。ただし `schedule` コマンドや一括 `build` の対象判定ではキーの明示が必要なため、catalog から Schedule と exec へ進む構成では省略しないでください。
80
+
81
+ ## 4. projectの非パスキー
82
+
83
+ | キー | 既定値 | 役割・利用箇所 |
84
+ | ----------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
85
+ | `project_context` | `["prj-overview"]` | edit / review plan へ常に渡す project 共通文書のローカル ID です。空配列 `[]` で無効化できます。`depends_on` や成果物の `based_on` は変更しません。 |
86
+ | `run` | `{}` | agent 実行、worktree、登録日の表示に関する project 単位の設定です。 |
87
+
88
+ ## 5. `run`のキー
89
+
90
+ `projects.<project-id>.run` に指定します。これらのパスは `base_path` の影響を受けず、リポジトリルート基準です。
91
+
92
+ | キー | 既定値 | 役割・利用箇所 |
93
+ | ------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------- |
94
+ | `exec_defaults` | なし | provider、権限、リトライなどを定義する exec defaults ファイルです。agent を起動する `exec run` が参照します。 |
95
+ | `agent_config` | なし | `exec_defaults` の旧キーです。互換目的でのみ利用し、新しい設定では `exec_defaults` を使います。 |
96
+ | `worktree_base` | `../worktrees` | `exec run --worktree` / `--auto` と `exec trial` が作る worktree の親です。リポジトリ外を指定します。 |
97
+ | `register_date_timezone` | `UTC` | 登録簿の「登録日」「完了日」を日時から暦日へ変換する IANA タイムゾーン名です。例は `Asia/Tokyo` です。 |
98
+
99
+ `config init` は Detached Unit の標準配置に合わせ、一般既定の `../worktrees` ではなく `../app1-worktrees` を `worktree_base` へ明示します。
100
+
101
+ ## 6. catalog・schedule・execへ進む設定例
102
+
103
+ register の最小構成から成果物カタログと Schedule へ進む場合は、対象 project へ必要なキーを追加します。次は Quick Start の代表例です。
104
+
105
+ ```json
106
+ {
107
+ "base_path": "docs/ja/projects/prj-0001",
108
+ "catalog_path": "010-deliverables-catalog",
109
+ "schedule_path": "schedule",
110
+ "execution_path": "execution",
111
+ "timeline_path": "timeline",
112
+ "members_path": "030-project-management/pm-members.yaml",
113
+ "roles_path": "030-project-management/pm-roles.yaml",
114
+ "viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
115
+ "project_register_path": "controls/project-register",
116
+ "project_context": ["prj-overview"],
117
+ "run": {
118
+ "exec_defaults": ".specdojo/exec-defaults.yaml",
119
+ "worktree_base": "../app1-worktrees"
120
+ }
121
+ }
122
+ ```
123
+
124
+ routine / Job を使う段階で、同じ project 設定へ `routines_path` と `jobs_path` を追加します。未使用のキーまで最初から埋める必要はありません。
125
+
126
+ ## 7. 設定不足時の確認順序
127
+
128
+ 1. エラーに表示されたキーが対象 project にあるか確認します。
129
+ 2. `base_path` と対象パスを連結した先が意図した配置か確認します。
130
+ 3. 複数 project では `npx specdojo <command> --project <project-id>` のように対象を明示します。
131
+ 4. `npx specdojo project list` で project と解決された Schedule / execution のパスを確認します。
132
+
133
+ `catalog_path not set` は、`config init` が register 用の最小構成だけを生成するために表示されます。`catalog_path` を追加してから `catalog scaffold` を再実行してください。