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
@@ -0,0 +1,40 @@
1
+ # yaml-language-server: $schema=../../../specdojo/schemas/v1/dct.schema.yaml
2
+ # specdojo-schema: validate=false reason=template
3
+ # Template: data model deliverables catalog (code table)
4
+ # Placeholder _PROJECT_ID_ is not used for product-level templates.
5
+ # base_path is fixed to the product document directory.
6
+ #
7
+ # This is the cdt physical part of the data-model domain. Catalog build merges
8
+ # all dct-data-model-*-template parts by same-name group in sorted file order.
9
+ #
10
+ # local_id の _TERM_ 反復方針(複数業務領域への複製 / 単一領域を複数項目に分割)は
11
+ # dct-rulebook.md の「業務領域テンプレートの反復方針(_TERM_ の使い分け)」を正とする。
12
+ id: specdojo:dct-data-model-cdt-template
13
+ type: template
14
+ status: draft
15
+ title: 成果物カタログ(データモデル/分類一覧)
16
+ rulebook: specdojo:dct-rulebook
17
+ supersedes:
18
+ - specdojo:dct-data-model-cld-template
19
+ domain: data-model
20
+ base_path: /docs/ja/product/010-business-specs/020-data-model
21
+
22
+ groups:
23
+ - name: 業務データ辞書
24
+ deliverables:
25
+ - local_id: cdt-_TERM_
26
+ min_size: medium
27
+ name: 分類一覧
28
+ kind: work
29
+ depends_on: []
30
+ overview: 業務上の分類(カテゴリ・種別・区分など)を一覧で定義する
31
+ path: cdt-_TERM_.md
32
+ rulebook: specdojo:cdt-rulebook
33
+ note: "_TERM_ は対象分類体系の略称(kebab-case)"
34
+ done_criteria:
35
+ - text: 分類名・説明が業務観点で正確に定義されていること
36
+ roles: [BA]
37
+ viewpoint: vp-ba-requirements-completeness
38
+ - text: 分類実装(マスタデータ・コード値)の基礎として参照できること
39
+ roles: [DEV]
40
+ viewpoint: vp-dev-implementation-readiness
@@ -1,18 +1,11 @@
1
1
  # yaml-language-server: $schema=../../../specdojo/schemas/v1/dct.schema.yaml
2
2
  # specdojo-schema: validate=false reason=template
3
- # Template: data model deliverables catalog (classification definition)
4
- # Placeholder _PROJECT_ID_ is not used for product-level templates.
5
- # base_path is fixed to the product document directory.
6
- #
7
- # This is the cld physical part of the data-model domain. Catalog build merges
8
- # all dct-data-model-*-template parts by same-name group in sorted file order.
9
- #
10
- # local_id の _TERM_ 反復方針(複数業務領域への複製 / 単一領域を複数項目に分割)は
11
- # dct-rulebook.md の「業務領域テンプレートの反復方針(_TERM_ の使い分け)」を正とする。
3
+ # 非推奨: 分類一覧の略号は cld から cdt へ移行しました。
4
+ # 移行先は specdojo:dct-data-model-cdt-template を参照してください。
12
5
  id: specdojo:dct-data-model-cld-template
13
6
  type: template
14
- status: draft
15
- title: 成果物カタログ(データモデル/分類定義)
7
+ status: deprecated
8
+ title: 成果物カタログ(データモデル/分類定義)(非推奨)
16
9
  rulebook: specdojo:dct-rulebook
17
10
  domain: data-model
18
11
  base_path: /docs/ja/product/010-business-specs/020-data-model
@@ -22,13 +15,13 @@ groups:
22
15
  deliverables:
23
16
  - local_id: cld-_TERM_
24
17
  min_size: medium
25
- name: 分類定義
18
+ name: 分類定義(非推奨)
26
19
  kind: work
27
20
  depends_on: []
28
- overview: 業務上の分類(カテゴリ・種別・区分など)を一覧で定義する
21
+ overview: 非推奨。specdojo:dct-data-model-cdt-template の cdt-_TERM_ を参照
29
22
  path: cld-_TERM_.md
30
23
  rulebook: specdojo:cld-rulebook
31
- note: "_TERM_ は対象分類体系の略称(kebab-case)"
24
+ note: 非推奨。specdojo:dct-data-model-cdt-template を使用してください
32
25
  done_criteria:
33
26
  - text: 分類名・説明が業務観点で正確に定義されていること
34
27
  roles: [BA]
@@ -2,7 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:dct-index-template
4
4
  type: template
5
- status: draft
5
+ status: ready
6
6
  frontmatter_template:
7
7
  specdojo:
8
8
  id: _PROJECT_ID_:dct-index
@@ -15,25 +15,14 @@ specdojo:
15
15
 
16
16
  Project Deliverables Catalog
