specdojo 0.6.0 → 0.8.0

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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -101,6 +101,7 @@ properties:
101
101
  [
102
102
  draft,
103
103
  fully-guided,
104
+ condense,
104
105
  recipe-guided,
105
106
  freeform,
106
107
  retrofit,
@@ -120,6 +121,8 @@ properties:
120
121
  else:
121
122
  properties:
122
123
  track: false
124
+ domains: false
125
+ start_on: false
123
126
  - type: object
124
127
  required:
125
128
  - rulebook
@@ -165,7 +168,15 @@ properties:
165
168
 
166
169
  track:
167
170
  $ref: "#/$defs/Track"
168
- description: "Track governed by this epic; checked against tml-index.yaml when present."
171
+ description: "Track governed exclusively by this epic."
172
+
173
+ domains:
174
+ type: array
175
+ items:
176
+ type: string
177
+ minLength: 1
178
+ uniqueItems: true
179
+ description: "Catalog domains governed by this epic. Omission permits legacy fallback."
169
180
 
170
181
  item_status:
171
182
  $ref: "#/$defs/ItemStatus"
@@ -196,6 +207,10 @@ properties:
196
207
  register timezone. Omit the key only when the registration time of a
197
208
  legacy item is unknown; newly added items always record it.
198
209
 
210
+ start_on:
211
+ $ref: "#/$defs/Date"
212
+ description: "Planned start calendar date for an epic. Omit while undecided."
213
+
199
214
  due_on:
200
215
  oneOf:
201
216
  - $ref: "#/$defs/Date"
@@ -383,6 +398,7 @@ $defs:
383
398
  enum:
384
399
  - draft
385
400
  - fully-guided
401
+ - condense
386
402
  - recipe-guided
387
403
  - freeform
388
404
  - bootstrap
@@ -51,6 +51,7 @@ $defs:
51
51
  lint-fm,
52
52
  lint-md,
53
53
  lint-mermaid,
54
+ lint-d2,
54
55
  build,
55
56
  format-check,
56
57
  ]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.6.0",
3
+ "version": "0.8.0",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -71,6 +71,8 @@
71
71
  "orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
72
72
  "orch:flash": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
73
73
  "orch:flash:work": "tools/worktree/open-agent-worktree.sh agy-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider antigravity -- --add-dir . --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
74
+ "orch:argon": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-4-argon-medium -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
75
+ "orch:argon:work": "tools/worktree/open-agent-worktree.sh argon-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider antigravity -- --add-dir . --model gemini-4-argon-medium -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
74
76
  "orch:qwen": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent qwen-orchestrator",
75
77
  "orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider opencode -- --agent qwen-orchestrator",
76
78
  "orch:gemma": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent gemma-orchestrator",
@@ -91,9 +93,10 @@
91
93
  "docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
92
94
  "docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
93
95
  "docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
94
- "docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
96
+ "docs:build": "npm run docs:generate && NODE_OPTIONS=--max-old-space-size=8192 npm --prefix packages/docs-site run docs:build",
95
97
  "lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
96
98
  "lint:mermaid": "node tools/lint-mermaid.mjs",
99
+ "lint:d2": "node tools/lint-d2.mjs",
97
100
  "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",
98
101
  "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",
99
102
  "validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
@@ -102,7 +105,7 @@
102
105
  "validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
103
106
  "validate:catalog": "tsx src/specdojo.ts catalog validate",
104
107
  "validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
105
- "check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
108
+ "check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run lint:d2 && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
106
109
  "check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
107
110
  "dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
108
111
  "dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
@@ -1,64 +1,37 @@
1
- # Antigravity 向け配布原本
1
+ # Antigravity CLI provider 設定
2
2
 
3
- `npx specdojo config scaffold --provider antigravity` が配置するファイルの原本です。この README 自体はコピーされません。
3
+ `npx specdojo config scaffold --provider antigravity` の配布原本です。README と旧 `settings.global.json` はコピーされません。
4
4
 
5
- ## 配置されるもの
5
+ | 原本 | 配置先 |
6
+ | ----------------------------------------------------------------------------------------------------- | ------------------------ |
7
+ | `settings.edit.json` / `settings.review.json` / `settings.report.json` / `settings.orchestrator.json` | `.specdojo/antigravity/` |
8
+ | `orchestrator.md` / `exec-defaults-snippet.yaml` / `agent-members-snippet.yaml` | `.specdojo/antigravity/` |
6
9
 
