specdojo 0.4.7 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (267) hide show
  1. package/.github/agents/specdojo-orchestrator.md +14 -9
  2. package/CHANGELOG.md +46 -0
  3. package/dist/commands/init.js +3 -0
  4. package/dist/commands/night-orchestrator.js +33 -4
  5. package/dist/dashboard/dashboard.js +5 -6
  6. package/dist/dashboard/timeline-build.js +5 -1
  7. package/dist/dashboard/timeline.js +6 -3
  8. package/dist/docs/yaml-pages.js +17 -17
  9. package/dist/exec/core.js +2 -0
  10. package/dist/exec/pipeline-state.js +5 -2
  11. package/dist/exec/plans-core.js +3 -2
  12. package/dist/exec/plans-generation.js +9 -5
  13. package/dist/exec/plans-grade-findings.js +16 -0
  14. package/dist/exec/plans-planning.js +43 -0
  15. package/dist/exec/plans-storage.js +5 -2
  16. package/dist/exec/register.js +16 -1
  17. package/dist/exec/repo-integration-sync.js +9 -0
  18. package/dist/exec/repo-integration.js +17 -2
  19. package/dist/exec/repo-trace.js +17 -4
  20. package/dist/exec/results.js +2 -0
  21. package/dist/exec/run/register-core.js +11 -0
  22. package/dist/exec/run/register-mode.js +19 -1
  23. package/dist/exec/run/register-resume.js +22 -0
  24. package/dist/exec/run/register-worktree.js +23 -0
  25. package/dist/exec/strategy.js +2 -0
  26. package/dist/exec/task-repos.js +18 -4
  27. package/dist/exec/worktree-ops-commit.js +7 -1
  28. package/dist/grade/apply.js +6 -2
  29. package/dist/grade/markdown.js +7 -2
  30. package/dist/grade/plan.js +6 -4
  31. package/dist/register/approach.js +19 -0
  32. package/dist/register/catalog-status.js +49 -0
  33. package/dist/register/core.js +3 -0
  34. package/dist/register/create-commands.js +34 -4
  35. package/dist/register/dependency.js +123 -0
  36. package/dist/register/derivation.js +2 -2
  37. package/dist/register/epic.js +42 -0
  38. package/dist/register/event-merge.js +5 -2
  39. package/dist/register/events.js +4 -0
  40. package/dist/register/external-project.js +4 -0
  41. package/dist/register/item.js +10 -0
  42. package/dist/register/maintenance-commands.js +7 -1
  43. package/dist/register/planning.js +37 -0
  44. package/dist/register/register.js +5 -1
  45. package/dist/register/renumber.js +12 -4
  46. package/dist/register/views.js +55 -4
  47. package/dist/schedule/schedule.js +3 -1
  48. package/dist/schedule/strategy-generate-scope.js +5 -1
  49. package/dist/schedule/strategy-generate.js +1 -0
  50. package/dist/schedule/strategy-profiles.js +1 -1
  51. package/dist/shared/agent-types.js +3 -0
  52. package/dist/shared/grade-result.js +23 -5
  53. package/dist/shared/markdownlint-config.js +38 -0
  54. package/dist/shared/markdownlint-scaffold.js +2 -9
  55. package/dist/shared/specdojo-config.js +10 -3
  56. package/dist/shared/specdojo-gitignore.js +4 -0
  57. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  58. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  59. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  60. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  61. package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
  62. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  63. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  64. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  65. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
  66. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  67. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  68. package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
  69. package/docs/ja/specdojo/references/command-reference.md +42 -4
  70. package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
  71. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  72. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  73. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  74. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  75. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  76. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  77. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  78. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  79. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  80. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  81. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  82. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  83. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  84. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  85. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  86. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  87. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  88. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  89. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  90. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  91. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  92. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  93. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  94. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  95. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  96. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  97. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
  98. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  99. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  101. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  104. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  105. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  106. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  107. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  108. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  109. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  116. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  117. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  118. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  120. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  121. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  122. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  123. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  124. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  125. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  126. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  127. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  128. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  129. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  130. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  131. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  134. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  135. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  136. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +50 -36
  137. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  138. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  139. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  140. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  148. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  150. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  151. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  152. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  153. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  154. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  155. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  156. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  157. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
  158. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  159. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  160. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  161. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  165. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  167. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  168. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  173. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  174. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  176. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  178. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  179. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  180. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  181. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  182. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  183. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  184. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  185. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  186. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  187. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  188. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  189. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  190. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  191. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  192. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  193. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  195. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  196. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  197. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  198. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  199. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  200. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  201. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  202. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  203. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  204. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  205. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  206. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  207. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  208. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  212. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  227. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  232. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  234. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  235. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  236. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  237. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  238. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  241. package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
  242. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  243. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
  244. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  245. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  246. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  247. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  248. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  249. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  250. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  251. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  252. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
  253. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  254. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  255. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  256. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  257. package/docs/specdojo/schemas/v1/register-events.schema.yaml +18 -0
  258. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
  259. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  260. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
  261. package/package.json +2 -2
  262. package/templates/antigravity/orchestrator.md +14 -9
  263. package/templates/claude/agents/specdojo-orchestrator.md +14 -9
  264. package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
  265. package/templates/codex/orchestrator.md +14 -9
  266. package/templates/copilot/README.md +2 -1
  267. package/templates/opencode/agents/specdojo-orchestrator.md +14 -9