17
17
 
18
- > このファイルは `dct-index.yaml` と各 `dct-*.yaml` から生成された一覧ビューです。表示名・概要・順序・グループの正本は `dct-index.yaml` であり、このファイルを手編集しても次回の `specdojo catalog build` で失われます。
19
-
20
- SpecDojo プロジェクトで作成する成果物とその説明をまとめたプロジェクト成果物カタログです。
21
- ドメイン別成果物カタログへの参照先を一元管理し、成果物体系の参照起点を明確にします。
22
- 個別成果物の詳細情報は各 `dct-<domain>.md` に集約し、本書では共通ルールとドメイン一覧を管理します。
23
-
24
- ## 1. 共通ルール
25
-
26
- - Frontmatter の `id` は `<project-id>:<local-id>` とします。
27
- - `ドメイン` は成果物の分類を示すために使用します。また、`DOMAIN` はその短縮名で、Schedule などで使用します。
28
- - Frontmatter の `based_on` には、直接根拠として参照した文書のみを記載します。
29
- - `local-id` は成果物の論理名を表し、ファイル名および Frontmatter の `id` の基礎として使用します(例: `prj-overview`)。
30
- - `ARTIFACT` は `local-id` の短縮名で、Schedule などで使用します。
31
- - ファイルは以下の形式で命名し、`配置先` に保存します。
32
- - Markdown の場合は、`<local-id>.md` もしくは `<成果物名>.md`
33
- - YAML の場合は、`<local-id>.yaml` もしくは `<成果物名>.yaml`
34
- - `根拠` には、その成果物の検討・作成における主要な依存関係を記載します。
35
- - `根拠` と `based_on` は原則として一致させますが、必要に応じて差分があっても構いません。
36
- - 種別は、`work`(作成する成果物)、`control`(管理用のドキュメント)、`generated`(自動生成したドキュメント等)とします。スケジュールへの展開対象は `work` のみです。
18
+ > このファイルは `dct-index.yaml` と各 `dct-*.yaml` から生成された一覧ビューです。直接編集した内容は、次回の `specdojo catalog build` で失われます。
19
+
20
+ ドメイン別成果物カタログへの参照起点です。
21
+
22
+ ## 1. 索引の正本と参照先
23
+
24
+ - 分類・表示順・表示名・概要の正本は `dct-index.yaml` です。記述規約は [[specdojo:dct-index-rulebook|成果物カタログ索引の作成ルール]] に従います。
25
+ - 個別成果物の定義の正本は `dct-<domain>.yaml` です。次の一覧から、各ドメインの生成ビューへ進めます。
37
26
 
38
27
  ## 2. 成果物カタログ一覧
39
28
 
@@ -22,7 +22,11 @@ groups:
22
22
  - local_id: pm-plan # small+
23
23
  name: プロジェクト管理計画
24
24
  kind: work
25
- depends_on: []
25
+ depends_on:
26
+ - prj-overview
27
+ - prj-scope
28
+ - prj-success-criteria-and-acceptance-criteria
29
+ - pm-organization
26
30
  overview: プロジェクト全体の管理方針・プロセスを定義
27
31
  path: pm-plan.md
28
32
  rulebook: specdojo:pm-plan-rulebook
