specdojo 0.1.0 → 0.2.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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,42 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _PJR_ID_ _PJR_TITLE_
4
+
5
+ ## 1. このタスクで行うこと
6
+
7
+ プロジェクト登録簿の項目 _PJR_ID_「_PJR_TITLE_」(_PJR_TYPE_)について調査し、結論案を result に記録する。成果物やソースコードの編集は行わない。
8
+
9
+ _PJR_DESCRIPTION_
10
+
11
+ ## 2. 対象項目
12
+
13
+ - `id`: _PJR_ID_
14
+ - `type`: _PJR_TYPE_
15
+ - `priority`: _PJR_PRIORITY_
16
+ - `owner`: _PJR_OWNER_
17
+ - `due`: _PJR_DUE_
18
+ - `登録簿`: `_PJR_INDEX_PATH_`
19
+ - `個票`: _PJR_TICKET_REF_
20
+ - `result`: `_RESULT_REF_`
21
+
22
+ ## 3. 進め方
23
+
24
+ 1. 登録簿の該当行と個票(存在する場合)を読み、問い・リスク内容・判断に必要な条件を把握する。
25
+ 2. 関連する成果物・設計書・実装・実行ログを確認し、判断材料を集める。
26
+ 3. 実行 agent が Web 検索能力を持ち、一般的な観点・用語・標準の確認が必要な場合は、関連情報を取得して出典を添える。
27
+ 4. 集めた材料から結論案を組み立てる。question は回答案、risk は影響・発生可能性の評価と対応案(回避・軽減・受容など)を示す。
28
+ 5. 判断しきれない事項は、不足している情報と確認方法を result の申し送りに残す。
29
+
30
+ ## 4. 完了手順
31
+
32
+ 1. 「進め方」に従って調査を完了する。
33
+ 2. result の実施内容に調査の要約と結論案を、変更ファイルに `-`(編集なし)を、申し送りに人間が判断・実施すべき事項を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
34
+ 3. 登録簿(`pjr-index.md`)の行と個票のステータス項目・結論列は変更しない。結論の確定と状態遷移は人間が行う。
35
+
36
+ ## 5. 異常終了の条件
37
+
38
+ - 前提不足・判断材料の欠落により調査自体が成立しない場合は異常終了する(終了コード 1)。
39
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
40
+ - agent 自身は登録簿の状態を変更せず、終了コードと標準エラー出力で runner に結果を返す。
41
+
42
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,49 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _PJR_ID_ _PJR_TITLE_
4
+
5
+ ## 1. このタスクで行うこと
6
+
7
+ プロジェクト登録簿の項目 _PJR_ID_「_PJR_TITLE_」に対応する。
8
+
9
+ _PJR_DESCRIPTION_
10
+
11
+ ## 2. 対象項目
12
+
13
+ - `id`: _PJR_ID_
14
+ - `type`: _PJR_TYPE_
15
+ - `priority`: _PJR_PRIORITY_
16
+ - `owner`: _PJR_OWNER_
17
+ - `due`: _PJR_DUE_
18
+ - `登録簿`: `_PJR_INDEX_PATH_`
19
+ - `個票`: _PJR_TICKET_REF_
20
+ - `result`: `_RESULT_REF_`
21
+
22
+ ## 3. 進め方
23
+
24
+ 1. 登録簿の該当行と個票(存在する場合)を読み、目的・完了条件・制約を把握する。
25
+ 2. 個票に完了条件がある場合はそれを作業の基準にする。無い場合はタイトルと説明から完了条件の仮説を立て、その仮説を result に明記する。
26
+ 3. 関連する成果物・設計書・実装を確認し、対象ファイルを特定して変更する。
27
+ 4. 個票が存在する場合は、個票の作業内容・対応結果セクションを実施内容で更新する。
28
+ 5. 判断に迷う箇所は _TODO_ / _ASSUMPTION_ で残し、根拠と次のアクションを result に書く。
29
+
30
+ ### grade result から展開された finding
31
+
32
+ _GRADE_FINDINGS_
33
+
34
+ plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result に記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
35
+
36
+ ## 4. 完了手順
37
+
38
+ 1. 「進め方」に従って対応を完了する。
39
+ 2. 共通規約に従って、必要な整形・静的検査を実行する。
40
+ 3. result に実施内容・変更ファイル・申し送りを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
41
+ 4. 登録簿(`pjr-index.md`)の行と個票のステータス項目は変更しない。状態遷移(review / close など)は runner と人間が行う。
42
+
43
+ ## 5. 異常終了の条件
44
+
45
+ - 前提不足・対象ファイル不明・静的検査未解消の場合は異常終了する(終了コード 1)。
46
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
47
+ - agent 自身は登録簿の状態を変更せず、終了コードと標準エラー出力で runner に結果を返す。
48
+
49
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,98 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 対象成果物
10
+
11
+ - `name`: _DELIVERABLE_NAME_
12
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `overview`: _DELIVERABLE_OVERVIEW_
14
+ - `path`: `_DELIVERABLE_PATH_`
15
+ - `rulebook`: `_RULEBOOK_REF_`
16
+ - `result`: `_RESULT_REF_`
17
+
18
+ _PROJECT_CONTEXT_
19
+
20
+ ## 3. 実装エビデンス
21
+
22
+ 次の参照は成果物カタログの `evidence_refs` から展開した読み取り専用の調査入力である。`targets`、変更許可範囲、commit 対象には含めない。
23
+
24
+ _IMPLEMENTATION_EVIDENCE_
25
+
26
+ ## 4. 根拠の位置づけ
27
+
28
+ 根拠は次の責務で使い分ける。実装だけを意図された仕様の正本とはみなさない。
29
+
30
+ | 根拠 | 位置づけ | 主な確認内容 |
31
+ | -------------------------------------------------- | ----------------------- | ---------------------------------------- |
32
+ | 実装エビデンス | 現在動作(AS-IS)の根拠 | 入出力、処理、状態遷移、例外、制約 |
33
+ | 既存成果物・`depends_on`・プロジェクトコンテキスト | 意図された仕様の根拠 | 目的、業務判断、承認済みの変更、将来方針 |
34
+ | 成果物カタログの `done_criteria` | 成果物が満たすべき目的 | 記載範囲、完了判定、下流利用者の必要情報 |
35
+ | rulebook | 文書構造と記法の基準 | 必須要素、禁止事項、表現規則 |
36
+
37
+ 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
38
+
39
+ ## 5. owner ロールとしての記述ポイント
40
+
41
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。
42
+
43
+ - owner role: **_OWNER_ROLE_LABEL_**
44
+ - 責務: _OWNER_ROLE_NOTE_
45
+
46
+ このロールが重視するレビュー観点:
47
+
48
+ _OWNER_ROLE_VIEWPOINTS_
49
+
50
+ ## 6. 進め方
51
+
52
+ 1. 対象成果物が存在するかを確認し、存在する場合は既存記述を先に読む。`depends_on` とプロジェクトコンテキストも読み、意図された仕様を抽出する。
53
+ 2. 「実装エビデンス」に列挙されたパスをすべて実際に読み、確認できた現在動作を、参照パスと対応付けて整理する。列挙外のコードを根拠に追加する必要がある場合は、変更せず未確認範囲として result に記録する。
54
+ 3. 現在動作、意図された仕様、`done_criteria` を照合し、一致・乖離・実装から確認不能・未確認に分類する。実装から目的、業務判断、将来方針を推測しない。
55
+ 4. 次の判断基準で、維持・部分反映・作り直し・新設を選ぶ。
56
+
57
+ | 判断 | 条件 | 対応 |
58
+ | -------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
59
+ | 維持 | 既存文書が現在動作と意図された仕様を満たし、rulebook の必須要素・禁止事項・章構成にも適合する | 誤記や不足がなければ変更せず、照合結果だけを記録する |
60
+ | 部分反映 | 既存構造は有効だが、承認済みの現在動作が欠落または古い、または rulebook の必須要素・章構成に不適合 | 該当箇所だけを更新する。rulebook 不適合は既存記述を保持したまま章立てを移し替えて直す |
61
+ | 作り直し | 既存構造では `done_criteria` または rulebook の章構成を満たせず、局所修正より再構成が明確 | 有効な決定・用語を保持しながら文書を再構成する |
62
+ | 新設 | 対象成果物が存在せず、カタログに `path` と `done_criteria` が定義済み | rulebook とカタログに従って新規作成する |
63
+
64
+ 判断後は次の順で作業する。
65
+
66
+ 1. 実装と意図された仕様が一致する箇所、または実装変更が承認済みで文書だけが古い箇所を成果物へ反映する。承認根拠が確認できない乖離は実装へ無条件に合わせず、成果物には意図された仕様を保持し、PJR または後続 review finding 候補として result に残す。
67
+ 2. 実装エビデンスは編集しない。実装修正が必要な場合は、本タスクへ混在させず別タスクとして申し送る。
68
+
69
+ ### 6.1. 判断根拠の記録
70
+
71
+ result には、少なくとも次を記録する。
72
+
73
+ - 実際に参照した実装エビデンスのパスと、そこから抽出した現在動作
74
+ - 選択した判断(維持・部分反映・作り直し・新設)と根拠
75
+ - 成果物へ反映した内容
76
+ - 未反映の乖離と、実装・文書のどちらを変更すべきかの候補
77
+ - 調査できなかったパス、分岐、外部依存などの未確認範囲
78
+
79
+ 本タスクの実行に必要な retrofit の進め方は、このセクションで完結する。approach 全体の定義を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
80
+
81
+ ## 7. 完了の狙い
82
+
83
+ _DONE_CRITERIA_GOALS_
84
+
85
+ ## 8. 完了手順
86
+
87
+ 1. 「進め方」に従って成果物を更新または新設する。
88
+ 2. 「完了の狙い」を満たし、実装との一致・乖離・未確認範囲を区別できることを確認する。
89
+ 3. 共通規約に従って、必要な整形・静的検査を実行する。
90
+ 4. result に実施内容・変更ファイル・判断根拠を記入する。プレースホルダを残したまま終了しない。
91
+
92
+ ## 9. 異常終了の条件
93
+
94
+ - `evidence_refs` 欠落、実装エビデンス不存在、対象パス不明、lint/test 未解消の場合は異常終了する(終了コード 1)。
95
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
96
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
97
+
98
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,86 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 根拠となる成果物と編集対象
10
+
11
+ 根拠となる成果物:
12
+
13
+ - `name`: _DELIVERABLE_NAME_
14
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
15
+ - `overview`: _DELIVERABLE_OVERVIEW_
16
+ - `path`: `_DELIVERABLE_PATH_`
17
+ - `result`: `_RESULT_REF_`
18
+
19
+ 編集対象(成果物カタログの rulebook 宣言から解決):
20
+
21
+ - `kind`: rulebook
22
+ - `path`: `_RULEBOOK_REF_`
23
+ - `state`: `_RULEBOOK_STATE_`
24
+
25
+ `existing` は既存文書を編集し、`missing` は宣言されたパスへ新規作成する。`unresolved` は宣言からパスを解決できない状態であり、命名規則から推測して作成せず異常終了する。
26
+
27
+ _PROJECT_CONTEXT_
28
+
29
+ ## 3. owner ロールとしての記述ポイント
30
+
31
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
32
+
33
+ - owner role: **_OWNER_ROLE_LABEL_**
34
+ - 責務: _OWNER_ROLE_NOTE_
35
+
36
+ このロールが重視するレビュー観点:
37
+
38
+ _OWNER_ROLE_VIEWPOINTS_
39
+
40
+ ## 4. 進め方
41
+
42
+ 参照の向きを「成果物 → rulebook」に切り替え、対象成果物に紐づく rulebook を「見直す対象」として編集する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで判断する。読み込まずに記憶や推測で代替しない。
43
+
44
+ ### grade result から展開された finding
45
+
46
+ _GRADE_FINDINGS_
47
+
48
+ 1. 見直し対象の rulebook を読み込み、現状の章構成・必須項目・禁止事項・判定基準を把握する。
49
+ 2. plan に展開された finding は severity にかかわらず、message と同じ viewpoint ID の判定根拠を修正要件として読み取る。message と判定根拠から指摘の根拠となる規範を特定し、対象 rulebook の frontmatter から辿れる recipe / sample / template、`併せて適用する rulebook`、該当する執筆標準のうち必要な文書を読み、指摘された問題を解消するよう該当箇所を修正する。
50
+ 3. 修正後、各 finding の問題が判定根拠に照らして解消したことを確認する。未解消、根拠不足、または判断不能の finding は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
51
+ 4. 複数の成果物・review result・対象領域の慣行を根拠に、それらが成果物の実態と合っているかを見直す。
52
+ 5. 成果物側で繰り返し守られていない規定は、規定が過剰なのか成果物側の不備なのかを判断し、根拠とともに rulebook へ反映するか result に記録する。
53
+ 6. 既存記述のうち、根拠と整合しない・陳腐化したものは見直し、整合するものは維持する。
54
+
55
+ finding の修正後は、再評価で構造・整合性が劣化していないことを確認する。
56
+
57
+ 見直した rulebook は [[specdojo:rulebook-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従う。recipe / sample / template と記述が矛盾しないように更新する(構造・必須項目・禁止事項は rulebook を正とする)。
58
+
59
+ approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な rulebook メンテナンスの進め方は、このセクションで完結する。
60
+
61
+ ### 4.1. 見直しの根拠が不足する場合
62
+
63
+ - finding の message と判定根拠、対象 rulebook から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂を判断できない場合に限り、根拠不足として見送る。成果物または review result がないことだけを理由に見送らない。
64
+ - 見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result の `進め方と実践の型の適用` セクションに記録する。
65
+ - 根拠不足のまま推測で rulebook を改訂しない。確証が得られた範囲に改訂を限定し、残りは申し送りに残す。
66
+ - 見直し対象の rulebook が存在しない場合は、根拠とした成果物群から新規に作成する。
67
+
68
+ ### 4.2. 判断根拠の記録
69
+
70
+ 見直しの根拠とした規範・成果物・review result と判断根拠を result に残す。記録先は次のとおり。
71
+
72
+ - 根拠とした規範・成果物・review result、改訂・維持した記述とその根拠、矛盾時に rulebook を正とした箇所: result の `進め方と実践の型の適用` セクション。
73
+
74
+ ## 5. 完了手順
75
+
76
+ 1. 「このフェーズで行うこと」に従って rulebook を更新する。
77
+ 2. 共通規約に従って、必要な整形・静的検査を実行する。
78
+ 3. result の `実施内容`・`変更ファイル`・`進め方と実践の型の適用` セクションを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
79
+
80
+ ## 6. 異常終了の条件
81
+
82
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
83
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
84
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
85
+
86
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,86 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 根拠となる成果物と編集対象
10
+
11
+ 根拠となる成果物:
12
+
13
+ - `name`: _DELIVERABLE_NAME_
14
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
15
+ - `overview`: _DELIVERABLE_OVERVIEW_
16
+ - `path`: `_DELIVERABLE_PATH_`
17
+ - `result`: `_RESULT_REF_`
18
+
19
+ 編集対象(rulebook frontmatter の sample 宣言から解決):
20
+
21
+ - `kind`: sample
22
+ - `path`: `_SAMPLE_REF_`
23
+ - `state`: `_SAMPLE_STATE_`
24
+
25
+ `existing` は既存文書を編集し、`missing` は宣言されたパスへ新規作成する。`unresolved` は宣言からパスを解決できない状態であり、命名規則から推測して作成せず異常終了する。
26
+
27
+ _PROJECT_CONTEXT_
28
+
29
+ ## 3. owner ロールとしての記述ポイント
30
+
31
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
32
+
33
+ - owner role: **_OWNER_ROLE_LABEL_**
34
+ - 責務: _OWNER_ROLE_NOTE_
35
+
36
+ このロールが重視するレビュー観点:
37
+
38
+ _OWNER_ROLE_VIEWPOINTS_
39
+
40
+ ## 4. 進め方
41
+
42
+ 参照の向きを「成果物 → sample」に切り替え、対象成果物に紐づく sample を「見直す対象」として編集する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで判断する。読み込まずに記憶や推測で代替しない。
43
+
44
+ ### grade result から展開された finding
45
+
46
+ _GRADE_FINDINGS_
47
+
48
+ 1. 見直し対象の sample を読み込み、現状の粒度・文体・表の書き方を把握する。
49
+ 2. plan に展開された finding は severity にかかわらず、message と同じ viewpoint ID の判定根拠を修正要件として読み取る。message と判定根拠から指摘の根拠となる規範を特定し、対象 sample の frontmatter から辿れる rulebook と recipe、該当する執筆標準のうち必要な文書を読み、指摘された問題を解消するよう該当箇所を修正する。rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として照合する。
50
+ 3. 修正後、各 finding の問題が判定根拠に照らして解消したことを確認する。未解消、根拠不足、または判断不能の finding は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
51
+ 4. 複数の成果物・review result・対象領域の慣行を根拠に、それらが完成例として適切かを見直す。
52
+ 5. rulebook の必須項目・禁止事項を満たす最小の記述例になるよう再構成し、実成果物の丸写しを避ける。
53
+ 6. 既存記述のうち、根拠と整合しない・陳腐化したものは見直し、整合するものは維持する。
54
+
55
+ finding の修正後は、再評価で構造・整合性が劣化していないことを確認する。
56
+
57
+ 見直した sample は [[specdojo:sample-authoring-standard]](構成・記述ルール・禁止事項の正本)に従う。rulebook / recipe と記述が矛盾しないように更新する(構造・必須項目・禁止事項は rulebook を正とする)。
58
+
59
+ approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な sample メンテナンスの進め方は、このセクションで完結する。
60
+
61
+ ### 4.1. 見直しの根拠が不足する場合
62
+
63
+ - finding の message と判定根拠、対象 sample から辿れる rulebook / recipe、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂を判断できない場合に限り、根拠不足として見送る。成果物または review result がないことだけを理由に見送らない。
64
+ - 見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result の `進め方と実践の型の適用` セクションに記録する。
65
+ - 根拠不足のまま推測で sample を改訂しない。確証が得られた範囲に改訂を限定し、残りは申し送りに残す。
66
+ - 見直し対象の sample が存在しない場合は、根拠とした成果物群から新規に作成する。
67
+
68
+ ### 4.2. 判断根拠の記録
69
+
70
+ 見直しの根拠とした規範・成果物・review result と判断根拠を result に残す。記録先は次のとおり。
71
+
72
+ - 根拠とした規範・成果物・review result、改訂・維持した記述とその根拠、矛盾時に rulebook を正とした箇所: result の `進め方と実践の型の適用` セクション。
73
+
74
+ ## 5. 完了手順
75
+
76
+ 1. 「このフェーズで行うこと」に従って sample を更新する。
77
+ 2. 共通規約に従って、必要な整形・静的検査を実行する。
78
+ 3. result の `実施内容`・`変更ファイル`・`進め方と実践の型の適用` セクションを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
79
+
80
+ ## 6. 異常終了の条件
81
+
82
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
83
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
84
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
85
+
86
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,86 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 根拠となる成果物と編集対象
10
+
11
+ 根拠となる成果物:
12
+
13
+ - `name`: _DELIVERABLE_NAME_
14
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
15
+ - `overview`: _DELIVERABLE_OVERVIEW_
16
+ - `path`: `_DELIVERABLE_PATH_`
17
+ - `result`: `_RESULT_REF_`
18
+
19
+ 編集対象(rulebook frontmatter の template 宣言から解決):
20
+
21
+ - `kind`: template
22
+ - `path`: `_TEMPLATE_REF_`
23
+ - `state`: `_TEMPLATE_STATE_`
24
+
25
+ `existing` は既存文書を編集し、`missing` は宣言されたパスへ新規作成する。`unresolved` は宣言からパスを解決できない状態であり、命名規則から推測して作成せず異常終了する。
26
+
27
+ _PROJECT_CONTEXT_
28
+
29
+ ## 3. owner ロールとしての記述ポイント
30
+
31
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
32
+
33
+ - owner role: **_OWNER_ROLE_LABEL_**
34
+ - 責務: _OWNER_ROLE_NOTE_
35
+
36
+ このロールが重視するレビュー観点:
37
+
38
+ _OWNER_ROLE_VIEWPOINTS_
39
+
40
+ ## 4. 進め方
41
+
42
+ 参照の向きを「成果物 → template」に切り替え、対象成果物に紐づく template を「見直す対象」として編集する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで判断する。読み込まずに記憶や推測で代替しない。
43
+
44
+ ### grade result から展開された finding
45
+
46
+ _GRADE_FINDINGS_
47
+
48
+ 1. 見直し対象の template を読み込み、現状の章構成の骨組みとプレースホルダの配置・網羅性を把握する。
49
+ 2. plan に展開された finding は severity にかかわらず、message と同じ viewpoint ID の判定根拠を修正要件として読み取る。message と判定根拠から指摘の根拠となる規範を特定し、対象 template の frontmatter から辿れる rulebook / recipe / sample、該当する執筆標準のうち必要な文書を読み、指摘された問題を解消するよう該当箇所を修正する。
50
+ 3. 修正後、各 finding の問題が判定根拠に照らして解消したことを確認する。未解消、根拠不足、または判断不能の finding は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
51
+ 4. 複数の成果物・review result・対象領域の慣行を根拠に、それらが成果物作成の開始点として適切かを見直す。
52
+ 5. 成果物間で共通する定型部分は雛形の本文に取り込み、成果物ごとに内容が異なる部分は _TODO_ などのプレースホルダとして配置する。
53
+ 6. 既存記述のうち、根拠と整合しない・陳腐化したものは見直し、整合するものは維持する。
54
+
55
+ finding の修正後は、再評価で構造・整合性が劣化していないことを確認する。
56
+
57
+ 見直した template は [[specdojo:template-authoring-standard]](構成・プレースホルダ規約・禁止事項の正本)に従う。rulebook / recipe / sample と記述が矛盾しないように更新する(構造・必須項目・禁止事項は rulebook を正とする)。
58
+
59
+ approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な template メンテナンスの進め方は、このセクションで完結する。
60
+
61
+ ### 4.1. 見直しの根拠が不足する場合
62
+
63
+ - finding の message と判定根拠、対象 template から辿れる rulebook / recipe / sample、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂を判断できない場合に限り、根拠不足として見送る。成果物または review result がないことだけを理由に見送らない。
64
+ - 見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result の `進め方と実践の型の適用` セクションに記録する。
65
+ - 根拠不足のまま推測で template を改訂しない。確証が得られた範囲に改訂を限定し、残りは申し送りに残す。
66
+ - 見直し対象の template が存在しない場合は、根拠とした成果物群から新規に作成する。
67
+
68
+ ### 4.2. 判断根拠の記録
69
+
70
+ 見直しの根拠とした規範・成果物・review result と判断根拠を result に残す。記録先は次のとおり。
71
+
72
+ - 根拠とした規範・成果物・review result、改訂・維持した記述とその根拠、矛盾時に rulebook を正とした箇所: result の `進め方と実践の型の適用` セクション。
73
+
74
+ ## 5. 完了手順
75
+
76
+ 1. 「このフェーズで行うこと」に従って template を更新する。
77
+ 2. 共通規約に従って、必要な整形・静的検査を実行する。
78
+ 3. result の `実施内容`・`変更ファイル`・`進め方と実践の型の適用` セクションを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
79
+
80
+ ## 6. 異常終了の条件
81
+
82
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
83
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
84
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
85
+
86
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,66 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 対象成果物
10
+
11
+ - `name`: _DELIVERABLE_NAME_
12
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `overview`: _DELIVERABLE_OVERVIEW_
14
+ - `path`: `_DELIVERABLE_PATH_`
15
+ - `result`: `_RESULT_REF_`
16
+
17
+ _PROJECT_CONTEXT_
18
+
19
+ ## 3. owner ロールとしての記述ポイント
20
+
21
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
22
+
23
+ - owner role: **_OWNER_ROLE_LABEL_**
24
+ - 責務: _OWNER_ROLE_NOTE_
25
+
26
+ このロールが重視するレビュー観点:
27
+
28
+ _OWNER_ROLE_VIEWPOINTS_
29
+
30
+ ## 4. 進め方
31
+
32
+ - exec plan frontmatter の `approach` を確認する。
33
+ - `approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、参照の向きを「成果物 → 対象の実践の型」に切り替えて進める。
34
+ - それ以外の場合は、対象成果物に紐づく rulebook / recipe / sample / template の有無を確認し、`approach` に応じて参照範囲を決める。
35
+ - `fully-guided`: rulebook / recipe / sample / template をそれぞれの役割に沿って活用する(構造・必須要素・禁止事項は rulebook、内容の組み立ては recipe、粒度・文体・表の書き方は sample、雛形は template を基準にし、プレースホルダは残さず埋める)。
36
+ - `recipe-guided`: recipe が示す構成・問い・観点だけを使って組み立てる(rulebook / sample が存在しても構造・文体の基準にはしない)。
37
+ - `freeform`: 実践の型より、類似成果物の実例やプロジェクト文脈を優先して組み立てる。
38
+ - 未指定の場合は、存在するすべての実践の型をそれぞれの役割に沿って活用する。
39
+ - 複数の文書間で記述に矛盾がある場合、参照範囲に rulebook を含む `approach`(`fully-guided` など)では rulebook を正とする。
40
+ - `freeform` と実践の型メンテナンス系(`*-maintenance`)を除く `approach` では、参照してよい文書をこの plan に記載されたもの(対象成果物に紐づく rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキスト)に限定する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
41
+ - `freeform` と実践の型メンテナンス系を除く `approach` では、対象成果物の既存記述を尊重する。既存記述の破棄や全面的な書き換えは原則として行わず、`depends_on` の最新の決定事項と明確に矛盾する箇所、および参照範囲に rulebook を含む `approach` では rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合のみ最小限を修正し、不足分は既存記述を基礎に加筆・補強する。rulebook 不適合の修正は、既存記述を保持したままの章立ての移し替えと必須要素の補完として行う。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除する。統合・削除の判断根拠は result に記録する。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しない。rulebook が複数の構成を許容している場合、他章との見た目の整合を理由により詳細な構成へ書き換えない。
42
+ - `freeform` を除く `approach` では、ファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述を新たに書き加える場合、参照範囲の文書で裏付けが取れる場合に限る。既存記述が曖昧・不完全であっても、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しない。
43
+ - `freeform` または実践の型メンテナンス系では、存在しない、または参照範囲から外れた文書がある場合に、他に存在する文書、類似成果物、対象領域の慣行を手がかりに判断する。それ以外の `approach` では、判断できない箇所(裏付けのない具体化を見送った箇所を含む)を憶測で補わず _TODO_ / _ASSUMPTION_ として残す。いずれも判断の根拠を成果物または result に残す。
44
+
45
+ 詳細は [[specdojo:ryu-guide]] を参照する。
46
+
47
+ ## 5. 完了の狙い
48
+
49
+ この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って実践の型に沿って記述する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
50
+
51
+ _DONE_CRITERIA_GOALS_
52
+
53
+ ## 6. 完了手順
54
+
55
+ 1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
56
+ 2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
57
+ 3. 共通規約に従って、必要な整形・静的検査を実行する。
58
+ 4. result の `実施内容`・`変更ファイル`・`進め方と実践の型の適用` セクションを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
59
+
60
+ ## 7. 異常終了の条件
61
+
62
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
63
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
64
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
65
+
66
+ _COMMON_CONVENTIONS_
@@ -0,0 +1,31 @@
1
+ _FRONTMATTER_
2
+
3
+ # Cross-deliverable Dedup Result
4
+
5
+ ## 1. 実施内容
6
+
7
+ _TODO_: 実施した内容の要約を記入する。
8
+
9
+ ## 2. 変更ファイル
10
+
11
+ _TODO_: 変更したファイルのパスを記入する。
12
+
13
+ ## 3. 正本へ集約した記述
14
+
15
+ _TODO_: 論点、正本文書、集約・変更した内容を記入する。
16
+
17
+ ## 4. 要約・参照へ置き換えた重複
18
+
19
+ _TODO_: 対象文書、重複していた論点、置換後の要約と参照先を記入する。
20
+
21
+ ## 5. 意図的に残した重複
22
+
23
+ _TODO_: 残した記述と、単独可読性・成果物固有の責務・必須情報などの理由を記入する。該当がなければ「なし」と記入する。
24
+
25
+ ## 6. 維持確認
26
+
27
+ _TODO_: 各対象の `done_criteria`、トレーサビリティ、文書責務、`based_on` / `depends_on` の確認結果を記入する。
28
+
29
+ ## 7. 申し送り
30
+
31
+ _TODO_: 後続タスクへの申し送り事項を記入する。なければ「なし」と記入する。
@@ -0,0 +1,40 @@
1
+ _FRONTMATTER_
2
+
3
+ # Finalize Result
4
+
5
+ ## 1. 実施基準
6
+
7
+ - 実施手順: [[specdojo:exec-human-finalize-recipe|Human Finalize 実行レシピ]]
8
+ - 共通規約: [[specdojo:exec-human-finalize-standard|Human Finalize 実行標準]]
9
+
10
+ この result を作業指示と確認記録の正本とし、frontmatter の `targets` に含まれる成果物と実践の型だけを確認・修正・確定する。
11
+
12
+ ## 2. 確認チェックリスト
13
+
14
+ done_criteria の各項目を確認し、満たしていればチェックを付ける。満たせない項目がある場合は「確定判断」を差し戻しにし、理由を「備考」に記録する。
15
+
16
+ _DONE_CRITERIA_CHECKLIST_
17
+
18
+ ## 3. 実践の型の確認
19
+
20
+ 実践の型を種別ごとに確認し、満たしていればチェックを付ける。「確定対象」に無い種別はスキップし、行を削除する。
21
+
22
+ - [ ] rulebook: 章構成・必須項目・禁止事項・判定基準が完成版の成果物と整合している
23
+ - [ ] recipe: 問い・観点・深掘り手順が完成版の作成過程に照らして有効である
24
+ - [ ] sample: 粒度・文体・表の書き方が完成例として適切である
25
+ - [ ] template: 章構成の骨組みとプレースホルダが雛形として再利用できる
26
+ - [ ] 共通: プロジェクト固有の内容が一般化されており、他プロジェクトでも再利用できる
27
+
28
+ ## 4. 確定対象
29
+
30
+ 最終確認と frontmatter の `status` の `ready` への昇格が済んだ対象にチェックを付ける。既に `ready` の実践の型は、劣化がないことを確認してチェックを付ける。
31
+
32
+ _FINALIZE_TARGETS_CHECKLIST_
33
+
34
+ ## 5. 確定判断
35
+
36
+ - judgement: _TODO_(承認 / 差し戻し)
37
+
38
+ ## 6. 備考
39
+
40
+ _TODO_: 差し戻し理由、確定対象以外に修正した内容、後続タスクへの申し送りなど、必要な場合のみ記入する(なければ削除)。
@@ -0,0 +1,30 @@
1
+ _FRONTMATTER_
2
+
3
+ # Finalize Result
4
+
5
+ ## 1. 実施基準
6
+
7
+ - 実施手順: [[specdojo:exec-human-finalize-recipe|Human Finalize 実行レシピ]]
8
+ - 共通規約: [[specdojo:exec-human-finalize-standard|Human Finalize 実行標準]]
9
+
10
+ この result を作業指示と確認記録の正本とし、frontmatter の `targets` に含まれる文書だけを確認・修正・確定する。
11
+
12
+ ## 2. 確認チェックリスト
13
+
14
+ done_criteria の各項目を確認し、満たしていればチェックを付ける。満たせない項目がある場合は「確定判断」を差し戻しにし、理由を「備考」に記録する。
15
+
16
+ _DONE_CRITERIA_CHECKLIST_
17
+
18
+ ## 3. 確定対象
19
+
20
+ 最終確認と frontmatter の `status` の `ready` への昇格が済んだ対象にチェックを付ける。
21
+
22
+ _FINALIZE_TARGETS_CHECKLIST_
23
+
24
+ ## 4. 確定判断
25
+
26
+ - judgement: _TODO_(承認 / 差し戻し)
27
+
28
+ ## 5. 備考
29
+
30
+ _TODO_: 差し戻し理由、確定対象以外に修正した内容、後続タスクへの申し送りなど、必要な場合のみ記入する(なければ削除)。
@@ -0,0 +1,19 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Result
4
+
5
+ ## 1. 実施内容
6
+
7
+ _TODO_: 実施した内容の要約を記入する。
8
+
9
+ ## 2. 変更ファイル
10
+
11
+ _TODO_: 変更したファイルのパスを記入する。
12
+
13
+ ## 3. 申し送り
14
+
15
+ _TODO_: 後続タスクへの申し送り事項を記入する(なければ削除)。
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 を正として判断した箇所、参照範囲から外れていた文書とその代わりに根拠にした内容があれば、あわせて記録する。