specdojo 0.3.1 → 0.4.1

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 (260) hide show
  1. package/.github/agents/specdojo-orchestrator.md +61 -2
  2. package/CHANGELOG.md +90 -0
  3. package/README.md +85 -25
  4. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  5. package/dist/catalog/build-render.js +32 -0
  6. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  7. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  8. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  9. package/dist/catalog/paths.js +1 -0
  10. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  11. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  12. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  13. package/dist/{agent.js → commands/agent.js} +11 -11
  14. package/dist/{build-command.js → commands/build.js} +2 -2
  15. package/dist/{init-command.js → commands/init.js} +168 -45
  16. package/dist/commands/night-orchestrator.js +287 -0
  17. package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
  18. package/dist/{watch.js → commands/watch.js} +3 -3
  19. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  20. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  21. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  22. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  23. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  24. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  25. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  26. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  27. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  28. package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
  29. package/dist/devcontainer/scaffold.js +418 -0
  30. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  31. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  32. package/dist/{index-command.js → docs/index-command.js} +1 -1
  33. package/dist/docs/template-resolution.js +1 -0
  34. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  35. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  36. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  37. package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
  38. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  39. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  40. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  41. package/dist/{exec-core.js → exec/core.js} +11 -11
  42. package/dist/{exec-events.js → exec/events.js} +2 -2
  43. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  44. package/dist/exec/exec.js +2 -0
  45. package/dist/exec/format.js +1 -0
  46. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  47. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  48. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
  49. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
  50. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  51. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  52. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  53. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  54. package/dist/{exec-project.js → exec/project.js} +1 -1
  55. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  56. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  57. package/dist/{exec-register.js → exec/register.js} +114 -9
  58. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  59. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  60. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
  61. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  62. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  63. package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
  64. package/dist/{exec-results.js → exec/results.js} +287 -31
  65. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
  66. package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
  67. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  68. package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
  69. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  70. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  71. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  72. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
  73. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
  74. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
  75. package/dist/exec/run/register-post-review.js +420 -0
  76. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
  77. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  78. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
  79. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  80. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  81. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  82. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  83. package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
  84. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  85. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  86. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  87. package/dist/exec/schedule/gantt-chart.js +2 -0
  88. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  89. package/dist/exec/schedule/index.js +1 -0
  90. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  91. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  92. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  93. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  94. package/dist/exec/shared.js +63 -0
  95. package/dist/exec/slot-lock.js +1 -0
  96. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  97. package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
  98. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  99. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  100. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  101. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  102. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  103. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  104. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  105. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  106. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  107. package/dist/exec/worktree.js +305 -0
  108. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  109. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  110. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  111. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  112. package/dist/{grade-core.js → grade/core.js} +3 -3
  113. package/dist/grade/grade.js +19 -0
  114. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  115. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  116. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  117. package/dist/{grade-result.js → grade/result.js} +5 -94
  118. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  119. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  120. package/dist/{job-definition.js → job/definition.js} +25 -6
  121. package/dist/{job.js → job/job.js} +12 -11
  122. package/dist/{kata-command.js → kata/command.js} +3 -3
  123. package/dist/{kata.js → kata/kata.js} +5 -5
  124. package/dist/register/approach.js +134 -0
  125. package/dist/{register-core.js → register/core.js} +26 -8
  126. package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
  127. package/dist/{register-date.js → register/date.js} +1 -1
  128. package/dist/register/derivation.js +163 -0
  129. package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
  130. package/dist/{register-events.js → register/events.js} +13 -3
  131. package/dist/{register-history.js → register/history.js} +7 -6
  132. package/dist/{register-item.js → register/item.js} +32 -5
  133. package/dist/register/lifecycle-lock.js +5 -0
  134. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  135. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  136. package/dist/{register-migration.js → register/migration.js} +5 -4
  137. package/dist/{register.js → register/register.js} +32 -27
  138. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  139. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  140. package/dist/{register-update.js → register/update.js} +5 -5
  141. package/dist/{register-views.js → register/views.js} +47 -7
  142. package/dist/{review-grade.js → review/grade.js} +2 -2
  143. package/dist/{review-plan.js → review/plan.js} +3 -3
  144. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  145. package/dist/{routine.js → routine/routine.js} +49 -22
  146. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  147. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  148. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  149. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  150. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  151. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  152. package/dist/shared/agent-types.js +23 -0
  153. package/dist/shared/artifact-path.js +9 -0
  154. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  155. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  156. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  157. package/dist/shared/fs.js +30 -0
  158. package/dist/shared/git.js +346 -0
  159. package/dist/shared/grade-result.js +94 -0
  160. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  161. package/dist/shared/plan-templates.js +114 -0
  162. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
  163. package/dist/shared/random.js +4 -0
  164. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  165. package/dist/shared/schedule-paths.js +9 -0
  166. package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
  167. package/dist/{exec-shared.js → shared/text.js} +4 -135
  168. package/dist/shared/time.js +28 -0
  169. package/dist/shared/workspace-scaffold.js +69 -0
  170. package/dist/specdojo.js +22 -22
  171. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
  172. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
  174. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  175. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  176. package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
  177. package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
  178. package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
  179. package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
  180. package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
  181. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  182. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
  183. package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
  184. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
  185. package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
  186. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  188. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
  189. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  190. package/docs/ja/specdojo/guides/waza-guide.md +1 -1
  191. package/docs/ja/specdojo/references/command-reference.md +124 -55
  192. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  193. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
  194. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  195. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  196. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  197. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  198. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  199. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
  200. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
  201. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  202. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  203. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
  204. package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
  205. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
  206. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  207. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
  208. package/package.json +17 -17
  209. package/templates/antigravity/README.md +6 -2
  210. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  211. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  212. package/templates/antigravity/orchestrator.md +61 -2
  213. package/templates/claude/README.md +27 -3
  214. package/templates/claude/agents/claude-executor.md +0 -1
  215. package/templates/claude/agents/claude-reporter.md +2 -1
  216. package/templates/claude/agents/claude-review-executor.md +0 -1
  217. package/templates/claude/agents/specdojo-orchestrator.md +61 -2
  218. package/templates/codex/README.md +40 -4
  219. package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
  220. package/templates/codex/orchestrator.md +61 -2
  221. package/templates/devcontainer/devcontainer.json +5 -2
  222. package/templates/devcontainer/post-create.sh +15 -7
  223. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
  224. package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
  225. package/templates/devcontainer/vim/vimrc +37 -0
  226. package/templates/init-agent-members.yaml +75 -25
  227. package/templates/init-exec-defaults.yaml +44 -9
  228. package/templates/opencode/README.md +17 -3
  229. package/templates/opencode/agents/opencode-executor.md +0 -1
  230. package/templates/opencode/agents/opencode-reporter.md +2 -1
  231. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  232. package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
  233. package/dist/devcontainer-scaffold.js +0 -165
  234. package/dist/exec-schedule-gantt-chart.js +0 -2
  235. package/dist/exec-worktree.js +0 -474
  236. package/dist/exec.js +0 -2
  237. package/dist/grade.js +0 -19
  238. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  239. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  240. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  241. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  242. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  243. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  244. /package/dist/{exec-types.js → exec/types.js} +0 -0
  245. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  246. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  247. /package/dist/{review-types.js → review/types.js} +0 -0
  248. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  249. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  250. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  251. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  252. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  253. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  254. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  255. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  256. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  257. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  258. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  259. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  260. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -2,42 +2,55 @@