@@ -0,0 +1,86 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:ifd-template
4
+ type: template
5
+ status: ready
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _LOCAL_ID_
9
+ type: architecture
10
+ status: draft
11
+ owner: ARC
12
+ rulebook: specdojo:ifd-mermaid-rulebook
13
+ part_of: []
14
+ based_on: _BASED_ON_
15
+ supersedes: []
16
+ ---
17
+
18
+ # _DELIVERABLE_NAME_
19
+
20
+ ## 1. 概要
21
+
22
+ _TODO_: 上位構成図への参照、対象環境、本図で判断する内容、対象外と詳細の委譲先を記入する。
23
+
24
+ _TODO_: 改訂・廃止で境界や経路が変わる場合、上位構成・連携設計(ARC)、検証対象(QE)、監視・運用参照(OPS)、公開判断(PO)の追従先と影響を記入する。
25
+
26
+ ## 2. インフラ構成図(Mermaid)
27
+
28
+ <!-- 対象に必要な境界・処理・保管先へ増減する。仮定の経路は図の近傍にも明示する。 -->
29
+
30
+ ```mermaid
31
+ flowchart LR
32
+ subgraph local["_EXECUTION_ENVIRONMENT_"]
33
+ client["_PROCESS_ROLE_"]
34
+ records("_RECORD_STORE_ROLE_")
35
+ end
36
+ subgraph external["_EXTERNAL_ZONE_"]
37
+ service["_SERVICE_ROLE_"]
38
+ end
39
+ client -->|"PATH-01: _LOCAL_PURPOSE_"| records
40
+ client -->|"PATH-02: _EXTERNAL_PURPOSE_"| service
41
+ ```
42
+
43
+ _TODO_: 枠の意味、矢印の向きと応答の省略、線種の意味、仮定を記入する。中継を省略した経路は、中継と到達条件を明記する。
44
+
45
+ ## 3. 配置と境界の定義
46
+
47
+ | 図中の環境・要素 | 上位要素 | 管理主体 | 情報・到達条件 |
48
+ | -------------------------------------------- | ----------------------- | -------------------- | ----------------------------------- |
49
+ | `_EXECUTION_ENVIRONMENT_` / `_PROCESS_ROLE_` | `_UPSTREAM_ELEMENT_` | `_MANAGER_ROLE_` | `_LOCAL_INFORMATION_AND_ACCESS_` |
50
+ | `_RECORD_STORE_ROLE_` | `_UPSTREAM_STORE_` | `_STORE_MANAGER_` | `_RECORD_SCOPE_` |
51
+ | `_EXTERNAL_ZONE_` / `_SERVICE_ROLE_` | `_UPSTREAM_DEPENDENCY_` | `_EXTERNAL_MANAGER_` | `_EXTERNAL_INFORMATION_AND_ACCESS_` |
52
+
53
+ _TODO_: 上位要素のうち図から除外したものと理由、代替配置があれば適用条件と置き換わる要素を記入する。
54
+
55
+ ## 4. 通信経路と情報の境界
56
+
57
+ | 経路 ID | 起点 → 終点 | 目的・情報 | 利用条件・詳細の委譲先 |
58
+ | --------- | ---------------------------------------- | ------------------------ | --------------------------------- |
59
+ | `PATH-01` | `_PROCESS_ROLE_` → `_RECORD_STORE_ROLE_` | `_LOCAL_INFORMATION_` | `_LOCAL_CONDITION_AND_SOURCE_` |
60
+ | `PATH-02` | `_PROCESS_ROLE_` → `_SERVICE_ROLE_` | `_EXTERNAL_INFORMATION_` | `_EXTERNAL_CONDITION_AND_SOURCE_` |
61
+
62
+ ## 5. 技術前提・制約と検証観点
63
+
64
+ ### 5.1. 技術前提・制約
65
+
66
+ - _TODO_: 実行場所・書込範囲・外部依存の必須性を記入する。
67
+ - _TODO_: 管理主体間の情報持ち出し・公開・認証の前提を記入する。
68
+ - _TODO_: 詳細設定・連携契約・運用手順の正本または未整備の引き継ぎ先を記入する。
69
+
70
+ ### 5.2. 境界・障害の検証対象
71
+
72
+ _TODO_: 検証予定と実施済みの範囲を区別し、実施済みの場合は証跡への参照を記入する。
73
+
74
+ | 対象経路・境界 | 障害条件・影響 | 観測する結果・切り分け対象 | 主確認ロール |
75
+ | -------------------- | ---------------------- | -------------------------- | -------------- |
76
+ | `_PATH_OR_BOUNDARY_` | `_FAILURE_AND_IMPACT_` | `_OBSERVABLE_RESULT_` | `_CHECK_ROLE_` |
77
+
78
+ _TODO_: 監視対象と、閾値・通知先・復旧手順を管理する正本または引き継ぎ先を記入する。
79
+
80
+ ## 6. メモ / 将来課題
81
+
82
+ <!-- 仮定・未決事項がない場合はこの章を削除する。論点には共通ラベルを付ける。未作成の委譲先はリンクにせず参照名をコードで記す。 -->
83
+
84
+ | 対象・論点 | 影響 | 担当 | 解消条件・引き継ぎ先 |
85
+ | -------------- | ---------- | -------------- | ------------------------------ |
86
+ | `_OPEN_TOPIC_` | `_IMPACT_` | `_OWNER_ROLE_` | `_RESOLUTION_AND_DESTINATION_` |
@@ -1,57 +1,69 @@
1
1
  # yaml-language-server: $schema=../../../specdojo/schemas/v1/ifx-cmd.schema.yaml
2
2
  # specdojo-schema: validate=false reason=template
3
- # Template: external command interface specification
4
- # Replace _TERM_ with a kebab-case integration name and fill every remaining
5
- # _UPPER_SNAKE_ or _TODO_ placeholder before treating the generated file as complete.
3
+ # 記入判断は [[specdojo:ifx-cmd-recipe|外部コマンド連携仕様 作成レシピ]]、
4
+ # 完成例は [[specdojo:ifx-cmd-sample|外部コマンド連携仕様サンプル]] を参照する。
5
+ # 生成時プレースホルダを展開し、残る記入欄を埋める。値・型は対応 schema を参照する。
6
6
  id: specdojo:ifx-cmd-template
7
7
  type: template
