specdojo 0.7.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 (337) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +153 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/plan.js +1 -1
  5. package/dist/catalog/scaffold.js +4 -1
  6. package/dist/commands/init.js +5 -1
  7. package/dist/commands/night-orchestrator.js +6 -4
  8. package/dist/dashboard/dashboard-timeline.js +18 -16
  9. package/dist/dashboard/dashboard.js +612 -259
  10. package/dist/dashboard/epic-plan.js +81 -0
  11. package/dist/dashboard/exec-records.js +16 -20
  12. package/dist/dashboard/routines.js +8 -6
  13. package/dist/dashboard/timeline-build.js +5 -9
  14. package/dist/dashboard/timeline.js +9 -4
  15. package/dist/devcontainer/scaffold.js +18 -0
  16. package/dist/docs/frontmatter-namespace.js +1 -48
  17. package/dist/docs/yaml-pages.js +125 -3
  18. package/dist/exec/agent-config.js +22 -0
  19. package/dist/exec/agent-plan.js +3 -2
  20. package/dist/exec/commands.js +69 -21
  21. package/dist/exec/commit-hook-skips.js +78 -0
  22. package/dist/exec/core.js +19 -7
  23. package/dist/exec/events.js +159 -8
  24. package/dist/exec/evidence.js +64 -16
  25. package/dist/exec/handoff.js +9 -13
  26. package/dist/exec/limit.js +1 -1
  27. package/dist/exec/mechanical-result.js +45 -0
  28. package/dist/exec/migrate-records.js +249 -0
  29. package/dist/exec/parent-validation.js +153 -12
  30. package/dist/exec/pipeline-state.js +27 -5
  31. package/dist/exec/plans-condense-findings.js +89 -0
  32. package/dist/exec/plans-core.js +24 -17
  33. package/dist/exec/plans-generation.js +48 -25
  34. package/dist/exec/plans-grade-findings.js +8 -3
  35. package/dist/exec/plans-kata-findings.js +61 -0
  36. package/dist/exec/plans-planning.js +3 -3
  37. package/dist/exec/plans-storage.js +12 -24
  38. package/dist/exec/register-resume.js +55 -56
  39. package/dist/exec/register.js +26 -22
  40. package/dist/exec/repo-integration-sync.js +8 -4
  41. package/dist/exec/repo-integration.js +21 -1
  42. package/dist/exec/reporter.js +121 -23
  43. package/dist/exec/results.js +85 -24
  44. package/dist/exec/review-completion.js +47 -0
  45. package/dist/exec/review-kata.js +109 -0
  46. package/dist/exec/run/agent-pipeline.js +75 -6
  47. package/dist/exec/run/agent.js +20 -7
  48. package/dist/exec/run/in-place.js +69 -32
  49. package/dist/exec/run/job.js +81 -24
  50. package/dist/exec/run/lifecycle-commands.js +188 -36
  51. package/dist/exec/run/mode-shared.js +11 -3
  52. package/dist/exec/run/register-command.js +6 -10
  53. package/dist/exec/run/register-core.js +20 -13
  54. package/dist/exec/run/register-mode.js +12 -12
  55. package/dist/exec/run/register-post-review.js +21 -9
  56. package/dist/exec/run/register-resume.js +28 -18
  57. package/dist/exec/run/register-state.js +10 -7
  58. package/dist/exec/run/register-worktree.js +60 -30
  59. package/dist/exec/run/schedule-mode.js +4 -4
  60. package/dist/exec/run/schedule-prepare.js +201 -59
  61. package/dist/exec/run/schedule-task.js +129 -25
  62. package/dist/exec/run/shared.js +4 -3
  63. package/dist/exec/run/trailing-records.js +35 -0
  64. package/dist/exec/run-records.js +2 -0
  65. package/dist/exec/strategy.js +1 -0
  66. package/dist/exec/trailing-records.js +242 -0
  67. package/dist/exec/trial-commands.js +3 -2
  68. package/dist/exec/validate-records-commit.js +110 -0
  69. package/dist/exec/validate-records.js +148 -0
  70. package/dist/exec/worktree-command.js +29 -16
  71. package/dist/exec/worktree-ops-commit.js +119 -48
  72. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  73. package/dist/exec/worktree-ops-merge.js +13 -2
  74. package/dist/exec/worktree-ops.js +2 -2
  75. package/dist/exec/worktree.js +19 -2
  76. package/dist/grade/apply.js +32 -6
  77. package/dist/grade/command-inspect.js +2 -2
  78. package/dist/grade/command-run.js +2 -0
  79. package/dist/grade/command-shared.js +1 -1
  80. package/dist/grade/core.js +18 -5
  81. package/dist/grade/markdown.js +3 -3
  82. package/dist/grade/pipeline-state.js +15 -11
  83. package/dist/grade/plan.js +37 -17
  84. package/dist/grade/result.js +3 -3
  85. package/dist/grade/run.js +23 -3
  86. package/dist/grade/target-discovery.js +17 -4
  87. package/dist/grade/targets.js +12 -11
  88. package/dist/job/job.js +31 -17
  89. package/dist/job/noop.js +104 -0
  90. package/dist/register/core.js +2 -0
  91. package/dist/register/create-commands.js +28 -3
  92. package/dist/register/deliverable-target.js +9 -1
  93. package/dist/register/epic.js +104 -26
  94. package/dist/register/event-merge.js +3 -0
  95. package/dist/register/events.js +4 -0
  96. package/dist/register/external-project.js +3 -0
  97. package/dist/register/item.js +6 -0
  98. package/dist/register/maintenance-commands.js +4 -1
  99. package/dist/register/planning.js +7 -14
  100. package/dist/register/register.js +43 -9
  101. package/dist/register/track-domains.js +34 -0
  102. package/dist/register/track-plan.js +78 -0
  103. package/dist/register/transition-commands.js +8 -0
  104. package/dist/register/work-table.js +64 -0
  105. package/dist/review/grade.js +35 -13
  106. package/dist/routine/definition.js +4 -3
  107. package/dist/routine/failure.js +30 -0
  108. package/dist/routine/routine.js +56 -32
  109. package/dist/routine/storage.js +33 -0
  110. package/dist/schedule/schedule.js +1 -0
  111. package/dist/schedule/strategy-generate-document.js +26 -14
  112. package/dist/schedule/strategy-generate-scope.js +17 -45
  113. package/dist/schedule/strategy-generate.js +33 -3
  114. package/dist/schedule/strategy-profiles.js +86 -12
  115. package/dist/shared/agent-types.js +2 -0
  116. package/dist/shared/condense-records.js +25 -0
  117. package/dist/shared/deprecation.js +8 -0
  118. package/dist/shared/document-metadata.js +20 -0
  119. package/dist/shared/finding-cause.js +20 -0
  120. package/dist/shared/frontmatter-namespace.js +48 -0
  121. package/dist/shared/git.js +142 -15
  122. package/dist/shared/grade-result.js +17 -1
  123. package/dist/shared/local-state.js +20 -0
  124. package/dist/shared/markdownlint-config.js +8 -3
  125. package/dist/shared/plan-conventions.js +129 -0
  126. package/dist/shared/plan-templates.js +57 -41
  127. package/dist/shared/run-records.js +224 -0
  128. package/dist/shared/specdojo-config.js +39 -21
  129. package/dist/shared/text.js +65 -5
  130. package/dist/shared/timeline-index.js +2 -0
  131. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
  132. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  133. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  134. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  135. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  136. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  137. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  138. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  139. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  140. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  141. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  142. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  143. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  144. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  145. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  146. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  147. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  148. package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
  149. package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
  150. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  151. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  152. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  153. package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
  154. package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
  155. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  156. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  157. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  158. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  159. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  160. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  161. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  162. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  163. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  164. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  165. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  166. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  167. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
  168. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  169. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  170. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  171. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  172. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  173. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  174. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  175. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  176. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  177. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  178. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  179. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  180. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  181. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  182. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  183. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  184. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  185. package/docs/ja/specdojo/references/command-reference.md +79 -64
  186. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  187. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  188. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  189. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  190. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  191. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  192. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  193. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  194. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  195. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  196. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
  197. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  198. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  199. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  200. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  201. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  202. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  207. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  208. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  209. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  210. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  211. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  212. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  213. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  214. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  215. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  216. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  217. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  218. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  219. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  220. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  221. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  222. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  223. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  224. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  225. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  226. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  227. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  228. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  229. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  230. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  234. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  235. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  236. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  237. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  238. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  239. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  240. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  241. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  242. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  243. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  244. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  245. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  246. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  247. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  248. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  249. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  250. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  251. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  252. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  253. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  254. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  255. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  256. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  257. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  258. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  259. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  260. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  261. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  262. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  263. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  264. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  265. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  266. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  267. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  268. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  269. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  270. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  271. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  272. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  273. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  274. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  275. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  276. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  277. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  278. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  279. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  280. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  281. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  282. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  283. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  284. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  285. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  286. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  287. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  288. package/docs/ja/specdojo/templates/br-template.md +64 -0
  289. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  290. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  291. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  292. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  293. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  294. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  295. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  296. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  297. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  298. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  299. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  300. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  301. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  302. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  303. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  304. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  305. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  306. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  307. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  308. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  309. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  310. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  311. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  312. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  313. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  314. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  315. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  316. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  317. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  318. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  319. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  320. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
  321. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  322. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  323. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  324. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  325. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  326. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  327. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  328. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  329. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  330. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  331. package/package.json +2 -2
  332. package/templates/antigravity/orchestrator.md +3 -2
  333. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  334. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  335. package/templates/codex/orchestrator.md +3 -2
  336. package/templates/devcontainer/tmux.conf +6 -0
  337. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -62,7 +62,7 @@ _TODO_: 購入 / 構築の判断後に具体製品の比較が必要になるな