2
2
 
3
3
  この規約は、生成される全 exec plan に共通で適用される。result の完了条件、他文書を参照する際のリンク記法、成果物の状態(status)の扱いを統一する。
4
4
 
5
+ 要点(次の `plan-essentials` マーカーの間の箇条書き)は、plan の本文にもそのまま転記される。plan に転記するとき、`_SCHEMA_REF_` はタスクごとに解決した schema のパスに置き換わり、schema の無いタスクではその行が除かれる。
6
+
7
+ <!-- plan-essentials:start -->
8
+
5
9
  - result(review plan の場合は review result)への記入は、タスク完了に必須の作業である。成果物の編集とは別に、最後に必ず実施する。
6
10
  - 終了コード 0 で完了する前に、result の必須セクションをすべて実際の内容で埋め、プレースホルダ(_TODO_ など)や未記入のセクションを残さない。
7
- - 成果物に変更が不要と判断した場合でも、result の記入は省略しない。変更不要と判断した理由と根拠を result に記入してから完了する。
8
- - result が未記入・プレースホルダのまま終了コード 0 で終了すると、runner は成果物未完了(block)として扱い、タスクはやり直しになる。完了前に result の記入漏れがないことを必ず確認する。
9
- - result の frontmatter は scaffold 済みの構造を正本とする。`id` / `task_id` / `mode` / `project_id` / `plan_ref` / `agent` / `execution` / `approach` / `targets` はキーの追加・削除・改名をせず、scaffold された値のまま維持する。見出し構成(`# Edit Result` などの H1、`## 1.` 以降の章立て)も独自の構成に置き換えない。埋めるのは本文セクションの `_TODO_` プレースホルダの中身だけである。`status` と `completed_at` は完了処理(runner 側)が更新するため、自分で書き換えない。
10
11
  - 文書へのリンクは、対象文書が既に存在する場合は `[[id|title]]` 形式で記載する(`id` は project 修飾 doc id)。