8
- status: draft
8
+ status: ready
9
9
  title: 外部コマンド連携仕様テンプレート
10
10
  rulebook: none
11
11
  metadata_template:
12
- id: ifx-cmd-_TERM_
12
+ id: _PROJECT_ID_:_LOCAL_ID_
13
13
  type: api
14
14
  status: draft
15
- title: _COMMAND_SPEC_TITLE_
15
+ title: _DELIVERABLE_NAME_
16
16
  rulebook: specdojo:ifx-cmd-rulebook
17
17
  version: 1
18
- based_on: []
18
+ based_on: _BASED_ON_
19
19
 
20
20
  command:
21
+ # 固定名または正本からの解決規則。可変の実行ファイル一覧は転載しない。
21
22
  executable: _EXECUTABLE_
23
+ # サブコマンドがなければ省略する。
22
24
  subcommands:
23
25
  - _SUBCOMMAND_
24
26
  purpose: "_TODO_: 呼び出し側から見た実行目的と成功後の状態を記載する。"
27
+ reference: "_TODO_: 起動方法の正本の文書・設定キーと対象操作を特定する。"
25
28
  version_constraint: _VERSION_CONSTRAINT_
26
- shell: false
27
-
28
- arguments:
29
- - name: _ARGUMENT_NAME_
30
- kind: _ARGUMENT_KIND_
31
- required: _ARGUMENT_REQUIRED_
32
- value_type: _ARGUMENT_VALUE_TYPE_
33
- value_source: _ARGUMENT_VALUE_SOURCE_
34
- description: "_TODO_: 引数の意味と制約を記載する。"
35
- example: _PUBLIC_EXAMPLE_VALUE_
29
+ # 原則 false。true の場合は必要な理由と設定の管理・展開値の検証先を reference に記す。
30
+ shell: _SHELL_
36
31
 
37
32
  streams:
38
33
  stdin:
39
34
  mode: _STDIN_MODE_
40
35
  format: _STDIN_FORMAT_
41
36
  encoding: UTF-8
42
- description: "_TODO_: stdin を使う場合は入力の意味を記載する。使わない場合は mode と format を none にする。"
37
+ description: "_TODO_: 渡す内容と入力終了の約束。使わない場合も要否と形式を明示する。"
43
38
  stdout:
44
39
  format: _STDOUT_FORMAT_
45
40
  encoding: UTF-8
46
- description: "_TODO_: 呼び出し元が利用する成功出力の安定契約を記載する。"
41
+ description: "_TODO_: 採用する出力の範囲、内容の正本、終了コードとは別に確認する完了条件。"
47
42
  stderr:
48
43
  format: _STDERR_FORMAT_
49
44
  encoding: UTF-8
50
- description: "_TODO_: 進捗、警告、失敗詳細の用途と、秘密値を出力しない条件を記載する。"
45
+ description: "_TODO_: 診断用途と成否判定に使う信号の区別。秘密値を出力しない条件。"
46
+
47
+ # 入出力がなければ files を省略する。片側だけなければ該当配列を [] にするか省略する。
48
+ files:
49
+ inputs:
50
+ - path: _INPUT_FILE_PATH_
51
+ format: _INPUT_FILE_FORMAT_
52
+ encoding: UTF-8
53
+ description: "_TODO_: パスの基準・解決規則、用途、作成主体、内容の正本。"
54
+ outputs:
55
+ - path: _OUTPUT_FILE_PATH_
56
+ format: _OUTPUT_FILE_FORMAT_
57
+ encoding: UTF-8
58
+ description: "_TODO_: パスの基準・解決規則、用途、作成・更新主体、内容の正本。呼び出し元が保存する記録と区別する。"
59
+
60
+ side_effects:
61
+ - "_TODO_: 外部状態・ローカル環境への変更、利用枠・課金への影響、変更禁止の境界。副作用がなければその旨を記す。"
51
62
 
63
+ # 代表的な失敗ごとに複製する。同じコードの分類には追加信号・判定順・未分類時の扱いを meaning に記す。
52
64
  exit_codes:
53
- - code: 0
54
- meaning: _SUCCESS_MEANING_
65
+ - code: _SUCCESS_EXIT_CODE_
66
+ meaning: "_TODO_: プロセスの成功が保証する範囲。業務完了の確認条件は stdout と対応させる。"
55
67
  category: success
56
68
  retryable: false
57
69
  - code: _FAILURE_EXIT_CODE_
@@ -60,14 +72,16 @@ exit_codes:
60
72
  retryable: _FAILURE_RETRYABLE_
61
73
 
62
74
  authentication:
75
+ # 認証不要の場合も明示し、injection の参照名を含め schema に従って埋める。秘密値は書かない。
63
76
  method: _AUTHENTICATION_METHOD_
64
77
  injection:
65
78
  mechanism: _AUTHENTICATION_INJECTION_MECHANISM_
66
79
  names:
67
80
  - _AUTHENTICATION_REFERENCE_NAME_
68
- secret_source: "_TODO_: シークレットストアや CLI プロファイルなど値の管理境界を記載する。"
69
- log_policy: "_TODO_: 引数、環境変数、stdout、stderr、エラー記録のマスク条件を記載する。"
81
+ secret_source: "_TODO_: 認証状態・値の供給元と管理主体の境界。"
82
+ log_policy: "_TODO_: 引数・環境変数・stdout・stderr・保存ログのマスク対象と実施時点。"
70
83
 
84
+ # 制約は根拠に従って埋める。未決定なら現在動作・必要な判断・確認先をコメント等に残す。
71
85
  execution:
72
86
  working_directory: _WORKING_DIRECTORY_
73
87
  timeout_seconds: _TIMEOUT_SECONDS_
@@ -75,14 +89,16 @@ execution:
75
89
  max_parallel: _MAX_PARALLEL_
76
90
  idempotency:
77
91
  guaranteed: _IDEMPOTENCY_GUARANTEED_
78
- condition: "_TODO_: 重複実行を防ぐ条件、または冪等性を保証できない理由を記載する。"
92
+ condition: "_TODO_: 重複処理を防ぐ条件、または保証できない理由と既存変更を確認して再開する条件。"
79
93
 
80
94
  error_handling:
81
95
  retry:
96
+ # exit_codes の retryable と揃える。対象がなければ [] とし、回数・待機方式は再試行しない契約に合わせる。
82
97
  on_categories:
83
98
  - _RETRYABLE_CATEGORY_
99
+ # 初回を含むか、条件付き再試行の根拠と併せて記す。
84
100
  max_attempts: _MAX_ATTEMPTS_
85
101
  backoff: _BACKOFF_STRATEGY_
86
- timeout_action: "_TODO_: 子プロセスと不完全出力の扱いを記載する。"
87
- malformed_output_action: "_TODO_: stdout を契約どおり解析できない場合の処置を記載する。"
88
- authentication_failure_action: "_TODO_: 再認証の依頼先と自動再試行しない条件を記載する。"
102
+ timeout_action: "_TODO_: 子プロセス・不完全出力・既存変更の扱いと、再開条件または確認先。"
103
+ malformed_output_action: "_TODO_: 出力の欠落・解析失敗時の停止・再試行の判断、既存変更の扱いと確認先。"
104
+ authentication_failure_action: "_TODO_: 検出できる範囲、自動再試行しない条件と再認証の依頼先。認証不要なら想定外の要求の扱い。"
@@ -0,0 +1,40 @@
1
+ # yaml-language-server: $schema=../../../specdojo/schemas/v1/ifx-index.schema.yaml
2
+ # specdojo-schema: validate=false reason=template
3
+ id: specdojo:ifx-index-template
4
+ type: template
5
+ status: ready
6
+ title: 外部システムI/F一覧テンプレート
7
+ rulebook: none
8
+ metadata_template:
9
+ id: _PROJECT_ID_:_LOCAL_ID_
10
+ type: api
11
+ title: _DELIVERABLE_NAME_
12
+ status: draft
13
+ rulebook: specdojo:ifx-index-rulebook
14
+ based_on: _BASED_ON_
15
+ supersedes: []
16
+
17
+ # _TODO_: 対象システム・利用場面・連携境界・主要な対象外を記す。
18
+ # _TODO_: 一覧の管理担当 Role code、人間の PO による承認・公開判断の対象と公開先を記す。
19
+ # 仮定・意思決定待ちは rulebook の共通ラベルで区別する。
20
+ # 連携ごとに要素を複製する。値域・構文は先頭 modeline の schema を参照する。
21
+ interfaces:
22
+ # _TODO_: 連携目的・渡す内容・成功後の結果を、名前だけで伝わらない場合に補う。
23
+ - name: _INTERFACE_NAME_
24
+ source: _SOURCE_SYSTEM_
25
+ target: _TARGET_SYSTEM_
26
+ direction: _DIRECTION_
27
+ kind: _INTERFACE_KIND_
28
+ format: _DATA_FORMAT_
29
+ timing: _TRIGGER_AND_CONDITION_
30
+ error_handling: "_TODO_: 失敗で未完了・結果不明になる結果、停止・保留条件、確認対象と担当を記す。"
31
+ spec_ref: TBD
32
+ # _TODO_: 実在する対応仕様の ID へ置換する。未整備・対応未確認なら TBD を維持し、
33
+ # 論点・担当 Role code・解消条件・期限または判断するマイルストーン、
34
+ # 影響する業務・後続作業・公開範囲と保留範囲、次アクションを記す。
35
+ # _TODO_: BA(利用場面・業務影響)、ARC・DEV(契約)、QE(期待結果)の
36
+ # 確認者・合意対象を記す。必要な外部窓口は、未特定なら担当と特定時点を記す。
37
+ # _TODO_: 残作業は Schedule の作業 ID と引き継ぎ時点の未完了事項を記す。
38
+ # リスク・課題・変更・決定があれば、連携への影響・対応担当・報告先と
39
+ # PJR 等の管理レコードへの参照を記す。未登録なら PM への登録依頼と登録時点を記す。
40
+ # 採否・公開条件が未決なら、PO へ渡す判断対象と保留範囲を記す。
@@ -5,7 +5,7 @@ specdojo:
5
5
  status: draft
