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
package/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Tiny Shrine
4
+ Authored by naoji3x
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
package/README.md CHANGED
@@ -1,59 +1,166 @@
1
- # specdojo
1
+ # SpecDojo
2
2
 
3
- CLI for SpecDojo specification-driven execution workflows.
3
+ SpecDojo は、仕様駆動開発のためのドキュメントフレームワークです。
4
+ プロダクトの構築・改修に必要な情報を体系化し、人と生成 AI が同じ成果物を作成・検証・更新できるようにします。
4
5
 
5
- ## Install
6
+ **登録簿ひとつから始められます。** 設定 2 行で使い始め、必要になった分だけ広げられます。
6
7
 
7
- ```bash
8
- npm install -g specdojo
8
+ ## できること
9
+
10
+ ### 気づいたことを、型に沿って残せる
11
+
12
+ 作業だけでなく、判断・保留・観測・リスク・変更要求も同じ登録簿へ記録します。種別を選ぶと
13
+ 本文の章構成が与えられるため、「選択肢を比較して理由を書く」といった記録が形を保ちます。
14
+ 正本は Markdown なので、`git log` でそのまま読め、3 年後も SpecDojo なしで読めます。
15
+ 決定ログ・課題ログ・リスク登録簿は、この記録から生成されます。
16
+
17
+ ### 会話で進められる
18
+
19
+ 同梱の対話型オーケストレーターを配置すると、やりたいことを話すだけで進みます。
20
+ 調査や議論の内容がそのまま個票の本文になるため、別途まとめ直す必要がありません。
21
+ 状態を変える操作は実行前に提示して承認を求め、`git push` や破壊的操作は行いません。
22
+
23
+ ### 必要になったら、成果物の型へ広げられる
24
+
25
+ 要件、設計、テスト、運用まで 100 種類以上の記述規則・手順・テンプレート・サンプルを持ちます。
26
+ 使うものだけをカタログで宣言し、型に沿って作れます。最初から全部を用意する必要はありません。
27
+
28
+ 日本語ドキュメントは [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
29
+
30
+ ## この README の役割
31
+
32
+ この README は、GitHub やパッケージページでリポジトリを訪れた人に、SpecDojo の概要、入手方法、詳しい文書への入口を示します。
33
+ 文書体系や CLI 操作の詳細はここへ複製せず、ドキュメントサイトを正本とします。
34
+
35
+ ## 使い始める
36
+
37
+ ### npm で導入する
38
+
39
+ 既定では、プロダクトリポジトリ `app1/` の隣に SpecDojo 専用リポジトリ
40
+ `app1-specdojo/` と worktree 用ディレクトリ `app1-worktrees/` を置く Detached Unit で始めます。
41
+ workspace 直下で次を実行します。
42
+
43
+ ```sh
44
+ mkdir app1-specdojo app1-worktrees
45
+ git -C app1-specdojo init
46
+ cd app1-specdojo
47
+ npm init -y
48
+ npm install --save-dev specdojo @specdojo/docs-lint
49
+ npx specdojo config init
9
50
  ```
10
51
 
11
- Or run via `npx`:
52
+ SpecDojo は文書と実行管理のためのツールで、成果物へ同梱されるものではないため `--save-dev` で導入します。あわせて、kata は `node_modules/specdojo` から参照されるため、`package-lock.json` が kata の版も固定します。グローバル導入(`npm install -g`)では版がプロジェクトに記録されず再現できません。
53
+
54
+ `config init` は `.specdojo/specdojo.config.json` とその親ディレクトリを作成します。既定では
55
+ `prj-0001` と `docs/ja/projects/prj-0001/controls/project-register` を使う最小構成です。別の
56
+ project ID や配置を使う場合は、生成された設定の `current_project`、`projects` のキー、
57
+ `base_path` を次へ進む前に変更してください。catalog や schedule へ進むときに追加するキーは
58
+ [SpecDojo設定リファレンス](https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html)で確認できます。
59
+
60
+ ### オーケストレーターを配置する
61
+
62
+ SpecDojo は対話型オーケストレーターを同梱しています。CLI を直接叩く代わりに、会話で意図を伝えると、
63
+ 対応するコマンドを提案し、承認を得てから実行します。利用する provider の設定を配置します。
12
64
 
13
- ```bash
14
- npx specdojo --help
65
+ ```sh
66
+ npx specdojo config scaffold --provider claude
15
67
  ```
16
68
 