11
12
  - リンクを表(テーブル)のセル内に置く場合は、区切りの `|` を `[[id\|title]]` のようにエスケープする。エスケープしないと列がずれて表が壊れ、prettier 整形でセルが分割されて固定化される。
12
13
  - まだ存在しない文書を参照する場合は、`[[...]]` ではなく `` `id` `` または `` `filename` `` のようにバッククォートで仮置きする。
13
14
  - Markdown の自由記述では、`_` を含む識別子・フィールド名(例: `depends_on`)を必ずインラインコードで囲む。result に描画される executor evidence や reporter の自由記述も同じ記法にする。
14
15
  - 成果物 frontmatter の `status` を `ready` に変更しない。`ready` への昇格は人間のみが行うため、`draft` のまま据え置く(exec のコミット時ガードでも昇格はブロックされる)。
16
+ - ファイルの読み取り・書き込み・編集は、作業ディレクトリ(カレントディレクトリ)からの相対パスで指定する。絶対パスを自分で組み立てたり、作業ディレクトリ名を推測して指定したりしない(作業ディレクトリ名の取り違えは外部パス扱いになり拒否される)。
17
+ - 検査を実行する前に、リポジトリの `package.json`、`.specdojo/specdojo.config.json`、hook 設定(`lefthook.yml` など)を読み、本共通規約の詳細にある検査表の適用条件で、実行する検査を決める。
18
+ - 適用条件を満たさない検査は実行せず、executor evidence の validations に `not_applicable` と非適用の理由を `reason` へ記録する。適用される検査が 1 つもない場合も同じく、該当する検査ごとに `not_applicable` と理由を記録する。
19
+ - `not_run` は、適用される検査を実行できたのに実行しなかった場合だけに使う。runner は `not_run` を検証失敗として扱い、タスクを先へ進めない。
20
+ - `pipeline.parent_validations` に設定された検査は executor evidence の validations に含めなくてよい。executor が同じ検査を `not_run` または `not_applicable` として含めても、同じリポジトリで実行した親 runner の結果を正とする。
21
+ - YAML 成果物を編集した場合、対応 schema `_SCHEMA_REF_` に従って記述する。`package.json` に `validate:schema:file` script がある場合だけ、`npm run validate:schema:file -- --schema _SCHEMA_REF_ --data <対象ファイル>` で schema 検査を実施する。適用した検査でエラーが出た場合は修正してから完了とする。
22
+
23
+ <!-- plan-essentials:end -->
24
+
25
+ - 成果物に変更が不要と判断した場合でも、result の記入は省略しない。変更不要と判断した理由と根拠を result に記入してから完了する。
26
+ - result の変更ファイル欄には、変更したファイル(成果物・ソース・テストなど)ごとの実施内容を具体的に記入する。
27
+ - result が未記入・プレースホルダのまま終了コード 0 で終了すると、runner は成果物未完了(block)として扱い、タスクはやり直しになる。完了前に result の記入漏れがないことを必ず確認する。
28
+ - result の frontmatter は scaffold 済みの構造を正本とする。`id` / `task_id` / `mode` / `project_id` / `plan_ref` / `agent` / `execution` / `approach` / `targets` はキーの追加・削除・改名をせず、scaffold された値のまま維持する。見出し構成(`# Edit Result` などの H1、`## 1.` 以降の章立て)も独自の構成に置き換えない。埋めるのは本文セクションの `_TODO_` プレースホルダの中身だけである。`status` と `completed_at` は完了処理(runner 側)が更新するため、自分で書き換えない。
15
29
  - plan に「プロジェクトコンテキスト」章がある場合、そこに挙がる文書はプロジェクト共通の前提を読むための参照であり、成果物 frontmatter の `based_on` へ転記しない。参照して得た前提は本文の記述内容へ反映する。
16
30
  - 成果物 frontmatter の `based_on` に書けるのは、その成果物の `depends_on` の推移閉包に含まれる先行成果物だけである。閉包外の ID を書くと `catalog validate` が「`based_on` が `depends_on` の推移閉包に含まれていません」としてエラーになり、コミットがブロックされる。`based_on` を増やす必要が生じた場合は、自分で転記せず、根拠不足として result に記録する。
17
- - ファイルの読み取り・書き込み・編集は、作業ディレクトリ(カレントディレクトリ)からの相対パスで指定する。絶対パスを自分で組み立てたり、作業ディレクトリ名を推測して指定したりしない(作業ディレクトリ名の取り違えは外部パス扱いになり拒否される)。
18
31
  - 編集・書き込みが作業ディレクトリ外(`external_directory`)として拒否された場合、原因はパス指定の誤り(誤った絶対パス・ディレクトリ名の取り違え)である。bash の heredoc などへ回避的に切り替えず、相対パスに直したうえで同じ編集ツールで再実行する。