7
- | 原本 | 配置先 |
8
- | ---------------------------- | -------------------------------------------------- |
9
- | `orchestrator.md` | `.specdojo/antigravity/orchestrator.md` |
10
- | `exec-defaults-snippet.yaml` | `.specdojo/antigravity/exec-defaults-snippet.yaml` |
11
- | `agent-members-snippet.yaml` | `.specdojo/antigravity/agent-members-snippet.yaml` |
12
-
13
- `settings.global.json` はリポジトリへコピーされません。`--global` を明示した場合だけ、
14
- 権限ルールをユーザー設定へマージするための原本として使われます。
15
-
16
- ## ユーザー権限設定
17
-
18
- まず dry-run で、`~/.gemini/antigravity-cli/settings.json` へ追加されるルールだけを差分表示します。
10
+ 通常の導入ではグローバル設定を書き換えません。agy 1.4.12 以上と、同じ版の `specdojo` が PATH に必要です。
19
11
 
20
12
  ```sh
21
- npx specdojo config scaffold --provider antigravity --global --dry-run
13
+ npx specdojo config scaffold --provider antigravity --dry-run
14
+ npx specdojo config scaffold --provider antigravity
22
15
  ```
23
16
 
24
- 内容を確認してから適用します。
17
+ provider / member のスニペットを設定へマージし、生成ファイルを commit します。command template は次の入口を使います。
25
18
 
26
- ```sh
27
- npx specdojo config scaffold --provider antigravity --global
19
+ ```yaml
20
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
28
21
  ```
29
22
 
30
- - `--global` を付けない通常の scaffold はユーザーディレクトリへ触れません。
31
- - `permissions.allow` / `deny` / `ask` の既存要素と、それ以外のユーザー設定を保持し、不足するルールだけを末尾へ追加します。
32
- - 書き換え前のファイルは `settings.json.backup-<timestamp>` へ退避します。設定ファイルがまだ無い場合は新規作成し、バックアップは作りません。
33
- - 既存 JSON や permission 配列の形式が不正な場合は、バックアップも書き込みも行わずエラーにします。
34
- - `--force` はリポジトリ内の配布物だけに作用し、グローバル設定の既存項目を上書きしません。
35
-
36
- 権限原本は、必要な検証コマンドを allow し、`git push`、読み取りを含む全 `gh`、破壊的コマンド、秘密情報、親 runner・hook・CI・agent 設定を変更できるパスを deny します。`.specdojo/doc-index.json` のような既知の生成物は検証で更新できるよう、`.specdojo/` 全体ではなく設定ファイルと provider ディレクトリを個別に deny します。provider 非依存の実行後ガードも併用されます。
23
+ `mode` は edit / review / report です。起動処理が役割プロファイルと runner の宣言済み task worktree の絶対パスを単一の `--settings` JSON にまとめて渡し、保存しません。edit は通常成果物を編集し、秘密情報・保護設定を拒否します。review / report は全ファイルの書き込みと command / MCP を拒否します。検証は親 runner に委ねます。
37
24
 
38
- ## オーケストレーターの起動
39
-
40
- Antigravity CLI(`agy`)はファイル定義の agent を持たないため、`--agent <name>` では起動できません。規範の本文を `-i` で渡します。
25
+ 対話型は生成された `npm run orch:argon`(または `npm run orch:flash`)あるいは次の入口を使います。
41
26
 
42
27
  ```sh