17
- ## Quick start
69
+ `--provider` には `antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定できます。
70
+ オーケストレーターの配置先と起動方法は provider ごとに異なります。
18
71
 
19
- Initialize config:
72
+ | provider | 配置先 | 起動 |
73
+ | ------------- | ------------------------------------------- | -------------------------------------------------------------------------- |
74
+ | `claude` | `.claude/agents/specdojo-orchestrator.md` | `claude --agent specdojo-orchestrator` |
75
+ | `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `opencode --agent specdojo-orchestrator` |
76
+ | `codex` | `.specdojo/codex/orchestrator.md` | `codex "$(cat .specdojo/codex/orchestrator.md)"` |
77
+ | `antigravity` | `.specdojo/antigravity/orchestrator.md` | `agy --add-dir "$(pwd)" -i "$(cat .specdojo/antigravity/orchestrator.md)"` |
20
78
 
21
- ```bash
22
- specdojo config init
79
+ `claude` と `opencode` は agent の定義ファイルを名前で選べるため、`--agent` で起動します。`codex` と
80
+ `antigravity` は定義ファイルから agent を選ぶ仕組みを持たないため、規範の本文を起動時の指示として
81
+ 渡します。antigravity の `.agents/` は rules と skills のためのディレクトリで、agent の定義は扱いません。
82
+ rules へ置くと全セッションへ読み込まれ、executor として起動したときにも役割が混入します。
83
+
84
+ 配置されるファイルにはモデル名が書かれています。手元で使えるモデルに合わせて編集してください。
85
+ executor / reporter の設定も同時に配置されるので、agent にタスクを実行させる段階で使います。
86
+
87
+ ### 会話で操作する
88
+
89
+ 起動したら、やりたいことをそのまま伝えます。オーケストレーターがコマンドへ翻訳し、実行前に内容を提示します。
90
+
91
+ ```text
92
+ あなた : このプロジェクトを始めたい。まず登録簿を用意して、最初の作業を起票して。
93
+ agent : 次を実行します。よろしいですか。
94
+ npx specdojo register scaffold --project prj-0001
95
+ npx specdojo register add --project prj-0001 --type todo --title "..."
96
+ あなた : お願いします。
23
97
  ```
24
98
 
25
- List projects:
99
+ 状態を変える操作は承認を得てから実行し、`git push` や破壊的操作は行いません。起票した項目の
100
+ 実行、状況の確認、成果物の生成も同じ流れで進みます。
26
101
 
27
- ```bash
28
- specdojo project list
102
+ ```text
103
+ PJR-XXXX を実行して
104
+ 今の状況は?
105
+ kata の rulebook を確認したい
29
106
  ```
30
107
 
31
- Validate and build execution artifacts:
108
+ 詳しい進め方は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
32
109
 
33
- ```bash
34
- specdojo exec validate --project shj-0001
35
- specdojo exec build --project shj-0001
110
+ ### CLI を直接使う
111
+
112
+ agent を使わずに操作することもできます。最初の登録簿と todo を作り、一覧を生成します。
113
+
114
+ ```sh
115
+ npx specdojo register scaffold --project prj-0001
116
+ npx specdojo register add \
117
+ --project prj-0001 \
118
+ --type todo \
119
+ --title "最初のタスク"
120
+ npx specdojo register build --project prj-0001
36
121
  ```
37
122
 
38
- Claim the next task:
123
+ ここまでの手順は、利用側へ kata をコピーせずに実行できます。生成された todo の個票が編集対象、
124
+ `generated/pjr-index.md` が個票から作る一覧です。`register add` が表示した ID を使い、agent を
125
+ 起動せずに exec plan の内容まで確認できます。
39
126
 
40
- ```bash
41
- specdojo exec scheduler --project shj-0001 --by copilot --owner ARC
127
+ ```sh
128
+ npx specdojo exec plan --project prj-0001 --register PJR-XXXX
42
129
  ```
43
130
 
44
- ## Config file
131
+ kata は既定で npm package 内のものを参照します。適用中の rulebook を確認し、プロジェクトで
132
+ 上書きする場合だけ eject します。
133
+
134
+ ```sh
135
+ npx specdojo kata list --kind rulebook
136
+ npx specdojo kata show specdojo:pjr-rulebook
137
+ npx specdojo kata eject --id specdojo:pjr-rulebook
138
+ ```
45
139
 