19
32
  - 作業用のファイル(編集用スクリプト、検証用の一時データなど)はリポジトリの外(一時ディレクトリ)または worktree の `tmp/` 配下に置き、終了前に削除する。使い捨てのファイルを最上位に作らない。`tmp/` 配下のファイルは commit の対象から除外される。
20
33
  - 整形・静的検査は、この plan の完了手順または本共通規約で明示されたコマンドを実行する。変更対象に必要な test、build、schema 検証は、plan に個別記載がなくても実行してよい。同じ test script では対象限定と全件を同一 executor run 内で連続実行せず、どちらか一方に絞る。下表、plan、またはプロジェクト標準が全件 test を求める場合は、全件を1回だけ実行して対象限定の実行を省く。この制約は executor が sandbox 内で実行する test script の回数に対するものであり、親検証に設定された ID のコマンドは対象外である(親 runner が別途実行する)。実行したコマンド・対象・結果は result に記録する。
21
- - executor / reporter pipeline で親 runner の検証が設定されている場合、executor は設定済み ID に対応するコマンドを sandbox 内で実行せず、executor 終了後に親 runner が固定許可リストから実行して evidence へ追記する。`validate-schema` は `npm run validate:schema`、`test-unit` は `npm run test:unit`、`test-integration` は `npm run test:integration` に対応する。executor は親検証と同じコマンドの対象限定版も追加せず、二重実行しない。
22
- - 検査を実行する前に、リポジトリの `package.json`、`.specdojo/specdojo.config.json`、hook 設定を読み、下表の適用条件を確認する。条件を満たさない検査は実行せず、executor evidence の validations に `not_applicable` と非適用の理由を `reason` へ記録する。`not_run` は適用される検査を実行しなかった場合だけに使う。誤って `not_run` と記録しても、npm script・依存 package の不在、または SpecDojo サブコマンドの設定上の非適用を runner が機械的に確定できる場合は適用外として扱われるが、この救済を前提に記録を省略しない。
34
+ - executor / reporter pipeline で親 runner の検証が設定されている場合、executor は設定済み ID に対応するコマンドを sandbox 内で実行せず、executor 終了後に親 runner が固定許可リストから実行して evidence へ追記する。`validate-schema` は `npm run validate:schema`、`test-unit` は `npm run test:unit`、`test-integration` は `npm run test:integration` に対応する。executor は親検証と同じコマンドの対象限定版も追加せず、二重実行しない。executor が親検証のコマンドを validations に含めた場合も、同じリポジトリで実行された親 runner の結果を正とし、executor の `not_run` / `not_applicable` は pipeline を失敗させない。
35
+ - 適用条件の判定と `not_applicable` / `not_run` の使い分けは、要点に記した規則に従う。誤って `not_run` と記録しても、npm script・依存 package の不在、または SpecDojo サブコマンドの設定上の非適用を runner が機械的に確定できる場合は適用外として扱われるが、この救済を前提に記録を省略しない。
23
36
  - 依存パッケージの有無は、対象リポジトリの `package.json` の `dependencies` / `devDependencies` と、リポジトリに固定された package manager の設定を基準に判断する。`npx` が未導入パッケージをネットワークから一時取得できることは、導入済みとはみなさない。設定ファイルがない、壊れているなどの理由で適用条件を確定できない検査は実行せず、validations に `not_applicable` として理由と次の確認事項を記録する。
37
+ - `npm init` が `package.json` に入れる仮の `test` script(`echo "Error: no test specified" && exit 1` と、引用符の有無・種類や空白だけが違う変種)は、常に失敗する仮置きであり、`test` script がないものとみなす。`npm test` は実行せず、validations に `not_applicable` と、仮の script である旨を `reason` に記録する。runner も同じ判断で `not_applicable` を受け付ける。本物の test script がある場合は適用される。
24
38
  - Markdown 成果物を編集した場合、Prettier が導入されているときだけ `npx prettier --write <対象ファイル>` で整形する。`markdownlint-cli` または `markdownlint` が導入されているときだけ `npx markdownlint <対象ファイル>` を実行し、`markdownlint-cli2` を採用するリポジトリでは、そのリポジトリで定めた CLI2 のコマンドを実行する。適用した検査でエラーが出た場合は修正してから完了とする。