43
- agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
44
- ```
45
-
46
- `--add-dir "$(pwd)"` を付けないと、作業ディレクトリのファイルを読み書きできず、`AGENTS.md` と `.agents/rules/*.md` も読み込まれません。
47
-
48
- `package.json` へ登録しておくと短く起動できます。
49
-
50
- ```json
51
- {
52
- "scripts": {
53
- "orch:flash": "specdojo orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
54
- }
55
- }
28
+ specdojo orchestrator launch --provider antigravity -- --model gemini-4-argon-medium -i "$(cat .specdojo/antigravity/orchestrator.md)"
56
29
  ```
57
30
 
58
- ## executor / reporter として使う
31
+ この入口は orchestrator プロファイルと選択 project の宣言済み repository を使い、cwd も `--add-dir` に加えます。保護設定の編集は利用者の承認に従い、秘密情報・Git metadata・push の制限は維持します。直接 `agy` を起動すると、この権限生成処理は適用されません。
59
32
 
60
- `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。
33
+ 既存利用者は command template と個別 command を上記へ移行し、`--dangerously-skip-permissions` を削除してください。既存 npm script は scaffold が上書きしないため、`orchestrator launch` 経由へ手動変更します。旧 `--global` は互換用途で残ります。既存ルールを自動で消さず、ユーザー設定をバックアップして自身の制限を役割プロファイルへ移してください。
61
34
 
62
- 名簿は実体と別名の 2 段で書きます。実体(`flash-executor`・`agy-opus-executor` など)は model の系統で名付け、model の ID を `model` に持ちます。従来の名前(`agy-executor`・`agy-claude-executor` など)は `aliases` で実体を指す別名にします。スニペット末尾の `aliases` の例は、向き先の member を有効にしたものだけを写します(別名は無効な member を指せません)。
35
+ `--settings` と既存グローバル・project 設定の配列マージは実機で未検証です。Claude と同等の隔離を確認したとは扱いません。仕様・移行・無害なファイルでの実機検証手順は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。実機の許可/拒否と、統合後の PJR-JSEY の証跡を記録してから運用へ適用します。
63
36
 
64
- 使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
37
+ モデル ID は `agy models` で確認し、推論強度を含むため `--effort` と併用しません。認証は利用者が別途行い、設定や成果物に資格情報を書きません。
@@ -7,20 +7,19 @@
7
7
 
8
8
  providers:
9
9
  antigravity:
10
- # Antigravity CLI(agy)は --agent による定義ファイルの選択を持たず、codex と同じく
11
- # プロンプト(plan)だけで役割を与える。-p はプロンプトを引数に取り stdin を読まないため、
10
+ # pipeline の役割指示は plan、権限は agent launch の --role で分離する。
11
+ # -p はプロンプトを引数に取り stdin を読まないため、
12
12
  # runner が stdin へ書く plan を "$(cat)" で引数に渡す(shell: true で実行される)。
13
13
  # --sandbox は書き込み先を ~/.gemini 配下の scratch へ逃がすため、--add-dir で作業
14
14
  # ディレクトリ(worktree)を明示して成果物へ書けるようにする(2026-09-21 実測)。
15
- # 非対話実行で必要な command は、config scaffold --provider antigravity --global が
16
- # ~/.gemini/antigravity-cli/settings.json へ追記する。dangerously-skip-permissions は
17
- # deny rule も含めた承認境界を迂回するため使わない。
15
+ # agent launch が settings.{mode}.json と宣言済み worktree の保護ルールを一つの
16
+ # --settings JSON にまとめて渡す。グローバル設定への書き込みは不要。
18
17
  # agy のモデル ID は推論強度を含む(gemini-3.8-flash-{high,medium,low} など)。--effort を
19
18
  # 併用すると ID と食い違ったときに "invalid model selection" で起動に失敗するため、
20
19
  # 強度はモデル ID だけで指定する(2026-09-21 実測: flash-high + --effort medium で失敗)。
21
20
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
22
21
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
23
- command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
22
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
24
23
  # 従来の 1 段の名簿(model を持たない member)を使い続ける場合の補い方:
25
24
  # command_params:
26
25
  # by_proficiency:
@@ -178,6 +178,7 @@ npx specdojo exec validate --project <project-id>
178
178
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
179
179
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
180
180
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
181
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
181
182
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
182
183
 
183
184
  ## 止まったときの対処
@@ -187,7 +188,7 @@ npx specdojo exec validate --project <project-id>
187
188
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
188
189
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
189
190
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
190
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
191
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
191
192
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
192
193
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
193
194
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -196,7 +197,7 @@ npx specdojo exec validate --project <project-id>
196
197
 
197
198
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
198
199
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
199
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
200
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
200
201
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
201
202
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
202
203
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
@@ -0,0 +1,73 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": [
5
+ "command(git status)",
6
+ "command(git diff)",
7
+ "command(git log)",
8
+ "command(git show)",
9
+ "command(npm run)",
10
+ "command(npm test)",
11
+ "command(npx prettier)",
12
+ "command(npx markdownlint)",
13
+ "command(specdojo catalog validate)"
14
+ ],
15
+ "deny": [
16
+ "command(git add)",
17
+ "command(git commit)",
18
+ "command(git push)",
19
+ "command(gh)",
20
+ "command(/usr/bin/git push)",
21
+ "command(/usr/bin/gh)",
22
+ "command(/usr/local/bin/git push)",
23
+ "command(/usr/local/bin/gh)",
24
+ "command(git reset --hard)",
25
+ "command(rm -rf)",
26
+ "command(sudo)",
27
+ "read_file(.env)",
28
+ "read_file(secrets/)",
29
+ "write_file(.git/)",
30
+ "write_file(node_modules/)",
31
+ "write_file(.specdojo/specdojo.config.json)",
32
+ "write_file(.specdojo/exec-defaults.yaml)",
33
+ "write_file(.specdojo/index-config.yaml)",
34
+ "write_file(.specdojo/antigravity/)",
35
+ "write_file(.specdojo/claude/)",
36
+ "write_file(.specdojo/codex/)",
37
+ "write_file(.specdojo/copilot/)",
38
+ "write_file(.specdojo/opencode/)",
39
+ "write_file(.agents/rules/)",
40
+ "write_file(.agents/skills/)",
41
+ "write_file(.claude/)",
42
+ "write_file(.codex/)",
43
+ "write_file(.opencode/)",
44
+ "write_file(.github/agents/)",
45
+ "write_file(.github/workflows/)",
46
+ "write_file(.gitlab/ci/)",
47
+ "write_file(.circleci/)",
48
+ "write_file(.azure-pipelines/)",
49
+ "write_file(.jenkins/)",
50
+ "write_file(package.json)",
51
+ "write_file(AGENTS.md)",
52
+ "write_file(CLAUDE.md)",
53
+ "write_file(GEMINI.md)",
54
+ "write_file(lefthook.yml)",
55
+ "write_file(.lefthook.yml)",
56
+ "write_file(.gitlab-ci.yml)",
57
+ "write_file(.gitlab-ci.yaml)",
58
+ "write_file(azure-pipelines.yml)",
59
+ "write_file(azure-pipelines.yaml)",
60
+ "write_file(Jenkinsfile)",
61
+ "write_file(commitlint.config.js)",
62
+ "write_file(commitlint.config.cjs)",
63
+ "write_file(commitlint.config.mjs)",
64
+ "write_file(commitlint.config.ts)",
65
+ "write_file(.commitlintrc)",
66
+ "write_file(.commitlintrc.json)",
67
+ "write_file(.commitlintrc.yaml)",
68
+ "write_file(.commitlintrc.yml)",
69
+ "write_file(.specdojo/)",
70
+ "command(git config)"
71
+ ]
72
+ }
73
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
5
+ "deny": [
6
+ "read_file(.env)",
7
+ "read_file(secrets/)",
8
+ "write_file(.git/)",
9
+ "command(git push)",
10
+ "command(gh)",
11
+ "command(rm -rf)",
12
+ "command(sudo)"
13
+ ]
14
+ }
15
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
5
+ "deny": ["write_file(*)", "command(*)", "unsandboxed(*)", "mcp(*)", "execute_url(*)"]
6
+ }
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
5
+ "deny": ["write_file(*)", "command(*)", "unsandboxed(*)", "mcp(*)", "execute_url(*)"]
6
+ }
7
+ }
@@ -185,6 +185,7 @@ npx specdojo exec validate --project <project-id>
185
185
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
186
186
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
187
187
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
188
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
188
189
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
189
190
 
190
191
  ## 止まったときの対処
@@ -194,7 +195,7 @@ npx specdojo exec validate --project <project-id>
194
195
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
195
196
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
196
197
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
197
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
198
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
198
199
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
199
200
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
200
201
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -203,7 +204,7 @@ npx specdojo exec validate --project <project-id>
203
204
 
204
205
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
205
206
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
206
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
207
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
207
208
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
208
209
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
209
210
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
@@ -185,6 +185,7 @@ npx specdojo exec validate --project <project-id>
185
185
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
186
186
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
187
187
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
188
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
188
189
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
189
190
 
190
191
  ## 止まったときの対処
@@ -194,7 +195,7 @@ npx specdojo exec validate --project <project-id>
194
195
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
195
196
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
196
197
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
197
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
198
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
198
199
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
199
200
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
200
201
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -203,7 +204,7 @@ npx specdojo exec validate --project <project-id>
203
204
 
204
205
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
205
206
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
206
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
207
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
207
208
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
208
209
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
209
210
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
@@ -178,6 +178,7 @@ npx specdojo exec validate --project <project-id>
178
178
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
179
179
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
180
180
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
181
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
181
182
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
182
183
 
183
184
  ## 止まったときの対処
@@ -187,7 +188,7 @@ npx specdojo exec validate --project <project-id>
187
188
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
188
189
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
189
190
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
190
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
191
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
191
192
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
192
193
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
193
194
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -196,7 +197,7 @@ npx specdojo exec validate --project <project-id>
196
197
 
197
198
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
198
199
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
199
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
200
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
200
201
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
201
202
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
202
203
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。