6
6
  frontmatter_template:
7
7
  specdojo:
8
- id: _PROJECT_ID_:_LOCAL_ID_
8
+ id: _LOCAL_ID_
9
9
  type: operations
10
10
  status: draft
11
11
  rulebook: specdojo:opr-rulebook
@@ -15,11 +15,9 @@ specdojo:
15
15
 
16
16
  # _DELIVERABLE_NAME_
17
17
 
18
- _DELIVERABLE_OVERVIEW_
19
-
20
18
  ## 1. 概要
21
19
 
22
- _TODO_: 対象となる運用作業と、この手順によって再現可能にする結果を記述する。`opr-<term>` の場合は `opr-index` のどの共通規約を参照し、何を具体化する文書かを明示する。
20
+ _TODO_: `_DELIVERABLE_OVERVIEW_` を基に、対象となる運用作業と、この手順によって再現可能にする結果を記述する。`opr-<term>` の場合は `opr-index` のどの共通規約を参照し、何を具体化する文書かを明示する。
23
21
 
24
22
  ## 2. 手順適用範囲・前提
25
23
 
@@ -27,9 +27,15 @@ _TODO_: プロジェクト規模、兼務方針、当事者・利用者の確認
27
27
 
28
28
  ## 2. ロール・owner方針
29
29
 
30
- - _TODO_: Schedule ownerとRACI列には採用済みRole codeだけを使う。
31
- - _TODO_: Role codeの採用と専任member配置を区別する。
32
- - _TODO_: 実行主体、兼務、Agent利用はメンバー定義へ委譲する。
30
+ | Role code | 採用/未採用 | 判断理由・プロジェクトでの扱い | 未採用時の代替方針 |
31
+ | ------------- | ------------ | ------------------------------ | ------------------ |
32
+ | `_ROLE_CODE_` | _TODO_ | _TODO_ | _TODO_ |
33
+
34
+ _TODO_: 標準ロールごと、および独自ロールがあればその採用判断を記入する。未採用がなければ「なし」と記す。
35
+
36
+ 使用可能な `owner`: _TODO_: 採用集合のうち Schedule に使える Role code を列挙する。
37
+
38
+ _TODO_: RACI の採用列・省略列の扱いと、実行主体・兼務・Agent 支援を管理するメンバー定義を示す。
33
39
 
34
40
  ## 3. 正本と責任境界
35
41
 
@@ -27,9 +27,9 @@ _TODO_: 検証する価値、対象期間、軽量・拡張プロファイル、
27
27
 
28
28
  _TODO_: 実際に管理する対象だけを記載する。費用を扱う場合は、現金支出、作業時間、継続運用負荷を分ける。
29
29
 
30
- | 管理対象 | 基準・上限 | 確認契機 | 逸脱時対応 | 責任 |
31
- | -------- | ---------- | -------- | ---------- | ------ |
32
- | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
30
+ | 管理対象 | 根拠(文書・条件 ID) | 基準・上限 | 確認契機 | 逸脱時対応 | 責任 | 証跡・正本 |
31
+ | -------- | --------------------- | ---------- | -------- | ---------- | ------ | ---------- |
32
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
33
33
 
34
34
  ## 3. 判断ゲートとエスカレーション
35
35
 
@@ -43,7 +43,7 @@ _TODO_: 実際に管理する対象だけを記載する。費用を扱う場合
43
43
  | ------ | ------ | -------------- | ---------- |
44
44
  | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
45
45
 
46
- _TODO_: 目的、スコープ、成功基準、体制、外部条件が変わった場合の見直し方針を記述する。
46
+ _TODO_: 目的、スコープ、成功基準、体制、外部条件の変更時に、影響先・更新順序・担当 Role・期限・確認担当を追従タスクへ渡す方針を記述する。
47
47
 
48
48
  ## 5. 未決事項
49
49
 
@@ -19,7 +19,7 @@ specdojo:
19
19
 
20
20
  ## 1. 品質方針と適用範囲
21
21
 