25
- - YAML 成果物を編集した場合、対応 schema `_SCHEMA_REF_` に従って記述する。`package.json` に `validate:schema:file` script がある場合だけ、`npm run validate:schema:file -- --schema _SCHEMA_REF_ --data <対象ファイル>` で schema 検査を実施する。適用した検査でエラーが出た場合は修正してから完了とする。
26
39
  - 終了する前に、コミット時に実行される検査(pre-commit 相当)のうち、現在のリポジトリに設定され、上記の適用条件を満たすものを先回りで実行する。適用した検査の失敗はすべて修正してから完了する。
27
40
  - 実行対象は、変更したファイルの種別で判断する。下表のうち、変更したファイルが該当し、かつ適用条件を満たす行の検査を実行する。該当行がない場合や適用条件を満たさない場合は追加の検査は不要である。ただし親検証に設定された ID のコマンドは下表よりも優先し、executor は実行しない。下表に同じコマンドが挙がっていても、親 runner の実行に委ねる。
28
41
  - 検査コマンドの正本はリポジトリの hook 設定(`lefthook.yml` など)である。下表と設定が食い違う場合は、適用条件を満たす設定側のコマンドに合わせ、実行したコマンドと結果を result に記録する。`specdojo` コマンドは、リポジトリで定められた起動方法(`npx specdojo <subcommand>`、`npx tsx src/specdojo.ts <subcommand>` など)で実行する。ただし、sandbox 環境で `tsx` の IPC エラー(`EPERM`)が発生する場合は、代わりに `node --import tsx src/specdojo.ts <subcommand>` を使用して実行する。
29
42
 
30
- | 変更したファイル | 適用条件 | 実行する検査 |
31
- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
32
- | `*.md` | 対応するローカル依存が `package.json` にある | `npx prettier --write <対象ファイル>`、導入済み実装に対応する markdownlint コマンド |
33
- | `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml` | Prettier が `package.json` にある | `npx prettier --write <対象ファイル>` |
34
- | `src/`、`tests/`、`scripts/`、`tools/`、`tsconfig*.json` | `package.json` に `typecheck` script がある | `npm run typecheck` |
35
- | `src/`、`tests/`、`docs/ja/specdojo/templates/`、`docs/ja/specdojo/exec-templates/`、`vitest.config.*` | pipeline executor は `test:unit`、それ以外は `test` script が `package.json` にある | pipeline executor は `npm run test:unit`、それ以外は `npm test`(`test-unit` が親検証に設定されている場合は executor では実行しない) |
36
- | `docs/ja/projects/` 配下 | 対象 project に `catalog_path` が設定されている | `specdojo catalog validate` |
37
- | `dct-*.yaml` | 対象 project に `catalog_path` が設定されている | `specdojo catalog build` |
38
- | `pjr-index.md` | 対象 project に `project_register_path` が設定されている | `specdojo register build` |
39
- | `sch-*.yaml` | 対象 project に `schedule_path` が設定されている | `specdojo exec refresh` |
40
- | `docs/` 配下 | リポジトリで定められた起動方法により SpecDojo CLI を実行できる | `specdojo index build` |
43
+ | 変更したファイル | 適用条件 | 実行する検査 |
44
+ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | `*.md` | 対応するローカル依存が `package.json` にある | `npx prettier --write <対象ファイル>`、導入済み実装に対応する markdownlint コマンド |
46
+ | `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml` | Prettier が `package.json` にある | `npx prettier --write <対象ファイル>` |
47
+ | `src/`、`tests/`、`scripts/`、`tools/`、`tsconfig*.json` | `package.json` に `typecheck` script がある | `npm run typecheck` |
48
+ | `src/`、`tests/`、`docs/ja/specdojo/templates/`、`docs/ja/specdojo/exec-templates/`、`vitest.config.*` | pipeline executor は `test:unit`、それ以外は `test` script が `package.json` にある(`npm init` の仮の `test` script は、ないものとみなす) | pipeline executor は `npm run test:unit`、それ以外は `npm test`(`test-unit` が親検証に設定されている場合は executor では実行しない) |
49
+ | `docs/ja/projects/` 配下 | 対象 project に `catalog_path` が設定されている | `specdojo catalog validate` |
50
+ | `dct-*.yaml` | 対象 project に `catalog_path` が設定されている | `specdojo catalog build` |
51
+ | `pjr-index.md` | 対象 project に `project_register_path` が設定されている | `specdojo register build` |
52
+ | `sch-*.yaml` | 対象 project に `schedule_path` が設定されている | `specdojo exec refresh` |
53
+ | `docs/` 配下 | リポジトリで定められた起動方法により SpecDojo CLI を実行できる | `specdojo index build` |
41
54
 
42
55
  <!-- review-only:start -->
43
56
 
