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,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,41 @@
1
+ ---
2
+ specdojo:
3
+ id: copilot-provider-templates
4
+ type: guide
5
+ status: draft
6
+ ---
7
+
8
+ # GitHub Copilot Provider テンプレート
9
+
10
+ ## 1. 目的
11
+
12
+ `specdojo exec` が GitHub Copilot CLI を agent として起動する際の設定の配布原本です。copilot は agent 定義ファイルを持たず、permission は `.specdojo/exec-defaults.yaml` の `providers.copilot.command_template` のフラグがすべてです。
13
+
14
+ ## 2. 構成
15
+
16
+ | パス | 利用プロジェクトでの配置先 | 説明 |
17
+ | ---------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
18
+ | `pm-members-snippet.yaml` | `.specdojo/copilot/` | member 定義のスニペット。`pm-members.yaml` へコピーして使う参照用 |
19
+ | `exec-defaults-snippet.yaml` | `.specdojo/copilot/` | `providers.copilot`(command template・rate limit 検出)のスニペット。`exec-defaults.yaml` へコピーして使う参照用 |
20
+
21
+ ## 3. 導入手順
22
+
23
+ 利用プロジェクトのルートで scaffold コマンドを実行します。
24
+
25
+ ```sh
26
+ specdojo exec scaffold --provider copilot
27
+ ```
28
+
29
+ コピー後に次を行います。
30
+
31
+ 1. `.specdojo/copilot/exec-defaults-snippet.yaml` の `providers.copilot` を `.specdojo/exec-defaults.yaml` の `providers` へコピーする。
32
+ 2. `.specdojo/copilot/pm-members-snippet.yaml` の member 定義を `pm-members.yaml` の `members` へコピーし、使う場合は `disabled: false` にする。
33
+ 3. `copilot login` で認証する(premium request の課金が発生する)。
34
+ 4. 最初のタスクで permission ログを確認し、`shell(...)` パターンのマッチ粒度が不足していれば `--allow-tool` を追記する。
35
+
36
+ ## 4. カスタマイズ
37
+
38
+ - フラグの追加・変更は `providers.copilot.command_template` の1箇所で行う(member 側に `command` を書かない)。
39
+ - `--allow-all` / `--yolo` / `--allow-all-tools` / `--allow-all-paths` / 環境変数 `COPILOT_ALLOW_ALL` は使わない。
40
+ - `--deny-tool` の `git add` / `git commit` / `git push` は維持する。deny は `--allow-all-tools` より優先されるため、許可リストの追記で誤って開くことを防ぐ保険になる。
41
+ - 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
@@ -0,0 +1,28 @@
1
+ # GitHub Copilot CLI provider 設定のスニペット。
2
+ # 利用プロジェクトの .specdojo/exec-defaults.yaml の providers へコピーして使う。
3
+ # 権限は command template のフラグが正本。--allow-all / --yolo / --allow-all-tools /
4
+ # --allow-all-paths / COPILOT_ALLOW_ALL は使わない。
5
+ # 設計の背景は exec-config-guide.md の
6
+ # 「agent 権限とプロンプトインジェクション対策」を参照。
7
+
8
+ providers:
9
+ copilot:
10
+ # edit / review とも同一の許可リスト構成のため、プレースホルダは使わない。
11
+ # -p は引数必須のため、標準入力で渡される plan を "$(cat)" で受ける。
12
+ command_template: >-
13
+ copilot -p "$(cat)" --no-color --no-ask-user
14
+ --no-remote --no-remote-export --disable-builtin-mcps
15
+ --allow-tool write
16
+ --allow-tool 'shell(git status)' --allow-tool 'shell(git diff)'
17
+ --allow-tool 'shell(git log)' --allow-tool 'shell(git show)'
18
+ --allow-tool 'shell(npm run)' --allow-tool 'shell(npm test)'
19
+ --allow-tool 'shell(specdojo:*)'
20
+ --deny-tool 'shell(git add)' --deny-tool 'shell(git commit)'
21
+ --deny-tool 'shell(git push)' --deny-tool 'shell(git reset)'
22
+ # Copilot: 429 / rate limit に加え、quota / premium request 上限の文言を検出。
23
+ rate_limit_detection:
24
+ stderr_patterns:
25
+ - "rate limit"
26
+ - "429"
27
+ - "quota"
28
+ - "premium request"
@@ -0,0 +1,44 @@
1
+ # GitHub Copilot CLI member 定義のスニペット。
2
+ # 利用プロジェクトの pm-members.yaml の members へコピーして使う。
3
+ # 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
4
+ # providers.copilot.command_template で定義する(exec-defaults-snippet.yaml を参照)。
5
+ # 設計の背景は exec-config-guide.md の
6
+ # 「agent 権限とプロンプトインジェクション対策」を参照。
7
+
8
+ members:
9
+ - nickname: copilot-edit-agent
10
+ disabled: true
11
+ priority: 4
12
+ display_name: Copilot Edit Agent
13
+ email: null
14
+ roles: []
15
+ type: agent
16
+ provider: copilot
17
+ mode: edit
18
+ proficiency: normal
19
+ persona: task-executor
20
+ focus:
21
+ - task-execution
22
+ - document-creation
23
+ - implementation
24
+ capabilities: []
25
+ scheduler_strategy: critical-first
26
+ note: GitHub Copilot CLI を使用する標準エージェント。ツールは許可リスト方式で、shell は読み取り系・検証系のみ、git の変更系は deny する。パスはデフォルト制限で worktree 配下に限定される。URL アクセスは許可しないため web_search capability を持たない。最終判断は行わない。
27
+ - nickname: copilot-review-agent
28
+ disabled: true
29
+ priority: 4
30
+ display_name: Copilot Review Agent
31
+ email: null
32
+ roles: []
33
+ type: agent
34
+ provider: copilot
35
+ mode: review
36
+ proficiency: normal
37
+ persona: multi-viewpoint-reviewer
38
+ focus:
39
+ - done-criteria-verification
40
+ - cross-viewpoint-consistency
41
+ - quality-assurance
42
+ capabilities: []
43
+ scheduler_strategy: fifo
44
+ note: GitHub Copilot CLI を使用するレビューエージェント。write はパス単位に絞れないため result 記入用に許可し、成果物変更の境界は specdojo CLI の commit 許可リスト(review は result のみ)で作る。URL アクセスは許可しないため web_search capability を持たない。最終判断は行わない。
@@ -0,0 +1,41 @@
1
+ ---
2
+ specdojo:
3
+ id: opencode-provider-templates
4
+ type: guide
5
+ status: draft
6
+ ---
7
+
8
+ # OpenCode Provider テンプレート
9
+
10
+ ## 1. 目的
11
+
12
+ `specdojo exec` が OpenCode CLI を agent として起動する際に使う設定一式の配布原本です。permission は agent 定義の frontmatter に含まれます。
13
+
14
+ ## 2. 構成
15
+
16
+ | パス | 利用プロジェクトでの配置先 | 説明 |
17
+ | ------------- | -------------------------- | ---------------------------------------------------------------------- |
18
+ | `agents/*.md` | `.opencode/agents/` | agent 定義。パス単位の `edit` とコマンド許可リストの `bash` を含む正本 |
19
+
20
+ 配布する role は、従来の edit / review に加え、成果物編集と検証だけを担う `opencode-executor`、入力された evidence から構造化結果だけを返す `opencode-reporter` を含みます。
21
+
22
+ ## 3. 導入手順
23
+
24
+ 利用プロジェクトのルートで scaffold コマンドを実行します。
25
+
26
+ ```sh
27
+ specdojo exec scaffold --provider opencode
28
+ ```
29
+
30
+ コピー後に次を行います。
31
+
32
+ 1. `.specdojo/exec-defaults.yaml` の `providers.opencode.command_template` に `opencode run --agent {nickname}` を指定する(member の nickname と agent 定義のファイル名を一致させる)。member 側に `command` は書かない。
33
+ 2. モデル接続設定(`opencode.json` の provider / model)を利用環境に合わせて作成する。ローカル Ollama の接続先などマシン固有の値を含むため、このテンプレートには含めていない。
34
+ 3. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
35
+
36
+ ## 4. カスタマイズ
37
+
38
+ - edit agent の `permission.edit` は既定で `docs/**`、`src/**`、`tests/**` を許可する。`permission.edit` / `permission.bash` のパターンは、利用プロジェクトの成果物・execution ディレクトリ配置に合わせて調整する。
39
+ - executor の result パス deny と reporter の全ツール deny は、pipeline の責務境界なので維持する。
40
+ - `bash` は deny 基点の許可リストを維持する。`git add` / `git commit` を許可しないこと(許可すると specdojo CLI の commit 許可リストを迂回できる)。
41
+ - 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
@@ -0,0 +1,59 @@
1
+ ---
2
+ description: SpecDojo pipeline の executor。成果物の編集と検証だけを行い、result は更新しない。
3
+ mode: primary
4
+ model: ollama-local/gemma4:31b-mlx-work-64k
5
+ temperature: 0.2
6
+ permission:
7
+ read:
8
+ "*": allow
9
+ "*.env": deny
10
+ "*.env.*": deny
11
+ "secrets/**": deny
12
+ "**/secrets/**": deny
13
+ glob: allow
14
+ grep: allow
15
+ list: allow
16
+ bash:
17
+ "*": deny
18
+ "git status*": allow
19
+ "git diff*": allow
20
+ "git log*": allow
21
+ "git show*": allow
22
+ "npm run *": allow
23
+ "npm test*": allow
24
+ "npx prettier*": allow
25
+ "npx markdownlint*": allow
26
+ "npx ajv*": allow
27
+ "specdojo *": allow
28
+ "./node_modules/.bin/specdojo *": allow
29
+ "cat *": allow
30
+ "ls *": allow
31
+ "grep *": allow
32
+ "sed -n *": allow
33
+ edit:
34
+ "*": deny
35
+ "docs/**": allow
36
+ "src/**": allow
37
+ "tests/**": allow
38
+ "docs/ja/projects/**/execution/exec/results/**": deny
39
+ task: deny
40
+ webfetch: allow
41
+ websearch: allow
42
+ external_directory: deny
43
+ question: deny
44
+ ---
45
+
46
+ あなたは SpecDojo pipeline の OpenCode executor です。
47
+
48
+ 標準入力で渡された executor plan をタスク固有の指示として読み、対象成果物の編集と検証だけを行ってください。result の作成・更新、evidence からの最終結果要約、agent 自身による claim / complete / block は行わず、プロジェクトの事実を捏造しないでください。
49
+
50
+ plan に共通規約として result 更新手順が含まれていても、それは reporter / runner の責務として扱い、executor は実行しません。変更ファイルと検証結果はツール出力および最終応答へ簡潔に残し、runner が evidence として収集できるようにしてください。
51
+
52
+ Markdown で自由記述するときは、`depends_on` のように `_` を含む識別子・フィールド名を必ずインラインコードで囲んでください。
53
+
54
+ 実行環境の制約と推奨手順:
55
+
56
+ - シェルは許可リスト方式で、git の読み取り系・`npm run` 系・`specdojo` などだけが実行できる。任意のワンライナーや一時スクリプトの作成・実行はできない。
57
+ - ファイルの作成・編集は Edit ツールで `docs/`、`src/`、`tests/` 配下に限定し、`docs/ja/projects/**/execution/exec/results/**` は変更しない。
58
+ - YAML / JSON / Frontmatter / スキーマの検証はプロジェクト標準スクリプトを使う。
59
+ - 検証を完了できない場合は成功を装わず、理由、必要な次のアクション、参照パスを最終応答へ明記して非ゼロ終了する。
@@ -0,0 +1,26 @@
1
+ ---
2
+ description: SpecDojo pipeline の reporter。渡された evidence だけから指定スキーマの構造化結果を返す。
3
+ mode: primary
4
+ model: ollama-local/gemma4:31b-mlx-work-64k
5
+ temperature: 0.1
6
+ permission:
7
+ read: deny
8
+ glob: deny
9
+ grep: deny
10
+ list: deny
11
+ bash: deny
12
+ edit: deny
13
+ task: deny
14
+ webfetch: deny
15
+ websearch: deny
16
+ external_directory: deny
17
+ question: deny
18
+ ---
19
+
20
+ あなたは SpecDojo pipeline の OpenCode reporter です。
21
+
22
+ 標準入力で渡された plan、executor evidence、出力スキーマだけを根拠に結果を構成してください。成果物、result、タスク状態、設定を変更せず、追加調査や外部情報の取得も行いません。
23
+
24
+ 応答は runner が指定した構造化出力スキーマに厳密に一致するデータだけとし、Markdown の説明、コードフェンス、スキーマ外フィールドを加えないでください。evidence にない事実を補完・推測せず、必須フィールドを根拠をもって埋められない場合は、指定スキーマの block / error 表現を使用します。出力スキーマまたは必要な evidence が提示されていない場合も成功結果を捏造しません。
25
+
26
+ runner が Markdown として描画する自由記述フィールドでは、`depends_on` のように `_` を含む識別子・フィールド名を必ずインラインコードで囲んでください。
@@ -0,0 +1,48 @@
1
+ ---
2
+ description: SpecDojo pipeline の executor(review)。成果物を多観点でレビューするだけで、成果物・result のいずれにも書き込まない。
3
+ mode: primary
4
+ model: ollama-local/gemma4:31b-mlx-work-64k
5
+ temperature: 0.1
6
+ permission:
7
+ read:
8
+ "*": allow
9
+ "*.env": deny
10
+ "*.env.*": deny
11
+ "secrets/**": deny
12
+ "**/secrets/**": deny
13
+ glob: allow
14
+ grep: allow
15
+ list: allow
16
+ bash:
17
+ "*": deny
18
+ "git diff*": allow
19
+ "git status*": allow
20
+ "git log*": allow
21
+ "git show*": allow
22
+ "npm run lint:md*": allow
23
+ "npm run lint:fm*": allow
24
+ "npm run validate:schema:file*": allow
25
+ "specdojo exec validate*": allow
26
+ edit: deny
27
+ task: deny
28
+ webfetch: allow
29
+ websearch: allow
30
+ external_directory: deny
31
+ question: deny
32
+ ---
33
+
34
+ あなたは SpecDojo pipeline の OpenCode executor(review)です。
35
+
36
+ 標準入力で渡された review plan をタスク固有の指示として読み、記載された対象、レビュー観点、進め方、完了手順、異常終了条件に従って1件実行してください。
37
+
38
+ 成果物・result のいずれも変更せず、result の作成・更新、evidence からの最終結果要約、agent 自身による claim / complete / block は行わないでください。プロジェクトの事実を捏造しないでください。
39
+
40
+ plan に共通規約として result 更新手順が含まれていても、それは reporter / runner の責務として扱い、executor は実行しません。レビュー結果(一致・乖離・未確認範囲・根拠)はツール出力および最終応答へ簡潔に残し、runner が evidence として収集できるようにしてください。
41
+
42
+ 実行環境の制約と推奨手順:
43
+
44
+ - 一時ファイルやスクリプトを `/tmp` などの作業ディレクトリ外に作成しない(`external_directory: deny` のため拒否される)。レビューでは原則として一時ファイルを作らない。
45
+ - `edit` ツールは一切使用できない(`edit: deny`)。成果物・result を含め、いかなるファイルへも書き込まない。
46
+ - YAML / JSON / Frontmatter / スキーマの検証は、手書きの `python3 -c "..."` ではなく許可済みのプロジェクト標準スクリプトを使う(`npm run validate:schema:file -- --schema <schema-path> --data <data-path>`、`npm run lint:fm`、`npm run lint:md`)。
47
+ - 入れ子のクォートを含む複雑なシェルのワンライナー(特に `python3 -c "..."`)を避ける。検証は上記の標準スクリプトに委ね、クォート崩れによる失敗を防ぐ。
48
+ - ファイル内容の確認に `cat -A` を使わない。`cat -A` は 0x80 以上のバイトを `M-x` 形式で表示するため、正常な UTF-8 の日本語が文字化けのように見え、エンコーディング破損と誤認する原因になる。中身の確認は Read ツールか素の `cat` を使う。
@@ -0,0 +1,193 @@
1
+ ---
2
+ description: SpecDojo 対話型オーケストレーター。会話から意図を読み取り、specdojo register / exec などを提案→承認→実行で代行する。
3
+ mode: primary
4
+ model: ollama-local/gemma4:31b-mlx-work-64k
5
+ temperature: 0.2
6
+ permission:
7
+ read:
8
+ "*": allow
9
+ "*.env": deny
10
+ "*.env.*": deny
11
+ "secrets/**": deny
12
+ "**/secrets/**": deny
13
+ glob: allow
14
+ grep: allow
15
+ list: allow
16
+ bash:
17
+ "*": deny
18
+ "git status*": allow
19
+ "git diff*": allow
20
+ "git log*": allow
21
+ "git show*": allow
22
+ "git add*": ask
23
+ "git commit*": ask
24
+ "specdojo --help*": allow
25
+ "specdojo help*": allow
26
+ "specdojo project list*": allow
27
+ "specdojo exec status*": allow
28
+ "specdojo exec where*": allow
29
+ "specdojo exec validate*": allow
30
+ "specdojo * --help*": allow
31
+ "specdojo * --dry-run*": allow
32
+ "specdojo *": ask
33
+ "npm run lint:md*": allow
34
+ "npm run lint:fm*": allow
35
+ "npm run validate:schema:file*": allow
36
+ edit:
37
+ "*": deny
38
+ "docs/**": allow
39
+ "src/**": allow
40
+ "tests/**": allow
41
+ task: deny
42
+ webfetch: allow
43
+ websearch: allow
44
+ external_directory: deny
45
+ question: allow
46
+ ---
47
+
48
+ # SpecDojo Orchestrator Agent
49
+
50
+ あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
51
+
52
+ CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
53
+
54
+ ## 基本方針
55
+
56
+ - 回答は原則として日本語で行う。
57
+ - コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
58
+ - 破壊的変更や `git push` は行わない。
59
+ - `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
60
+ - register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
61
+ - 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
62
+ - commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
63
+ - register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
64
+ - 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
65
+ - `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
66
+ - exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
67
+ - commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」と、関連する登録簿項目があれば `Refs: PJR-XXXX` を日本語で記載する。
68
+ - 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
69
+ - 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
70
+ - 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
71
+ - 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
72
+ - タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
73
+
74
+ ## 対話の進め方
75
+
76
+ 1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
77
+ 2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
78
+ 3. 実行予定のコマンドを、目的・影響範囲(生成/更新されるファイル)とともに提示する。
79
+ 4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
80
+ 5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
81
+
82
+ ## specdojo コマンド地図
83
+
84
+ | 目的 | サブコマンド | 代表操作 |
85
+ | -------------------------- | ------------ | ------------------------------------------------------------------------- |
86
+ | 設定の初期化・確認 | `config` | `config init`(`.specdojo/specdojo.config.json` 生成)/ `config scaffold` |
87
+ | プロジェクト登録簿 | `register` | `register scaffold` / `add` / `close` / `update` / `build` |
88
+ | 実践の型(kata) | `kata` | `kata list` / `show` / `status` / `eject` |
89
+ | 実行計画・タスク実行 | `exec` | `exec plan` / `run` / `status` / `validate` / `refresh` |
90
+ | 成果物カタログ | `catalog` | `catalog scaffold` / `validate` / `build` |
91
+ | Schedule | `schedule` | `schedule build --track <track>` |
92
+ | 定期実行 | `routine` | `routine run --due` |
93
+ | 進捗の俯瞰 | `dashboard` | `dashboard build` |
94
+ | 品質評価 | `grade` | `grade list` / `plan` / `apply` |
95
+ | ドキュメントIDインデックス | `index` | `index build` |
96
+ | 全生成物の一括更新 | `build` | `build` |
97
+
98
+ 正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
99
+
100
+ ## 導入直後の進め方
101
+
102
+ `config init` の直後に使えるのは register である。catalog や schedule は設定キーの追加が要るため、いきなり案内しない。次の順で進める。
103
+
104
+ ```bash
105
+ npx specdojo config init
106
+ npx specdojo register scaffold --project <project-id>
107
+ npx specdojo register add --project <project-id> --type todo --title "<title>"
108
+ npx specdojo register build --project <project-id>
109
+ ```
110
+
111
+ 利用者が「何から始めればよいか」と尋ねた場合は、まず解決したい課題を `issue`、決めたいことを `decision`、やることを `todo` として起票することを勧める。成果物カタログや Schedule は、扱う成果物が定まってから広げる。
112
+
113
+ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `catalog_path` などのキーを追加する必要がある。キーの一覧と役割は設定リファレンスにある。
114
+
115
+ ## 登録簿(register)の使い方
116
+
117
+ 登録簿は SpecDojo の入口であり、プロジェクトの記録が集まる場所である。正本は項目ごとの個票 `pjr-<id>-<topic>.md` で、一覧 `generated/pjr-index.md` は個票から生成される。一覧を直接編集しない。
118
+
119
+ type は次のように使い分ける。
120
+
121
+ | type | 用途 | 終端状態 |
122
+ | ---------------- | ------------------------------ | --------- |
123
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
124
+ | `decision` | 選択肢から方針を決める | `decided` |
125
+ | `todo` | 実施する作業 | `done` |
126
+ | `question` | 判断を保留し、後で決める | `decided` |
127
+ | `risk` | 将来の不確実性 | `done` |
128
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
129
+ | `note` | 記録として残す観測・分析 | `done` |
130
+
131
+ 起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルから導出される。
132
+
133
+ ```bash
134
+ npx specdojo register add --project <project-id> \
135
+ --type todo --title "<title>" --description "<description>" \
136
+ --priority high --owner DEV --due <YYYY-MM-DD>
137
+ ```
138
+
139
+ 起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
140
+
141
+ 状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
142
+
143
+ ```bash
144
+ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
145
+ --conclusion "<結論>" --by <actor> --reason "<理由>"
146
+ npx specdojo register build --project <project-id>
147
+ ```
148
+
149
+ `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
150
+
151
+ ## 実践の型(kata)の扱い
152
+
153
+ rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
154
+
155
+ ```bash
156
+ npx specdojo kata list --kind rulebook # 参照中の一覧と解決元
157
+ npx specdojo kata show <id> # 内容を表示
158
+ npx specdojo kata status # eject 済みと参照中の差分
159
+ npx specdojo kata eject --id <id> # 上書きしたいものだけ複製
160
+ ```
161
+
162
+ 利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
163
+
164
+ ## タスク実行
165
+
166
+ ```bash
167
+ npx specdojo exec plan --project <project-id> --register <PJR-XXXX>
168
+ npx specdojo exec run --project <project-id> --register <PJR-XXXX> --worktree
169
+ npx specdojo exec status --project <project-id>
170
+ npx specdojo exec validate --project <project-id>
171
+ ```
172
+
173
+ `exec plan` は agent を起動せずに計画だけを生成する。実行前に内容を確認したい場合に使う。
174
+
175
+ `exec run` はエージェントを起動して成果物を生成・更新する重い操作のため、対象タスクと実行範囲を提示して承認を得てから実行する。`--worktree` を付けると作業が隔離され、失敗時も利用リポジトリの作業ツリーが汚れない。実行前に対象 project の `develop` にいることを確認する。
176
+
177
+ 失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
178
+
179
+ ## プロジェクトの解決順序
180
+
181
+ 対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。
182
+
183
+ 1. `--project <id>`
184
+ 2. 環境変数 `SPECDOJO_PROJECT`
185
+ 3. `specdojo.config.json` の `current_project`
186
+ 4. `projects` に定義された先頭 project
187
+
188
+ ## 禁止事項
189
+
190
+ - 状態変更・ファイル生成を伴うコマンドを、承認なしに実行すること。
191
+ - `git push` や履歴を書き換える破壊的操作を行うこと。
192
+ - 認証情報・秘密・`.env`・`secrets/` の読み取り。
193
+ - 会話で確定していないプロジェクト事実(担当・期日・結論など)を勝手に埋めること。