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,66 @@
1
+ # sch-track.schema.yaml
2
+ $schema: "https://json-schema.org/draft/2020-12/schema"
3
+ title: "SpecDojo Schedule track schema"
4
+ type: object
5
+ additionalProperties: false
6
+
7
+ required:
8
+ - kind
9
+ - id
10
+ - type
11
+ - status
12
+ - title
13
+ - rulebook
14
+ - version
15
+ - project_id
16
+ - track
17
+ - settings
18
+
19
+ properties:
20
+ kind:
21
+ const: "track"
22
+ id:
23
+ type: string
24
+ minLength: 1
25
+ description: "Deliverable ID (e.g., prj-0001:sch-track-launch)."
26
+ type:
27
+ const: "project"
28
+ status:
29
+ type: string
30
+ enum: ["draft", "ready", "deprecated"]
31
+ title:
32
+ type: string
33
+ minLength: 1
34
+ description: "Document title. Equivalent to the Markdown H1; used as the heading of the generated display page."
35
+ rulebook:
36
+ type: string
37
+ pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
38
+ description: "Rulebook ID this document conforms to. Use none only when no rulebook exists."
39
+ version:
40
+ type: integer
41
+ minimum: 1
42
+ description: "Schema/data version."
43
+ project_id:
44
+ type: string
45
+ minLength: 1
46
+ description: "Project identifier (e.g., prj-0001)."
47
+ track:
48
+ $ref: "./sch-common.schema.yaml#/$defs/Track"
49
+ calendar:
50
+ $ref: "./sch-common.schema.yaml#/$defs/CalendarOverride"
51
+ settings:
52
+ $ref: "./sch-common.schema.yaml#/$defs/SettingsOverride"
53
+ notes:
54
+ type: string
55
+ description: "Optional file-level notes."
56
+ tasks:
57
+ type: array
58
+ minItems: 1
59
+ description: "Scheduled tasks (duration-based)."
60
+ items:
61
+ $ref: "./sch-common.schema.yaml#/$defs/Task"
62
+ milestones:
63
+ type: array
64
+ description: "Track-level milestones (duration=0) representing gates/approvals."
65
+ items:
66
+ $ref: "./sch-common.schema.yaml#/$defs/Milestone"
@@ -0,0 +1,18 @@
1
+ $schema: "https://json-schema.org/draft/2020-12/schema"
2
+ title: Standard Front Matter
3
+ # SpecDojo が所有する frontmatter は `specdojo:` 名前空間配下に置く。
4
+ type: object
5
+ required:
6
+ - specdojo
7
+ properties:
8
+ specdojo:
9
+ type: object
10
+ unevaluatedProperties: false
11
+ allOf:
12
+ - $ref: "./common-frontmatter.schema.yaml"
13
+ - type: object
14
+ properties:
15
+ type:
16
+ type: string
17
+ const: standard
18
+ description: "ドキュメント種別(standard 固定)"
@@ -0,0 +1,103 @@
1
+ # tml-index.schema.yaml
2
+ $schema: "https://json-schema.org/draft/2020-12/schema"
3
+ title: "SpecDojo Timeline index schema"
4
+ type: object
5
+ additionalProperties: false
6
+
7
+ required:
8
+ - id
9
+ - type
10
+ - status
11
+ - title
12
+ - rulebook
13
+ - version
14
+ - project_id
15
+ - tracks
16
+
17
+ properties:
18
+ id:
19
+ type: string
20
+ minLength: 1
21
+ description: "Deliverable ID (e.g., prj-0001:tml-index)."
22
+ type:
23
+ const: "project"
24
+ status:
25
+ type: string
26
+ enum: ["draft", "ready", "deprecated"]
27
+ title:
28
+ type: string
29
+ minLength: 1
30
+ description: "Document title. Equivalent to the Markdown H1; used as the heading of the generated display page."
31
+ rulebook:
32
+ type: string
33
+ pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
34
+ description: "Rulebook ID this document conforms to. Use none only when no rulebook exists."
35
+ version:
36
+ type: integer
37
+ minimum: 1
38
+ description: "Schema/data version."
39
+ project_id:
40
+ type: string
41
+ minLength: 1
42
+ description: "Project identifier (e.g., prj-0001)."
43
+ notes:
44
+ type: string
45
+ description: "Optional file-level notes."
46
+ planned_start_date:
47
+ type: string
48
+ pattern: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
49
+ description: "Planned start date (YYYY-MM-DD) used as the x-axis origin of the dashboard Timeline Gantt chart. Each track's planned start/finish is derived from this date and catalog_duration_estimate_days using the Schedule calendar."
50
+ tracks:
51
+ type: array
52
+ minItems: 1
53
+ description: "Planned tracks in macro execution order. Human-authored plan, not a generated result."
54
+ items:
55
+ $ref: "#/$defs/TrackPlan"
56
+
57
+ $defs:
58
+ TrackPlan:
59
+ type: object
60
+ additionalProperties: false
61
+ required:
62
+ - track
63
+ - domains
64
+ - catalog_status
65
+ - order
66
+ - depends_on
67
+ properties:
68
+ track:
69
+ type: string
70
+ pattern: "^[a-z0-9][a-z0-9-]*$"
71
+ description: "Track identifier matching <track> in sch-strategy-<track>.yaml / sch-track-<track>.yaml."
72
+ domains:
73
+ type: array
74
+ minItems: 1
75
+ description: "Domain values of the dct-<domain>.yaml catalogs this track covers."
76
+ items:
77
+ type: string
78
+ pattern: "^[a-z0-9][a-z0-9-]*$"
79
+ catalog_status:
80
+ type: string
81
+ enum: ["not_started", "draft", "primary"]
82
+ description: "Progress of catalog authoring. not_started = no catalog yet, draft = catalog exists but not fixed, primary = catalog is the SSOT that drives schedule build."
83
+ catalog_duration_estimate_days:
84
+ type: number
85
+ exclusiveMinimum: 0
86
+ description: "Estimated working days to bring the catalog from draft to primary."
87
+ order:
88
+ type: integer
89
+ minimum: 1
90
+ description: "Sequential start order. Equal values are candidates for parallel execution."
91
+ parallel_group:
92
+ type: string
93
+ minLength: 1
94
+ description: "Optional group label. Tracks sharing the same value may run in parallel."
95
+ depends_on:
96
+ type: array
97
+ description: "Track ids that should be started earlier. Empty array means no prerequisite."
98
+ items:
99
+ type: string
100
+ pattern: "^[a-z0-9][a-z0-9-]*$"
101
+ note:
102
+ type: string
103
+ description: "Optional free-form supplement."
package/package.json CHANGED
@@ -1,17 +1,31 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.1.0",
4
- "description": "CLI for SpecDojo specification-driven execution workflows.",
3
+ "version": "0.2.1",
4
+ "description": "SpecDojo CLI, schemas, and documentation for specification-driven execution workflows.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
7
+ "private": false,
8
+ "type": "module",
9
+ "bin": {
10
+ "specdojo": "dist/specdojo.js"
11
+ },
12
+ "files": [
13
+ "dist",
14
+ "docs/ja/specdojo",
15
+ "!docs/ja/specdojo/**/generated/**",
16
+ "docs/specdojo",
17
+ "!docs/specdojo/**/generated/**",
18
+ "templates",
19
+ "README.md",
20
+ "LICENSE"
21
+ ],
7
22
  "repository": {
8
23
  "type": "git",
9
- "url": "git+https://github.com/specdojo/specdojo-handbook.git",
10
- "directory": "tools/specdojo"
24
+ "url": "git+https://github.com/specdojo/specdojo.git"
11
25
  },
