specdojo 0.3.0 → 0.4.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 (245) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +77 -18
  3. package/dist/catalog/build-references.js +144 -0
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +18 -295
  6. package/dist/{catalog.js → catalog/catalog.js} +11 -11
  7. package/dist/{catalog-generate.js → catalog/generate.js} +13 -16
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +5 -5
  10. package/dist/{catalog-plan.js → catalog/plan.js} +9 -9
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +6 -6
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +103 -37
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/dashboard/dashboard-timeline.js +175 -0
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +16 -549
  19. package/dist/dashboard/exec-records.js +105 -0
  20. package/dist/dashboard/routines.js +256 -0
  21. package/dist/dashboard/shared.js +14 -0
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +7 -7
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +3 -3
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +2 -2
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +3 -3
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +5 -5
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec.js → exec/commands.js} +22 -467
  39. package/dist/exec/core.js +457 -0
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans.js → exec/plans-core.js} +97 -468
  49. package/dist/exec/plans-generation.js +249 -0
  50. package/dist/exec/plans-storage.js +131 -0
  51. package/dist/exec/plans.js +3 -0
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/exec/repo-integration-git.js +23 -0
  57. package/dist/exec/repo-integration-sync.js +264 -0
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -287
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/exec/reporter-output.js +206 -0
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -216
  62. package/dist/{exec-results.js → exec/results.js} +277 -36
  63. package/dist/exec/run/agent-pipeline.js +276 -0
  64. package/dist/exec/run/agent.js +583 -0
  65. package/dist/exec/run/in-place.js +570 -0
  66. package/dist/exec/run/job.js +746 -0
  67. package/dist/exec/run/lifecycle-commands.js +530 -0
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/exec/run/mode-shared.js +140 -0
  70. package/dist/exec/run/register-command.js +252 -0
  71. package/dist/exec/run/register-core.js +411 -0
  72. package/dist/exec/run/register-mode.js +210 -0
  73. package/dist/exec/run/register-resume.js +398 -0
  74. package/dist/exec/run/register-state.js +325 -0
  75. package/dist/exec/run/register-worktree.js +540 -0
  76. package/dist/exec/run/run.js +11 -0
  77. package/dist/exec/run/schedule-mode.js +294 -0
  78. package/dist/exec/run/schedule-prepare.js +366 -0
  79. package/dist/exec/run/schedule-task.js +599 -0
  80. package/dist/exec/run/shared.js +449 -0
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial.js → exec/trial-commands.js} +23 -388
  97. package/dist/exec/trial-core.js +371 -0
  98. package/dist/exec/trial.js +2 -0
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/exec/worktree-ops-commit.js +672 -0
  101. package/dist/exec/worktree-ops-lifecycle.js +297 -0
  102. package/dist/exec/worktree-ops-merge.js +344 -0
  103. package/dist/exec/worktree-ops.js +3 -0
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/grade/apply.js +734 -0
  106. package/dist/grade/command-apply.js +250 -0
  107. package/dist/grade/command-inspect.js +138 -0
  108. package/dist/grade/command-plan.js +101 -0
  109. package/dist/grade/command-shared.js +68 -0
  110. package/dist/grade/core.js +307 -0
  111. package/dist/grade/grade.js +19 -0
  112. package/dist/grade/markdown.js +274 -0
  113. package/dist/grade/pipeline-state.js +184 -0
  114. package/dist/grade/plan.js +507 -0
  115. package/dist/{grade-result.js → grade/result.js} +7 -96
  116. package/dist/grade/target-discovery.js +265 -0
  117. package/dist/grade/targets.js +435 -0
  118. package/dist/{job.js → job/definition.js} +32 -574
  119. package/dist/job/job.js +568 -0
  120. package/dist/{kata-command.js → kata/command.js} +4 -4
  121. package/dist/{kata.js → kata/kata.js} +5 -5
  122. package/dist/register/approach.js +134 -0
  123. package/dist/register/command-types.js +1 -0
  124. package/dist/register/core.js +369 -0
  125. package/dist/register/create-commands.js +352 -0
  126. package/dist/{register-date.js → register/date.js} +1 -1
  127. package/dist/register/derivation.js +163 -0
  128. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  129. package/dist/{register-events.js → register/events.js} +12 -6
  130. package/dist/{register-history.js → register/history.js} +7 -6
  131. package/dist/{register-item.js → register/item.js} +28 -10
  132. package/dist/register/lifecycle-lock.js +5 -0
  133. package/dist/register/maintenance-commands.js +193 -0
  134. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  135. package/dist/register/migration.js +268 -0
  136. package/dist/register/register.js +404 -0
  137. package/dist/register/renumber.js +341 -0
  138. package/dist/register/transition-commands.js +248 -0
  139. package/dist/register/update.js +230 -0
  140. package/dist/register/views.js +296 -0
  141. package/dist/{review-grade.js → review/grade.js} +2 -2
  142. package/dist/{review-plan.js → review/plan.js} +5 -5
  143. package/dist/routine/definition.js +401 -0
  144. package/dist/{routine.js → routine/routine.js} +50 -419
  145. package/dist/{schedule-approach.js → schedule/approach.js} +9 -9
  146. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  147. package/dist/{schedule.js → schedule/schedule.js} +9 -9
  148. package/dist/schedule/strategy-generate-document.js +273 -0
  149. package/dist/schedule/strategy-generate-scope.js +199 -0
  150. package/dist/schedule/strategy-generate.js +348 -0
  151. package/dist/shared/agent-types.js +23 -0
  152. package/dist/shared/artifact-path.js +9 -0
  153. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  154. package/dist/shared/catalog-render.js +115 -0
  155. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  156. package/dist/shared/fs.js +30 -0
  157. package/dist/shared/git.js +316 -0
  158. package/dist/shared/grade-result.js +94 -0
  159. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  160. package/dist/shared/plan-templates.js +114 -0
  161. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  162. package/dist/shared/random.js +4 -0
  163. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  164. package/dist/shared/schedule-paths.js +9 -0
  165. package/dist/{specdojo-config.js → shared/specdojo-config.js} +96 -9
  166. package/dist/{exec-shared.js → shared/text.js} +0 -134
  167. package/dist/shared/time.js +28 -0
  168. package/dist/shared/yaml.js +28 -0
  169. package/dist/specdojo.js +22 -22
  170. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  171. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  172. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  174. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  175. package/docs/ja/specdojo/guides/exec-config-guide.md +97 -22
  176. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  177. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  178. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +51 -18
  179. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  180. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  181. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  182. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  183. package/docs/ja/specdojo/guides/routine-operation-guide.md +6 -6
  184. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  185. package/docs/ja/specdojo/references/command-reference.md +52 -28
  186. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  187. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  188. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  189. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  190. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  191. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  192. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  193. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  194. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  195. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  196. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  197. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  198. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  199. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  200. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  201. package/package.json +4 -5
  202. package/templates/antigravity/README.md +7 -3
  203. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  204. package/templates/antigravity/exec-defaults-snippet.yaml +10 -13
  205. package/templates/claude/README.md +27 -3
  206. package/templates/claude/agents/claude-executor.md +0 -1
  207. package/templates/claude/agents/claude-reporter.md +2 -1
  208. package/templates/claude/agents/claude-review-executor.md +0 -1
  209. package/templates/codex/README.md +23 -4
  210. package/templates/devcontainer/devcontainer.json +2 -2
  211. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  212. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  213. package/templates/init-agent-members.yaml +75 -25
  214. package/templates/init-exec-defaults.yaml +26 -8
  215. package/templates/opencode/README.md +17 -3
  216. package/templates/opencode/agents/opencode-executor.md +0 -1
  217. package/templates/opencode/agents/opencode-reporter.md +2 -1
  218. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  219. package/dist/exec-run.js +0 -6182
  220. package/dist/exec-schedule-gantt-chart.js +0 -2
  221. package/dist/exec-worktree-ops.js +0 -1292
  222. package/dist/exec-worktree.js +0 -446
  223. package/dist/grade.js +0 -3193
  224. package/dist/register.js +0 -2407
  225. package/dist/schedule-strategy-generate.js +0 -812
  226. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  227. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  228. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  229. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  230. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  231. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  232. /package/dist/{exec-types.js → exec/types.js} +0 -0
  233. /package/dist/{review-types.js → review/types.js} +0 -0
  234. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  235. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  236. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  237. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  238. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  239. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  240. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  241. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  242. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  243. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  244. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  245. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