@@ -15,13 +15,12 @@ _PJR_DESCRIPTION_
15
15
  - `priority`: _PJR_PRIORITY_
16
16
  - `owner`: _PJR_OWNER_
17
17
  - `due`: _PJR_DUE_
18
- - `登録簿`: `_PJR_INDEX_PATH_`
19
18
  - `個票`: _PJR_TICKET_REF_
20
19
  - `result`: `_RESULT_REF_`
21
20
 
22
21
  ## 3. 進め方
23
22
 
24
- 1. 登録簿の該当行と個票(存在する場合)を読み、問い・リスク内容・判断に必要な条件を把握する。
23
+ 1. 個票(存在する場合)を読み、問い・リスク内容・判断に必要な条件を把握する。登録簿の一覧は大きいため読まない。
25
24
  2. 関連する成果物・設計書・実装・実行ログを確認し、判断材料を集める。
26
25
  3. 実行 agent が Web 検索能力を持ち、一般的な観点・用語・標準の確認が必要な場合は、関連情報を取得して出典を添える。
27
26
  4. 集めた材料から結論案を組み立てる。question は回答案、risk は影響・発生可能性の評価と対応案(回避・軽減・受容など)を示す。
@@ -15,13 +15,12 @@ _PJR_DESCRIPTION_
15
15
  - `priority`: _PJR_PRIORITY_
16
16
  - `owner`: _PJR_OWNER_
17
17
  - `due`: _PJR_DUE_
18
- - `登録簿`: `_PJR_INDEX_PATH_`
19
18
  - `個票`: _PJR_TICKET_REF_
20
19
  - `result`: `_RESULT_REF_`
21
20
 
22
21
  ## 3. 進め方
23
22
 
24
- 1. 登録簿の該当行と個票(存在する場合)を読み、目的・完了条件・制約を把握する。
23
+ 1. 個票(存在する場合)を読み、目的・完了条件・制約を把握する。登録簿の一覧は大きいため読まない。
25
24
  2. 個票に完了条件がある場合はそれを作業の基準にする。無い場合はタイトルと説明から完了条件の仮説を立て、その仮説を result に明記する。
26
25
  3. 関連する成果物・設計書・実装を確認し、対象ファイルを特定して変更する。
27
26
  4. 個票が存在する場合は、個票の作業内容・対応結果セクションを実施内容で更新する。
@@ -33,6 +32,8 @@ _GRADE_FINDINGS_
33
32
 
34
33
  plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result に記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
35
34
 
35
+ _AUTOPILOT_CONSTRAINTS_
36
+
36
37
  ## 4. 完了手順
37
38
 
38
39
  1. 「進め方」に従って対応を完了する。
@@ -14,6 +14,4 @@ _TODO_: 変更したファイルのパスを記入する。
14
14
 
15
15
  _TODO_: 後続タスクへの申し送り事項を記入する(なければ削除)。
16
16
 
17
- ## 4. 進め方と実践の型の適用
18
-
19
- _TODO_: `approach` に従ってどう進めたか、その進め方の中で実践の型(rulebook / recipe / sample / template)をどう適用したかを記入する(`fully-guided` で rulebook / recipe / sample / template をどう使い分けたか、`recipe-guided` で recipe のみを基準にした内容、`freeform` で実践の型より優先した実例やプロジェクト文脈、`retrofit` で実際に参照した実装パス・抽出した現在動作・反映/新設判断・未反映の乖離・未確認範囲、`rulebook-maintenance` などの maintenance 系で見直した実践の型とその根拠、など)。実践の型を基準にしなかった場合は、その判断と代わりに根拠にした内容も記入する。複数文書間に矛盾があり rulebook を正として判断した箇所、参照範囲から外れていた文書とその代わりに根拠にした内容があれば、あわせて記録する。
17
+ _APPROACH_SECTION_
@@ -30,15 +30,17 @@ _ANALYSIS_DESCRIPTION_
30
30
  1. `_BASE_COMMIT_.._OUTPUT_COMMIT_` の差分が当該 Job Run の出力だけで構成されている。
31
31
  2. Job Run の状態、command evidence、result の記述が相互に整合している。
32
32
  3. score・verdict・finding・失敗文書がある場合は、その変化と理由を確認している。
33
- 4. Run が失敗している場合は `incomplete` とし、再開または人手対応に必要な理由を残している。
34
- 5. reviewer は Job Run の出力を修正せず、review result だけに判断を記録している。
33
+ 4. Run が `partial` の場合は、完了分を統合でき、失敗分が次の Run で再試行できる記録を持つときだけ `complete-with-findings` とし、失敗した対象と理由を finding に残している。
34
+ 5. Run が `failed` の場合、または `partial` でも完了分がない、失敗分を再試行できない、未開始の対象がある場合は `incomplete` とし、再開または人手対応に必要な理由を残している。
35
+ 6. reviewer は Job Run の出力を修正せず、review result だけに判断を記録している。
35
36
 