@@ -92,15 +92,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
92
92
 
93
93
  type は次のように使い分ける。
94
94
 
95
- | type | 用途 | 終端状態 |
96
- | ---------------- | ------------------------------ | --------- |
97
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
- | `decision` | 選択肢から方針を決める | `decided` |
99
- | `todo` | 実施する作業 | `done` |
100
- | `question` | 判断を保留し、後で決める | `decided` |
101
- | `risk` | 将来の不確実性 | `done` |
102
- | `change-request` | 合意済み範囲の変更要求 | `done` |
103
- | `note` | 記録として残す観測・分析 | なし |
95
+ | type | 用途 | 終端状態 |
96
+ | ---------------- | ---------------------------------- | --------- |
97
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
+ | `decision` | 選択肢から方針を決める | `decided` |
99
+ | `todo` | 実施する作業 | `done` |
100
+ | `question` | 判断を保留し、後で決める | `decided` |
101
+ | `risk` | 将来の不確実性 | `done` |
102
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
103
+ | `note` | 記録として残す観測・分析 | なし |
104
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
104
105
 
105
106
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
106
107
 
@@ -130,6 +131,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
130
131
 
131
132
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
132
133
 
134
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
135
+
136
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
137
+
133
138
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
134
139
 
135
140
  ## 実践の型(kata)の扱い
@@ -92,15 +92,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
92
92
 
93
93
  type は次のように使い分ける。
94
94
 
95
- | type | 用途 | 終端状態 |
96
- | ---------------- | ------------------------------ | --------- |
97
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
- | `decision` | 選択肢から方針を決める | `decided` |
99
- | `todo` | 実施する作業 | `done` |
100
- | `question` | 判断を保留し、後で決める | `decided` |
101
- | `risk` | 将来の不確実性 | `done` |
102
- | `change-request` | 合意済み範囲の変更要求 | `done` |
103
- | `note` | 記録として残す観測・分析 | なし |
95
+ | type | 用途 | 終端状態 |
96
+ | ---------------- | ---------------------------------- | --------- |
97
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
+ | `decision` | 選択肢から方針を決める | `decided` |
99
+ | `todo` | 実施する作業 | `done` |
100
+ | `question` | 判断を保留し、後で決める | `decided` |
101
+ | `risk` | 将来の不確実性 | `done` |
102
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
103
+ | `note` | 記録として残す観測・分析 | なし |
104
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
104
105
 