46
- Create `specdojo.config.json` in the repository root.
140
+ provider と agent の設定を終えた後は、同じ登録項目を実行できます。成功後は人が result と成果物を
141
+ 確認し、登録項目を close します。
47
142
 
48
- ```json
49
- {
50
- "version": 1,
51
- "projects": {
52
- "shj-0001": {
53
- "schedule_path": "docs/ja/sdh-ja-projects/prj-0001/060-schedule",
54
- "execution_path": "docs/ja/sdh-ja-projects/prj-0001/070-execution",
55
- "members_path": "docs/ja/sdh-ja-projects/prj-0001/040-project-management/010-management-plan/members.yaml"
56
- }
57
- }
58
- }
143
+ ```sh
144
+ npx specdojo exec run --project prj-0001 --register PJR-XXXX
59
145
  ```
146
+
147
+ agent の実行は数分から数十分かかり、`routine` は定期実行されます。作業端末の状態に依存せず
148
+ 実行を続けたい場合は、常時稼働するホストへリモート接続する構成例を
149
+ [常時稼働ホスト運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/remote-host-development-guide.html) に示しています。
150
+
151
+ ### テンプレートリポジトリとして導入する
152
+
153
+ npm package の参照方式ではなく、SpecDojo のソースと文書体系一式を最初から配置して
154
+ カスタマイズする場合は、このリポジトリの **Use this template** から新しいリポジトリを作成します。
155
+ 通常の利用開始には、更新差分を小さく保てる npm 導入を推奨します。
156
+
157
+ 導入後の初期設定と、最初のタスクを完了するまでの手順は [Quick Start ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/quick-start-guide.html) を参照してください。
158
+ 全体像から確認する場合は [全体概要ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/specdojo-overview-guide.html) を参照してください。
159
+
160
+ ## ライセンス
161
+
162
+ 本リポジトリは MIT ライセンスです。詳細は [LICENSE](LICENSE) を参照してください。
163
+
164
+ ## フィードバック
165
+
166
+ Issue または Pull Request を歓迎します。
@@ -0,0 +1,27 @@
1
+ // agent の最終応答から JSON 本体を取り出す。
2
+ //
3
+ // plan で「JSON だけを出力する」と契約しても、provider やモデルによって前後に
4
+ // 文字列が付く。実測では claude と gemma がコードフェンスで囲み、qwen が作業経過の
5
+ // 前置きを残した。生の応答をそのまま JSON.parse すると、判定内容が妥当でも解析に
6
+ // 失敗する。
7
+ //
8
+ // Ollama の format 指定など provider 固有の出力強制は、他 provider へ適用できず、
9
+ // thinking を有効化した agent とも競合しうるため採らない。呼び出し側は抽出後の
10
+ // 文字列を検証するため、抽出に失敗しても不正な内容を受け入れることはない。
11
+ /**
12
+ * agent の生応答から JSON オブジェクトの本文を取り出す。
13
+ * 取り出せない場合は入力をそのまま返し、解析の失敗は呼び出し側の検証に委ねる。
14
+ */
15
+ export function extractJsonText(raw) {
16
+ const unfenced = stripCodeFence(raw.trim());
17
+ const start = unfenced.indexOf("{");
18
+ const end = unfenced.lastIndexOf("}");
19
+ if (start === -1 || end <= start)
20
+ return unfenced;
21
+ return unfenced.slice(start, end + 1);
22
+ }
23
+ // 最初のコードフェンスの中身を返す。フェンスが無ければ入力をそのまま返す。
24
+ function stripCodeFence(text) {
25
+ const fenced = /```[a-z]*\r?\n([\s\S]*?)```/i.exec(text);
26
+ return fenced ? fenced[1].trim() : text;
27
+ }
package/dist/agent.js ADDED
@@ -0,0 +1,124 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { dirname, resolve } from "node:path";
3
+ import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "./exec-agent-config.js";
4
+ import { resolveProjectPaths } from "./exec-project.js";
5
+ import { executeAgent, loadRosterForExecutionPath } from "./exec-run.js";
6
+ import { gitEnvironment } from "./git-environment.js";
7
+ import { specdojoRootDir } from "./specdojo-config.js";
8
+ // Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
9
+ // shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
10
+ export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
11
+ export function resolveAgentMember(roster, nickname) {
12
+ const members = roster?.members.filter((candidate) => {
13
+ return candidate.type === "agent" && candidate.nickname === nickname;
14
+ });
15
+ if (!members || members.length === 0) {
16
+ return { error: `--by agent nickname not found in pm-members.yaml: ${nickname}` };
17
+ }
18
+ if (members.length !== 1) {
19
+ return { error: `--by agent nickname is not unique in pm-members.yaml: ${nickname}` };
20
+ }
21
+ const [member] = members;
22
+ if (member.disabled) {
23
+ return { error: `--by agent is disabled in pm-members.yaml: ${nickname}` };
24
+ }
25
+ return { member };
26
+ }
27
+ export function resolveAgentCommand(execDefaults, member) {
28
+ let command;
29
+ try {
30
+ command = resolveMemberCommand(execDefaults, member);
31
+ }
32
+ catch (error) {
33
+ return { error: error instanceof Error ? error.message : String(error) };
34
+ }
35
+ if (!command) {
36
+ return { error: `--by agent has no resolvable command: ${member.nickname}` };
37
+ }
38
+ return { command };
39
+ }
40
+ export function readAgentPlan(planPath) {
41
+ const absolutePath = resolve(planPath);
42
+ if (!existsSync(absolutePath)) {
43
+ throw new Error(`--plan not found: ${planPath}`);
44
+ }
45
+ const prompt = readFileSync(absolutePath, "utf8");
46
+ if (!prompt.trim()) {
47
+ throw new Error(`--plan is empty: ${planPath}`);
48
+ }
49
+ return prompt;
50
+ }
51
+ export function writeAgentOutput(outPath, stdout) {
52
+ const absolutePath = resolve(outPath);
53
+ mkdirSync(dirname(absolutePath), { recursive: true });
54
+ writeFileSync(absolutePath, stdout, "utf8");
55
+ return absolutePath;
56
+ }
57
+ export async function runAgentPlan(opts) {
58
+ const prompt = readAgentPlan(opts.planPath);
59
+ const paths = resolveProjectPaths({ project: opts.project });
60
+ const roster = loadRosterForExecutionPath(paths.executionPath);
61
+ const memberResult = resolveAgentMember(roster, opts.nickname);
62
+ if ("error" in memberResult)
63
+ throw new Error(memberResult.error);
64
+ const { member } = memberResult;
65
+ const execDefaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), paths.executionPath);
66
+ const commandResult = resolveAgentCommand(execDefaults, member);
67
+ if ("error" in commandResult)
68
+ throw new Error(commandResult.error);
69
+ const { command } = commandResult;
70
+ if (opts.dryRun) {
71
+ process.stdout.write(`${command}\n`);
72
+ return { command, actor: member.nickname };
73
+ }
74
+ const execution = await executeAgent(command, prompt, resolveRateLimitDetection(execDefaults, member.provider), member.provider, resolveRateLimitPolicy(execDefaults, member.provider)?.cooldown_seconds, specdojoRootDir(), {
75
+ ...gitEnvironment(),
76
+ SPECDOJO_SCHEDULE_PATH: paths.schedulePath,
77
+ SPECDOJO_EXECUTION_PATH: paths.executionPath,
78
+ }, opts.quiet);
79
+ return { execution, command, actor: member.nickname };
80
+ }
81
+ export function registerAgentCommands(program) {
82
+ const agent = program.command("agent").description("Run a plan with a specific agent");
83
+ agent
84
+ .command("run")
85
+ .description("Feed a plan to one agent and capture its stdout")
86
+ .requiredOption("--plan <path>", "Plan file passed to the agent on stdin")
87
+ .requiredOption("--by <nickname>", "Agent nickname defined in pm-members.yaml")
88
+ .option("--out <path>", "Write the agent stdout to this file instead of the terminal")
89
+ .option("--project <projectId>", "Project id in specdojo.config.json")
90
+ .option("--exec-defaults <path>", "Override the exec-defaults.yaml path")
91
+ .option("--dry-run", "Print the resolved command without executing", false)
92
+ .action(async (options) => {
93
+ try {
94
+ const { execution, command, actor } = await runAgentPlan({
95
+ planPath: options.plan,
96
+ nickname: options.by,
97
+ project: options.project,
98
+ execDefaultsPath: options.execDefaults,
99
+ dryRun: options.dryRun,
100
+ quiet: options.out !== undefined,
101
+ });
102
+ if (!execution)
103
+ return;
104
+ if (options.out) {
105
+ const writtenPath = writeAgentOutput(options.out, execution.stdout);
106
+ process.stdout.write(`Wrote agent stdout: ${writtenPath}\n`);
107
+ }
108
+ if (execution.result === "rate_limit") {
109
+ process.stderr.write(`rate limit: ${actor} (${command})` +
110
+ `${execution.limit?.resume_at ? ` resume_at=${execution.limit.resume_at}` : ""}\n`);
111
+ process.exitCode = AGENT_RUN_RATE_LIMIT_EXIT_CODE;
112
+ return;
113
+ }
114
+ if (execution.result === "failure") {
115
+ process.stderr.write(`agent failed: ${actor} exit=${execution.exitCode ?? "null"}\n`);
116
+ process.exitCode = 1;
117
+ }
118
+ }
119
+ catch (error) {
120
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
121
+ process.exitCode = 1;
122
+ }
123
+ });
124
+ }
@@ -0,0 +1,149 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { loadConfig, loadEnv, specdojoRootDir } from "./specdojo-config.js";
3
+ import { selfRunArgs } from "./spawn-self.js";
4
+ const VALID_SCOPES = [
5
+ "exec",
6
+ "catalog",
7
+ "register",
8
+ "yaml-pages",
9
+ "dashboard",
10
+ "index",
11
+ "all",
12
+ ];
13
+ // ================================
14
+ // Step Resolution
15
+ // ================================
16
+ function isStepApplicable(scope, project) {
17
+ if (scope === "yaml-pages" || scope === "index")
18
+ return true;
19
+ if (!project)
20
+ return false;
21
+ switch (scope) {
22
+ case "exec":
23
+ return !!(project.schedule_path?.trim() && project.execution_path?.trim());
24
+ case "catalog":
25
+ return !!project.catalog_path?.trim();
26
+ case "register":
27
+ return !!project.project_register_path?.trim();
28
+ case "dashboard":
29
+ // タスク実行中(execution_path 指定)のプロジェクトのみ。execution/generated/ に集約する。
30
+ return !!project.execution_path?.trim();
31
+ }
32
+ }
33
+ function resolveSteps(scope, projectArgs, project) {
34
+ const candidates = [
35
+ {
36
+ scope: "exec",
37
+ label: "exec refresh",
38
+ subArgs: ["exec", "refresh", ...projectArgs],
39
+ },
40
+ {
41
+ scope: "catalog",
42
+ label: "catalog build",
43
+ subArgs: ["catalog", "build", ...projectArgs],
44
+ },
45
+ {
46
+ scope: "register",
47
+ label: "register build",
48
+ subArgs: ["register", "build", ...projectArgs],
49
+ },
50
+ {
51
+ scope: "yaml-pages",
52
+ label: "yaml-pages build",
53
+ subArgs: ["yaml-pages", "build"],
54
+ },
55
+ // dashboard は execution/generated/dashboard.md + timeline Gantt SVG を生成する。
56
+ // state.json / ready.json(exec refresh)と tml-index / rtn-*.yaml / routine-state.json
57
+ // (routines)を機械可読な入力で集約するため、index build の手前に置く。
58
+ {
59
+ scope: "dashboard",
60
+ label: "dashboard build",
61
+ subArgs: ["dashboard", "build", ...projectArgs],
62
+ },
63
+ {
64
+ scope: "index",
65
+ label: "index build",
66
+ subArgs: ["index", "build"],
67
+ },
68
+ ];
69
+ const active = scope === "all" ? candidates : candidates.filter((s) => s.scope === scope);
70
+ return active.filter((s) => isStepApplicable(s.scope, project));
71
+ }
72
+ // ================================
73
+ // Logging
74
+ // ================================
75
+ function log(msg) {
76
+ process.stdout.write(`[build] ${msg}\n`);
77
+ }
78
+ function logError(msg) {
79
+ process.stderr.write(`[build] ${msg}\n`);
80
+ }
81
+ // ================================
82
+ // Command Registration
83
+ // ================================
84
+ export function registerBuildCommand(program) {
85
+ program
86
+ .command("build")
87
+ .description("Run all build steps in sequence (exec → catalog → register → yaml-pages → dashboard → index)")
88
+ .option("--project <id>", "Project ID (specdojo.config.json)")
89
+ .option("--scope <scope>", `Build scope: ${VALID_SCOPES.join(" | ")}`, "all")
90
+ .option("--dry-run", "Print commands without executing", false)
91
+ .action((opts) => {
92
+ const scope = opts.scope;
93
+ if (!VALID_SCOPES.includes(scope)) {
94
+ logError(`Invalid scope: "${scope}". Must be one of: ${VALID_SCOPES.join(", ")}`);
95
+ process.exitCode = 1;
96
+ return;
97
+ }
98
+ loadEnv();
99
+ const { config, configPath } = loadConfig();
100
+ const baseDir = specdojoRootDir();
101
+ const projectId = opts.project?.trim() ||
102
+ process.env.SPECDOJO_PROJECT?.trim() ||
103
+ (config ? Object.keys(config.projects)[0] : undefined);
104
+ // Suppress unused variable warning — baseDir is kept for symmetry with other commands
105
+ void baseDir;
106
+ const project = config && projectId ? config.projects[projectId] : undefined;
107
+ if (projectId && config && !project) {
108
+ logError(`Unknown project: "${projectId}" (check ${configPath})`);
109
+ process.exitCode = 1;
110
+ return;
111
+ }
112
+ const projectArgs = projectId ? ["--project", projectId] : [];
113
+ const steps = resolveSteps(scope, projectArgs, project);
114
+ if (steps.length === 0) {
115
+ logError(`No applicable steps for scope "${scope}". ` +
116
+ `Check that required paths are configured in specdojo.config.json.`);
117
+ process.exitCode = 1;
118
+ return;
119
+ }
120
+ const total = steps.length;
121
+ if (opts.dryRun) {
122
+ for (let i = 0; i < total; i++) {
123
+ const step = steps[i];
124
+ const [cmd, args] = selfRunArgs(step.subArgs);
125
+ log(`step ${i + 1}/${total}: ${step.label} (dry-run)`);
126
+ log(` would run: ${cmd} ${args.join(" ")}`);
127
+ }
128
+ return;
129
+ }
130
+ const overallStart = Date.now();
131
+ for (let i = 0; i < total; i++) {
132
+ const step = steps[i];
133
+ log(`step ${i + 1}/${total}: ${step.label}`);
134
+ const start = Date.now();
135
+ const [cmd, args] = selfRunArgs(step.subArgs);
136
+ const result = spawnSync(cmd, args, { stdio: "inherit" });
137
+ const elapsed = ((Date.now() - start) / 1000).toFixed(1);
138
+ const exitCode = result.status ?? 1;
139
+ if (exitCode !== 0) {
140
+ logError(`error: ${step.label} exited with code ${exitCode} — aborting`);
141
+ process.exitCode = 1;
142
+ return;
143
+ }
144
+ log(`done: ${step.label} (${elapsed}s)`);
145
+ }
146
+ const totalElapsed = ((Date.now() - overallStart) / 1000).toFixed(1);
147
+ log(`all steps completed (${totalElapsed}s)`);
148
+ });
149
+ }
@@ -0,0 +1,35 @@
1
+ #!/usr/bin/env node
2
+ // src が dist より新しい(または dist が無い)場合だけ `npm run build` を実行する。
3
+ //
4
+ // specdojo の bin は dist/specdojo.js を指すため、merge / checkout で src が更新された
5
+ // あとに再ビルドしないと、古い挙動のまま CLI が動作する。Git hook(post-merge /
6
+ // post-checkout)や `npm run build:if-stale` から呼び出すことを想定し、失敗しても
7
+ // 呼び出し元を止めない best-effort な処理にしている。最終的な安全網は
8
+ // dist-freshness.ts による CLI 起動時の鮮度ガードである。
9
+ import { existsSync, lstatSync } from "node:fs";
10
+ import path from "node:path";
11
+ import { fileURLToPath } from "node:url";
12
+ import { ensureFreshDistBuild } from "./dist-freshness.js";
13
+ function report(message) {
14
+ process.stderr.write(`[build-if-stale] ${message}\n`);
15
+ }
16
+ function isPrimaryWorktree(repoRoot) {
17
+ const gitEntry = path.join(repoRoot, ".git");
18
+ return existsSync(gitEntry) && lstatSync(gitEntry).isDirectory();
19
+ }
20
+ function main() {
21
+ const repoRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
22
+ if (!isPrimaryWorktree(repoRoot)) {
23
+ // linked worktree は dist を持たず、agent は tsx で src を直接実行するため対象外。
24
+ return;
25
+ }
26
+ const result = ensureFreshDistBuild(repoRoot);
27
+ if (result.message)
28
+ report(result.message);
29
+ }
30
+ try {
31
+ main();
32
+ }
33
+ catch (error) {
34
+ report(`鮮度判定に失敗した: ${error instanceof Error ? error.message : String(error)}`);
35
+ }