36
37
  ## 4. 判断手順
37
38
 
38
39
  1. `git diff --stat _BASE_COMMIT_.._OUTPUT_COMMIT_` と `git diff --name-status _BASE_COMMIT_.._OUTPUT_COMMIT_` で出力範囲を確認する。
39
40
  2. Job Run の plan・result・evidence・Run JSON と、Job が更新した成果物を照合する。
40
- 3. 完了条件を満たす場合は `complete`、軽微な finding を残して統合可能なら `complete-with-findings` とする。
41
- 4. 失敗、対象外変更、根拠不足がある場合は `incomplete` とし、改善指示と waiting の理由を明記する。
41
+ 3. `succeeded` で完了条件を満たす場合は `complete`、軽微な finding を残して統合可能なら `complete-with-findings` とする。
42
+ 4. `partial` で完了分を統合可能かつ失敗分を次の Run へ回せる場合は `complete-with-findings` とする。`partial` に `complete` は使わない。
43
+ 5. 失敗、未完了、対象外変更、根拠不足がある場合は `incomplete` とし、改善指示と waiting の理由を明記する。
42
44
 
43
45
  ## 5. 完了手順
44
46
 
@@ -0,0 +1,46 @@
1
+ _FRONTMATTER_
2
+
3
+ # Register Post-run Review Plan: _ITEM_ID_ _ITEM_TITLE_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ `exec run --register` が統合した変更を読み取り専用で確認し、登録項目を自動で close できるかを判定する。
8
+
9
+ この review は成果物の grade ではなく、登録項目の完了判定である。grade サイドカーの有無や鮮度は判定条件にしない。verdict は `complete`、`complete-with-findings`、`incomplete` のいずれかにする。
10
+
11
+ ## 2. 確認対象
12
+
13
+ - 登録項目: `_ITEM_PATH_`
14
+ - edit plan: `_EDIT_PLAN_REF_`
15
+ - edit result: `_EDIT_RESULT_REF_`
16
+ - executor evidence: `_EDIT_EVIDENCE_REF_`
17
+ - 統合前 commit: `_BASE_COMMIT_`
18
+ - 統合後 commit: `_OUTPUT_COMMIT_`
19
+ - review result: `_RESULT_REF_`
20
+
21
+ ## 3. 完了条件
22
+
23
+ 1. 登録項目の「完了条件」を edit result、統合差分、検証結果と照合している。
24
+ 2. `_BASE_COMMIT_.._OUTPUT_COMMIT_` の差分に対象外の変更が混入していない。
25
+ 3. edit result と executor evidence に、完了を妨げる失敗、未実施の必須検証、未解消の申し送りがない。
26
+ 4. 完了条件を満たす場合は `complete`、軽微な finding を残して完了できる場合は `complete-with-findings`、未充足・根拠不足・検証失敗がある場合は `incomplete` とする。
27
+ 5. review executor は、確認のための読み取り専用コマンドだけを実行し、成果物、登録項目、edit plan/result を変更しない。
28
+
29
+ ## 4. 判断手順
30
+
31
+ 1. 登録項目の概要と完了条件、edit plan、edit result を読む。
32
+ 2. `git diff --stat _BASE_COMMIT_.._OUTPUT_COMMIT_` と `git diff --name-status _BASE_COMMIT_.._OUTPUT_COMMIT_` を実行し、必要に応じて同じ範囲の差分本文を読む。
33
+ 3. executor evidence がある場合は、変更一覧、検証結果、block 理由、申し送りを確認する。`_EDIT_EVIDENCE_REF_` が `-` の場合は、edit result と差分から確認できる範囲を判断根拠に明記する。
34
+ 4. 個票の各完了条件について、満たした根拠または未充足事項を具体的に記録する。
35
+ 5. result の「評価結果の確認」には、この review では grade を使わず、edit の検証結果を確認したことを書く。
36
+
37
+ ## 5. 完了手順
38
+
39
+ 1. review result の全セクションを埋める。
40
+ 2. `decision` に `complete`、`complete-with-findings`、`incomplete` のいずれかを記録する。
41
+ 3. verdict にかかわらず、review 自体を完了できた場合は終了コード 0 とする。
42
+
43
+ ## 6. 異常終了の条件
44
+
45
+ - 登録項目、edit plan/result、または統合差分を読めず review 自体を完了できない場合は終了コード 1 とする。
46
+ - review executor は review result を含むファイルを編集しない。result の記入は reporter が行う。
@@ -340,7 +340,40 @@ git push origin --delete feature/branch-policy
340
340
 