22
- _TODO_: 利用者価値として確認する品質、価値提供を支える成果物品質、人間とAI Agentの判断境界を記述する。
22
+ _TODO_: 利用者価値として確認する品質、価値提供を支える成果物品質、適用開始・終了のイベントまたは日付、人間と AI Agent の判断境界を記述する。
23
23
 
24
24
  ## 2. 品質ゲート
25
25
 
@@ -29,18 +29,26 @@ _TODO_: 利用者価値として確認する品質、価値提供を支える成
29
29
 
30
30
  ## 3. レビューと証跡
31
31
 
32
- | 対象 | 主な観点 | 実施責任 | 出口条件・証跡 |
33
- | ------ | -------- | -------- | -------------- |
34
- | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
32
+ | 対象 | 主な観点 | 実施責任 | 出口条件 | 証跡 | 記録先 |
33
+ | ------ | -------- | -------- | -------- | ------ | ------ |
34
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
35
35
 
36
36
  ## 4. 不適合と是正
37
37
 
38
- | 区分 | 対応 | 再判定 | 記録先 |
39
- | ------ | ------ | ------ | ------ |
40
- | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
38
+ _TODO_: 重大な不適合の判定境界と、解消まで保留するゲート、報告・登録の責任を記述する。
39
+
40
+ | 区分 | 対応 | 再判定条件 | 再判定責任 | 記録先 |
41
+ | ------ | ------ | ---------- | ---------- | ------ |
42
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
41
43
 
42
44
  ## 5. 見直し条件と未決事項
43
45
 
44
- _TODO_: 成功基準、公開範囲、成果物構造、検証方法、重大不適合の傾向が変わった場合の見直しを記述する。
46
+ ### 5.1. 見直しと後続作業
47
+
48
+ _TODO_: 成功基準、公開範囲、成果物構造、検証方法、体制、重大不適合の傾向が変わった場合の起案・改訂・確認責任と、追従する正本・後続作業を記述する。
49
+
50
+ ### 5.2. 未決事項と保留
45
51
 
46
- - _UNDECIDED_: 未決事項があれば、決定時期と判断者を添える。
52
+ | 論点 | 正本と判断材料の担当 | 決定時期・判断者 | 未決中に保留する判定・作業 |
53
+ | ------ | -------------------- | ---------------- | -------------------------- |
54
+ | _TODO_ | _UNDECIDED_: _TODO_ | _TODO_ | _TODO_ |
@@ -21,28 +21,39 @@ specdojo:
21
21
 
22
22
  _TODO_: 対象とする主要成果物・判断、省略範囲、使用するRole code、兼務とAgent支援の扱いを記述する。
23
23
 
24
- - `R`: 主たる実作業
25
- - `A`: 最終責任・承認・判断
26
- - `C`: 作業前または判断前の相談・確認
27
- - `I`: 結果または変更の共有
24
+ 記号の意味は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従う。
28
25
 
29
26
  ## 2. 成果物別 RACI
30
27
 
31
- | 成果物 | PO | PM | BA | ARC | QE |
32
- | ------ | ------ | ------ | ------ | ------ | ------ |
33
- | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
28
+ _TODO_: `_ROLE_CODE_` を採用 Role に置換して列を必要数に増減する。複数 `R` の行には対象作業ごとの主担当と担当範囲を注記する。
29
+
30
+ | 成果物 | `_ROLE_CODE_` |
31
+ | ------ | ------------- |
32
+ | _TODO_ | _TODO_ |
34
33
 
35
34
  ## 3. 判断・プロセス別 RACI
36
35
 
37
- | 判断・プロセス | PO | PM | BA | ARC | QE |
38
- | -------------- | ------ | ------ | ------ | ------ | ------ |
39
- | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
36
+ | 判断・プロセス | `_ROLE_CODE_` |
37
+ | -------------- | ------------- |
38
+ | _TODO_ | _TODO_ |
40
39
 
41
40
  ## 4. Schedule・実行主体との対応
42
41
 
43
- - _TODO_: Schedule ownerを主たる`R`と一致させる方針を記述する。
44
- - _TODO_: member、兼務、Agent支援の割り当て先となる正本を記述する。
45
- - _TODO_: 不一致時に更新する正本を記述する。
42
+ ### 4.1. 主担当と照合先
43
+
44
+ _TODO_: WBS・Schedule の正本と主担当を示す。`owner` の優先順と承認・レビュー・外部待ちの扱いは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「Schedule への担当展開」に従う。
45
+
46
+ | 対象作業 | 主担当・`owner` | 対応する行と照合内容 |
47
+ | -------- | --------------- | -------------------- |
48
+ | _TODO_ | _TODO_ | _TODO_ |
49
+
50
+ _TODO_: Member、兼務、Agent 支援の割り当て先となる正本を記述する。
51
+
52
+ ### 4.2. 不一致時の更新先
53
+
54
+ | 不一致の原因・具体例 | 更新する正本と確認 |
55
+ | -------------------- | ------------------ |
56
+ | _TODO_ | _TODO_ |
46
57
 
