specdojo 0.4.7 → 0.5.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 (267) hide show
  1. package/.github/agents/specdojo-orchestrator.md +14 -9
  2. package/CHANGELOG.md +46 -0
  3. package/dist/commands/init.js +3 -0
  4. package/dist/commands/night-orchestrator.js +33 -4
  5. package/dist/dashboard/dashboard.js +5 -6
  6. package/dist/dashboard/timeline-build.js +5 -1
  7. package/dist/dashboard/timeline.js +6 -3
  8. package/dist/docs/yaml-pages.js +17 -17
  9. package/dist/exec/core.js +2 -0
  10. package/dist/exec/pipeline-state.js +5 -2
  11. package/dist/exec/plans-core.js +3 -2
  12. package/dist/exec/plans-generation.js +9 -5
  13. package/dist/exec/plans-grade-findings.js +16 -0
  14. package/dist/exec/plans-planning.js +43 -0
  15. package/dist/exec/plans-storage.js +5 -2
  16. package/dist/exec/register.js +16 -1
  17. package/dist/exec/repo-integration-sync.js +9 -0
  18. package/dist/exec/repo-integration.js +17 -2
  19. package/dist/exec/repo-trace.js +17 -4
  20. package/dist/exec/results.js +2 -0
  21. package/dist/exec/run/register-core.js +11 -0
  22. package/dist/exec/run/register-mode.js +19 -1
  23. package/dist/exec/run/register-resume.js +22 -0
  24. package/dist/exec/run/register-worktree.js +23 -0
  25. package/dist/exec/strategy.js +2 -0
  26. package/dist/exec/task-repos.js +18 -4
  27. package/dist/exec/worktree-ops-commit.js +7 -1
  28. package/dist/grade/apply.js +6 -2
  29. package/dist/grade/markdown.js +7 -2
  30. package/dist/grade/plan.js +6 -4
  31. package/dist/register/approach.js +19 -0
  32. package/dist/register/catalog-status.js +49 -0
  33. package/dist/register/core.js +3 -0
  34. package/dist/register/create-commands.js +34 -4
  35. package/dist/register/dependency.js +123 -0
  36. package/dist/register/derivation.js +2 -2
  37. package/dist/register/epic.js +42 -0
  38. package/dist/register/event-merge.js +5 -2
  39. package/dist/register/events.js +4 -0
  40. package/dist/register/external-project.js +4 -0
  41. package/dist/register/item.js +10 -0
  42. package/dist/register/maintenance-commands.js +7 -1
  43. package/dist/register/planning.js +37 -0
  44. package/dist/register/register.js +5 -1
  45. package/dist/register/renumber.js +12 -4
  46. package/dist/register/views.js +55 -4
  47. package/dist/schedule/schedule.js +3 -1
  48. package/dist/schedule/strategy-generate-scope.js +5 -1
  49. package/dist/schedule/strategy-generate.js +1 -0
  50. package/dist/schedule/strategy-profiles.js +1 -1
  51. package/dist/shared/agent-types.js +3 -0
  52. package/dist/shared/grade-result.js +23 -5
  53. package/dist/shared/markdownlint-config.js +38 -0
  54. package/dist/shared/markdownlint-scaffold.js +2 -9
  55. package/dist/shared/specdojo-config.js +10 -3
  56. package/dist/shared/specdojo-gitignore.js +4 -0
  57. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  58. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  59. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  60. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  61. package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
  62. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  63. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  64. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  65. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
  66. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  67. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  68. package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
  69. package/docs/ja/specdojo/references/command-reference.md +42 -4
  70. package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
  71. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  72. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  73. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  74. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  75. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  76. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  77. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  78. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  79. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  80. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  81. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  82. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  83. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  84. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  85. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  86. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  87. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  88. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  89. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  90. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  91. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  92. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  93. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  94. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  95. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  96. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  97. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
  98. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  99. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  101. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  104. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  105. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  106. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  107. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  108. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  109. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  116. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  117. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  118. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  120. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  121. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  122. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  123. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  124. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  125. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  126. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  127. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  128. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  129. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  130. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  131. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  134. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  135. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  136. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +50 -36
  137. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  138. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  139. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  140. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  148. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  150. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  151. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  152. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  153. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  154. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  155. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  156. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  157. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
  158. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  159. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  160. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  161. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  165. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  167. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  168. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  173. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  174. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  176. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  178. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  179. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  180. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  181. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  182. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  183. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  184. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  185. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  186. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  187. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  188. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  189. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  190. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  191. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  192. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  193. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  195. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  196. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  197. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  198. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  199. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  200. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  201. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  202. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  203. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  204. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  205. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  206. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  207. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  208. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  212. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  227. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  232. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  234. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  235. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  236. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  237. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  238. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  241. package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
  242. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  243. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
  244. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  245. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  246. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  247. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  248. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  249. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  250. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  251. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  252. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
  253. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  254. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  255. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  256. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  257. package/docs/specdojo/schemas/v1/register-events.schema.yaml +18 -0
  258. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
  259. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  260. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
  261. package/package.json +2 -2
  262. package/templates/antigravity/orchestrator.md +14 -9
  263. package/templates/claude/agents/specdojo-orchestrator.md +14 -9
  264. package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
  265. package/templates/codex/orchestrator.md +14 -9
  266. package/templates/copilot/README.md +2 -1
  267. package/templates/opencode/agents/specdojo-orchestrator.md +14 -9