12
- "homepage": "https://github.com/specdojo/specdojo-handbook/tree/main/tools/specdojo",
26
+ "homepage": "https://github.com/specdojo/specdojo#readme",
13
27
  "bugs": {
14
- "url": "https://github.com/specdojo/specdojo-handbook/issues"
28
+ "url": "https://github.com/specdojo/specdojo/issues"
15
29
  },
16
30
  "keywords": [
17
31
  "specdojo",
@@ -23,30 +37,113 @@
23
37
  "publishConfig": {
24
38
  "access": "public"
25
39
  },
26
- "files": [
27
- "dist",
28
- "README.md"
29
- ],
30
- "private": false,
31
- "type": "module",
32
- "bin": {
33
- "specdojo": "dist/specdojo.js"
34
- },
35
40
  "scripts": {
36
- "prepare": "npm run build",
37
- "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
41
+ "prepare": "node tools/install-lefthook.mjs",
42
+ "pre-commit": "lefthook run pre-commit",
43
+ "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json && node -e \"require('node:fs').chmodSync('dist/specdojo.js', 0o755)\"",
44
+ "build:if-stale": "node tools/build-if-stale.mjs",
45
+ "test": "vitest run",
46
+ "test:unit": "vitest run --config vitest.unit.config.ts",
47
+ "test:integration": "vitest run --config vitest.integration.config.ts",
48
+ "test:watch": "vitest",
49
+ "test:e2e": "npm run build && tsx tools/e2e/exec-run-e2e.ts",
38
50
  "dev": "tsx src/specdojo.ts",
39
- "start": "node dist/specdojo.js"
51
+ "start": "node dist/specdojo.js",
52
+ "prepack": "npm run build",
53
+ "specdojo:build": "npm run build",
54
+ "vscode:install": "npm --prefix packages/vscode-specdojo ci",
55
+ "vscode:build": "npm --prefix packages/vscode-specdojo run compile",
56
+ "vscode:package": "npm --prefix packages/vscode-specdojo run package",
57
+ "exec:watch-claude-log": "tools/exec/watch-claude-log.sh",
58
+ "worktree:sync": "tools/worktree/sync.sh",
59
+ "orch:sonnet": "claude --agent specdojo-orchestrator --model sonnet",
60
+ "orch:sonnet:work": "tools/worktree/open-agent-worktree.sh claude-work claude --agent specdojo-orchestrator --model sonnet",
61
+ "orch:opus": "claude --agent specdojo-orchestrator --model opus",
62
+ "orch:opus:work": "tools/worktree/open-agent-worktree.sh claude-work claude --agent specdojo-orchestrator --model opus",
63
+ "orch:terra": "codex -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
64
+ "orch:terra:work": "tools/worktree/open-agent-worktree.sh codex-work codex -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
65
+ "orch:sol": "codex -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
66
+ "orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work codex -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
67
+ "orch:copilot": "copilot --agent specdojo-orchestrator",
68
+ "orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work copilot --agent specdojo-orchestrator",
69
+ "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
70
+ "orch:agy:work": "tools/worktree/open-agent-worktree.sh agy-work agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
71
+ "orch:qwen": "opencode --agent qwen-orchestrator",
72
+ "orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work opencode --agent qwen-orchestrator",
73
+ "orch:gemma": "opencode --agent gemma-orchestrator",
74
+ "orch:gemma:work": "tools/worktree/open-agent-worktree.sh gemma-work opencode --agent gemma-orchestrator",
75
+ "code:red": "tools/vscode/open-worktree-workspace.sh red",
76
+ "code:blue": "tools/vscode/open-worktree-workspace.sh blue",
77
+ "code:green": "tools/vscode/open-worktree-workspace.sh green",
78
+ "typecheck": "tsc -b --noEmit",
79
+ "lint:ts": "eslint 'src/**/*.ts' 'tests/**/*.ts' 'packages/docs-lint/src/**/*.ts' 'tools/e2e/**/*.ts'",
80
+ "lint:ts:fix": "eslint --fix 'src/**/*.ts' 'tests/**/*.ts' 'packages/docs-lint/src/**/*.ts' 'tools/e2e/**/*.ts'",
81
+ "lint:orchestrator-sync": "node tools/validate-orchestrator-sync.mjs",
82
+ "orchestrator:sync": "node tools/generate-orchestrator-wrappers.mjs",
83
+ "lint:md": "node packages/docs-lint/bin/specdojo-docs-lint.js markdownlint '**/*.md'",
84
+ "lint:md:fix": "node packages/docs-lint/bin/specdojo-docs-lint.js markdownlint --fix '**/*.md'",
85
+ "format": "prettier --write '**/*.{ts,js,mjs,cjs,json,yaml,yml,md}'",
86
+ "format:check": "prettier --check '**/*.{ts,js,mjs,cjs,json,yaml,yml,md}'",
87
+ "docs:generate": "tsx src/specdojo.ts build",
88
+ "docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
89
+ "docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
90
+ "docs:rebuild:mermaid": "rm -f public/mermaid/*.svg && npm run docs:build:mermaid",
91
+ "docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
92
+ "lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
93
+ "validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
94
+ "validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
95
+ "validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
96
+ "validate:schema": "npm run validate:schema:yaml && npm run validate:schema:job-run && npm run validate:schema:grade-pipeline && npm run validate:schema:rulebook-enums",
97
+ "validate:schema:rulebook-enums": "node packages/docs-lint/bin/specdojo-docs-lint.js rulebook-schema-enums",
98
+ "validate:catalog": "tsx src/specdojo.ts catalog validate",
99
+ "validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
100
+ "check": "npm run typecheck && npm run lint:ts && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
101
+ "dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
102
+ "dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
103
+ "dc:bash": "bash -lc 'name=$(docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"); [ -n \"$name\" ] && docker exec -it --detach-keys=\"ctrl-]\" -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 -u node \"$name\" bash -lc \"cd /workspaces/specdojo-workspace/specdojo && exec bash\" || echo \"matching container not found\"'",
104
+ "vscode:ps": "bash .devcontainer/kill-stale-vscode.sh --list",
105
+ "vscode:kill-stale": "bash .devcontainer/kill-stale-vscode.sh",
106
+ "specdojo:exec:opencode": "specdojo exec run --auto --loop --parallel 1 --edit-by opencode-edit-agent --review-by opencode-review-agent > logs/exec-opencode.stdout.log 2> logs/exec-opencode.stderr.log",
107
+ "specdojo:exec:auto": "specdojo exec run --auto --loop --parallel 1 > logs/exec-auto.stdout.log 2> logs/exec-auto.stderr.log",
108
+ "specdojo:exec:auto2": "specdojo exec run --auto --loop --parallel 2 > logs/exec-auto.stdout.log 2> logs/exec-auto.stderr.log",
109
+ "specdojo:exec:auto3": "specdojo exec run --auto --loop --parallel 3 > logs/exec-auto.stdout.log 2> logs/exec-auto.stderr.log",
110
+ "validate:schema:yaml": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --modeline"
40
111
  },
41
112
  "dependencies": {
42
- "commander": "^12.1.0",
43
- "dotenv": "^16.4.5",
44
- "js-yaml": "^4.1.0"
113
+ "ajv": "^8.20.0",
114
+ "commander": "^15.0.0",
115
+ "dotenv": "^17.4.2",
116
+ "fast-glob": "^3.3.3",
117
+ "js-yaml": "^4.2.0",
118
+ "prettier": "^3.8.4",
119
+ "remark-parse": "^11.0.0",
120
+ "unified": "^11.0.5"
45
121
  },
46
122
  "devDependencies": {
123
+ "@commitlint/cli": "^21.0.2",
124
+ "@commitlint/config-conventional": "^21.0.2",
47
125
  "@types/js-yaml": "^4.0.9",
48
- "@types/node": "^22.10.0",
49
- "tsx": "^4.21.0",
50
- "typescript": "^5.6.3"
126
+ "@types/node": "^25.9.2",
127
+ "@typescript-eslint/eslint-plugin": "^8.61.0",
128
+ "@typescript-eslint/parser": "^8.61.0",
129
+ "ajv-cli": "^5.0.0",
130
+ "ajv-formats": "^3.0.1",
131
+ "cloc": "^2.6.0-cloc",
132
+ "eslint-config-prettier": "^10.1.8",
133
+ "gray-matter": "^4.0.3",
134
+ "lefthook": "^2.1.9",
135
+ "markdownlint-cli": "^0.48.0",
136
+ "remark": "^15.0.1",
137
+ "remark-cli": "^12.0.1",
138
+ "remark-frontmatter": "^5.0.0",
139
+ "remark-gfm": "^4.0.1",
140
+ "remark-lint": "^10.0.1",
141
+ "remark-lint-frontmatter-schema": "^3.15.4",
142
+ "remark-mdx": "^3.1.1",
143
+ "remark-stringify": "^11.0.0",
144
+ "tsx": "^4.22.4",
145
+ "typescript": "^6.0.3",
146
+ "typescript-eslint": "^8.61.0",
147
+ "vitest": "^4.1.8"
51
148
  }
52
149
  }
