specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -42,61 +42,87 @@ plan / result の frontmatter には `targets`(対象文書の doc id リス
42
42
 
43
43
  ### 1.2. 配置
44
44
 
45
- | 種別 | 配置 |
46
- | ------------- | ----------------------------------- |
47
- | plan | `<execution_path>/exec/plans/` |
48
- | 完了後の plan | `<execution_path>/exec/plans/done/` |
49
- | result | `<execution_path>/exec/results/` |
45
+ 1 回の実行を `execution/runs/<出どころ>/<項目 ID>/<run ID>/` にまとめます。配置の決め方は `src/shared/run-records.ts` を正本とします。
50
46
 
51
- result は完了記録であり、review などから参照されるため `done/` へ移動しません。
52
-
53
- ## 2. 命名規則
47
+ ```text
48
+ execution/
49
+ runs/<出どころ>/<項目 ID>/<run ID>/
50
+ plan.md
51
+ result.md
52
+ evidence.json
53
+ pipeline-state.json
54
+ executor.log
55
+ reporter.log
56
+ ```
54
57
 
55
- task identity の有無によるファイル名の決め方と、対象成果物の解決方法を示します。
58
+ ログは実行した段に応じて保存し、親検証・統合のログも同じディレクトリに置きます。human の実行は result のみです。完了しても保存先は変わりません。共通規約の版は `execution/conventions/`、成果物ごとの評価結果は `execution/grade/results/`、job の状態管理 JSON は `execution/jobs/runs/` に残します。
56
59
 
57
- ### 2.1. task identityありの命名
60
+ ### 1.3. 配置の検査
58
61
 
59
- `--task <task-id>` を使う場合、plan と result は task ID を使った固定名になります。
62
+ `exec validate` は schedule・event とともに実行記録の配置を検査し、欠けた記録を `WARN:` で知らせます。欠落だけなら終了コードは 0 です。CI などで配置だけを検査し、欠落もエラーにする場合は次を使います。
60
63
 
61
- ```text
62
- exec/plans/<task-id>-plan.md
63
- exec/results/<task-id>-result.md
64
+ ```bash
65
+ specdojo exec validate --project <project-id> --records-only
64
66
  ```
65
67
 
66
- 対象:
68
+ 次の過去の世代の記録は、通常の検査でも `--records-only` でもエラー・警告にしません。
67
69
 
68
- | 操作 | 命名 |
69
- | ------------------------ | -------------------- |
70
- | `exec plan --task` | 固定名 plan |
71
- | `exec run --task` | 固定名 plan / result |
72
- | `exec claim` | 固定名 result |
73
- | `exec run --track-state` | 固定名 plan / result |
74
- | `exec run --worktree` | 固定名 plan / result |
70
+ - evidence 導入前: `plan.md` と `result.md` がそろい、`pipeline-state.json` と `evidence.json` がない run。
71
+ - 移行で plan・result を集約した先行試行: `pipeline-state.json` と `evidence.json` があり、plan・result が両方なく、同じ出どころ・項目の別 run に plan・result の対がある run。
72
+ - 旧配置: `execution/exec/plans/`・`results/`・`evidence/` 配下。evidence や対になる記録がなくても検査対象から外します。
75
73
 
76
- 同じ task の再生成や再実行では同じファイルを上書きします。過去内容は Git 履歴、完了の事実は event と commit 履歴で追跡します。
74
+ このほか `execution: human` を明記した result は単独で正常とします。それ以外で `plan.md`・`result.md`・`evidence.json` が欠けた run は、通常は警告、`--records-only` では `ERROR:` と終了コード 1 で報告します。生成直後の plan 単独や中断中の run も含みます。ログと checkpoint は実行段に応じた任意の記録で、退避した試行も同じ run に保持できます。
77
75
 
78
- ### 2.2. task identityなしの命名
76
+ run の外の plan・result・evidence・checkpoint・ログ、不正な出どころや深さは、上の例外を除き両モードでエラーにします。`exec/events/`・`exec/trials/`、規約の版、`grade/results/`・`grade/generated/`、job の状態、生成物、routine の失敗記録は独立した形式として検査から除きます。runtime lock は `git check-ignore` で確認し、追跡済みや無視されていない lock、Git で確認できない場合は両モードで終了コード 1 を返します。旧 `routines/.locks/` も設定された routine のディレクトリで検査しますが、ファイルのない lock のディレクトリは対象外です。
79
77
 
80
- `--deliverable <local_id>` や ad-hoc 実行では、task ID がないためユニーク名を使います。
78
+ 検査は記録を書き換えず、欠けたファイルも生成しません。CI で `--records-only` を使う場合は、実行が終了して記録がそろった revision を対象にしてください。
81
79
 
82
- ```text
83
- exec/plans/<stem>-plan.md
84
- exec/results/<stem>-result.md
80
+ 作業ツリーには中断中の run や空のディレクトリが残ることがあるため、push する前の確認は commit の tree を対象にします。`--commit <rev>` を付けると、`<rev>` の tree を一時ディレクトリへ書き出して同じ検査を流し、未 commit の記録は対象にしません。pre-push hook(`tools/check-run-record-layout-push.mjs`)は push する各 ref の先端 commit をこの形で検査し、CI の Check execution record layout と同じ欠落を push の前に止めます。
81
+
82
+ ```bash
83
+ specdojo exec validate --project <project-id> --records-only --commit <rev>
85
84
  ```
86
85
 
87
- `<stem>` は plan と result の連結キーです。同じ plan から実行する result は同じ `<stem>` を使います。
86
+ `exec run` と `exec cycle` の事前検証は `exec validate --schedule-only` で schedule・event だけを調べます。生成途中や中断中の run と、取得中の runtime lock があっても、実行・再開を妨げません。`--schedule-only` と `--records-only` は併用できません。
87
+
88
+ ## 2. 命名規則
89
+
90
+ ### 2.1. 出どころと項目 ID
91
+
92
+ | 出どころ | 項目 ID |
93
+ | ---------- | -------------------------- |
94
+ | `register` | 登録項目 ID(`PJR-XXXX`) |
95
+ | `schedule` | タスク ID(`T-...`) |
96
+ | `job` | job の実行 ID(`JBR-...`) |
97
+
98
+ review は元の項目の下の別 run とします。plan と result の文書 ID は frontmatter の `specdojo.id` を正本とし、ファイルの移動で変更しません。
99
+
100
+ ### 2.2. run ID
101
+
102
+ 新しい plan の生成では `<slug>-<UTC>-<rand>` のユニークな run ID を採番します。`<rand>` は4バイト(16進8桁)で、同一プロセス内で重複した場合は連番を加えます。job の attempt など、呼び出し側が run ID を指定する場合も同じ配置モジュールを通します。
103
+
104
+ plan と result のファイル名はそれぞれ `plan.md` と `result.md` です。同じ task の新しい実行は別 run に保存します。同一 run の再開では保存先を維持し、executor をやり直す前の state・evidence・ログを `*.attempt-N.*` に退避します。
105
+
106
+ state と evidence は元も残し、ログは退避先へ移します。退避した evidence の `log_refs` も退避先を指します。引き継ぐ evidence が参照するログは元の名前でも保持します。reporter からの再開では executor の試行を退避せず、evidence とログをそのまま使います。
88
107
 
89
- ### 2.3. stemの決定順序
108
+ ### 2.3. 既存記録の移行
90
109
 
91
- `<stem>` は次の優先順位で決まります。
110
+ `exec migrate-records` は検査を通すためには不要です。旧配置の記録を CLI の通常の探索で使う場合に移行します。移さない場合の制約は次のとおりです。
92
111
 
93
- 1. `--out <path>` または `--plan <path>` を指定した場合は、そのファイル名から導出します。
94
- 2. `--task <task-id>` がある場合は、`<stem> = <task-id>` とします。
95
- 3. task identity がない場合は、`<slug>-<UTC>-<rand>` のユニーク名を採番します。
112
+ - `exec run --register ... --resume` と schedule の executor 再開は、`runs/` 内の checkpoint を候補にするため旧 `exec/evidence/` の run を発見しません。schedule の通常実行・統合再開も、plan・result の通常の探索では旧配置を参照しません。保存済みイベントや checkpoint の明示的なパス参照を読む経路はありますが、旧配置を自動探索する互換機能ではありません。
113
+ - `dashboard build` の実行記録一覧と plan・result 件数には、旧配置の記録が含まれません。`exec archive` や task ID からの plan・result の取得も `runs/` のみを探索します。
114
+ - `register build` は個票とイベントから派生ビューを作り、旧記録の探索やリンクの移行はしません。個票にある既存リンクは元ファイルが残れば利用できますが、検査の成功によって補完・更新されることはありません。
96
115
 
97
- `<rand>` は4バイト(16進8桁)です。同じプロセス内で slug・UTC秒・乱数がすべて重複した場合は、`<rand>-1`、`<rand>-2` のように連番を加えます。plan path から stem を読む処理は stem 全体を連結キーとして扱うため、従来の16進4桁の名前と連番付きの名前をどちらも読み取れます。
116
+ 移行対象の run を完了または破棄し、対応する worktree を撤去してから、Git index に書き込める環境で移行します。プロセスを止めただけで worktree が残っている場合は、`--dry-run` でも項目 ID・worktree のパス・ブランチを示して処理前に停止します。進行中の run の移行と再開は対象外です。
98
117
 
99
- これにより、task 実行は固定名で扱い、schedule 非依存の実行は実行ごとの証跡を残せます。
118
+ ```bash
119
+ specdojo exec migrate-records --project <project-id> --dry-run
120
+ specdojo exec migrate-records --project <project-id>
121
+ ```
122
+
123
+ コマンドは移動先と参照の更新対象、対になる plan または result が欠けた記録を表示します。移動には `git mv` を使い、ログ本文と文書 ID を保持してパスの欄と旧形式の共通規約への相対参照を更新します。ルート相対パスの新形式は移動しても変更しません。移動先の衝突・追跡されていない移動元は処理前に拒否します。移行済みの状態で再実行すると移動は 0 件です。
124
+
125
+ checkpoint に同じ plan / result を参照する試行が複数ある場合、対は最新の checkpoint の run に置き、先行試行の evidence とログはそれぞれの run に残します。対応が特定できない記録は元の stem を run ID とし、欠けた記録を捏造しません。比較実験の `exec/trials/` は独立した保存形式のため移行対象から外します。通常の読み取りは `runs/` のみを対象にします。
100
126
 
101
127
  ### 2.4. deliverable指定の解決
102
128
 
@@ -141,16 +167,40 @@ plan の構造と生成規則は schema・本ガイド・各テンプレート
141
167
  | `mode: review` | `xrp-template.md` |
142
168
  | `approach` が指定済み | `xep-<approach>-template.md` |
143
169
 
170
+ 共通規約は `xp-common-conventions-template.md`(edit / review 共通)と、`mode` に対応する `xep-common-conventions-template.md`(edit 専用)または `xrp-common-conventions-template.md`(review 専用)を組み合わせます。接頭辞の `x` は exec、`p` は plan、`e` / `r` は edit / review を表します。各ファイルの `plan-essentials` マーカー間を plan の `_COMMON_CONVENTIONS_` 位置へ順に展開し、規約の詳細を読む案内には両ファイルのパスを載せます。マーカーのないローカル断片は全文を展開します。grade の plan はこれらの規約を使いません。
171
+
172
+ 保存する plan では、末尾に展開済みの共通規約を `` `共通規約 sha256:<内容のハッシュ>` `<リポジトリルートからのパス>` `` の形で記録します。パスは `docs/ja/projects/<project-id>/execution/conventions/<SHA-256>.txt` などで、Markdown リンクにはしません。規約本体は `<execution_path>/conventions/<SHA-256>.txt` に版ごとに一度だけ保存し、整形で内容が変わらないようプレーンテキストで保持します。版は mode・schema の解決後の本文(末尾の改行を含む)から計算します。規約本文の資源への参照はリポジトリ相対とし、別 checkout の同梱資源は package 内の相対パスにするため、端末の絶対パスで版が変わりません。agent と reporter へ渡す前に保存した版を復元するため、テンプレートの更新後や再開時も当時の規約が届きます。`exec run --plan` と `agent run --plan` も同じ読み取りを使います。参照先が欠けている場合やハッシュが一致しない場合は、版とパスを示すエラーで停止します。規約を埋め込んだ既存 plan と、末尾に `[共通規約 sha256:<内容のハッシュ>](<plan からの相対パス>)` を持つ旧形式もそのまま読めます。復元するのは末尾の独立した段落の参照だけで、個票から転記した本文やコードブロックの例は読み取りません。plan に指示を追記するときは、この参照より前に置いてください。別 checkout で使うときは規約ファイルも同じルート相対パスに引き継ぎます。旧形式の plan を移す場合は、plan からの相対参照を維持してください。
173
+
144
174
  `execution: human` のタスクに `exec plan` を実行するとエラーになります。human の確定手順は [Human Finalize 実行レシピ](../recipes/exec-human-finalize-recipe.md)、共通規約は [Human Finalize 実行標準](../standards/exec-human-finalize-standard.md)を正本とし、human result から参照します。
145
175
 
146
- `approach` が指定されていれば `xep-fully-guided-template.md`、`xep-recipe-guided-template.md`、`xep-freeform-template.md`、`xep-retrofit-template.md`、`xep-rulebook-maintenance-template.md` のような approach 別テンプレートを優先します。該当テンプレートが存在しない場合は標準テンプレートにフォールバックします。
176
+ `approach` が指定されていれば `xep-fully-guided-template.md`、`xep-condense-template.md`、`xep-recipe-guided-template.md`、`xep-freeform-template.md`、`xep-retrofit-template.md`、`xep-rulebook-maintenance-template.md` のような approach 別テンプレートを優先します。該当テンプレートが存在しない場合は標準テンプレートにフォールバックします。
147
177
 
148
178
  register のカタログなしの成果物 plan は、個票の `target_path`・`target_rulebook` または既存文書の索引と frontmatter から対象を解決します。カタログの `done_criteria` がないことを明記し、個票の完了条件と rulebook を使います。`bootstrap` は未作成 kata の ID・パスと参照宣言の指示、`finalize`・`bootstrap-finalize` は既存成果物の確認チェック表と確定対象を plan に載せます。実 agent は `status: ready` への昇格を行いません。対象と起票の条件は [[specdojo:command-reference]] を参照してください。
149
179
 
150
180
  `approach: retrofit` では、対象成果物の DCT エントリに宣言された `evidence_refs` を edit / review plan の「実装エビデンス」へ展開します。カタログ経由で `evidence_refs` がない場合は plan 生成をエラーにします。カタログなしでは実装の調査パスを個票に明記して調査入力とします。実装エビデンスは調査入力であり、frontmatter の `targets` には追加しません。実行者は実際に参照したパス、抽出した現在動作、成果物との一致・乖離、未確認範囲を result に記録します。
151
181
 
182
+ `draft`・`fully-guided`・`recipe-guided` の edit plan にも `evidence_refs` を読み取り専用で展開します。未指定・カタログなしでは「なし」と示し、生成を拒否しません。これらの plan の `depends_on` は、既存文書を wikilink、未作成文書をインラインコードと「未作成」で表示します。未作成の依存の内容は推測せず _TODO_ / _ASSUMPTION_ として残し、存在しないことだけを理由に実行を止めません。`condense` など他 approach と review の plan は従来のままです。
183
+
152
184
  実践の型の扱いは [実践の進め方ガイド](ryu-guide.md) を参照します。
153
185
 
186
+ ### condense の記録
187
+
188
+ `condense` は既存の 1 文書を対象とする edit で、標準フローでは磨き込みの後・review の前に置きます。plan は `xep-condense-template.md`、result は `xer-condense-template.md` を使います。判定基準は [[specdojo:pm-review-viewpoints]] の `vp-arc-conciseness` とし、判断に要る背景・制約・例外・完了条件と意味を維持します。
189
+
190
+ result の `specdojo.condense_records` は修正・保持の記録のリストです。候補がなければ `[]` とし、変更不要の理由を本文へ書きます。各要素は次の 5 項目を持ち、本文の「修正・保持の記録」の表と 1 対 1 に対応します。
191
+
192
+ | 項目 | 内容 |
193
+ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
194
+ | `location` | 修正前の成果物の見出し・行・引用 |
195
+ | `category` | `repetition`(繰り返し)、`table-prose`(表と本文)、`figure-prose`(図をなぞる文)、`unneeded-background`(不要な背景)、`canonical-restatement`(正本の再掲) |
196
+ | `action` | `delete`(削る)、`merge`(まとめる)、`reference`(参照)、`retain`(残す) |
197
+ | `reason` | 意味を保った根拠、または残した理由 |
198
+ | `cause` | `FindingCause`: `{"type":"document"}`、または `{"type":"kata","kind":"recipe","location":"根拠の箇所"}`。`kind` は rulebook / recipe / sample / template |
199
+
200
+ Kata が原因とするのは、宣言された Kata の箇所を示せる場合だけです。schema は `condense-records.schema.yaml` から共通の `finding-cause.schema.yaml` を参照します。pipeline executor は最終 evidence に `condense_records` を出し、runner が検証済みの同じリストを frontmatter と表へ転記します。reporter の要約によって省略・変更しません。executor が `condense_records` を出さない、または形式が正しくない場合は、reporter を起動せず executor の段の失敗として止めます([[specdojo:exec-config-guide]] の executor の報告の説明を参照)。通常の識別項目は scaffold と照合し、`condense_records` は記録用の可変項目として検証します。完了・block などの状態更新後も記録を保持します。
201
+
202
+ Kata の手入れ plan は成果物ごとの最新の完了済み `condense` result から Kata が原因の記録を展開します。成果物が宣言する rulebook から辿れる対象 Kata と原因の種類が一致する記録に限り、grade 由来とは出どころを区別します。
203
+
154
204
  ### 3.3. resultテンプレート
155
205
 
156
206
  result は実行記録です。agent では plan と対になり、human では作業指示も兼ねます。`claim` または `exec run` が scaffold 生成します。
@@ -172,7 +222,7 @@ result の `status` は、個々の実行試行がどの状態にあるかを表
172
222
  | `blocked` | 障害や未充足条件によって停止した試行 | 理由を解消して再開または再実行する |
173
223
  | `superseded` | 後続の新しい run に置き換えられ、破棄された先行の試行 | なし。履歴として保持し、再開対象にしない |
174
224
 
175
- runner は一意名の新しい result を scaffold するとき、同じ `task_id` を持つ先行 result のうち `in_progress` または `blocked` のものを `superseded` へ更新します。`completed_at` には後続 run の開始時刻を記録し、先行 result の `block_reason` は除去します。`complete` の result は完了記録として変更しません。固定名 result の再利用や、同じ run を続ける `exec resume` は新しい result を作らないため、この遷移の対象外です。
225
+ runner は一意名の新しい result を scaffold するとき、同じ `task_id` を持つ先行 result のうち `in_progress` または `blocked` のものを `superseded` へ更新します。`completed_at` には後続 run の開始時刻を記録し、先行 result の `block_reason` は除去します。`complete` の result は完了記録として変更しません。同じ run を続ける `exec resume` は新しい result を作らないため、この遷移の対象外です。
176
226
 
177
227
  `exec status` が表示・集計する Schedule の `doing` / `blocked` などは event log から導出するタスク状態であり、result の status とは別です。このため、履歴上の `superseded` result が実行中件数や対応待ちの blocked 件数へ加算されることはありません。
178
228
 
@@ -190,30 +240,17 @@ worktree を再利用する `exec resume` では、再開直前の worktree resu
190
240
 
191
241
  ### 4.1. アーカイブ
192
242
 
193
- 完了後の plan は `exec/plans/done/` へ移動できます。
243
+ `exec archive` は完了した plan を同じ run ディレクトリに保持します。`exec complete`、`exec run --track-state` の成功時、`--archive-on-success` でも保存先は変わりません。
194
244
 
195
245
  ```bash
196
246
  specdojo exec archive --project <project-id> --task <task-id>
197
247
  ```
198
248
 
199
- | ケース | アーカイブ |
200
- | ------------------------------- | --------------------------------- |
201
- | `exec complete` | 対象 plan を自動移動する |
202
- | `exec run --track-state` 成功時 | 対象 plan を自動移動する |
203
- | 軽量実行(状態追跡なし) | `exec archive` で明示的に移動する |
204
- | `exec run --archive-on-success` | 成功時に移動する |
205
-
206
- 固定名 plan を `done/` へ移動する場合は、UTC タイムスタンプと4バイトの乱数を付けます。同じ名前が既にある場合は、既存ファイルを上書きせず末尾に連番を加えます。
207
-
208
- ```text
209
- exec/plans/done/<slug>-<UTC>-<rand>[-<sequence>]-plan.md
210
- ```
211
-
212
- 不要な plan は `done/` へ移動せず削除してもかまいません。plan は catalog と schedule から再生成でき、result が記録として残るためです。
249
+ 不要な plan は `--delete` で削除できます。result は実行記録として残ります。
213
250
 
214
251
  ### 4.2. 再実行
215
252
 
216
- 完了済み task を軽くやり直す場合は、固定名 plan / result を再生成してカレントリポジトリで実行します。
253
+ 完了済み task をやり直す場合は、新しい run の plan / result を生成してカレントリポジトリで実行します。
217
254
 
218
255
  ```bash
219
256
  specdojo exec run --project <project-id> --task <task-id>
@@ -229,4 +266,4 @@ specdojo exec run --project <project-id> --task <task-id>
229
266
  specdojo exec complete --project <project-id> --task <task-id> --by <actor> --msg "rerun done"
230
267
  ```
231
268
 
232
- `reopen` は完了済み plan を `done/` から戻さず、固定名 result の内容も変更しません。次の `exec plan` / `exec run` で新しい固定名 plan を生成し、再 claim 時に既存 result の `status` を `in_progress`、`started_at` と `agent` を新しい試行の値へ更新し、`completed_at` と `block_reason` を除去します。result 本文は前回の記録を引き継ぎ、過去の完了状態は Git 履歴と `complete` / `reopen` event で追跡します。
269
+ `reopen` は過去 run の plan / result を変更しません。次の `exec plan` / `exec run` は新しい run を作り、過去の完了状態は保存した記録と `complete` / `reopen` event で追跡します。同じ run の続きは `exec resume` で再開します。
@@ -0,0 +1,381 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:project-move-guide
4
+ type: guide
5
+ status: draft
6
+ based_on:
7
+ - specdojo:specdojo-overview-guide
8
+ - specdojo:specdojo-config-reference
9
+ - specdojo:branch-workflow-guide
10
+ - specdojo:id-and-file-naming-standard
11
+ ---
12
+
13
+ # プロジェクト移行ガイド
14
+
15
+ Project Move Guide
16
+
17
+ 同一リポジトリで管理していた SpecDojo プロジェクト(`prj-xxxx`)を、独立した管理用リポジトリ(別リポジトリ構成)へ安全に切り出して移す手順を説明します。
18
+
19
+ **対象読者**
20
+
21
+ - 同一リポジトリで運用していた project を、独立した管理用リポジトリ(別リポジトリ構成)へ切り出したい開発者、リポジトリ管理者、運用者
22
+
23
+ **この文書で分かること**
24
+
25
+ - `git subtree split` による履歴の切り出し、Kata の npm パッケージ版固定、設定の移行と元リポジトリからの削除、`external_projects` による相互起票連携、文書サイトからの除外手順、および取り返しのつかない操作の前の確認ポイントと戻し方
26
+
27
+ **次に読む文書**
28
+
29
+ - 設定項目の詳細は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] を参照してください。
30
+ - ブランチ構成や Git 操作の標準は [[specdojo:branch-workflow-guide|ブランチワークフローガイド]] を参照してください。
31
+ - プロジェクトとプロダクトの構成原則は [[specdojo:specdojo-overview-guide|全体概要ガイド]] を参照してください。
32
+
33
+ ## 1. 移行の概要と基本方針
34
+
35
+ ### 1.1. 背景と目的
36
+
37
+ SpecDojo では、同一リポジトリ内でプロダクトコードと複数のプロジェクト(`prj-xxxx`)を管理する同一リポジトリ構成と、プロジェクト管理文書(登録簿・計画・実行記録)を独立した専用リポジトリに置く別リポジトリ構成を選択できます。
38
+
39
+ 初期段階では手軽な同一リポジトリ構成で開始しても、プロジェクトの成長に伴い「プロダクトの変更履歴と管理作業の記帳 commit を分離したい」「管理リポジトリを独立させて権限や CI 実行環境を切り離したい」という要求が生じます。
40
+
41
+ 本ガイドでは、同一リポジトリ内の `prj-0002`(例: LP 管理)を別リポジトリ(例: `../specdojo-lp-specdojo`)へ移すシナリオを例として、安全に段階的に移行する標準手順を示します。説明中のパスやリポジトリ名は例示であり、実際のリポジトリは変更しません。
42
+
43
+ ### 1.2. 移行の全体フロー
44
+
45
+ 移行は以下の 5 つのステップで進めます。
46
+
47
+ ```mermaid
48
+ flowchart TD
49
+ A["事前準備<br/>クリーン状態確認とバックアップ"] --> B["1. 履歴の切り出し<br/>git subtree split で base_path を抽出"]
50
+ B --> C["2. Kataの版固定<br/>新リポジトリで npm package を参照"]
51
+ C --> D["3. 設定の写しと動作点検<br/>specdojo.config.json 等を配置・点検"]
52
+ D --> E["取り返しのつかない操作の確認<br/>元リポジトリから対象を削除"]
53
+ E --> F["4. 外部起票の宣言<br/>external_projects で相互参照を設定"]
54
+ F --> G["5. 文書サイトからの除外<br/>元サイトのサイドバー・リンク点検"]
55
+ ```
56
+
57
+ ### 1.3. ID と commit Refs の継続性
58
+
59
+ SpecDojo のドキュメント ID、登録簿項目 ID(`PJR-xxxx`)、コミットメッセージ末尾の `Refs: <project-id>:<ID>` は、プロジェクト ID(`prj-0002`)を変更しなければ、別リポジトリへ移した後もそのまま使い続けられます。
60
+
61
+ 移行時はプロジェクト ID を維持します。ただし、`git subtree split` が作るコミットの SHA は元のコミットと異なります。SHA を直接指すリンクの参照先として元リポジトリを残し、移行元の先端 SHA と切り出した先端 SHA を移行記録に残してください。
62
+
63
+ ### 1.4. 安全原則と取り返しのつかない操作の防止
64
+
65
+ - **共有履歴の書き換え禁止**: 元リポジトリの共有ブランチ(`main` や `develop`)の履歴を改変する操作(`git filter-branch` や強制プッシュを伴う履歴改変)は行いません。`git subtree split` を用いて対象ディレクトリの履歴だけを新ブランチとして抽出します。
66
+ - **削除前の確実な点検**: 元リポジトリから `base_path` や設定を削除する操作は元に戻すのに労力を要します。必ず新リポジトリ側での動作確認を完了してから削除を実行します。
67
+
68
+ ## 2. 手順1: 履歴の切り出し (`git subtree split`)
69
+
70
+ 対象プロジェクトの `base_path`(例: `docs/ja/projects/prj-0002`)のコミット履歴だけを抽出し、新リポジトリの初期履歴として取り込みます。
71
+
72
+ ### 2.1. 前提
73
+
74
+ - 元リポジトリの作業ツリーがクリーンであること(`git status --short` が空)。
75
+ - 移行対象ブランチ(例: `main`)に、移行対象のすべてのコミットがマージされていること。
76
+ - 対象 project の実行中・waiting の登録項目、doing の schedule タスク、exec の worktree・ブランチを確認し、実行や定期起動を止め、未統合の変更を取り込んでいること。`git worktree list` と `git branch --list 'exec/prj-0002-*'` で残存を確認します。
77
+ - 以下のシェル例は Bash で実行し、`../specdojo` が元リポジトリを指す配置であること。新リポジトリのディレクトリと `split-prj-0002` ブランチがまだ存在しないこと。
78
+ - 万一に備え、元リポジトリで移行前の状態にバックアップタグを作成していること。
79
+
80
+ ```bash
81
+ git tag backup-prj-0002-before-move
82
+ git rev-parse HEAD
83
+ ```
84
+
85
+ ### 2.2. 実行するコマンド
86
+
87
+ #### 2.2.1. 元リポジトリで履歴を切り出す
88
+
89
+ 対象 `base_path` の履歴を新しい一時ブランチ(`split-prj-0002`)へ抽出します。
90
+
91
+ ```bash
92
+ git subtree split --prefix=docs/ja/projects/prj-0002 -b split-prj-0002
93
+ git rev-parse split-prj-0002
94
+ ```
95
+
96
+ #### 2.2.2. 新しい管理用リポジトリを作る
97
+
98
+ ```bash
99
+ mkdir ../specdojo-lp-specdojo
100
+ cd ../specdojo-lp-specdojo
101
+ git init -b main
102
+ ```
103
+
104
+ #### 2.2.3. 切り出した履歴を取り込む
105
+
106
+ ```bash
107
+ git fetch ../specdojo split-prj-0002
108
+ git merge --ff-only FETCH_HEAD
109
+ ```
110
+
111
+ #### 2.2.4. 元と同じディレクトリ構造へ再配置する
112
+
113
+ 抽出直後は旧 `base_path` のファイル群がルートに展開されています。ルートに `move-prj-0002` が存在しないことを確認し、一時ディレクトリを経由して移します。追跡ファイル名は NUL 区切りで読み、空白やドットで始まる名前も保持します。
114
+
115
+ ```bash
116
+ mapfile -d '' -t project_files < <(git ls-tree -z --name-only HEAD)
117
+ mkdir move-prj-0002
118
+ git mv -- "${project_files[@]}" move-prj-0002/
119
+ mkdir -p docs/ja/projects
120
+ git mv move-prj-0002 docs/ja/projects/prj-0002
121
+ git diff --cached --stat
122
+ git commit -m "chore(prj-0002): relocate project root under docs/ja/projects/prj-0002"
123
+ ```
124
+
125
+ ### 2.3. 確かめ方
126
+
127
+ - 新リポジトリ側で `git log --oneline` を実行し、`prj-0002` に関連するコミット履歴だけが正しく引き継がれていることを確認します。
128
+ - 元リポジトリで `git rev-parse backup-prj-0002-before-move:docs/ja/projects/prj-0002`、新リポジトリで `git rev-parse HEAD:docs/ja/projects/prj-0002` を実行し、ツリーの SHA が一致することを確認します。
129
+ - 元リポジトリ側で `git status` および `git log` を確認し、既存のブランチ履歴が一切変更されていないことを確認します。
130
+
131
+ ### 2.4. 戻し方
132
+
133
+ - 元リポジトリの共有履歴は変わりません。新リポジトリへの追加作業がなければ、移行用に作成したディレクトリを退避してやり直せます。
134
+ - 一時ブランチは点検が終わるまで残します。削除する場合は対象名と、他の作業で使われていないことを確認します。
135
+
136
+ ## 3. 手順2: Kata の版の固定 (npm パッケージ参照)
137
+
138
+ 新リポジトリでは Kata(型)の文書群をリポジトリ内に複製せず、npm パッケージ `specdojo` から参照してバージョンを固定します。
139
+
140
+ ### 3.1. 前提
141
+
142
+ - Node.js(`>=22.13`)および npm が利用可能な環境であること。
143
+ - 新リポジトリで手順 1 の取り込みが完了していること。
144
+
145
+ ### 3.2. 実行するコマンド
146
+
147
+ #### 3.2.1. 新リポジトリのルートで npm を初期化する
148
+
149
+ 手順 1 の終了位置(新リポジトリのルート)で実行します。
150
+
151
+ ```bash
152
+ npm init -y
153
+ ```
154
+
155
+ #### 3.2.2. SpecDojo の版を固定する
156
+
157
+ 移行元で利用している版を指定します。以下は `0.7.0` の例です。
158
+
159
+ ```bash
160
+ npm install --save-dev --save-exact specdojo@0.7.0
161
+ ```
162
+
163
+ `package.json` の値が `^` や `~` を含まないことを確認し、`package-lock.json` とともに管理します。以後の再現には `npm ci` を使います。`specdojo:` の Kata は npm パッケージから解決されるため、旧リポジトリの同梱 Kata をコピーしません。`npx specdojo kata list --kind rulebook` の `SOURCE` が `node_modules` を指すことと、`npx specdojo kata show specdojo:pjr-rulebook` で本文を取得できることを確認します。独自の Kata がある場合は別途移し、既存の authority と ID を維持します。
164
+
165
+ #### 3.2.3. CLI のスクリプトを追加する
166
+
167
+ `package.json` の既存キーを保持し、次のスクリプトを追加します。
168
+
169
+ ```json
170
+ {
171
+ "scripts": {
172
+ "specdojo": "specdojo"
173
+ }
174
+ }
175
+ ```
176
+
177
+ ### 3.3. 確かめ方
178
+
179
+ - `npx specdojo --version` を実行し、指定した固定バージョン(例: `0.7.0`)が出力されることを確認します。
180
+ - `npx specdojo help` で CLI コマンド一覧が正常に表示されることを確認します。
181
+
182
+ ### 3.4. 戻し方
183
+
184
+ - インストールに関する変更だけを取り消します。既存の `package.json` がある場合はファイル全体を削除せず、移行前の依存定義へ戻して `npm ci` で復元します。
185
+
186
+ ## 4. 手順3: 設定の写しと元からの削除
187
+
188
+ プロジェクト固有の設定ファイル(`specdojo.config.json`、名簿、`exec-defaults.yaml` 等)を新リポジトリへ配置し、手動点検を行った後、元リポジトリから対象プロジェクトを削除します。
189
+
190
+ ### 4.1. 前提
191
+
192
+ - 手順 1 および手順 2 が正常に完了していること。
193
+ - 新リポジトリで `node_modules` の導入が完了していること。
194
+
195
+ ### 4.2. 取り返しのつかない操作の前の確認
196
+
197
+ 元リポジトリから `docs/ja/projects/prj-0002` や設定を削除する前に、必ず新リポジトリ側で設定の認識と登録簿の読み込みができることを点検します。
198
+
199
+ > [!IMPORTANT]
200
+ > 読むだけの点検機能(PJR-9XEG)は現在準備中であるため、用意されたら移行前後の点検に利用します。現時点では本章の「確かめ方」と手順 1 の実行・worktree の点検を手動で行います。
201
+
202
+ ### 4.3. 実行するコマンド
203
+
204
+ #### 4.3.1. 設定を配置する
205
+
206
+ 新リポジトリのルートで `.specdojo/` を作成します。
207
+
208
+ ```bash
209
+ mkdir -p .specdojo
210
+ ```
211
+
212
+ 元の `.specdojo/specdojo.config.json` の `projects.prj-0002` を、新しい `.specdojo/specdojo.config.json` に写し、`current_project` を `prj-0002` にします。以下は構成例です。実際には移行元の任意キーを含めて保持してください。
213
+
214
+ ```json
215
+ {
216
+ "version": 1,
217
+ "current_project": "prj-0002",
218
+ "projects": {
219
+ "prj-0002": {
220
+ "base_path": "docs/ja/projects/prj-0002",
221
+ "catalog_path": "010-deliverables-catalog",
222
+ "schedule_path": "schedule",
223
+ "execution_path": "execution",
224
+ "members_path": "030-project-management/pm-members.yaml",
225
+ "roles_path": "030-project-management/pm-roles.yaml",
226
+ "viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
227
+ "project_register_path": "controls/project-register",
228
+ "routines_path": "routines",
229
+ "jobs_path": "jobs",
230
+ "project_context": ["prj-overview"],
231
+ "run": {
232
+ "register_date_timezone": "Asia/Tokyo",
233
+ "exec_defaults": ".specdojo/exec-defaults.yaml"
234
+ }
235
+ }
236
+ }
237
+ }
238
+ ```
239
+
240
+ 元リポジトリから、`agent_members_path`(既定 `.specdojo/agent-members.yaml`)、`run.exec_defaults` のファイル、Markdown の検査設定を写します。project 配下の人間の名簿は手順 1 に含まれます。agent の別名と owner の解決を確認し、`repos[].path`・`run.*` のリポジトリルート基準のパス、統合先ブランチ、provider のコマンド、親検証の npm scripts を新しい配置へ合わせます。元の設定をそのまま使って存在しない検査やパスを指さないようにしてください。
241
+
242
+ `node_modules/` と生成物を commit に含めないため、配置した設定を使って除外ルールを確認・補完します。
243
+
244
+ ```bash
245
+ npx specdojo config init --dry-run
246
+ npx specdojo config init
247
+ git status --short
248
+ git add .specdojo package.json package-lock.json .gitignore
249
+ git commit -m "chore(prj-0002): configure specdojo settings and defaults"
250
+ ```
251
+
252
+ 検査設定や独自 Kata を移した場合は、それらも確認して個別に追加します。
253
+
254
+ #### 4.3.2. 点検後に元から外す
255
+
256
+ 「4.4. 確かめ方」の新リポジトリ側の点検がすべて通ってから実施します。
257
+
258
+ 元リポジトリ(`specdojo`)で:
259
+
260
+ - `.specdojo/specdojo.config.json` の `projects` から `prj-0002` の定義を削除します(もし `current_project` が `prj-0002` を指していれば残る project ID へ変更します)。
261
+ - 名簿や exec-defaults のうち、移行した project 専用で他に参照がない項目・ファイルを外します。他の project と共有する定義は残します。定期起動の設定も新しい管理先へ切り替えます。
262
+ - 元リポジトリの Git から `docs/ja/projects/prj-0002` を削除してコミットします。
263
+
264
+ ```bash
265
+ cd ../specdojo
266
+ git rm -r docs/ja/projects/prj-0002
267
+ git add .specdojo
268
+ git diff --cached --stat
269
+ git commit -m "chore(prj-0002): remove project files moved to separate repository"
270
+ ```
271
+
272
+ ### 4.4. 確かめ方
273
+
274
+ - 新リポジトリで `npx specdojo project list` を実行し、`prj-0002` の配置が正しく認識されることを確認します。
275
+ - `npx specdojo register history --project prj-0002 --limit 10` で既存 event を読めることを確認します。登録簿の個票・event の件数と ID、実行記録を元のコピーと照合します。
276
+ - `npx specdojo register build --project prj-0002` と `npx specdojo dashboard build --project prj-0002` を実行し、一覧とダッシュボードが生成されることを確認します。これらは生成物を書き込む検証です。
277
+ - 元から外した後、元リポジトリで `npx specdojo project list` と `git status` を確認し、残る project が認識され、削除対象が意図どおりであることを確認します。
278
+
279
+ ### 4.5. 戻し方
280
+
281
+ - 両側の起動を止め、元リポジトリの削除と設定変更を含むコミットを特定して `git revert <削除コミットのSHA>` で打ち消します。新しい起票や実行がある場合は先に差分を保全・照合し、二重運用を避けます。
282
+
283
+ ## 5. 手順4: 相互起票のための `external_projects` 宣言
284
+
285
+ リポジトリを分離した後も、元リポジトリから新リポジトリへ、また新リポジトリから元リポジトリへ相互に起票できるよう、双方の `specdojo.config.json` に `external_projects` を宣言します。
286
+
287
+ ### 5.1. 前提
288
+
289
+ - 双方のリポジトリの相対パスが決まっていること(例: 同一階層の `../specdojo-lp-specdojo` と `../specdojo`)。
290
+ - 相手のリポジトリに SpecDojo 0.4.2 以上が導入されていること。
291
+
292
+ ### 5.2. 実行するコマンド
293
+
294
+ #### 5.2.1. 元から新しい管理先を宣言する
295
+
296
+ 元リポジトリの `.specdojo/specdojo.config.json` のトップレベルへ次のキーを追加します。以下の JSON は既存の `projects` を保持して追加する部分だけを示します。
297
+
298
+ ```json
299
+ {
300
+ "external_projects": {
301
+ "specdojo-lp": {
302
+ "path": "../specdojo-lp-specdojo",
303
+ "project_id": "prj-0002"
304
+ }
305
+ }
306
+ }
307
+ ```
308
+
309
+ #### 5.2.2. 新しい管理先から元を宣言する
310
+
311
+ 新リポジトリの `.specdojo/specdojo.config.json` のトップレベルへ追加します。
312
+
313
+ ```json
314
+ {
315
+ "external_projects": {
316
+ "specdojo-core": {
317
+ "path": "../specdojo",
318
+ "project_id": "prj-0001"
319
+ }
320
+ }
321
+ }
322
+ ```
323
+
324
+ ### 5.3. 確かめ方
325
+
326
+ 設定の変更を各リポジトリで確認・commit し、双方の作業ツリーがクリーンで、project の統合先ブランチが存在することを確認します。元リポジトリ側で、書き込みをしない起票確認を行います。外部起票には `--commit` が必須ですが、`--dry-run` を併用すると書き込み・commit を行いません。
327
+
328
+ ```bash
329
+ npx specdojo register add --project specdojo-lp --type note --title "外部起票の接続テスト" --topic external-move-check --commit --dry-run
330
+ ```
331
+
332
+ 新リポジトリ側でも `--project specdojo-core` で同じ確認を行います。出力の project ID と個票の配置先が相手を指し、双方の `git status --short` が変わらないことを確認します。`--dry-run` を外すと相手側で commit されるため、試験チケットの追加・削除を点検手段にしません。相手が SpecDojo 本体の場合は npm 依存の CLI がなくても `dist/specdojo.js` から起動できるため、元で `npm run build` を済ませます。
333
+
334
+ ### 5.4. 戻し方
335
+
336
+ - 双方の `.specdojo/specdojo.config.json` の `external_projects` から追加した別名だけを削除します。
337
+
338
+ ## 6. 手順5: 元のリポジトリの文書サイトから外す
339
+
340
+ 元リポジトリのドキュメントサイト(VitePress)から移行したプロジェクトを除外し、リンク切れやビルド失敗を防ぎます。
341
+
342
+ ### 6.1. 前提
343
+
344
+ - 元リポジトリから `docs/ja/projects/prj-0002` の削除が完了していること。
345
+
346
+ ### 6.2. 実行するコマンドと確認
347
+
348
+ #### 6.2.1. サイドバーを確認する
349
+
350
+ このリポジトリの文書サイトは `docs/ja/projects/` 配下からサイドバーを生成するため、ディレクトリ削除で表示対象から外れます。固定メニュー(`sidebar-config.ts` や `config.mts`)、トップページ、生成済みページにも参照があれば取り除きます。
351
+
352
+ #### 6.2.2. 双方向のリンクを点検する
353
+
354
+ 元の文書から `prj-0002` への参照と、移した文書から元に残った文書への参照の両方を点検します。`external_projects` の宣言だけでは wikilink は解決されません。
355
+
356
+ > [!NOTE]
357
+ > リポジトリをまたぐリンクの標準的な書き方(PJR-66ER)は現在準備中であるため、用意されたらその記法に従います。現時点では `rg` で検索し、移行で解決不能になる wikilink を、相手の文書への実在する完全 URL に置き換えます。URL が未確定なら文書 ID をインラインコードで残して移行記録へ記載し、切替前に参照先を確認します。
358
+
359
+ ```bash
360
+ # 元リポジトリで実行(終了コード 1 は一致なし)
361
+ rg -n 'prj-0002:|/projects/prj-0002/' docs packages/docs-site
362
+ # 新リポジトリで実行(元に prj-0001 が残る例)
363
+ rg -n 'prj-0001:|/projects/prj-0001/' docs
364
+ ```
365
+
366
+ #### 6.2.3. 文書サイトを検証する
367
+
368
+ 元リポジトリで実行し、リンク切れエラーなく成功することを確認します。
369
+
370
+ ```bash
371
+ npm run docs:build
372
+ ```
373
+
374
+ ### 6.3. 確かめ方
375
+
376
+ - `npm run docs:dev` でローカルサーバーを起動し、ブラウザでサイドバーから `prj-0002` が除外されていることを確認します。
377
+ - `npm run docs:build` がエラー終了せず正常に完了することを確認します。
378
+
379
+ ### 6.4. 戻し方
380
+
381
+ - サイドバー設定やリンクの変更を取り消し、必要に応じて元ファイルを復元します。