341
341
  レビュー中または共同作業中の branch は無理に改名せず、完了後に新しい命名へ切り替える方が安全です。
342
342
 
343
- ## 10. 作業前後のチェックリスト
343
+ ## 10. プロダクトリポジトリの統合先を指定する
344
+
345
+ 別リポジトリ構成では、SpecDojo はプロダクトリポジトリにブランチ戦略を求めません。求めるのは、プロダクト側のルール(GitHub flow・git flow など)で決めた統合先を `repos[].integration_branch` に指定することだけで、ブランチ名に project ID を入れる必要はありません。`main` への取り込み方と merge の方式は、プロダクト側のルールに任せます。
346
+
347
+ ### 10.1. GitHub flow と git flow での `integration_branch` の選び方
348
+
349
+ | プロダクト側の運用 | `repos[].integration_branch` の指定例 | 解説 |
350
+ | ------------------ | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
351
+ | GitHub flow | トピックのブランチ名(例: `feature/<topic>`) | トピックのブランチから統合先へ統合し、最終的に `main` へは PR で取り込む。トピックごとに書き換える場合もある |
352
+ | git flow | `develop` | feature を `develop` に統合し、`develop` から `main` へ release する。既存の `project/<id>/develop` の仕組みと同じ型で動く |
353
+
354
+ GitHub flow で register の worktree 実行ごとにトピックを変える場合は、`exec run --integration-branch <repo>=<branch>` で設定ファイルを書き換えずに統合先を指定できます。指定がない場合は `repos[].integration_branch`、それも省略した場合はそのリポジトリの現在のブランチを使います。
355
+
356
+ ### 10.2. merge の方式ごとの `Refs:` の残り方
357
+
358
+ プロダクト側の exec branch 上の commit と merge commit には trace key `Refs: <project-id>:<item-id>` が付きます。merge の方式ごとに、この `Refs:` と記録した SHA の残り方が次のとおりです。
359
+
360
+ | merge の方式 | `Refs:`(プロダクト → プロジェクト) | 記録した SHA(プロジェクト → プロダクト) |
361
+ | ------------ | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
362
+ | merge commit | 残る | 統合先の祖先として残る |
363
+ | rebase merge | exec branch 上の commit の `Refs:` は残る。runner の merge commit は直線化で落ちる | SHA が変わると先祖ではなくなる |
364
+ | squash merge | GitHub の設定次第。「Pull request title」だけでは消え、「Pull request title and commit details」なら残る | 統合先の祖先ではなくなる。GitHub では PR の参照から辿れる |
365
+
366
+ squash merge を使う場合は、squash の commit メッセージに `Refs:` の行を残す設定(GitHub で「Pull request title and commit details」を選ぶなど)にします。`Refs: <project-id>:<item-id>` が消えると追跡が切れるためです。
367
+
368
+ ### 10.3. 追跡を trace key で行う
369
+
370
+ 追跡は SHA ではなく trace key(`Refs: <project-id>:<item-id>`)を主にします。`git log --grep` で辿れます。
371
+
372
+ ```bash
373
+ git log --grep "Refs: <project-id>:<item-id>" --oneline
374
+ ```
375
+
376
+ ## 11. 作業前後のチェックリスト
344
377
 
345
378
  | 時点 | 確認内容 |
346
379
  | -------------------- | -------------------------------------------------------------------- |
@@ -375,6 +375,8 @@ app1-workspace/
375
375
 
376
376
  `.specdojo/specdojo.config.json` の project パスは `app1-specdojo/` を基準とします。`config init` はリポジトリのディレクトリ名から `run.worktree_base` を作るため、この例では `../app1-specdojo-worktrees` になります。SpecDojo CLI の実行、プロジェクト成果物の解決、doc index の生成、運用記録の検証は `app1-specdojo/` 側で行います。
377
377
 
378
+ VS Code でプロジェクトリポジトリとプロダクトリポジトリを同時に開く場合は、`specdojo config scaffold --workspace` を実行して `<project-id>.code-workspace` を作成します。ワークスペースにはプロジェクトリポジトリ自身(`.`)と宣言した各プロダクトリポジトリ(`repos[].path`)が含まれ、worktree や隣接するリポジトリをシームレスに操作できます。
379
+
378
380
  ### 10.3. プロダクト文書の配置
379
381
 
380
382
  プロダクト文書は実装と同期して改訂するため、`app1/docs/ja/product/` に置きます。README、ソースコードから生成する API リファレンス、パッケージ利用者向けの手順など、コードと同じ revision で読む付属文書も `app1/` に置きます。