62
62
 
63
63
  ## 3. 評価軸と評価基準
64
64
 
65
- _TODO_: 同一レイヤーの全候補に同じ軸と判定方向を使用する。比較目的に応じて不要な軸を削除し、業務適合、データ移行、継続運用などを追加する。
65
+ _TODO_: 同一レイヤーの全候補に同じ軸・判定境界・方向を記入する。軸を省略する場合は観点名と理由を、統合する場合は対応先と判定条件を記す。
66
66
 
67
67
  | 評価軸 | 重み | 判定基準 | 根拠となる課題・制約 |
68
68
  | ------------------ | ------ | -------- | -------------------- |
@@ -70,43 +70,45 @@ _TODO_: 同一レイヤーの全候補に同じ軸と判定方向を使用する
70
70
  | コスト | _TODO_ | _TODO_ | _TODO_ |
71
71
  | 期間 | _TODO_ | _TODO_ | _TODO_ |
72
72
  | リスク | _TODO_ | _TODO_ | _TODO_ |
73
- | 利用者・業務適合 | _TODO_ | _TODO_ | _TODO_ |
73
+ | 業務適合 | _TODO_ | _TODO_ | _TODO_ |
74
74
  | 技術実現性 | _TODO_ | _TODO_ | _TODO_ |
75
75
  | データ移行・可逆性 | _TODO_ | _TODO_ | _TODO_ |
76
76
  | 運用・保守性 | _TODO_ | _TODO_ | _TODO_ |
77
77
 
78
- _TODO_: 評価表記(例: `High` / `Middle` / `Low`)、採択に有利な方向、重みの使い方を記述する。
78
+ _TODO_: 評価表記(例: `High` / `Middle` / `Low`)、未確認時の未判定、採択に有利な方向、重みと集約方法を記述する。
79
79
 
80
80
  ## 4. 比較結果と採択理由
81
81
 
82
82
  ### 4.1. D-01: _COMPARISON_LAYER_
83
83
 
84
- | 案ID | 効果 | コスト | 期間 | リスク | 業務適合 | 技術実現性 | 移行・可逆性 | 運用・保守性 | 総合評価 | 判定 |
85
- | ------ | ------ | ------ | ------ | ------ | -------- | ---------- | ------------ | ------------ | -------- | ------ |
86
- | ALT-01 | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
87
- | ALT-02 | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
84
+ | 案ID | 効果 | コスト | 期間 | リスク | 業務適合 | 技術実現性 | データ移行・可逆性 | 運用・保守性 | 総合評価 | 判定 |
85
+ | ------ | ------ | ------ | ------ | ------ | -------- | ---------- | ------------------ | ------------ | -------- | ------ |
86
+ | ALT-01 | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
87
+ | ALT-02 | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
88
88
 