@@ -149,9 +149,9 @@ function markdownLink(label, fromDirectory, targetPath) {
149
149
  const href = path.startsWith(".") ? path : `./${path}`;
150
150
  return `[${toCell(label)}](${href})`;
151
151
  }
152
- function generateDerivedItemsFile(paths, items) {
152
+ function generateDerivedItemsFile(paths, items, relationField = "derivedFrom") {
153
153
  const sourceDocs = new Map(items.flatMap((view) => (view.ticketPath ? [[view.id, view.ticketPath]] : [])));
154
- const rows = collectDerivedRegisterRelations(paths, items).map((relation) => {
154
+ const rows = collectDerivedRegisterRelations(paths, items, relationField).map((relation) => {
155
155
  const sourcePath = sourceDocs.get(relation.sourceId);
156
156
  const sourceCell = sourcePath
157
157
  ? markdownLink(relation.sourceId, paths.generatedPath, sourcePath)
@@ -172,11 +172,15 @@ function generateDerivedItemsFile(paths, items) {
172
172
  });
173
173
  const table = [
174
174
  "<!-- prettier-ignore -->",
175
- "| 元の項目 | 派生先 | 分類 | ステータス | タイトル |",
175
+ relationField === "dependsOn"
176
+ ? "| 先行項目 | 後続項目 | 分類 | ステータス | タイトル |"
177
+ : "| 元の項目 | 派生先 | 分類 | ステータス | タイトル |",
176
178
  "| --- | --- | --- | --- | --- |",
177
179
  ...rows,
178
180
  ].join("\n");
179
- const template = loadViewTemplate("pjr-derived-items-template.md", paths.projectId);
181
+ const template = loadViewTemplate(relationField === "dependsOn"
182
+ ? "pjr-dependent-items-template.md"
183
+ : "pjr-derived-items-template.md", paths.projectId);
180
184
  return injectViewSlots(template, { "derived-items": table });
181
185
  }
182
186
  function generateTypeFilterView(items, type, templateFileName, projectId, heading) {
@@ -186,6 +190,47 @@ function generateTypeFilterView(items, type, templateFileName, projectId, headin
186
190
  table: ["<!-- prettier-ignore -->", makeTable(filtered, heading)].join("\n"),
187
191
  });
188
192
  }
193
+ function generateEpicItemsFile(paths, items) {
194
+ const relations = collectDerivedRegisterRelations(paths, items);
195
+ const groups = items
196
+ .filter((view) => view.item.type === "epic")
197
+ .map((epic, index) => {
198
+ const label = epic.ticketPath
199
+ ? markdownLink(epic.id, paths.generatedPath, epic.ticketPath)
200
+ : epic.id;
201
+ const children = relations.filter((relation) => relation.sourceId === epic.id);
202
+ const rows = children.map((child) => {
203
+ const id = child.derivedProjectId === paths.projectId
204
+ ? child.derivedItem.id
205
+ : `${child.derivedProjectId}:${child.derivedItem.id}`;
206
+ return `| ${[
207
+ markdownLink(id, paths.generatedPath, child.derivedTicketPath),
208
+ child.derivedItem.type,
209
+ child.derivedItem.status,
210
+ child.derivedItem.title,
211
+ ]
212
+ .map(toCell)
213
+ .join(" | ")} |`;
214
+ });
215
+ return [
216
+ `### 1.${index + 1}. ${label} ${toCell(epic.item.title)}`,
217
+ "",
218
+ `track: ${toCell(epic.item.track ?? "-")} / ステータス: ${toCell(epic.item.status)}`,
219
+ "",
220
+ ...(rows.length === 0
221
+ ? ["子項目なし"]
222
+ : [
223
+ "<!-- prettier-ignore -->",
224
+ "| 子項目 | 分類 | ステータス | タイトル |",
225
+ "| --- | --- | --- | --- |",
226
+ ...rows,
227
+ ]),
228
+ ].join("\n");
229
+ });
230
+ return injectViewSlots(loadViewTemplate("pjr-epic-items-template.md", paths.projectId), {
231
+ "epic-items": groups.join("\n\n") || "該当なし",
232
+ });
233
+ }
189
234
  export const VALID_BUILD_SCOPES = ["register", "controls", "all"];
190
235
  export function generateDerivedViewFiles(paths, scope) {
191
236
  // 項目の値は個票 frontmatter(正本)から集める。列見出しは template から採用するため、
@@ -220,6 +265,12 @@ export function generateDerivedViewFiles(paths, scope) {
220
265
  }, {
221
266
  path: join(paths.generatedPath, "pjr-derived-items.md"),
222
267
  content: generateDerivedItemsFile(paths, itemViews),
268
+ }, {
269
+ path: join(paths.generatedPath, "pjr-dependent-items.md"),
270
+ content: generateDerivedItemsFile(paths, itemViews, "dependsOn"),
271
+ }, {
272
+ path: join(paths.generatedPath, "pjr-epic-items.md"),
273
+ content: generateEpicItemsFile(paths, itemViews),
223
274
  });
224
275
  }
225
276
  if (scope === "controls" || scope === "all") {
@@ -1,7 +1,7 @@
1
1
  import { dirname, join, relative, resolve, sep } from "node:path";
2
2
  import { existsSync, readdirSync, writeFileSync } from "node:fs";
3
3
  import { dump } from "../shared/yaml.js";
4
- import { getProjectCatalogPath, getProjectRolesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
4
+ import { getProjectCatalogPath, getProjectRolesPath, getProjectSchedulePath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
5
5
  import { buildScheduleTrack, } from "./build.js";
6
6
  import { readYaml } from "../shared/fs.js";
7
7
  import { resolveSpecdojoPath } from "../docs/template-resolution.js";
@@ -255,11 +255,13 @@ function registerScheduleStrategyCommands(sch) {
255
255
  if (!context.catalogPath) {
256
256
  throw new Error(`catalog_path not set for project '${context.projectId}'.`);
257
257
  }
258
+ const registerPath = getProjectRegisterPath(context.project);
258
259
  const result = generateStrategy({
259
260
  repoRoot: context.baseDir,
260
261
  schedulePath: context.schedulePath,
261
262
  catalogPath: context.catalogPath,
262
263
  timelinePath: context.timelinePath,
264
+ ...(registerPath ? { registerPath: resolve(context.baseDir, registerPath) } : {}),
263
265
  ...(context.rolesPath ? { rolesPath: context.rolesPath } : {}),
264
266
  projectId: context.projectId,
265
267
  track,
@@ -5,6 +5,7 @@ import { resolveBasePath } from "../catalog/paths.js";
5
5
  import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
6
6
  import { readYaml } from "../shared/fs.js";
7
7
  import { loadTimelineIndex } from "../shared/timeline-index.js";
8
+ import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
8
9
  export function isRecord(value) {
9
10
  return typeof value === "object" && value !== null && !Array.isArray(value);
10
11
  }
@@ -44,6 +45,9 @@ export function resolveTrackScopeCatalogs(opts) {
44
45
  const indexFile = join(timelinePath, "tml-index.yaml");
45
46
  if (existsSync(indexFile)) {
46
47
  const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
48
+ const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
49
+ index.tracks = derived.tracks;
50
+ warnings.push(...derived.warnings);
47
51
  if (loadErrors.length > 0) {
48
52
  warnings.push(`${basename(indexFile)}: ${loadErrors.join(" / ")}`);
49
53
  }
@@ -63,7 +67,7 @@ export function resolveTrackScopeCatalogs(opts) {
63
67
  }
64
68
  if (plan.catalog_status !== "primary") {
65
69
  warnings.push(`timeline: track '${track}' の catalog_status は '${plan.catalog_status}'。` +
66
- `strategy 生成では昇格させないため、確認後に人間が primary へ更新する。`);
70
+ `カタログ作成 todo の完了を確認して timeline build を実行する。todo がない domain は手書きの計画値を使う。`);
67
71
  }
68
72
  }
69
73
  else {
@@ -232,6 +232,7 @@ export function generateStrategy(opts) {
232
232
  repoRoot: opts.repoRoot,
233
233
  catalogPath: opts.catalogPath,
234
234
  timelinePath: opts.timelinePath,
235
+ registerPath: opts.registerPath,
235
236
  track: opts.track,
236
237
  existingStrategy: existing,
237
238
  });
@@ -250,7 +250,7 @@ export const STRATEGY_PROFILES = {
250
250
  };
251
251
  export function profileFor(approach) {
252
252
  if (!(approach in STRATEGY_PROFILES)) {
253
- throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring approaches are register-only`);
253
+ throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring and planning approaches are register-only`);
254
254
  }
255
255
  return STRATEGY_PROFILES[approach];
256
256
  }
@@ -7,11 +7,14 @@
7
7
  // cross-deliverable-dedup は明示した成果物群を横断して正本を選び、重複を要約と参照へ置換する。
8
8
  // finalize は human が成果物のみを最終確認して status を ready へ確定する進め方、
9
9
  // bootstrap-finalize は bootstrap と対になり、成果物と参考資料一式をまとめて確定する進め方。
10
+ // catalog-planning / strategy-planning は register の domain / track 単位で計画を生成する。
10
11
  export const APPROACHES = [
11
12
  "fully-guided",
12
13
  "recipe-guided",
13
14
  "freeform",
14
15
  "bootstrap",
16
+ "catalog-planning",
17
+ "strategy-planning",
15
18
  "rulebook-authoring",
16
19
  "recipe-authoring",
17
20
  "sample-authoring",
@@ -1,8 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
- import { existsSync, readFileSync } from "node:fs";
3
- import { join, resolve } from "node:path";
2
+ import { existsSync, readFileSync, realpathSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve, sep } from "node:path";
4
4
  import { load } from "./yaml.js";
5
- import { getProjectExecutionPath, loadConfig, specdojoRootDir } from "./specdojo-config.js";
5
+ import { getProjectExecutionPath, loadConfig, resolveRepoRoot, specdojoRootDir, } from "./specdojo-config.js";
6
6
  const DOCUMENT_ID_RE = /^[a-z0-9][a-z0-9-:]*$/;
7
7
  export const SEVERITIES = ["blocker", "major", "minor", "note"];
8
8
  function isRecord(value) {
@@ -24,7 +24,7 @@ export function markdownDocumentId(content, path) {
24
24
  return id;
25
25
  }
26
26
  export function resolveGradeResultsDirectory(projectOption, rootDir = specdojoRootDir()) {
27
- const { config } = loadConfig();
27
+ const { config } = loadConfig(rootDir);
28
28
  if (!config)
29
29
  throw new Error("grade commands require .specdojo/specdojo.config.json");
30
30
  const projectId = projectOption?.trim() || config.current_project || Object.keys(config.projects)[0] || "";
@@ -48,7 +48,25 @@ export function gradeResultPathForDocument(opts) {
48
48
  const rootDir = opts.rootDir ?? specdojoRootDir();
49
49
  const absolute = resolve(rootDir, opts.documentPath);
50
50
  const content = readFileSync(absolute, "utf8");
51
- return gradeResultPath(resolveGradeResultsDirectory(opts.project, rootDir), markdownDocumentId(content, opts.documentPath));
51
+ const { config } = loadConfig(rootDir);
52
+ const projectId = opts.project?.trim() || config?.current_project || Object.keys(config?.projects ?? {})[0];
53
+ const project = projectId ? config?.projects[projectId] : undefined;
54
+ const documentRealPath = realpathSync(absolute);
55
+ // 宣言済み repo の実体で判定し、相対・絶対パスや worktree の配置によらず同じ場所を使う。
56
+ const repo = (project?.repos ?? [])
57
+ .map((entry) => {
58
+ const root = resolveRepoRoot(rootDir, entry);
59
+ return { name: entry.name, root: existsSync(root) ? realpathSync(root) : root };
60
+ })
61
+ .sort((a, b) => b.root.length - a.root.length)
62
+ .find(({ root }) => {
63
+ const rel = relative(root, documentRealPath);
64
+ return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
65
+ });
66
+ const resultsDirectory = opts.resultsDirectory
67
+ ? resolve(rootDir, opts.resultsDirectory)
68
+ : resolveGradeResultsDirectory(opts.project, rootDir);
69
+ return gradeResultPath(repo ? join(resultsDirectory, repo.name) : resultsDirectory, markdownDocumentId(content, opts.documentPath));
52
70
  }
53
71
  export function parseGradeResult(content, path) {
54
72
  const parsed = load(content);
@@ -0,0 +1,38 @@
1
+ import { existsSync, readdirSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { dump } from "js-yaml";
4
+ // Keep the fallback result check and every scaffold on the same document rules.
5
+ export const DEFAULT_MARKDOWNLINT_CONFIG = {
6
+ MD013: false,
7
+ MD024: false,
8
+ MD033: false,
9
+ MD036: false,
10
+ MD041: false,
11
+ MD060: false,
12
+ };
13
+ // These are the project files read by markdownlint-cli (CLI2 uses a separate config).
14
+ export function hasMarkdownlintConfig(repoRoot) {
15
+ if (["jsonc", "json", "yaml", "yml"].some((ext) => existsSync(join(repoRoot, `.markdownlint.${ext}`))))
16
+ return true;
17
+ // markdownlint-cli also discovers .markdownlintrc in parent directories.
18
+ for (let dir = repoRoot;; dir = dirname(dir)) {
19
+ if (existsSync(join(dir, ".markdownlintrc")))
20
+ return true;
21
+ if (dirname(dir) === dir)
22
+ return false;
23
+ }
24
+ }
25
+ export function ensureMarkdownlintConfig(repoRoot, dryRun) {
26
+ const hasExistingConfig = readdirSync(repoRoot).some((file) => file.startsWith(".markdownlint.") || file.startsWith(".markdownlint-cli2."));
27
+ if (hasMarkdownlintConfig(repoRoot) || hasExistingConfig) {
28
+ process.stdout.write("Kept existing markdownlint settings.\n");
29
+ return;
30
+ }
31
+ const content = dump(DEFAULT_MARKDOWNLINT_CONFIG);
32
+ if (dryRun) {
33
+ process.stdout.write(`[dry-run] would write: .markdownlint.yaml\n${content}`);
34
+ return;
35
+ }
36
+ writeFileSync(join(repoRoot, ".markdownlint.yaml"), content, { encoding: "utf8", flag: "wx" });
37
+ process.stdout.write("Written: .markdownlint.yaml\n");
38
+ }
@@ -2,14 +2,7 @@ import { existsSync } from "node:fs";
2
2
  import { readdir, writeFile } from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { dump } from "js-yaml";
5
- const BASE_CONFIG = {
6
- MD013: false,
7
- MD024: false,
8
- MD033: false,
9
- MD036: false,
10
- MD041: false,
11
- MD060: false,
12
- };
5
+ import { DEFAULT_MARKDOWNLINT_CONFIG } from "./markdownlint-config.js";
13
6
  // Slide boundaries and per-slide frontmatter interrupt normal Markdown blocks.
14
7
  // Each slide may start with its own H1 or use a heading level chosen for its layout.
15
8
  const SLIDEV_CONFIG = {
@@ -24,7 +17,7 @@ export async function writeMarkdownlintConfigs(opts) {
24
17
  const legacyConfigs = files.filter((file) => file.startsWith(".markdownlint."));
25
18
  const cli2Configs = files.filter((file) => file.startsWith(".markdownlint-cli2."));
26
19
  const hasRc = existsSync(path.join(opts.repoRoot, ".markdownlintrc"));
27
- const rcContent = `${JSON.stringify(BASE_CONFIG, null, 2)}\n`;
20
+ const rcContent = `${JSON.stringify(DEFAULT_MARKDOWNLINT_CONFIG, null, 2)}\n`;
28
21
  const cli2Content = dump({
29
22
  config: { extends: ".markdownlintrc" },
30
23
  ...(opts.slidevKataPatterns?.length
@@ -6,6 +6,7 @@ import Ajv2020Module from "ajv/dist/2020.js";
6
6
  import { runProviderScaffold, specdojoPackageRootDir } from "./provider-scaffold.js";
7
7
  import { runWorkspaceScaffold } from "./workspace-scaffold.js";
8
8
  import { runLefthookScaffold } from "./lefthook-scaffold.js";
9
+ import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
9
10
  import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
10
11
  import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
11
12
  /** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
@@ -254,7 +255,7 @@ export function getProjectRepos(project) {
254
255
  function isRecord(value) {
255
256
  return typeof value === "object" && value !== null && !Array.isArray(value);
256
257
  }
257
- const REPO_KEYS = new Set(["name", "path", "integration_branch", "setup"]);
258
+ const REPO_KEYS = new Set(["name", "path", "integration_branch", "integration_strategy", "setup"]);
258
259
  const REPO_SETUP_KEYS = new Set(["install", "build"]);
259
260
  const EXTERNAL_PROJECT_KEYS = new Set(["path", "project_id"]);
260
261
  /** Resolve a configured external-project repository from the SpecDojo root. */
@@ -381,6 +382,11 @@ export function validateProjectRepos(projectId, project, projectIds, rootDir) {
381
382
  !isOmittedOrNonEmptyString(repo.integration_branch)) {
382
383
  errors.push(`${at}.integration_branch must be a non-empty string when present`);
383
384
  }
385
+ if (repo.integration_strategy !== undefined &&
386
+ repo.integration_strategy !== "merge" &&
387
+ repo.integration_strategy !== "branch-only") {
388
+ errors.push(`${at}.integration_strategy must be "merge" or "branch-only" when present`);
389
+ }
384
390
  const setup = repo.setup;
385
391
  if (setup !== undefined) {
386
392
  if (!isRecord(setup)) {
@@ -727,11 +733,12 @@ export function registerConfigCommands(program) {
727
733
  cfg
728
734
  .command("init")
729
735
  .description("Create .specdojo/specdojo.config.json template (does not overwrite existing) " +
730
- "and add the lines excluding specdojo outputs to .gitignore")
731
- .option("--dry-run", "Show the planned config and .gitignore lines without writing", false)
736
+ "and initialize .gitignore and markdownlint settings")
737
+ .option("--dry-run", "Show the planned config, .gitignore and markdownlint settings without writing", false)
732
738
  .action((opts) => {
733
739
  const dryRun = !!opts.dryRun;
734
740
  const { configPath, config } = loadConfig();
741
+ ensureMarkdownlintConfig(specdojoRootDir(), dryRun);
735
742
  if (config) {
736
743
  process.stdout.write(`Already exists: ${configPath}\n`);
737
744
  writeGitignoreForConfig(config, dryRun);
@@ -10,6 +10,10 @@ export const DEFAULT_GITIGNORE_PATTERNS = [
10
10
  "docs/**/generated/*",
11
11
  "!docs/**/generated/.gitkeep",
12
12
  "docs/**/execution/exec/.locks/",
13
+ "/.vitepress/dist/",
14
+ "/.vitepress/cache/",
15
+ "/.vitepress/mermaid/",
16
+ "/.vitepress/kata-staging/",
13
17
  ];
14
18
  // repo-root 相対の posix パスへ正規化する。リポジトリ外(絶対パス・`..`)や root 自身は
15
19
  // 除外対象にできないため undefined を返す。
@@ -0,0 +1,24 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_ カタログの判定計画と生成
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ 対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
10
+
11
+ - result: `_RESULT_REF_`
12
+
13
+ ## 2. 完了手順
14
+
15
+ 1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
16
+ 2. 共通規約に従って必要な整形・静的検査を行う。
17
+ 3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
18
+
19
+ ## 3. 異常終了の条件
20
+
21
+ - 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
22
+ - 登録簿と個票のステータスを変更しない。
23
+
24
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,24 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_ Schedule strategy と track の生成
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ 対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
10
+
11
+ - result: `_RESULT_REF_`
12
+
13
+ ## 2. 完了手順
14
+
15
+ 1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
16
+ 2. 共通規約に従って必要な整形・静的検査を行う。
17
+ 3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
18
+
19
+ ## 3. 異常終了の条件
20
+
21
+ - 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
22
+ - 登録簿と個票のステータスを変更しない。
23
+
24
+ _COMMON_CONVENTIONS_
@@ -336,7 +336,20 @@ npm install --save-dev @specdojo/docs-site
336
336
  npx specdojo-docs-site build .
337
337
  ```
338
338
 
339
- 開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリに存在しない package 同梱の kata・guide・reference を、gitignore 済みの `specdojo-kata-staging/` へ一時的に複製して `/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先するため、サイト表示のために `kata install --all` を実行する必要はありません。
339
+ 開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリの `docs/` と package 同梱の kata・guide・reference を `.vitepress/kata-staging/docs/` に重ねた閲覧用ツリーを作り、`/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先し、`dev` 中の編集・追加・削除も同期するため、サイト表示のために `kata install --all` を実行する必要はありません。ページ走査のルートをこのツリーに限定し、`.vitepress/dist` や cache、利用者の設定ファイルはページに含めません。
340
+
341
+ Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .` を使います。SVG と manifest は `.vitepress/mermaid/`、サイトの build 結果は `.vitepress/dist/`、cache は `.vitepress/cache/` に置きます。図の公開 URL は `/mermaid/<hash>.svg` を維持し、利用者の `public/` のファイルも従来どおり配信します。
342
+
343
+ `specdojo config init` は `.gitignore` の既存の内容を保持して、次の生成ディレクトリだけを除外します。既存のリポジトリでは再実行するか、手動で追記してください。`.vitepress/` 全体を除外せず、利用者の設定ファイルは Git 管理対象に残します。
344
+
345
+ ```text
346
+ /.vitepress/dist/
347
+ /.vitepress/cache/
348
+ /.vitepress/mermaid/
349
+ /.vitepress/kata-staging/
350
+ ```
351
+
352
+ 旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動で削除しません。移行時は内容を確認し、不要な生成物だけを手動で片付けてください。
340
353
 
341
354
  ### 6.1. Mermaid 図を組み立てる
342
355
 
@@ -527,13 +527,15 @@ app1-specdojo-worktrees/
527
527
 
528
528
  統合は次の順序で行います。
529
529
 
530
- 1. 全リポジトリで commit 対象を commit し、merge できるかを事前に検査する。1つでも統合できないリポジトリがあれば、どのリポジトリも統合しない。
531
- 2. 宣言順にプロダクトの exec branch を統合先ブランチへ merge commit で統合する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
532
- 3. 統合後のプロダクトの trace key と commit snapshot を、プロジェクト側の result 本文へ記録する。
530
+ 1. 全リポジトリで commit 対象を commit し、merge するリポジトリでは merge 可否、`branch-only` では exec worktree に未 commit の変更が無いことを事前に検査する。1つでも検査に失敗したリポジトリがあれば、どのリポジトリも統合しない。
531
+ 2. 宣言順にプロダクトを処理する。`repos[].integration_strategy` が `merge`(既定)の場合は exec branch を統合先ブランチへ merge commit で統合し、`branch-only` の場合は merge せず exec branch を保持する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
532
+ 3. プロダクトの trace key、exec branch 名、状態、統合先の commit snapshot を、プロジェクト側の result 本文へ記録する(register 項目の場合)。`branch-only` は未統合と明示し、統合先の snapshot と PR は `not applicable` とする。
533
533
  4. プロジェクトの exec branch を `app1-specdojo/` の統合先ブランチへ統合する。
534
- 5. 全リポジトリの統合後に、全リポジトリの worktree と exec branch をまとめて撤去する。
534
+ 5. 処理成功後に全リポジトリの worktree を撤去する。`merge` の exec branch とプロジェクトの exec branch は削除し、`branch-only` の exec branch は変更の有無によらず残す。
535
535
 
536
- ソースを先に統合することで、プロダクトの統合を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、プロダクトがすべて統合された後にだけ統合先へ入ります。
536
+ ソースを先に処理することで、プロダクトの処理を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、全プロダクトが merge 済み・変更なし・`branch-only` の保持のいずれかになった後に統合先へ入ります。`review` は SpecDojo のタスク成果を確認する段階であり、プロダクト側の PR が merge 済みであることを意味しません。
537
+
538
+ PR レビューを必須にするプロダクトは、[[specdojo:specdojo-config-reference|設定リファレンス]] の `repos` で `"integration_strategy": "branch-only"` を選びます。統合先への merge 可否や統合先 checkout の未 commit 変更は、そのリポジトリの事前検査を妨げません。runner は push と PR 作成(`gh` を含む)を実装せず、利用者が必要な承認のもと、保持された branch を push してプロダクト側で PR を作ります。squash merge では `Refs:` を commit メッセージに残してください。未統合の branch は `exec worktree prune` でも削除しません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除します。
537
539
 
538
540
  ### 10.7. 複数リポジトリの統合の失敗と再開
539
541
 
@@ -545,10 +547,10 @@ app1-specdojo-worktrees/
545
547
  | n 番目のプロダクトの統合 | 1〜n-1 番目のプロダクトだけ統合済み | 項目を `waiting` とし、統合済みのプロダクトを飛ばして n 番目から再開する |
546
548
  | プロジェクトの統合 | 全プロダクトが統合済み、プロジェクトは未統合 | 項目を `waiting` とし、プロダクトを再統合せずプロジェクトの統合だけ再開する |
547
549
 
548
- - リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
550
+ - リポジトリ別の状態(`pending` / `merged` / `unchanged` / `branch-only` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
549
551
  - `block_reason` には、失敗したリポジトリ、統合済みのリポジトリ、未統合のリポジトリを記録します。
550
552
  - 失敗後も全リポジトリの worktree と exec branch を保持します。原因を解消した後、`exec run --register <item-id> --worktree --resume` で統合段から再開します。agent は再実行しません。
551
- - 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)のプロダクトは取り込まず、exec branch に merge commit を作りません。
553
+ - 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)または方式が `branch-only` のプロダクトは取り込まず、exec branch に merge commit を作りません。
552
554
  - 再開時は、統合先へ取り込み済みのプロダクトを merge し直さず、最初の統合で作った merge commit を result の trace 表へ記録します。
553
555
 
554
- 一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
556
+ `branch-only` の保持はそのリポジトリの処理完了とします。これを除き、一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
@@ -43,25 +43,26 @@ exec が扱う関心事、タスクの出どころによる実行経路の選び
43
43
 
44
44
  ### 1.2. 実行経路の使い分け
45
45
 
46
- agent にタスクを実行させる経路は、実行対象の出どころによって schedule 実行と register 実行の 2 つがあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(schedule / register)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
47
-
48
- | 観点 | schedule 実行 | register 実行 | routine(トリガー層) |
49
- | ------------ | ----------------------------------------- | ------------------------------------------------- | ---------------------------------------- |
50
- | 実行対象 | `sch-track-*.yaml` のタスク(依存グラフ) | `generated/pjr-index.md` の項目 | `rtn-*.yaml` の定義(実体は左の 2 経路) |
51
- | 代表コマンド | `exec run --task` / `exec run --auto` | `exec run --register` | `routine run --due` |
52
- | 起動 | 人、または routine(`job-exec-auto`) | 人、または routine(`job-register-sweep`) | 外部スケジューラ(cron / CI) |
53
- | 状態追跡 | exec events(claim / complete / block) | register の遷移(in-progress / review / waiting) | `last_run` の記録のみ |
54
- | 隔離 | worktree(`--worktree` / `--auto`) | `run.register_execution` または CLI で選択 | -(実行経路へ委譲) |
55
- | 終端の扱い | `complete` event(human finalize で確定) | 人が確認して `register close` | -(発火の記録のみ) |
56
- | 典型用途 | 計画された成果物の作成・レビュー・確定 | 立ち上げ時の課題・判断、進行中の計画外対応・調査 | 日次スイープ・夜間バッチなどの定期実行 |
46
+ agent にタスクを実行させる経路には、業務の起点・着手承認・完了判断を担う register と、成果物カタログに基づく途中の進み具合を担う schedule があります。両者は同格の 2 経路ではなく、register を親、schedule を子とする階層関係にあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(register の項目 / schedule のタスク)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
47
+
48
+ | 観点 | register 実行(親: 起点・承認・完了) | schedule 実行(子: 途中の進捗・依存実行) | routine(トリガー層) |
49
+ | ------------ | --------------------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------- |
50
+ | 役割 | 業務の起点、着手承認、完了判断、単発の調査・対応 | 成果物の依存関係に基づく進捗管理・実行 | 定期起動・スケジューリング |
51
+ | 実行対象 | `generated/pjr-index.md` の項目(todo / issue / change-request 等) | `sch-track-*.yaml` のタスク(依存グラフ) | `rtn-*.yaml` の定義(実体は左の 2 経路) |
52
+ | 代表コマンド | `exec run --register` | `exec run --task` / `exec run --auto` | `routine run --due` |
53
+ | 起動 | 人、または routine(`job-register-sweep`) | 人、または routine(`job-exec-auto`) | 外部スケジューラ(cron / CI) |
54
+ | 状態追跡 | register の遷移(in-progress / review / waiting) | exec events(claim / complete / block) | `last_run` の記録のみ |
55
+ | 隔離 | `run.register_execution` または CLI で選択 | worktree(`--worktree` / `--auto`) | -(実行経路へ委譲) |
56
+ | 終端の扱い | 人が確認して `register close`(epic も人が判断) | `complete` event(human finalize で確定) | -(発火の記録のみ) |
57
+ | 典型用途 | 課題・判断、track の epic 起票、カタログ・strategy 計画、計画外の対応・調査 | 計画された成果物群の作成・レビュー・確定 | 日次スイープ・夜間バッチなどの定期実行 |
57
58
 
58
59
  迷った場合は次で判断します。
59
60
 
60
- - 成果物カタログと依存関係に基づく計画済みの作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
61
- - 立ち上げ時の未整理な課題・判断、または進行中に発生した計画外の単発対応・調査で、台帳として追跡したいものは register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。手順は [登録簿運用ガイド](register-operation-guide.md))。
62
- - 上記のどちらかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
61
+ - 業務の起点・着手承認・完了判断、未整理な課題や判断、単発の対応・調査、およびカタログや strategy の計画は register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。まとまった仕事は track ごとに `epic` を起票する。手順は [登録簿運用ガイド](register-operation-guide.md))。
62
+ - `epic` のもとで成果物カタログと依存関係を展開し、途中の進み具合を管理しながら進める作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
63
+ - 上記のいずれかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
63
64
 
64
- register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。立ち上げ時の個票で目的・スコープ・対象成果物を決定したら、カタログ作成の個票を完了し、以後の計画済み作業を schedule のタスクとして管理します。
65
+ register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。まとまった仕事は track ごとに `epic` を起票し、その子 todo でカタログ作成(`catalog-planning`)や strategy 作成(`strategy-planning`)を進めて schedule へ展開します。途中の進み具合は schedule が持ち、トラック完了時に人が `epic` の完了を判断して close します。
65
66
 
66
67
  登録の判断、type の選び方、個票の作成などの台帳運用は [登録簿運用ガイド](register-operation-guide.md) を参照します。
67
68
 
@@ -17,7 +17,7 @@ Orchestrator Operation Guide
17
17
 
18
18
  **この文書で分かること**
19
19
 
20
- - オーケストレーターの位置づけ、起動用スクリプト、対話フロー、承認と安全の扱い、設定ファイルの構成
20
+ - オーケストレーターの位置づけ、起動用スクリプト、VS Code からの使い方、対話フロー、承認と安全の扱い、設定ファイルの構成
21
21
 
22
22
  **次に読む文書**
23
23
 
@@ -109,6 +109,24 @@ npx specdojo config scaffold --provider antigravity --global
109
109
 
110
110
  分離環境が必要な場合は、追加の任意手順として `devcontainer scaffold` を利用できます。既存の `.devcontainer/` は上書きされず、provider の設定ディレクトリは名前付きボリュームへ保存されます。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `devcontainer` を参照してください。
111
111
 
112
+ ### 2.2. VS Code から使う
113
+
114
+ VS Code の各種 AI 拡張機能からオーケストレーターを利用することもできます。拡張機能ごとの起動手順は次のとおりです。
115
+
116
+ - **GitHub Copilot Chat**:
117
+ `npx specdojo config scaffold --provider copilot` を実行して設定を配置した後、VS Code の Copilot Chat パネルで agent の選択肢から `specdojo-orchestrator` を選びます(`.github/agents/specdojo-orchestrator.md` が読み込まれます)。
118
+ - **Claude Code 拡張**:
119
+ 設定(settings)の `agent` キーに `specdojo-orchestrator` を設定すると、セッションがオーケストレーターとして開始されます。共有の `.claude/settings.json` に書くとそのリポジトリを利用する全員のすべてのセッションが対象になるため、各自のローカル設定である `.claude/settings.local.json` に記述することを推奨します。
120
+
121
+ ```json
122
+ {
123
+ "agent": "specdojo-orchestrator"
124
+ }
125
+ ```
126
+
127
+ - **Codex 拡張**:
128
+ Codex の VS Code 拡張(`Codex – OpenAI's coding agent`)で名前付きの agent の定義を選ぶ仕組みは、公式の文書では確かめられていません(2026-10 時点で未確認)。そのため、会話開始時に SSOT である `.agents/specdojo-orchestrator.agent.md` の本文を最初の指示(プロンプト)として渡して対話を開始します。
129
+
112
130
  ## 3. 対話の進め方
113
131
 
114
132
  オーケストレーターは「提案 → 承認 → 実行」を基本とします。
@@ -64,6 +64,8 @@ package の探索では `node_modules` 全体を再帰走査せず、resolver
64
64
 
65
65
  template は記述する部分を _TODO_ などのプレースホルダとして配置した雛形で、内容が埋まった完成例である sample と役割を分担します。
66
66
 
67
+ sample は成果物として成り立つ完成例であり、template の `type: template` と異なり、見本にする成果物の type を持ちます。`type` と sample の識別の原則は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
68
+
67
69
  ここでいう `reference` は文書種別です。exec plan が実行時に参照する実践の型(rulebook / recipe / sample / template)とは別の役割として扱います。
68
70
 
69
71
  ## 3. 種別間の関係と成果物への紐付け