@@ -0,0 +1,35 @@
1
+ # Antigravity 向け配布原本
2
+
3
+ `npx specdojo config scaffold --provider antigravity` が配置するファイルの原本です。この README 自体はコピーされません。
4
+
5
+ ## 配置されるもの
6
+
7
+ | 原本 | 配置先 |
8
+ | ---------------------------- | -------------------------------------------------- |
9
+ | `orchestrator.md` | `.specdojo/antigravity/orchestrator.md` |
10
+ | `exec-defaults-snippet.yaml` | `.specdojo/antigravity/exec-defaults-snippet.yaml` |
11
+ | `pm-members-snippet.yaml` | `.specdojo/antigravity/pm-members-snippet.yaml` |
12
+
13
+ ## オーケストレーターの起動
14
+
15
+ Antigravity CLI(`agy`)はファイル定義の agent を持たないため、`--agent <name>` では起動できません。規範の本文を `-i` で渡します。
16
+
17
+ ```sh
18
+ agy --add-dir "$(pwd)" --model gemini-3.1-pro-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
19
+ ```
20
+
21
+ `--add-dir "$(pwd)"` を付けないと、作業ディレクトリのファイルを読み書きできず、`AGENTS.md` と `.agents/rules/*.md` も読み込まれません。
22
+
23
+ `package.json` へ登録しておくと短く起動できます。
24
+
25
+ ```json
26
+ {
27
+ "scripts": {
28
+ "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
29
+ }
30
+ }
31
+ ```
32
+
33
+ ## executor / reporter として使う
34
+
35
+ `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`pm-members-snippet.yaml` を `pm-members.yaml` の `members` へ写します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。
@@ -0,0 +1,38 @@
1
+ # Antigravity CLI(agy)provider 設定のスニペット。
2
+ # 利用プロジェクトの .specdojo/exec-defaults.yaml の providers へコピーして使う。
3
+ # by_nickname は member ごとにモデルを差し替える層で、Gemini 以外のモデルを
4
+ # 指名するために使う。不要な member の行は削除してよい。
5
+ # 設計の背景は sysd-antigravity-agent-settings と exec-config-guide.md を参照。
6
+
7
+ providers:
8
+ antigravity:
9
+ # Antigravity CLI(agy)は --agent による定義ファイルの選択を持たず、codex と同じく
10
+ # プロンプト(plan)だけで役割を与える。-p はプロンプトを引数に取り stdin を読まないため、
11
+ # runner が stdin へ書く plan を "$(cat)" で引数に渡す(shell: true で実行される)。
12
+ # --sandbox は書き込み先を ~/.gemini 配下の scratch へ逃がすため、--add-dir で作業
13
+ # ディレクトリ(worktree)を明示して成果物へ書けるようにする(2026-09-21 実測)。
14
+ # --dangerously-skip-permissions は非対話実行に必須。境界は worktree・保護設定・
15
+ # commit 許可リストで作る。
16
+ # agy のモデル ID は推論強度を含む(gemini-3.8-flash-{high,medium,low} など)。--effort を
17
+ # 併用すると ID と食い違ったときに "invalid model selection" で起動に失敗するため、
18
+ # 強度はモデル ID だけで指定する(2026-09-21 実測: flash-high + --effort medium で失敗)。
19
+ command_template: 'agy --sandbox --add-dir "$(pwd)" --dangerously-skip-permissions --model {model} -p "$(cat)"'
20
+ command_params:
21
+ by_proficiency:
22
+ normal: { model: gemini-3.8-flash-medium }
23
+ expert: { model: gemini-3.1-pro-high }
24
+ # Gemini 以外の Antigravity 提供モデルは member nickname で明示的に選ぶ。
25
+ # by_nickname は proficiency / mode の既定値より優先される。
26
+ by_nickname:
27
+ agy-sonnet-executor: { model: claude-sonnet-4-6 }
28
+ agy-opus-executor: { model: claude-opus-4-6-thinking }
29
+ agy-opus-review-executor: { model: claude-opus-4-6-thinking }
30
+ agy-gpt-executor: { model: gpt-oss-120b-medium }
31
+ # Gemini API の制限文言は未観測。429 / quota / RESOURCE_EXHAUSTED を初期値とし、
32
+ # 実観測した文言で更新する(observed-agent-limit-stderr と同じ扱い)。
33
+ rate_limit_detection:
34
+ stderr_patterns:
35
+ - "rate limit"
36
+ - "429"
37
+ - "quota"
38
+ - "RESOURCE_EXHAUSTED"
@@ -0,0 +1,146 @@
1
+ # SpecDojo Orchestrator Agent
2
+
3
+ あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
4
+
5
+ CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
6
+
7
+ ## 基本方針
8
+
9
+ - 回答は原則として日本語で行う。
10
+ - コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
11
+ - 破壊的変更や `git push` は行わない。
12
+ - `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
13
+ - register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
14
+ - 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
15
+ - commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
16
+ - register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
17
+ - 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
18
+ - `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
19
+ - exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
20
+ - commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」と、関連する登録簿項目があれば `Refs: PJR-XXXX` を日本語で記載する。
21
+ - 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
22
+ - 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
23
+ - 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
24
+ - 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
25
+ - タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
26
+
27
+ ## 対話の進め方
28
+
29
+ 1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
30
+ 2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
31
+ 3. 実行予定のコマンドを、目的・影響範囲(生成/更新されるファイル)とともに提示する。
32
+ 4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
33
+ 5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
34
+
35
+ ## specdojo コマンド地図
36
+
37
+ | 目的 | サブコマンド | 代表操作 |
38
+ | -------------------------- | ------------ | ------------------------------------------------------------------------- |
39
+ | 設定の初期化・確認 | `config` | `config init`(`.specdojo/specdojo.config.json` 生成)/ `config scaffold` |
40
+ | プロジェクト登録簿 | `register` | `register scaffold` / `add` / `close` / `update` / `build` |
41
+ | 実践の型(kata) | `kata` | `kata list` / `show` / `status` / `eject` |
42
+ | 実行計画・タスク実行 | `exec` | `exec plan` / `run` / `status` / `validate` / `refresh` |
43
+ | 成果物カタログ | `catalog` | `catalog scaffold` / `validate` / `build` |
44
+ | Schedule | `schedule` | `schedule build --track <track>` |
45
+ | 定期実行 | `routine` | `routine run --due` |
46
+ | 進捗の俯瞰 | `dashboard` | `dashboard build` |
47
+ | 品質評価 | `grade` | `grade list` / `plan` / `apply` |
48
+ | ドキュメントIDインデックス | `index` | `index build` |
49
+ | 全生成物の一括更新 | `build` | `build` |
50
+
51
+ 正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
52
+
53
+ ## 導入直後の進め方
54
+
55
+ `config init` の直後に使えるのは register である。catalog や schedule は設定キーの追加が要るため、いきなり案内しない。次の順で進める。
56
+
57
+ ```bash
58
+ npx specdojo config init
59
+ npx specdojo register scaffold --project <project-id>
60
+ npx specdojo register add --project <project-id> --type todo --title "<title>"
61
+ npx specdojo register build --project <project-id>
62
+ ```
63
+
64
+ 利用者が「何から始めればよいか」と尋ねた場合は、まず解決したい課題を `issue`、決めたいことを `decision`、やることを `todo` として起票することを勧める。成果物カタログや Schedule は、扱う成果物が定まってから広げる。
65
+
66
+ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `catalog_path` などのキーを追加する必要がある。キーの一覧と役割は設定リファレンスにある。
67
+
68
+ ## 登録簿(register)の使い方
69
+
70
+ 登録簿は SpecDojo の入口であり、プロジェクトの記録が集まる場所である。正本は項目ごとの個票 `pjr-<id>-<topic>.md` で、一覧 `generated/pjr-index.md` は個票から生成される。一覧を直接編集しない。
71
+
72
+ type は次のように使い分ける。
73
+
74
+ | type | 用途 | 終端状態 |
75
+ | ---------------- | ------------------------------ | --------- |
76
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
77
+ | `decision` | 選択肢から方針を決める | `decided` |
78
+ | `todo` | 実施する作業 | `done` |
79
+ | `question` | 判断を保留し、後で決める | `decided` |
80
+ | `risk` | 将来の不確実性 | `done` |
81
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
82
+ | `note` | 記録として残す観測・分析 | `done` |
83
+
84
+ 起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルから導出される。
85
+
86
+ ```bash
87
+ npx specdojo register add --project <project-id> \
88
+ --type todo --title "<title>" --description "<description>" \
89
+ --priority high --owner DEV --due <YYYY-MM-DD>
90
+ ```
91
+
92
+ 起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
93
+
94
+ 状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
95
+
96
+ ```bash
97
+ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
98
+ --conclusion "<結論>" --by <actor> --reason "<理由>"
99
+ npx specdojo register build --project <project-id>
100
+ ```
101
+
102
+ `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
103
+
104
+ ## 実践の型(kata)の扱い
105
+
106
+ rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
107
+
108
+ ```bash
109
+ npx specdojo kata list --kind rulebook # 参照中の一覧と解決元
110
+ npx specdojo kata show <id> # 内容を表示
111
+ npx specdojo kata status # eject 済みと参照中の差分
112
+ npx specdojo kata eject --id <id> # 上書きしたいものだけ複製
113
+ ```
114
+
115
+ 利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
116
+
117
+ ## タスク実行
118
+
119
+ ```bash
120
+ npx specdojo exec plan --project <project-id> --register <PJR-XXXX>
121
+ npx specdojo exec run --project <project-id> --register <PJR-XXXX> --worktree
122
+ npx specdojo exec status --project <project-id>
123
+ npx specdojo exec validate --project <project-id>
124
+ ```
125
+
126
+ `exec plan` は agent を起動せずに計画だけを生成する。実行前に内容を確認したい場合に使う。
127
+
128
+ `exec run` はエージェントを起動して成果物を生成・更新する重い操作のため、対象タスクと実行範囲を提示して承認を得てから実行する。`--worktree` を付けると作業が隔離され、失敗時も利用リポジトリの作業ツリーが汚れない。実行前に対象 project の `develop` にいることを確認する。
129
+
130
+ 失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
131
+
132
+ ## プロジェクトの解決順序
133
+
134
+ 対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。
135
+
136
+ 1. `--project <id>`
137
+ 2. 環境変数 `SPECDOJO_PROJECT`
138
+ 3. `specdojo.config.json` の `current_project`
139
+ 4. `projects` に定義された先頭 project
140
+
141
+ ## 禁止事項
142
+
143
+ - 状態変更・ファイル生成を伴うコマンドを、承認なしに実行すること。
144
+ - `git push` や履歴を書き換える破壊的操作を行うこと。
145
+ - 認証情報・秘密・`.env`・`secrets/` の読み取り。
146
+ - 会話で確定していないプロジェクト事実(担当・期日・結論など)を勝手に埋めること。
@@ -0,0 +1,55 @@
1
+ # Antigravity CLI(agy)member 定義のスニペット。
2
+ # 利用プロジェクトの pm-members.yaml の members へコピーして使う。
3
+ # 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
4
+ # providers.antigravity.command_template で定義する(exec-defaults-snippet.yaml を参照)。
5
+ # モデルの差し替えは command_params.by_nickname で行う。
6
+ # 既定では disabled にしてある。使う member だけ disabled を外す。
7
+
8
+ members:
9
+ - nickname: agy-executor
10
+ disabled: true
11
+ priority: 4
12
+ display_name: Antigravity Executor
13
+ email: null
14
+ roles: []
15
+ type: agent
16
+ provider: antigravity
17
+ mode: edit
18
+ proficiency: normal
19
+ persona: task-executor
20
+
21
+ - nickname: agy-expert-executor
22
+ disabled: true
23
+ priority: 3
24
+ display_name: Antigravity Expert Executor
25
+ email: null
26
+ roles: []
27
+ type: agent
28
+ provider: antigravity
29
+ mode: edit
30
+ proficiency: expert
31
+ persona: task-executor
32
+
33
+ - nickname: agy-expert-review-executor
34
+ disabled: true
35
+ priority: 3
36
+ display_name: Antigravity Expert Review Executor
37
+ email: null
38
+ roles: []
39
+ type: agent
40
+ provider: antigravity
41
+ mode: review
42
+ proficiency: expert
43
+ persona: reviewer
44
+
45
+ - nickname: agy-reporter
46
+ disabled: true
47
+ priority: 4
48
+ display_name: Antigravity Reporter
49
+ email: null
50
+ roles: []
51
+ type: agent
52
+ provider: antigravity
53
+ mode: report
54
+ proficiency: normal
55
+ persona: reporter