@@ -48,9 +48,10 @@ question を起票する(迷っていること)
48
48
  プロジェクトリポジトリを作り、SpecDojo を導入して `init` の質問に答えます。
49
49
 
50
50
  ```bash
51
- mkdir app1-specdojo
52
- git -C app1-specdojo init
53
- cd app1-specdojo
51
+ mkdir app1-workspace
52
+ mkdir app1-workspace/app1-specdojo
53
+ git -C app1-workspace/app1-specdojo init
54
+ cd app1-workspace/app1-specdojo
54
55
  npm init -y
55
56
  npm install --save-dev specdojo
56
57
  npx specdojo init
@@ -66,11 +67,14 @@ Your nickname [owner]: owner
66
67
  Your display name [Project Owner]: 店主
67
68
  Orchestrator providers (...) [codex]: claude <- 使う AI ツールを 1 つ選ぶ
68
69
  Delegate work to agents (exec)? [y/N]: <- Enter(実戦は後で設定する)
69
- Deliverables catalog (none|small|medium|large) [none]: <- Enter(カタログは使わない)
70
70
  Create a Dev Container? [y/N]: <- Enter
71
71
  ```
72
72
 
73
- 登録簿は `docs/ja/projects/prj-0001/controls/project-register/` に作られます。オーケストレーターで進める場合は、終了時に表示される `npm run orch:<provider>` で起動します。
73
+ 入力が不正な場合は理由が表示され、同じ質問だけがもう一度表示されます。たとえば provider に
74
+ `claud` と入力すると、利用可能な provider の一覧に続いて provider の質問だけが再表示されます。
75
+ それまでに答えた project や名簿の内容を入力し直す必要はありません。
76
+
77
+ 登録簿は `docs/ja/projects/prj-0001/controls/project-register/` に作られます。オーケストレーターで進める場合は、終了時に表示される `npm run orch:<provider>` で起動します。成果物カタログは対話では作られません。成果物の構成が定まったら、[[#41-成果物カタログを作成する|成果物カタログを作成する]] に従って `catalog_path` を設定し、`catalog scaffold` で追加してください。
74
78
 
75
79
  ### 1.2. 迷っていることを起票する(question)
76
80
 
@@ -191,6 +195,8 @@ npx specdojo register build --project prj-0001
191
195
 
192
196
  ## 2. CLIを初期設定する
193
197
 
198
+ Node.js 22.13 以上と Git を用意します。オーケストレーターに Claude Code を使う場合は、Claude Code も導入してログインしておきます。ほかの provider も選べます。
199
+
194
200
  既定では、SpecDojo の成果物更新、登録簿の状態遷移、実行記録をプロダクトの Git 履歴に混ぜないため、次の **別リポジトリ構成**で始めます。
195
201
 
196
202
  - **プロダクトリポジトリ** `app1/`: ソースコードと、仕様・設計などのプロダクトドキュメントを置きます。
@@ -204,24 +210,27 @@ app1-workspace/
204
210
  └── app1-specdojo-worktrees/ # task 単位の worktree 置き場
205
211
  ```
206
212
 
207
- `app1-workspace/` 直下でプロジェクトリポジトリと worktree 用ディレクトリを作成し、`app1-specdojo/` に依存パッケージと SpecDojo の設定ファイルを用意します。
213
+ 既に開発している `app1/` と並べてプロジェクトリポジトリを作り、`app1-specdojo/` に SpecDojo を導入します。worktree 用ディレクトリは、最初の隔離実行時に設定に従って作られます。
208
214
 
209
215
  ```bash
210
- mkdir app1-specdojo
211
- git -C app1-specdojo init
212
- cd app1-specdojo
216
+ mkdir app1-workspace
217
+ mkdir app1-workspace/app1-specdojo
218
+ git -C app1-workspace/app1-specdojo init
219
+ cd app1-workspace/app1-specdojo
213
220
  npm init -y
214
- npm install --save-dev specdojo @specdojo/docs-lint
221
+ npm install --save-dev specdojo
215
222
  # 質問に答えて project、register、agent 実行までを初期設定する
216
223
  npx specdojo init
217
224
  ```
218
225
 
219
226
  `specdojo init` は、project ID と名前、人の nickname と表示名、利用する agent provider、
220
- exec・成果物カタログ・Dev Container の要否を順に質問します。選択に応じて設定、登録簿、人と
227
+ exec・Dev Container の要否を順に質問します。成果物カタログは対話では質問せず、`--catalog <size>` を
228
+ 明示した場合にだけ初期化時に作成します。選択に応じて設定、登録簿、人と
221
229
  agent の名簿、provider の scaffold、`package.json` の `orch:<provider>`、exec の起動設定を
222
230
  作成します。exec の親検証は、対応する npm script が `package.json` にあるものだけを設定し、
223
231
  該当する script がなければ省略します。既存ファイルは上書きせず、作成内容は `--dry-run` で
224
- 先に確認できます。
232
+ 先に確認できます。対話中に不正な値を入力した場合は理由を表示して同じ質問だけをやり直し、
233
+ それまでの回答は保持します。非対話環境や `--yes` では再質問せず、不正な指定をエラーとして終了します。
225
234
 
226
235
  CI や標準入力が端末でない環境では質問しません。次のようにオプションだけで同じ初期設定を
227
236
  行えます。省略値は画面に表示されます。
@@ -234,18 +243,74 @@ npx specdojo init --yes \
234
243
  --display-name "Project Owner" \
235
244
  --provider claude,codex \
236
245
  --exec \
237
- --catalog small \
238
246
  --devcontainer \
239
247
  --dry-run
240
248
  ```
241
249
 
242
250
  初期化後は、表示された `npm run orch:<provider>` でオーケストレーターを起動し、最初の 1 件を
243
- 起票します。オーケストレーターを使わない場合は、同じ案内に表示される
251
+ 起票します。成果物カタログが必要になった場合は、`.specdojo/specdojo.config.json` に `catalog_path` を設定して `specdojo catalog scaffold` で追加します(詳細は [[#41-成果物カタログを作成する|成果物カタログを作成する]] を参照)。オーケストレーターを使わない場合は、同じ案内に表示される
244
252
  `exec run --register <id> --executor-by <executor> --reporter-by <reporter>` で実行できます。
245
253
  作成された設定と文書は内容を確認して commit してください。
246
254
 
247
- `@specdojo/docs-lint` は SpecDojo 文書向けの remark プラグインと検証コマンドを提供します。
248
- 最小構成では、リポジトリルートの `.remarkrc.yaml` から次のように公開 export を参照できます。
255
+ LP の例と同じく Claude Code へ作業を任せる場合は、provider の質問に `claude`、exec の質問に「はい」と答えます。初期化後は `npm run orch:opus`(または `npm run orch:sonnet`)でオーケストレーターを起動できます。
256
+
257
+ プロダクトを変更する前に、`.specdojo/specdojo.config.json` の `projects.prj-0001` へ、同じ workspace にあるプロダクトリポジトリを接続します。
258
+
259
+ ```json
260
+ "repos": [
261
+ {
262
+ "name": "app1",
263
+ "path": "../app1",
264
+ "integration_branch": "main"
265
+ }
266
+ ]
267
+ ```
268
+
269
+ 最初の作業を起票して個票へ完了条件を書いたら、Claude Code の executor と reporter を指定して実行できます。
270
+
271
+ ```bash
272
+ npx specdojo register add \
273
+ --project prj-0001 \
274
+ --type todo \
275
+ --title "最初のタスク"
276
+ npx specdojo exec run \
277
+ --project prj-0001 \
278
+ --register PJR-XXXX \
279
+ --worktree \
280
+ --executor-by claude-executor \
281
+ --reporter-by claude-reporter
282
+ ```
283
+
284
+ 実行後は両方のリポジトリの commit とプロダクトの動作を確認します。
285
+
286
+ ```bash
287
+ git -C ../app1 log --oneline -1
288
+ git log --oneline -1
289
+ npm --prefix ../app1 run dev
290
+ ```
291
+
292
+ 人が result と成果物を確認し、気づいた改善を次の `todo` や `issue` として残してから、元の登録項目を close します。
293
+
294
+ ```bash
295
+ npx specdojo register add \
296
+ --project prj-0001 \
297
+ --type todo \
298
+ --title "次の改善" \
299
+ --commit
300
+ npx specdojo register close \
301
+ --project prj-0001 \
302
+ --id PJR-XXXX \
303
+ --conclusion "完了条件を満たした" \
304
+ --commit
305
+ ```
306
+
307
+ `@specdojo/docs-lint` は初期設定に必須ではありません。SpecDojo 文書向けの remark プラグインと検証コマンドを使う場合だけ追加します。
308
+
309
+ ```bash
310
+ npm install --save-dev @specdojo/docs-lint
311
+ ```
312
+
313
+ リポジトリルートの `.remarkrc.yaml` から次のように公開 export を参照できます。
249
314
 
250
315
  ```yaml
251
316
  plugins:
@@ -83,7 +83,7 @@ specdojo register add --project <project-id> --type todo \
83
83
  --title "在庫初期データの登録" --topic inventory-seed
84
84
  ```
85
85
 
86
- タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID を変更できます。
86
+ タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID を変更できます。成果物や kata(実践の型)を作成・修正する todo では、`--approach <approach> --target <doc-id>` を指定して進め方と対象を宣言できます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
87
87
 
88
88
  `--priority` は次の目安で付けます(省略時は `medium`)。
89
89
 
@@ -362,6 +362,7 @@ specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree
362
362
 
363
363
  - type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
364
364
  - 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
365
+ - todo 個票に `approach` と `targets` を指定した場合、成果物カタログの `done_criteria` や kata 参照を取り込んだ schedule と共通の plan が生成されます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
365
366
  - 個票 Frontmatter の `targets` に宣言した変更対象文書は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。`targets` がない場合は finding を展開しません。「関連ドキュメント」は根拠や参考への導線であり、そこに wikilink があるだけでは解消対象になりません。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
366
367
  - `--register` には複数の PJR-ID を空白区切り・カンマ区切り(またはその混在)で渡せます。指定順に1件ずつ実行し、各IDが plan/result 生成・開始・agent実行・状態遷移まで完結してから次へ進みます。重複したIDは最初の1件だけを実行します。
367
368
  - 全ID処理後にID別の成否・状態遷移・commit 結果を一覧表示します。いずれかが失敗した場合は終了コード 1 で終了します。
@@ -60,7 +60,9 @@ npx specdojo devcontainer scaffold --provider claude,codex
60
60
 
61
61
  既存の `.devcontainer/` は通常実行では上書きしません。置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存し、ホストの認証情報・秘密鍵・`.env` は既定でマウントしません。Ollama 接続、コンテナ内の cron、コンテナ内の tmux が必要な場合だけ `--ollama`、`--cron`、`--tmux` を追加します。本書の構成図のようにホスト側の tmux でコンテナ自体を包む場合、`--tmux` は不要です。
62
62
 
63
- 生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリを `/workspaces/specdojo-workspace` へマウントします。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
63
+ 生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリをホスト側と同じ名前の `/workspaces/<親名>` へマウントします。例えば `app1-workspace/app1-specdojo` の作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
64
+
65
+ 親名に空白や `/` などがある場合は scaffold が停止するため、`--workspace-name <name>` で英数字・`.`・`_`・`-` だけの名前を指定します。また、コンテナ内で作成した Git worktree は絶対パスを記録します。ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定し、コンテナ内のパスを維持してください。
64
66
 
65
67
  端末版 Emacs と TypeScript・Markdown・YAML・Bash の LSP 環境を追加する場合は `--editor emacs` を指定します。
66
68
 
@@ -70,6 +72,13 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
70
72
 
71
73
  生成される `.devcontainer/emacs/init.el` は、`~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけコピーされます。空の `~/.emacs.d` があればその中の `init.el` へ、なければ `~/.config/emacs/init.el` へ配置し、配置先を出力します。初回作成前の既定値は生成されたテンプレートで変更でき、作成後は出力されたコピー先を編集します。dotfiles が設定を配置していれば上書きされません。
72
74
 
75
+ scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
76
+
77
+ - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。devcontainer が停止していれば `devcontainer up` で起動し、コンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
78
+ - `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。
79
+
80
+ `devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
81
+
73
82
  ## 3. 構成例
74
83
 
75
84
  ```text
@@ -174,7 +174,7 @@ viewpoint は継続品質評価 `specdojo grade` の正本です。review plan
174
174
 
175
175
  `document_kinds.include` は列挙した種類だけへ適用し、`document_kinds.exclude` は列挙した種類を除外します。二つは同時に指定できません。宣言を省略した観点は全種類へ適用します。`grade_targets` は kata / deliverable という評価経路の大分類、`document_kinds` は rulebook ID による文書種類の細分類であり、両方を指定した場合は双方を満たす文書だけを対象にします。
176
176
 
177
- `include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
177
+ `include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/docs/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
178
178
 
179
179
  `grade_rubric` の level 0-4 は category を跨いで共有し、viewpoint score を `level × 25` とします。`grade_rubric` には level ごとの `review_verdict`(level 4 が `complete`、level 3 が `complete-with-findings`、level 0-2 が `incomplete`)が定義されています。これは grade の level を review の入力にする写像であり、review はこの対応で観点を判定し直しません。写像の使い方は `grade の結果を review の入力にする規則` に示します。
180
180
 
@@ -69,9 +69,9 @@ review agent は、`exec run` の `--review-by` / `--reporter-by`、Job の `tas
69
69
 
70
70
  action の `commit: true` は互換として残しています。`task.review` を宣言していない Job でも `commit: true` なら同じ流れで実行しますが、新しい routine では推奨しません。Job が `task.review` を宣言している場合は Job を優先し、`commit` を省略しても、`false` を指定しても review を経て統合します。
71
71
 
72
- 統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
72
+ 統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `partial` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
73
73
 
74
- 出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合だけ、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
74
+ 出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合に加え、Run が `partial` で verdict が `complete-with-findings` の場合も、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。`partial`を統合した routine は`last_result: partial`と記録し、`routine list`でも部分成功を表示します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
75
75
 
76
76
  #### waiting Run の確認・統合・破棄
77
77
 
@@ -123,7 +123,7 @@ action:
123
123
  mode: strict
124
124
  ```
125
125
 
126
- 配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure` または `skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
126
+ 配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure`、`partial`、`skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`partial`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも部分成功なら `partial`、そのどちらもなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
127
127
 
128
128
  配列 action の実行後は、通常の `last_result` に加えて段ごとの `index`(1始まり)、`kind`、`result` を `last_action_results` へ記録します。単一オブジェクトの action では `last_action_results` を記録せず、既存の状態形式を維持します。
129
129
 
@@ -164,7 +164,7 @@ Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で execu
164
164
 
165
165
  成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
166
166
 
167
- `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日6時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
167
+ `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日5時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
168
168
 
169
169
  `changed_only: true` は、本文の変更に加えて、観点定義の `comparison_sources` で宣言した突き合わせ先(成果物カタログの自身の項目、依存先、Schedule、メンバー定義、ロール定義、RACI、組織定義)の変更も検出します。検出範囲と検出しない変更は `command-reference.md` の `grade` の説明に従います。突き合わせ先の記録(`source_hashes`)を持たない既存の評価は一度だけ変更扱いになるため、導入直後は `rtn-grade-deliverable-recheck` の選択が上限の10件に張り付きます。2026-09-27 時点の成果物 46 件がすべて該当し、約5日で記録が揃います。その後は突き合わせ先を変更した日だけ、その突き合わせ先を持つ成果物が選ばれます。現在の宣言では Kata に適用される観点は突き合わせ先を持たないため、`rtn-grade-recheck` の選択は変わりません。
170
170
 
@@ -190,7 +190,7 @@ Job runnerは、この入口をmaterialize済みの引数で1回起動し、コ
190
190
 
191
191
  scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。保存済み state の `stage_total` が現在の構成と異なる場合は、古い grade の日時にかかわらず完了扱いへ移行せず、state を削除して1段目から再評価します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
192
192
 
193
- Job Definition は script を `if` の条件として起動し、非0の終了コードを保存してそのまま Job runner へ返します。これにより、後続の `results.tsv` 表示が rate limit や中断の終了コードを0へ上書きしません。script が正常終了した場合だけ `grade pipeline complete:` と `results.tsv` が command evidence に揃い、analysis reporter が起動します。
193
+ Job Definition は script を `if` の条件として起動し、終了コードを保存してそのまま Job runner へ返します。script は全件完了を0、完了文書と失敗文書の混在を2、全件失敗を1、rate limitを75で返します。grade Jobは`partial_exit_code: 2`を宣言するため、2だけが`partial`になりanalysis reporterとreviewへ進みます。Jobは0と2のどちらでも`results.tsv`をcommand evidenceへ出力します。reviewは、`passed`が1件以上あり、`failed`の文書と失敗段がpipeline stateへ記録され次回の`--incomplete`で再試行できる場合だけ`complete-with-findings`を選べます。全件失敗、rate limit、中断、未開始文書があるRunは統合せず`waiting`にします。
194
194
 
195
195
  ## 2. due判定と実行
196
196
 
@@ -242,7 +242,7 @@ specdojo routine run --project <project-id> --due --dry-run
242
242
  [routine] skipped rtn-daily-register-sweep: job action skipped
243
243
  ```
244
244
 
245
- `routine-state.json` の `last_result` は `success`、`failure`、`skipped` のいずれかです。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
245
+ `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
246
246
 
247
247
  ### 2.1. devcontainerでのcron設定
248
248
 
@@ -69,7 +69,7 @@ flowchart TD
69
69
  ### 2.1. 新規プロジェクトを最短で立ち上げる
70
70
 
71
71
  - ゴール: 設定から1タスク完了までを最短で通す。
72
- - 進め方: `config init` → 成果物カタログ作成・検証・生成 → トラック戦略作成 → `schedule build` → `exec refresh` → 1タスクを claim / complete。
72
+ - 進め方: `specdojo init` → `register add` → 個票へ完了条件を記入 → `exec run --register --worktree` → 変更と動作を確認 → `register close`。成果物を計画的に増やす場合は、その後に成果物カタログと Schedule へ広げる。
73
73
  - 主に使う文書: [Quick Startガイド](quick-start-guide.md)、[遂行の技活用ガイド](waza-guide.md)。
74
74
 
75
75
  ### 2.2. 課題整理から目的・スコープを固める
@@ -47,31 +47,36 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
47
47
  | `project list` | 登録済み project を表示する | `specdojo project list` |
48
48
 
49
49
  `init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
50
- provider、exec、成果物カタログの規模、Dev Container の順に質問します。既存ファイルは上書きせず、
51
- スキップしたパスを表示します。`--dry-run` は予定だけを表示し、ファイルや `package.json` を変更しません。
50
+ provider、exec、Dev Container の順に質問します。成果物カタログは対話では質問せず、`--catalog <size>` を
51
+ 明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
52
+ 予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
53
+ 表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
54
+ 空の場合も、provider の質問だけをやり直します。非対話環境や `--yes` では再質問せず、従来どおり不正な
55
+ 指定をエラーとして終了します。
52
56
 
53
57
  非対話環境では質問せず、次の主要オプションと既定値を使います。
54
58
 
55
- | オプション | 用途 | 既定値 |
56
- | ----------------------- | --------------------------------------------------- | --------------- |
57
- | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
58
- | `--project <id>` | project ID | `prj-0001` |
59
- | `--name <name>` | project の表示名 | `My Project` |
60
- | `--no-register` | register を作らない | register を作る |
61
- | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
62
- | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
63
- | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
64
- | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
65
- | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る | 作らない |
66
- | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
67
- | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
59
+ | オプション | 用途 | 既定値 |
60
+ | ------------------------- | ------------------------------------------------------------------------- | --------------- |
61
+ | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
62
+ | `--project <id>` | project ID | `prj-0001` |
63
+ | `--name <name>` | project の表示名 | `My Project` |
64
+ | `--no-register` | register を作らない | register を作る |
65
+ | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
66
+ | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
67
+ | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
68
+ | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
69
+ | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
+ | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
72
+ | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
68
73
 
69
74
  `init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
70
75
  provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
71
76
  ID だけを `pipeline.parent_validations` へ設定し、該当する script がなければこの設定を省略します。
72
77
  採用した ID と省略理由は実行時に表示します。最後にオーケストレーターの起動コマンド、最初の起票、
73
78
  オーケストレーターを使わない `--executor-by` / `--reporter-by` の実行例、作成ファイルの commit を
74
- 次の一歩として表示します。`run.worktree_base` は `../<リポジトリ名>-worktrees` です。個別に設定する
79
+ 次の一歩として表示します(カタログを作らなかった場合は、後から `catalog scaffold` で追加する案内も含みます)。`run.worktree_base` は `../<リポジトリ名>-worktrees` です。個別に設定する
75
80
  場合は、以下の `config init`、`config scaffold`、`register scaffold` などを利用します。
76
81
 
77
82
  `config init` は、register 単体で始められる `prj-0001` の最小設定を作成し、設定確認、任意の
@@ -346,6 +351,8 @@ specdojo schedule strategy generate \
346
351
  | `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
347
352
  | `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
348
353
  | `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
354
+ | `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除) | `add` / `update` |
355
+ | `--target <doc-id>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
349
356
  | `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
350
357
  | `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
351
358
  | `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
@@ -359,19 +366,25 @@ specdojo schedule strategy generate \
359
366
 
360
367
  `register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
361
368
 
369
+ `--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
370
+
362
371
  `item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
363
372
 
364
373
  `--registered` / `--completed` にはタイムゾーン付きの RFC 3339 値(`2026-08-09T14:08:51Z` または `2026-08-09T23:08:51+09:00`)を指定し、保存時に UTC へ正規化します。タイムゾーンを含まない値は解釈が実行環境に依存するため受け付けません。期限(`--due`)は瞬間ではなく暦日のため `YYYY-MM-DD` のままです。
365
374
 
366
375
  `register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
367
376
 
377
+ `register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照と存在しない項目は書き込み前に拒否します。別 project が設定にあれば存在も確認し、未設定なら書式だけを確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
378
+
379
+ `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
380
+
368
381
  記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
369
382
 
370
383
  一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
371
384
 
372
385
  `register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
373
386
 
374
- `register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason` です。
387
+ `register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`derived_from` です。
375
388
 
376
389
  各書き込みコマンドは現在値を個票へ、event を項目別イベントファイルへ反映します。同じ現在値になる操作の再実行では event を追加しません。`register build` は個票とイベントファイルの対応、event の schema、ID 一意性、時刻順、直前イベント参照、状態連鎖、最新 event と現在値の一致を検証します。
377
390
 
@@ -445,10 +458,15 @@ specdojo schedule strategy generate \
445
458
  | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
446
459
  | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
447
460
  | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
461
+ | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
462
+ | `--fallback-executor-by <name>` | `fallback` 時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
463
+ | `--fallback-reporter-by <name>` | `fallback` 時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
448
464
  | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
449
465
 
450
466
  `--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
451
467
 
468
+ 指名した agent の rate limit は既定では `stop` です。`wait` は provider の reset / retry-after、次に `rate_limit_policy.cooldown_seconds` を使い、`rate_limit_policy.pinned.max_wait_seconds`(既定8時間)以内なら同じ段を同じ agent で再開します。`fallback` は対応する fallback flag または `rate_limit_policy.pinned.fallback_executor_by` / `fallback_reporter_by` の agent へ1回だけ切り替えます。fallback 未指定時と fallback agent も上限になった場合は停止します。CLI が `exec-defaults.yaml` より優先します。待機中は project の実行ロックを保持します。
469
+
452
470
  agent の指定は repository 共通 roster nickname(`.specdojo/agent-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
453
471
 
454
472
  Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` の既定の実行方式です。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの agent 選択は行いません。`--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると、その agent で実行します。`--by` と `--executor-by` / `--reporter-by` をいずれも指定しない場合は、`stage_role: executor`(`mode: edit` または `mode` 未指定)と `stage_role: reporter` の agent から `priority` 順に自動で選びます。`stage_role` を持たない agent(翻訳専用など)は自動選択の候補に入りません。どちらかの段に該当する agent がいない場合は、`--executor-by` / `--reporter-by` の指定を求めるエラーで実行前に止まります。複数項目では `--executor-by PJR-0001=exec-a,PJR-0002=exec-b` のような項目別指定も使用できます。項目別指定は選択した全項目を含む必要があり、対象外 ID と指定漏れは実行前にエラーになります。片方だけの指定もエラーになります。
@@ -889,19 +907,20 @@ Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加
889
907
  | ----------------------- | ------------------------------------------- |
890
908
  | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
891
909
 
892
- `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` を指定した場合は Emacs 用の `emacs/init.el` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
910
+ `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` を指定した場合は Emacs 用の `emacs/init.el` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
893
911
 
894
912
  主要オプション:
895
913
 
896
- | オプション | 用途 |
897
- | -------------------- | ----------------------------------------------------------- |
898
- | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
899
- | `--editor emacs` | 端末版 Emacs、LSP・検索ツール、初期設定を追加する。 |
900
- | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
901
- | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
902
- | `--tmux` | tmux をインストールする。 |
903
- | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
904
- | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
914
+ | オプション | 用途 |
915
+ | ------------------------- | ----------------------------------------------------------- |
916
+ | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
917
+ | `--editor emacs` | 端末版 Emacs、LSP・検索ツール、初期設定を追加する。 |
918
+ | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
919
+ | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
920
+ | `--tmux` | tmux をインストールする。 |
921
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
922
+ | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
923
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
905
924
 
906
925
  ```bash
907
926
  # claude と codex 用の CLI を含む Dev Container を生成する
@@ -912,11 +931,16 @@ npx specdojo devcontainer scaffold --provider claude --ollama --tmux
912
931
 
913
932
  # 端末版 Emacs と、すぐ使える組み込み機能だけの設定を追加する
914
933
  npx specdojo devcontainer scaffold --provider claude --editor emacs
934
+
935
+ # ホスト側の親名を変えた後も、コンテナ内の従来パスを保つ
936
+ npx specdojo devcontainer scaffold --workspace-name app1-workspace
915
937
  ```
916
938
 
917
939
  `.devcontainer/` が既に存在する場合は何も書き込まず、置き換える場合だけ `--force` を指定します。上書き前や初回生成前は `--dry-run` で対象ファイルを確認してください。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存してコンテナ再作成後も利用できるようにし、ホストの認証情報・秘密鍵・`.env` を直接マウントしません。認証は生成したコンテナ内で行います。
918
940
 
919
- 生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を `/workspaces/specdojo-workspace` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
941
+ 生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を、ホスト側の親ディレクトリ名に合わせた `/workspaces/<親名>` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。例えば `app1-workspace/app1-specdojo` で scaffold すると、作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
942
+
943
+ 親名には英数字・`.`・`_`・`-` だけを使用できます。空白、`/`、制御文字などを含む場合は、意図しないパスへ置換せずエラーにします。必要なら `--workspace-name <name>` で有効な名前を指定してください。`specdojo init --devcontainer` でも同じオプションを指定できます。コンテナ内で作った Git worktree は作成時の絶対パスを記録するため、ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定してコンテナ内のパスを保ってください。
920
944
 
921
945
  `codex` provider を指定した場合だけ、生成する `devcontainer.json` の `runArgs` に `--security-opt=seccomp=unconfined` を追加します。Docker の既定 seccomp profile は Codex 同梱の bubblewrap が sandbox 作成時に使う user namespace の作成を拒否するためです。この設定は devcontainer 全体の syscall filter を無効にしてコンテナの隔離を弱めますが、追加の Linux capability は付与せず、Docker が保護する `/proc` や `/sys` の system path も公開しません。`--security-opt=systempaths=unconfined` は保護範囲をさらに広げるため使用しません。
922
946
 
@@ -22,7 +22,7 @@ Project Register Documentation Rules
22
22
  ## 1. 全体方針
23
23
 
24
24
  - TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘の全登録項目は、それぞれ 1 件の個票を持つ。
25
- - 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論の唯一の正本である。
25
+ - 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論、起票元の唯一の正本である。
26
26
  - `events/pjr-XXXX.yaml` は、起票・状態遷移・更新を追う監査履歴の正本である。現在値の再計算には使わず、個票の現在値との整合を検証する。
27
27
  - 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
28
28
  - `generated/pjr-index.md` とすべての派生ビューは個票から `register build` で生成し、直接編集しない。
@@ -48,7 +48,7 @@ Project Register Documentation Rules
48
48
  - 個票は `docs/ja/projects/<project-id>/controls/project-register/` 直下に置く。
49
49
  - 項目別イベントログは同ディレクトリの `events/` 配下に置き、個票 1 件につき 1 ファイルとする。
50
50
  - 登録項目一覧は `docs/ja/projects/<project-id>/controls/project-register/generated/pjr-index.md` に生成する。
51
- - 状態別・優先度別・担当者別の補助一覧は同じ `generated/` 配下に生成する。
51
+ - 状態別・優先度別・担当者別の補助一覧と、元の項目から派生先を辿る一覧は同じ `generated/` 配下に生成する。
52
52
  - controls 全体の type 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
53
53
 
54
54
  ## 3. 推奨 Frontmatter 項目
@@ -71,12 +71,15 @@ Project Register Documentation Rules
71
71
  | `completed_at` | 完了・却下・決定日時 | 条件 |
72
72
  | `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
73
73
  | `conclusion` | 終端時の結論要約 | 任意 |
74
+ | `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
75
+ | `approach` | 対象を作成・修正するときの進め方 | 任意 |
74
76
  | `targets` | 変更対象文書の doc id リスト | 任意 |
75
77
 
76
78
  - `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
77
79
  - `item_type`、`item_status`、`priority` の値は schema の enum だけを使用する。
78
80
  - `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
79
81
  - Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
82
+ - `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。別 project が設定にない場合は書式だけを検証し、設定された後に存在確認できるよう project 修飾を維持する。
80
83
 
81
84
  ### 3.1. 日時と日付の使い分け
82
85
 
@@ -109,13 +112,14 @@ Project Register Documentation Rules
109
112
 
110
113
  ### 4.2. 生成一覧と派生ビュー
111
114
 
112
- | 生成物 | 内容 | 編集可否 |
113
- | ------------------------------------ | ------------------- | -------- |
114
- | `generated/pjr-index.md` | 全個票の一覧 | 不可 |
115
- | `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
116
- | `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
117
- | `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
118
- | `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
115
+ | 生成物 | 内容 | 編集可否 |
116
+ | ------------------------------------ | -------------------- | -------- |
117
+ | `generated/pjr-index.md` | 全個票の一覧 | 不可 |
118
+ | `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
119
+ | `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
120
+ | `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
121
+ | `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
122
+ | `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
119
123
 
120
124
  - 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票とする。
121
125
  - タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。
@@ -131,13 +135,15 @@ Project Register Documentation Rules
131
135
  - 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
132
136
  - 結果・結論には、完了を判定した根拠と後続対応を記載する。
133
137
  - 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
138
+ - 実行中に問題や後続作業を見つけて別の登録項目を起票するときは、起票元を `derived_from` に必ず記録する。decision から todo を起票する場合も同じ関係を使い、decision 本文へ追跡先を重複記載しない。既存本文の追跡先は移行のために書き換えない。
134
139
  - 本項目の実施において確実に変更する対象文書が分かっている場合は、その文書 ID を Frontmatter の `targets` 配列へ宣言する。宣言した `targets` は agent 実行時の変更網羅検証(target coverage)に用いられる。未知の場合や対象を固定しない場合は宣言を省略する。
140
+ - `approach` を宣言する場合、`targets` は 1 件だけ必須とする。`fully-guided`・`recipe-guided`・`freeform`・`bootstrap`・`retrofit`・`cross-deliverable-dedup`・`finalize`・`bootstrap-finalize` の対象は成果物カタログにある成果物の doc id とし、まだ文書がない成果物もカタログで解決する。`rulebook-maintenance`・`recipe-maintenance`・`sample-maintenance`・`template-maintenance` の対象は、名前に対応する種別の kata の doc id とし、文書索引で解決する。対応する正本で解決できない ID や、`approach` と種別が合わない対象は使用しない。
135
141
 
136
142
  ### 5.2. 構造化フィールドと生成
137
143
 
138
144
  - 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
139
- - 担当・期限・結論・topic などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
140
- - `register build` は個票を読み取り、一覧・派生ビューを再生成する。一覧を編集して個票へ反映する経路はない。
145
+ - 担当・期限・結論・topic・`derived_from`・`approach`・`targets` などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。`register add` と `register update` では、起票元に繰り返し指定できる `--from`、進め方に `--approach`、対象に繰り返し指定できる `--target` を使う。起票元、`approach`、対象を削除するときは、それぞれ `--from -`、`--approach -`、`--target -` を指定する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
146
+ - `register build` は個票を読み取り、一覧・派生ビューを再生成する。`generated/pjr-derived-items.md` では `derived_from` を逆引きし、元の項目から派生先を辿れるようにする。一覧を編集して個票へ反映する経路はない。
141
147
  - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時もコマンドが既定値を記録する。
142
148
  - 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
143
149
  - ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。