89
89
  _TODO_: 採択案、一部採択する要素、非採択理由、再評価条件を重複なく記述する。
90
90
 
91
- 比較試行を行う場合:
91
+ ### 4.2. 技術的実現性と影響
92
+
93
+ | 案IDまたは決定ID | 技術的実現性・外部依存 | 正本・移行・停止時の扱いと後続作業 |
94
+ | ---------------- | ---------------------- | ---------------------------------- |
95
+ | ALT-01 | _TODO_ | _TODO_ |
96
+ | ALT-02 | _TODO_ | _TODO_ |
97
+
98
+ ### 4.3. 比較試行の完了条件
99
+
100
+ _TODO_: 比較試行を行う場合に記入する。行わない場合はその旨を示す。
92
101
 
93
102
  - 入力と対象範囲: _TODO_
94
103
  - 測定項目と完了条件: _TODO_
95
104
  - 採用・撤退判定と記録先: _TODO_
96
105
 
97
- ### 4.2. 技術的実現性と影響
98
-
99
- | 案IDまたは決定ID | 技術的実現性 | 主な影響 |
100
- | ---------------- | ------------ | -------- |
101
- | ALT-01 | _TODO_ | _TODO_ |
102
- | ALT-02 | _TODO_ | _TODO_ |
103
-
104
106
  ## 5. リスクとトレードオフ
105
107
 
106
- | 区分 | 内容 | 軽減策 |
107
- | ------------ | ------ | ------ |
108
- | トレードオフ | _TODO_ | _TODO_ |
109
- | リスク | _TODO_ | _TODO_ |
108
+ | 区分・対象(決定・案 ID) | 内容 | 軽減策・担当・依存作業・完了条件 |
109
+ | ------------------------- | ------ | -------------------------------- |
110
+ | トレードオフ・_TODO_ | _TODO_ | _TODO_ |
111
+ | リスク・_TODO_ | _TODO_ | _TODO_ |
110
112
 
111
113
  ## 6. 決定と見直し
112
114
 
@@ -114,3 +116,4 @@ _TODO_: 採択案、一部採択する要素、非採択理由、再評価条件
114
116
  - _TODO_: 最終判断者を人間の責任ロールとして記述し、AI Agent は比較分析の支援に留める。
115
117
  - _TODO_: 再評価トリガーを候補カテゴリ単位で記述し、特定製品の自動採用条件にしない。
116
118
  - _TODO_: 方針変更、評価結果、影響範囲、データ移行・撤退方法の記録先を記述する。
119
+ - _TODO_: リスク・課題・変更要求・未決を各管理記録へ分け、担当 Role と転送先、後続成果物・Schedule の追従責任を記述する。
@@ -15,40 +15,65 @@ specdojo:
15
15
 
16
16
  # _DELIVERABLE_NAME_
17
17
 
18
- ## 1. 概要
18
+ _TODO_: `_DELIVERABLE_OVERVIEW_` を基に、何の状態と遷移を定義する文書かを 1〜2 行で示す。
19
19
 
20
- _TODO_: `_DELIVERABLE_OVERVIEW_` を基に、状態を持つ一つの対象、AS-IS / TO-BE のスコープ、状態管理の目的、利用者、状態の正本となる管理場所、状態変更を起こす業務範囲を 1〜3 文と箇条書きで記述する。
20
+ ## 1. 目的
21
21
 
22
- ## 2. 状態一覧
22
+ _TODO_: 状態が対象の何を管理し、誰がその状態で何を判断するために使うかを 1〜3 文で記述する。
23
23
 
24
- | 値 | 状態名 | 通称 | 意味 | 成立条件 | 管理場所 |
25
- | -------------- | ------------ | ------------- | --------------- | ----------------- | --------------------- |
26
- | `_STATE_CODE_` | _STATE_NAME_ | _COMMON_NAME_ | _STATE_MEANING_ | _ENTRY_CONDITION_ | _MANAGEMENT_LOCATION_ |
24
+ ## 2. 適用範囲
27
25
 
28
- <!-- 値は lower-kebab-case とし、`-` を除いて文書内で一意にする。コードを持たない場合、通称がない場合は `-` とする。状態名は状態遷移図・遷移の説明と完全一致させる。 -->
26
+ - 対象: _TODO_: 状態を持つ一つの業務対象を示す。
27
+ - 業務範囲: _TODO_: 状態変更を起こす業務の開始と対象外の境界を示す。
28
+ - 到達点: _TODO_: 業務上の到達点を示す。終了点を置かない場合は、管理を続ける状態と理由、出力遷移のない継続状態も示す。
29
29
 
30
- ## 3. 状態遷移図
30
+ <!-- スコープは現行を既定として省略する。同じ対象の TO-BE 文書と並ぶ場合だけ「スコープ: AS-IS / TO-BE」の項目を追加し、文書を分ける。 -->
31
31
 
32
- ```mermaid
33
- stateDiagram-v2
34
- [*] --> _INITIAL_STATE_ : _INITIAL_EVENT_ / _INITIAL_CONDITION_
35
- _INITIAL_STATE_ --> _NEXT_STATE_ : _EVENT_ / _CONDITION_
36
- _NEXT_STATE_ --> [*] : _END_EVENT_ / _END_CONDITION_
37
- ```
32
+ <!-- 状態が一つだけの場合は、状態変化がない根拠も記載する。 -->
33
+
34
+ ## 3. 状態の判定
35
+
36
+ - 状態の正本: _TODO_: 現在状態を確認する正本の管理場所を示す。履歴・集約記録を併用する場合は正本と派生物を区別する。
37
+ - 一意判定: _TODO_: 現在状態を一意に決める規則を示す。該当する場合はイベントの再生順序と初期値、導出条件と再判定の契機、成立条件が重なる場合の優先関係を記載し、状態固有の成立条件は状態一覧を参照する。
38
+ - 互換の扱い: _TODO_: 旧状態値・旧イベント、未設定・欠損記録の読み取りや移行の扱いを示す。過去の記録の読み替えと現在発行する遷移を区別し、互換の扱いが不要ならその旨を明記する。
39
+
40
+ ## 4. 状態一覧
41
+
42
+ | 値 | 状態名 | 通称 | 意味 | 成立条件 | 管理場所 |
43
+ | ---------------------- | -------------------- | --------------------- | ----------------------- | ------------------------- | ----------------------------- |
44
+ | `_INITIAL_STATE_CODE_` | _INITIAL_STATE_NAME_ | _INITIAL_COMMON_NAME_ | _INITIAL_STATE_MEANING_ | _INITIAL_ENTRY_CONDITION_ | _INITIAL_MANAGEMENT_LOCATION_ |
45
+ | `_NEXT_STATE_CODE_` | _NEXT_STATE_NAME_ | _NEXT_COMMON_NAME_ | _NEXT_STATE_MEANING_ | _NEXT_ENTRY_CONDITION_ | _NEXT_MANAGEMENT_LOCATION_ |
38
46
 