47
58
  ## 5. 見直し条件
48
59
 
@@ -8,13 +8,13 @@
8
8
  id: specdojo:pm-roles-template
9
9
  type: template
10
10
  status: ready
11
- title: ロール一覧テンプレート
11
+ title: ロール定義テンプレート
12
12
  rulebook: none
13
13
  metadata_template:
14
14
  id: _PROJECT_ID_:pm-roles
15
15
  type: project
16
16
  status: draft
17
- title: ロール一覧
17
+ title: ロール定義
18
18
  rulebook: specdojo:pm-roles-rulebook
19
19
  based_on:
20
20
  - _PROJECT_ID_:pm-organization
@@ -22,6 +22,7 @@ metadata_template:
22
22
  project_id: _PROJECT_ID_
23
23
 
24
24
  # Role code の採用方針・根拠は pm-organization.md を参照する。
25
+ # 以下は標準ロールの候補。組織定義の未採用ロールを削除し、採用集合と一致させる。
25
26
  # 実行主体、member nickname、兼務の割り当ては pm-members.yaml で管理する。
26
27
  # `project_note` は PO が承認判断できる公開可能な一行メモとして記述する。
27
28
  # メタ項目は pm-roles.schema.yaml で許可されたものだけを使用する。
@@ -20,7 +20,9 @@ _TODO_: 対象スコープの実行に影響する成立条件、守るべき境
20
20
 
21
21
  ## 1. 前提条件
22
22
 
23
- _TODO_: 計画が成立するために真または利用可能であると置く条件を記載する。スコープで確定済みの境界は再掲せず、章冒頭で参照先を明示して委譲する。各行に根拠、影響、確認方法、変化時の対応を含める。追加する前提がない場合は、表の代わりにその旨と追加時の記載条件を書く。リポジトリや作業環境など継続的な基盤の可用性は前提ではなく依存関係(3.)に書く。
23
+ _TODO_: 成立すると置く仮説と、上位文書へ委譲する境界の参照を記入する。登録対象がなければ理由と追加条件を書く。継続提供される端末・作業基盤は「依存関係」へ記入する。
24
+
25
+ _TODO_: 新規 ID は前提 `ACD-A01`、制約 `ACD-C01`、依存 `ACD-D01` から種別ごとの既採番の最大値に続ける。既存 ID は保持し、分類変更は新旧 ID を変更記録で結ぶ。
24
26
 
25
27
  | ID | 内容 | 根拠 | 影響 | 監視・確認方法 | 変化のトリガー | 所有者 | 対応方針 |
26
28
  | --------------- | ------ | ------ | ------ | -------------- | -------------- | ------ | -------- |
@@ -36,7 +38,7 @@ _TODO_: 守るべき限界と適用範囲を記載する。スコープの対象
36
38
 
37
39
  ## 3. 依存関係
38
40
 
39
- _TODO_: 外部サービス、先行成果物、承認、提供物など、他者または他の条件から受ける必要があるものを記載する。意思決定待ちの依存はプロジェクト登録簿へ登録し、本書からは登録項目 ID を参照する。先行成果物を wikilink で参照する場合は、表セル内のリンク区切りを `[[id\|表示名]]` のように `\|` でエスケープする(エスケープ漏れは表崩れの原因になる)。
41
+ _TODO_: 外部サービス、継続提供される基盤、先行成果物、承認・判断を記入する。「受領・成立条件」には成立状態、確認者、期限・判断イベント、確認する証跡を含める。成果物の受入は対象 ID・条件 ID・品質ゲートへ接続し、意思決定待ちは登録項目 ID を参照する。
40
42
 
41
43
  | ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
42
44
  | --------------- | ------------ | -------------- | -------------- | -------------- | ------ | -------- |
@@ -55,5 +57,6 @@ _TODO_: 前提の崩壊、制約の逸脱、依存先の変化ごとに、最初
55
57
  ## 5. 監視・変更管理
56
58
 
57
59
  - _TODO_: 本書を見直す契機を記載する。
58
- - _TODO_: 変更記録に残す項目(ID、変化内容、影響範囲、判断者、対応状況)と記録先(プロジェクト登録簿を第一候補とする)を記載する。
60
+ - _TODO_: 変更記録の項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期と、課題・リスク・変更要求・決定ごとの記録先・報告先を記載する。
61
+ - _TODO_: PM の計画・Schedule・登録簿の追従管理、ARC の参照・技術制約確認、QE の受入・検証確認と、人間の最終判断の分担を記載する。
59
62
  - _UNDECIDED_: 最終判断者または記録先が未確定の場合は、決定する文書またはタイミングを記載する。