105
106
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
106
107
 
@@ -130,6 +131,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
130
131
 
131
132
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
132
133
 
134
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
135
+
136
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
137
+
133
138
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
134
139
 
135
140
  ## 実践の型(kata)の扱い
@@ -85,15 +85,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
85
85
 
86
86
  type は次のように使い分ける。
87
87
 
88
- | type | 用途 | 終端状態 |
89
- | ---------------- | ------------------------------ | --------- |
90
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
91
- | `decision` | 選択肢から方針を決める | `decided` |
92
- | `todo` | 実施する作業 | `done` |
93
- | `question` | 判断を保留し、後で決める | `decided` |
94
- | `risk` | 将来の不確実性 | `done` |
95
- | `change-request` | 合意済み範囲の変更要求 | `done` |
96
- | `note` | 記録として残す観測・分析 | なし |
88
+ | type | 用途 | 終端状態 |
89
+ | ---------------- | ---------------------------------- | --------- |
90
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
91
+ | `decision` | 選択肢から方針を決める | `decided` |
92
+ | `todo` | 実施する作業 | `done` |
93
+ | `question` | 判断を保留し、後で決める | `decided` |
94
+ | `risk` | 将来の不確実性 | `done` |
95
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
96
+ | `note` | 記録として残す観測・分析 | なし |
97
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
97
98
 
98
99
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
99
100
 
@@ -123,6 +124,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
123
124
 
124
125
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
125
126
 
127
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
128
+
129
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
130
+
126
131
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
127
132
 
128
133
  ## 実践の型(kata)の扱い
@@ -33,7 +33,8 @@ specdojo config scaffold --provider copilot
33
33
  2. `.specdojo/copilot/agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へコピーし、使う場合は `disabled: false` にする。agent は project ごとの `pm-members.yaml` へ書かない。
34
34
  3. `copilot login` で認証する(premium request の課金が発生する)。
35
35
  4. `npm run orch:copilot` でオーケストレーターを起動できることを確認する。
36
- 5. 最初のタスクで permission ログを確認し、`shell(...)` パターンのマッチ粒度が不足していれば `--allow-tool` を追記する。
36
+ 5. VS Code から使う場合は、Copilot Chat を開き、agent の選択肢から `specdojo-orchestrator` を選ぶ(`.github/agents/specdojo-orchestrator.md` が読み込まれます)。
37
+ 6. 最初のタスクで permission ログを確認し、`shell(...)` パターンのマッチ粒度が不足していれば `--allow-tool` を追記する。
37
38
 
38
39
  ## 4. カスタマイズ
39
40
 
@@ -186,15 +186,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
186
186
 
187
187
  type は次のように使い分ける。
188
188
 
189
- | type | 用途 | 終端状態 |
190
- | ---------------- | ------------------------------ | --------- |
191
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
192
- | `decision` | 選択肢から方針を決める | `decided` |
193
- | `todo` | 実施する作業 | `done` |
194
- | `question` | 判断を保留し、後で決める | `decided` |
195
- | `risk` | 将来の不確実性 | `done` |
196
- | `change-request` | 合意済み範囲の変更要求 | `done` |
197
- | `note` | 記録として残す観測・分析 | なし |
189
+ | type | 用途 | 終端状態 |
190
+ | ---------------- | ---------------------------------- | --------- |
191
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
192
+ | `decision` | 選択肢から方針を決める | `decided` |
193
+ | `todo` | 実施する作業 | `done` |
194
+ | `question` | 判断を保留し、後で決める | `decided` |
195
+ | `risk` | 将来の不確実性 | `done` |
196
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
197
+ | `note` | 記録として残す観測・分析 | なし |
198
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
198
199
 
199
200
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
200
201
 
@@ -224,6 +225,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
224
225
 
225
226
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
226
227
 
228
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
229
+
230
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
231
+
227
232
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
228
233
 
229
234
  ## 実践の型(kata)の扱い