39
- <!-- 状態一覧の全状態を図へ配置する。図にだけ存在する業務状態や <<choice>> などの疑似状態を残さず、分岐は同じ遷移元からの複数矢印として、全遷移にイベントと条件を記載する。業務状態が 15、遷移が 20、または一状態の入出力遷移合計が 6 を超える場合は図を分割し、各図が扱う遷移 ID と共有状態を明記する。 -->
47
+ <!-- 対象の状態に合わせて行を増減する。値は lower-kebab-case とし、`-` を除いて文書内で一意にする。コードを持たない場合、通称がない場合は `-` とする。状態名は状態遷移の図・表と完全一致させる。 -->
40
48
 
41
- ## 4. 遷移の説明
49
+ ## 5. 状態遷移
42
50
 
43
- | 遷移 ID | 遷移元 | 遷移先 | イベント | 条件 | 補足 |
44
- | ----------------- | -------------- | -------------- | -------- | ----------- | ------ |
45
- | `_TRANSITION_ID_` | _SOURCE_STATE_ | _TARGET_STATE_ | _EVENT_ | _CONDITION_ | _NOTE_ |
51
+ <!-- 状態一覧の全状態を図へ配置する。図にだけ存在する業務状態や <<choice>> などの疑似状態を残さず、分岐は同じ遷移元からの複数矢印として示す。全遷移に `T-01 イベント / 条件` の形(遷移 ID・イベント・条件)で記載し、無条件の場合は条件を `イベント発生時` とする。 -->
52
+
53
+ <!-- 業務状態が 15、遷移が 20、または一状態の入出力遷移合計が 6 を超える場合は、業務フェーズまたは通常系・例外系で図を分割する。分割理由・各図が扱う遷移 ID の範囲・共有状態は図の前へ記載する。共有状態の表示名と `state_id` をそろえ、全図をつないで到達性を判断できるようにする。図と直下の表を一組として繰り返し、図と表の間に説明文や別の図を挟まない。 -->
54
+
55
+ <!-- 表示名は状態一覧の状態名と値を使い、値が `-` の場合は `<br>` と値を除いて状態名だけにする。`state_id`(雛形の `initial_state`・`next_state`)は英小文字で始まる英小文字・数字・アンダースコアにし、表示する値の代わりにはしない。ライフサイクルを閉じる業務イベントと条件がない場合は終了点への遷移と対応する表の行を削除する。初期点は開始遷移を扱う図だけに置く。 -->
56
+
57
+ <!-- 遷移表は直上の図の全遷移を一行ずつ記載し、分割時も文書全体で一意な遷移 ID を使い、重複・欠落を残さない。初期点は `開始`、終了点は `終了` と記載する。補足には判断者・証跡・例外の扱いなどを記入し、図表をなぞる説明は書かない。共通条件は適用する遷移 ID とともに図の前へまとめ、表から参照する。 -->
58
+
59
+ ```mermaid
60
+ stateDiagram-v2
61
+ state "_INITIAL_STATE_NAME_<br>_INITIAL_STATE_CODE_" as initial_state
62
+ state "_NEXT_STATE_NAME_<br>_NEXT_STATE_CODE_" as next_state
63
+ [*] --> initial_state : T-01 _INITIAL_EVENT_ / _INITIAL_CONDITION_
64
+ initial_state --> next_state : T-02 _EVENT_ / _CONDITION_
65
+ next_state --> [*] : T-03 _END_EVENT_ / _END_CONDITION_
66
+ ```
46
67
 
47
- <!-- 遷移 ID は T-01 形式とし、図の全遷移を一行ずつ記載する。初期点は `開始`、終了点は `終了` と記載する。 -->
68
+ | 遷移 ID | 遷移元 | 遷移先 | イベント | 条件 | 補足 |
69
+ | ------- | -------------------- | -------------------- | --------------- | ------------------- | -------------- |
70
+ | `T-01` | 開始 | _INITIAL_STATE_NAME_ | _INITIAL_EVENT_ | _INITIAL_CONDITION_ | _INITIAL_NOTE_ |
71
+ | `T-02` | _INITIAL_STATE_NAME_ | _NEXT_STATE_NAME_ | _EVENT_ | _CONDITION_ | _NOTE_ |
72
+ | `T-03` | _NEXT_STATE_NAME_ | 終了 | _END_EVENT_ | _END_CONDITION_ | _END_NOTE_ |
48
73
 
49
74
  <!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。
50
75
 
51
- ## 5. 今後の検討メモ
76
+ ## 6. 今後の検討メモ
52
77
 
53
78
  | 論点 | 影響する状態・遷移 | 決定者 | 決定時期 |
54
79
  | ------------------- | ------------------ | --------------- | ----------------- |
@@ -0,0 +1,94 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-critical-flows-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:sysd-critical-flows-rulebook
13
+ part_of: []
14
+ based_on: _BASED_ON_
15
+ ---
16
+
17
+ # _DELIVERABLE_NAME_
18
+
19
+ ## 1. 概要
20
+
21
+ - **対象・対象外**: _SCOPE_ENTRY_EXIT_AND_EXCLUSIONS_
22
+ - **最大5件の管理方針**: _FLOW_SELECTION_CONSOLIDATION_AND_REPLACEMENT_POLICY_
23
+ - **設計索引・状態用語の定義先**: _DESIGN_INDEX_AND_STATE_DEFINITION_SOURCE_
24
+ - **公開範囲・除外情報・人間の最終承認責任**: _PUBLICATION_SCOPE_EXCLUSIONS_AND_HUMAN_APPROVER_
25
+
26
+ ## 2. 重要フロー一覧
27
+
28
+ | ID | 名称 | 事故論点 | 対象者 | 業務影響 | 期待効果・選定理由 |
29
+ | ----------- | ----------- | ------------------ | ---------------- | ----------------- | ------------------------------------- |
30
+ | `_FLOW_ID_` | _FLOW_NAME_ | _ACCIDENT_CONCERN_ | _AFFECTED_ROLES_ | _BUSINESS_IMPACT_ | _EXPECTED_EFFECT_AND_PRIORITY_REASON_ |
31
+
32
+ <!-- 一覧と詳細は同じ ID の集合とし、総数は最大5件。対象者には影響を受ける利用者・運用者、業務影響には放置時の損失、選定理由には通常処理より優先する理由を記入する。 -->
33
+
34
+ ## 3. フロー詳細
35
+
36
+ _TODO_: 図の矢印・同期/非同期・境界の凡例を記入する。以下の節をフローごとに複製し、見出し番号を連番にする。
37
+
38
+ ### 3.1. _FLOW_ID_: _FLOW_NAME_
39
+
40
+ - **目的・起動**: _PURPOSE_AND_TRIGGER_
41
+ - **範囲・入出力**: _SCOPE_INPUT_OUTPUT_AND_EXCLUSIONS_
42
+ - **図**: _TODO_: システム内外、サービス/プロセスと保存先、主要識別子、同期・非同期の区別を表す図を記入する。
43
+ - **永続化点・成功の確定**: _PERSISTENCE_AND_SUCCESS_CONFIRMATION_
44
+ - **整合性・冪等・再実行**: _CONSISTENCY_IDEMPOTENCY_AND_REPLAY_CONDITIONS_
45
+ - **失敗・保持・補償・再開**: _FAILURE_RETENTION_COMPENSATION_AND_RESUME_CONDITIONS_
46
+ - **受入条件**: `_ACCEPTANCE_ID_`: _USER_OBSERVABLE_ACCEPTANCE_
47
+
48
+ ## 4. 観測性と運用連携
49
+
50
+ ### 4.1. 検知と責任
51
+
52
+ _TODO_: 共通の必須記録と trace 方針を記入する。フロー別の伝搬範囲または非採用理由・代替の追跡方法は下表に記入する。
53
+
54
+ | Flow ID | 相関キーと追跡範囲 | 検知条件・閾値の正本 | 実装動作 | 人間の一次対応・照会先 |
55
+ | ----------- | ------------------------------------ | -------------------------------- | -------------------- | ------------------------------- |
56
+ | `_FLOW_ID_` | _CORRELATION_SCOPE_AND_TRACE_POLICY_ | _DETECTION_AND_THRESHOLD_SOURCE_ | _AUTOMATED_BEHAVIOR_ | _HUMAN_RESPONSE_AND_ESCALATION_ |
57
+
58
+ ### 4.2. 管理記録への引渡し
59
+
60
+ | 条件・対象 | 記録種別 | 担当Role code・対応方針 | 報告・判断先 |
61
+ | ----------------- | ------------- | ----------------------- | -------------------------------- |
62
+ | _CONTROL_TRIGGER_ | _RECORD_TYPE_ | _OWNER_AND_RESPONSE_ | _REPORT_OR_DECISION_DESTINATION_ |
63
+
64
+ ## 5. 関連ドキュメント導線
65
+
66
+ ### 5.1. 正本と変更影響
67
+
68
+ | Flow ID | 実装・設定の一意な参照先 | 変更時の契約・schema・生成物・CLI・互換性 | 運用・判断への導線 |
69
+ | ----------- | ---------------------------------- | ----------------------------------------- | -------------------------------- |
70
+ | `_FLOW_ID_` | _IMPLEMENTATION_AND_CONFIG_SOURCE_ | _CHANGE_IMPACT_ | _OPERATIONS_AND_DECISION_SOURCE_ |
71
+
72
+ ### 5.2. 検証への引渡し
73
+
74
+ | 検証ID / フロー / 受入条件ID | 実在する確認先・実行方法 | 対象条件 | 期待結果・失敗判定 | 確認状況・不足の解消先 |
75
+ | ----------------------------------------------------- | ---------------------------- | ---------------- | ------------------------ | ----------------------------------------------------- |
76
+ | `_VERIFICATION_ID_` / `_FLOW_ID_` / `_ACCEPTANCE_ID_` | _TEST_REFERENCE_AND_COMMAND_ | _TEST_CONDITION_ | _PASS_AND_FAIL_CRITERIA_ | _LOCATION_COVERAGE_EXECUTION_STATUS_AND_GAP_TRACKING_ |
77
+
78
+ <!-- 確認先は実在するテストパスまたはテスト ID。内部結合は ITC(itc- 系)、外部結合は ETC(etc- 系)。所在・網羅性・実行結果を区別し、不足は「未決事項と後続作業」の ID・担当へ接続する。 -->
79
+
80
+ ### 5.3. 未決事項と後続作業
81
+
82
+ | ID / 対象 | 未充足事項・依存とScheduleへの影響 | 作業単位・依存順・担当Role code | 完了条件・判断時期・登録先 |
83
+ | ------------------------------- | ------------------------------------ | ------------------------------- | ----------------------------------------- |
84
+ | `_UNRESOLVED_ID_` / `_FLOW_ID_` | _GAP_DEPENDENCY_AND_SCHEDULE_IMPACT_ | _WORK_SEQUENCE_AND_OWNER_ | _CLOSURE_TIMING_AND_TRACKING_DESTINATION_ |
85
+
86
+ <!-- 未決事項がなければ行を削除し、確認した範囲と「なし」を記す。未作成参照はwikilinkにせずIDをコード表記し、追跡IDと作成担当を付ける。 -->
87
+
88
+ ### 5.4. 承認対象と公開前条件
89
+
90
+ | 判断対象 | 設計確認担当と合意事項 | 人間の承認責任・確定条件 |
91
+ | ----------- | ----------------------------------- | ----------------------------- |
92
+ | `_FLOW_ID_` | _DESIGN_REVIEW_ROLES_AND_AGREEMENT_ | _HUMAN_APPROVER_AND_EVIDENCE_ |
93
+
94
+ _TODO_: 公開/`ready` 昇格前の未決事項の解消または留保、人間承認の証跡、公開情報の確認、運用導線の充足条件を記入する。
@@ -0,0 +1,122 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-cross-cutting-policy-template
4
+ type: template
5
+ status: ready
6
+ rulebook: specdojo:sysd-cross-cutting-policy-rulebook
7
+ frontmatter_template:
8
+ specdojo:
9
+ id: _LOCAL_ID_
10
+ type: architecture
11
+ status: draft
12
+ rulebook: specdojo:sysd-cross-cutting-policy-rulebook
13
+ based_on: _BASED_ON_
14
+ part_of: [] # 所属するシステム設計索引の文書 ID を記入する。
15
+ ---
16
+
17
+ # _DELIVERABLE_NAME_
18
+
19
+ _DELIVERABLE_OVERVIEW_
20
+
21
+ ## 1. 概要(適用範囲・優先順位)
22
+
23
+ _TODO_: 対象者の課題、上位価値への寄与、適用対象、競合時の優先判断。
24
+
25
+ <!-- 非該当の領域がなければ「なし」とし、空表を削除する。 -->
26
+
27
+ | 対象外の領域 | 構成上の理由 | 代替手段・代替不要の理由 |
28
+ | ------------ | ------------ | ------------------------ |
29
+ | _AREA_ | _TODO_ | _TODO_ |
30
+
31
+ ### 1.1. 利用・確認・承認責務
32
+
33
+ | Role | 合意・確認対象 |
34
+ | ---------- | -------------------------------------------- |
35
+ | ARC | _TODO_: 設計・構造の更新対象 |
36
+ | DEV | _TODO_: 実装・設定・schema の照合対象 |
37
+ | QE / OPS | _TODO_: 検証、監視・回復の確認対象 |
38
+ | PM | _TODO_: 不足・依存・期限の追跡対象 |
39
+ | PO(人間) | _TODO_: 公開・留保・差し戻しと昇格の最終判断 |
40
+
41
+ ## 2. ルール一覧(ID/カテゴリ/要約/必須度)
42
+
43
+ <!-- エラー、冪等、時間上限と打切り、retry、診断ログ・監査、トレーシング、秘密・権限、設定上書き、モジュール境界を覆う行を追加する。非該当は概要へ接続する。 -->
44
+
45
+ | Rule ID | Category | Summary | Level | Owner |
46
+ | ------------------------- | ---------- | -------------- | ------- | ----------- |
47
+ | `scp-_CATEGORY_-_NUMBER_` | _CATEGORY_ | _RULE_SUMMARY_ | _LEVEL_ | _ROLE_CODE_ |
48
+
49
+ ### 2.1. 適合確認の順序と時機
50
+
51
+ | 確認群 | Rule ID | 現状 | 依存・確認タイミング | 担当 |
52
+ | ---------- | --------- | -------------------------------------------- | -------------------------------- | ----------- |
53
+ | _CHECK_ID_ | _RULE_ID_ | _TODO_: 実装済み・不足・未照合・非該当と証跡 | _TODO_: 先行確認・着手前・公開前 | _ROLE_CODE_ |
54
+
55
+ ## 3. 各ルール詳細(ID単位)
56
+
57
+ ### 3.1. _RULE_ID_: _RULE_TITLE_
58
+
59
+ <!-- ルールごとに連番を付けて繰り返す。Rule は不変条件、検証の詳細は Enforcement にまとめる。 -->
60
+
61
+ - **Rule(_LEVEL_)**: _TODO_: 入力条件と要求・禁止する動作。
62
+ - **Rationale(意図)**: _TODO_: 防ぐ失敗と守る価値。
63
+ - **Scope(適用範囲)**: _TODO_: 適用する実行・モジュールと境界。
64
+ - **Enforcement(検証)**: _TODO_: 入力・期待結果、検証群、コマンド・対象ケース。上限や設定キーの正本と照合する。
65
+ - **Exception(例外)**: _TODO_: 例外章への導線。なしなら明記。
66
+ - **References(参照)**: _TODO_: 実在する正本の ID またはリポジトリ相対パス。
67
+
68
+ ## 4. 例外と判断記録
69
+
70
+ ### 4.1. 例外の入口
71
+
72
+ <!-- 承認済み例外がなければ「なし」とし、空表を削除する。 -->
73
+
74
+ | Rule ID | 理由・条件・影響範囲 | 期限・判断者 | 復帰条件・決定参照 | 復帰・再確認の担当 |
75
+ | --------- | -------------------- | ------------ | ------------------ | ------------------ |
76
+ | _RULE_ID_ | _TODO_ | _TODO_ | _TODO_ | _ROLE_CODE_ |
77
+
78
+ ### 4.2. 報告と追跡
79
+
80
+ | 事象 | 記録先・種別 | 報告・追跡責務 |
81
+ | ---------------------- | ----------------------- | -------------------------------- |
82
+ | 発生した不適合 | _TODO_: issue の正本 | _TODO_: 報告者・追跡者・再確認者 |
83
+ | 依存遅延等の可能性 | _TODO_: risk の正本 | _TODO_ |
84
+ | ルール・保護境界の変更 | _TODO_: change の正本 | _TODO_: 影響整理・計画への接続 |
85
+ | 例外許可・留保・判断 | _TODO_: decision の正本 | _TODO_: 人間の判断・反映・追跡 |
86
+
87
+ ## 5. 関連ドキュメント導線
88
+
89
+ ### 5.1. 正本と運用への入口
90
+
91
+ <!-- 実在 ID は wikilink、未作成はコード表記にする。用途・状態には参照目的と未整備時の代替を記す。 -->
92
+
93
+ | 対象 | 参照 | 用途・状態 |
94
+ | ------------------------ | ------ | ---------- |
95
+ | システム設計・重要フロー | _TODO_ | _TODO_ |
96
+ | 非機能要件 | _TODO_ | _TODO_ |
97
+ | 運用設計・手順 | _TODO_ | _TODO_ |
98
+ | テスト | _TODO_ | _TODO_ |
99
+ | 判断記録 | _TODO_ | _TODO_ |
100
+
101
+ ### 5.2. 変更影響と再検証
102
+
103
+ | 確認群 | 更新・追従する対象 | 検証コマンド・対象 |
104
+ | ---------- | ------------------------------------------------ | ------------------------------------------ |
105
+ | _CHECK_ID_ | _TODO_: 担当・schema・生成物・互換性・移行の影響 | _TODO_: 実行場所・コマンド・入力・期待結果 |
106
+
107
+ ## 6. 未決事項と公開前確認
108
+
109
+ ### 6.1. 判断待ちと後続への影響
110
+
111
+ <!-- 未決事項がなければ「なし」とし、空表を削除する。不明は _TODO_:、判断待ちは _UNDECIDED_:、仮定は _ASSUMPTION_: で区別する。 -->
112
+
113
+ | ID・作成対象 | 判断者・担当 | 判断期限 | 影響・当面の扱い | 次アクションと解消条件 |
114
+ | ----------------------------------------------- | ------------ | ----------------- | ---------------- | -------------------------------------------------------------------- |
115
+ | _QUESTION_ID_: _RULE_ID_ / _TARGET_DOCUMENT_ID_ | _ROLE_CODE_ | _DECISION_TIMING_ | _TODO_ | _TODO_: 登録簿・計画への登録状況、実 ID または起票担当・時機、反映先 |
116
+
117
+ ### 6.2. 公開・昇格の判断条件
118
+
119
+ - _TODO_: ARC / DEV が全規則と正本・実装状況を照合する条件。
120
+ - _TODO_: QE / OPS が失敗・境界・回復・観測の証跡を確認する条件。
121
+ - _TODO_: PM が不足・依存・担当・期限と実 ID を接続する条件。
122
+ - _TODO_: 人間の PO が解消・期限付き留保・差し戻しを判断する条件。agent は `ready` へ昇格しない。
@@ -0,0 +1,89 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-index-template
4
+ type: template
5
+ status: ready
6
+ rulebook: specdojo:sysd-index-rulebook
7
+ frontmatter_template:
8
+ specdojo:
9
+ id: _LOCAL_ID_
10
+ type: architecture
11
+ status: draft
12
+ rulebook: specdojo:sysd-index-rulebook
13
+ based_on: []
14
+ supersedes: []
15
+ ---
16
+
17
+ # _SYSTEM_NAME_ システム設計索引(SYSD Index)
18
+
19
+ _TODO_: この索引を使う人と、正本(SSOT: Single Source of Truth)の所在を共有して解決する課題を記す。値・構文・構造の詳細は各正本へ委ねる。
20
+
21
+ ## 1. 概要(対象範囲・更新責任)
22
+
23
+ _TODO_: 対象システム、含む領域・含まない領域、略語の意味、パスの基準ディレクトリを記す。
24
+
25
+ <!-- ロールの行は対象の体制に合わせて追加・統合し、更新・確認・人間の承認の責務を分ける。 -->
26
+
27
+ | ロール | 更新・確認・承認の対象 |
28
+ | ------ | ------------------------------------ |
29
+ | ARC | _TODO_: 構成と索引の更新範囲 |
30
+ | DEV | _TODO_: コード・schema の更新範囲 |
31
+ | OPS | _TODO_: 運用設定と手順の更新範囲 |
32
+ | QE | _TODO_: 検証入力と判定条件の確認範囲 |
33
+ | PO | _TODO_: 人間が承認する範囲 |
34
+
35
+ ## 2. SSOT 一覧(表形式)
36
+
37
+ <!-- 各行に正本の名称・実在する所在・更新責任・検証方法を記す。非該当の領域も残し、理由と代替正本、または代替不要の理由を記す。未確認は担当・確認条件付きの _TODO_ とする。 -->
38
+
39
+ | 種別 | SSOT(正本) | 参照先 | 更新責任 | 検証方法・備考 |
40
+ | --------------------------- | ------------ | ------ | -------- | -------------- |
41
+ | API・外部連携・非同期連携 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
42
+ | データ契約・DB schema・移行 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
43
+ | モジュール境界 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
44
+ | 設定・環境変数・実行構成 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
45
+ | Job・定期処理 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
46
+ | 監視・ログ・通知 | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
47
+ | ソース管理・CI/CD | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
48
+
49
+ ## 3. 自動生成物(生成コマンド/生成先/閲覧先)
50
+
51
+ 設計の正本から再生成する派生物は直接編集しない。
52
+
53
+ _TODO_: 業務記録・実行状態と区別して生成物を記す。生成しない場合は理由を記し、空の表を削除する。
54
+
55
+ | 生成物 | 入力元(SSOT) | 生成コマンド | 生成先 | 閲覧先・更新タイミング |
56
+ | ------------- | --------------- | -------------------- | --------------- | -------------------------- |
57
+ | _OUTPUT_NAME_ | `_SOURCE_PATH_` | `_GENERATE_COMMAND_` | `_OUTPUT_PATH_` | _TODO_: 閲覧先・再生成時機 |
58
+
59
+ ## 4. 変更の入口(典型ケース)
60
+
61
+ _TODO_: 検証の実行場所を記し、API・DB・設定・Job・監視などの変更種別、非該当領域の導入、正本の移動・廃止ごとに行を作る。以下は変更時の検証手順とし、実行済みの証跡と区別する。
62
+
63
+ | 変更トリガー | 最初に更新する SSOT | 追従する生成物・関連文書 | 検証対象ケース・実行コマンド・期待結果 |
64
+ | ---------------- | ------------------------ | ------------------------------------ | ------------------------------------------------------------------ |
65
+ | _CHANGE_TRIGGER_ | _TODO_: 正本の名称・所在 | _TODO_: 再生成・参照更新の対象と担当 | _TODO_: 対象ファイル・正常/失敗/境界ケース・実行コマンド・期待結果 |
66
+
67
+ ## 5. 関連ドキュメント導線(C4 / NFR / OPD / DEC 等)
68
+
69
+ _TODO_: 構成図、設計分冊、業務フロー、外部連携、非機能要件、運用、テスト、判断記録への入口を参照目的で分類する。実在文書は wikilink、未作成文書はコード表記にする。
70
+
71
+ | 区分 | ドキュメント | 役割・参照目的 | 状態・備考 |
72
+ | --------------- | ------------ | -------------- | ---------------------------------------------------------- |
73
+ | _DOCUMENT_KIND_ | _TODO_ | _TODO_ | _TODO_: 整備状態。未作成なら代替参照先・整備担当・後続作業 |
74
+
75
+ ## 6. 未決事項・変更影響・公開前確認
76
+
77
+ ### 6.1. 未決事項と後続作業への影響
78
+
79
+ <!-- 不明は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置き前提は _ASSUMPTION_: で記す。該当事項がなければ「なし」とし、空の表を削除する。 -->
80
+
81
+ | 項目・対象 | 現状と影響範囲 | 担当ロール | 解消条件・次アクション |
82
+ | ---------------- | ---------------------------------- | ----------- | -------------------------------------------------------- |
83
+ | _DECISION_TOPIC_ | _TODO_: 現状・影響範囲・当面の扱い | _ROLE_CODE_ | _TODO_: 判断時機・解消条件・次アクション・解消後の更新先 |
84
+
85
+ ### 6.2. 公開・昇格前の確認条件
86
+
87
+ - _TODO_: ARC / DEV が正本の所在と生成・検証経路を確認する条件。
88
+ - _TODO_: OPS / QE が運用設定と対象ケースの期待結果を確認する条件。
89
+ - _TODO_: PO が対象範囲、非該当理由、未決事項の留保・解消を承認する条件。`ready` 昇格は人間が行う。
@@ -0,0 +1,7 @@
1
+ // YAML artifacts keep metadata at the root; external formats use x-spec-meta.
2
+ // Shared by grade and validate:schema (also shipped with the SpecDojo assets).
3
+ module.exports = function yamlMetadata(value) {
4
+ const isRecord = (item) => item !== null && typeof item === "object" && !Array.isArray(item);
5
+ if (!isRecord(value)) return undefined;
6
+ return isRecord(value["x-spec-meta"]) ? value["x-spec-meta"] : value;
7
+ };
@@ -59,7 +59,6 @@ properties:
59
59
  - logical_name
60
60
  - physical_name
61
61
  - key_fields
62
- - fields
63
62
 
64
63
  properties:
65
64
  logical_name:
@@ -73,6 +72,16 @@ properties:
73
72
  description:
74
73
  type: string
75
74
 
75
+ schema_ref:
76
+ type: string
77
+ pattern: "^[^\\s]+$"
78
+ description: "正本となるスキーマ(JSON Schema / YAML Schema 等)の参照パス"
79
+
80
+ type_ref:
81
+ type: string
82
+ pattern: "^[^\\s]+$"
83
+ description: "正本となる型定義(TypeScript 等)の参照パス(例: src/types/xxx.ts#Type)"
84
+
76
85
  glossary_term_id:
77
86
  type: string
78
87
  pattern: "^tm-[A-Za-z0-9\\-]+$"
@@ -99,7 +108,6 @@ properties:
99
108
  required:
100
109
  - logical_name
101
110
  - physical_name
102
- - type
103
111
 
104
112
  properties:
105
113
  logical_name:
@@ -173,58 +181,18 @@ properties:
173
181
  type: string
174
182
  uniqueItems: true
175
183
 
176
- # key_fields が fields 内の physical_name に存在することを検証
177
- allOf:
178
- - $comment: "key_fields must be included in fields[].physical_name"
179
- - type: object
180
- properties:
181
- key_fields:
182
- type: array
183
- fields:
184
- type: array
185
- required: ["key_fields", "fields"]
186
- allOf:
187
- # key_fields の各値が fields[].physical_name に存在すること
188
- - $comment: "Check each key_field is present in fields[].physical_name"
189
- - type: object
190
- properties:
191
- key_fields:
192
- type: array
193
- items:
194
- type: string
195
- fields:
196
- type: array
197
- items:
198
- type: object
199
- properties:
200
- physical_name:
201
- type: string
202
- required: ["key_fields", "fields"]
203
- allOf:
204
- - $comment: "Ensure each key_fields item is contained in fields[].physical_name"
205
- properties:
206
- key_fields:
207
- type: array
208
- items:
209
- type: string
210
- required: ["key_fields"]
211
- allOf:
212
- - $comment: "for each key in key_fields check membership"
213
- type: object
214
- properties:
215
- key_fields:
216
- type: array
217
- contains:
218
- type: string
219
- # membership check is implicit via contains + const matching below
220
- # 各 key_field が fields[].physical_name のいずれかに一致
221
- - type: object
222
- properties:
223
- fields:
224
- type: array
225
- items:
226
- type: object
227
- properties:
228
- physical_name:
229
- type: string
230
- required: ["fields"]
184
+ # schema_ref または type_ref がない(スタンドアロン定義)の場合は fields を必須とする
185
+ if:
186
+ not:
187
+ anyOf:
188
+ - required: ["schema_ref"]
189
+ - required: ["type_ref"]
190
+ then:
191
+ required:
192
+ - fields
193
+
194
+ # schema_ref と type_ref は同時に指定できない
195
+ not:
196
+ allOf:
197
+ - required: ["schema_ref"]
198
+ - required: ["type_ref"]
@@ -0,0 +1,26 @@
1
+ $schema: "https://json-schema.org/draft/2020-12/schema"
2
+ title: Condense Records
3
+ description: Changes and deliberately retained candidates within one document.
4
+ type: array
5
+ maxItems: 100
6
+ items:
7
+ type: object
8
+ additionalProperties: false
9
+ required: [location, category, action, reason, cause]
10
+ properties:
11
+ location:
12
+ type: string
13
+ pattern: "\\S"
14
+ maxLength: 4000
15
+ description: Heading, line, or passage in the deliverable before the edit.
16
+ category:
17
+ enum: [repetition, table-prose, figure-prose, unneeded-background, canonical-restatement]
18
+ action:
19
+ enum: [delete, merge, reference, retain]
20
+ reason:
21
+ type: string
22
+ pattern: "\\S"
23
+ maxLength: 4000
24
+ description: Meaning-preservation evidence or reason for retaining the candidate.
25
+ cause:
26
+ $ref: "finding-cause.schema.yaml"
@@ -54,6 +54,13 @@ properties:
54
54
  $ref: "#/$defs/DocId"
55
55
  uniqueItems: true
56
56
 
57
+ supersedes:
58
+ type: array
59
+ description: "Optional superseded document IDs."
60
+ items:
61
+ $ref: "#/$defs/DocId"
62
+ uniqueItems: true
63
+
57
64
  project_id:
58
65
  type: string
59
66
  pattern: "^prj-[0-9]{4,}$"
@@ -111,6 +118,9 @@ else:
111
118
  part_of:
112
119
  items:
113
120
  $ref: "#/$defs/StrictDocId"
121
+ supersedes:
122
+ items:
123
+ $ref: "#/$defs/StrictDocId"
114
124
  groups:
115
125
  items:
116
126
  $ref: "#/$defs/StrictSection"