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.
- package/LICENSE +22 -0
- package/README.md +82 -38
- package/dist/agent-response.js +27 -0
- package/dist/agent.js +124 -0
- package/dist/build-command.js +149 -0
- package/dist/build-if-stale.js +35 -0
- package/dist/catalog-build.js +1079 -0
- package/dist/catalog-generate.js +226 -0
- package/dist/catalog-paths.js +31 -0
- package/dist/catalog-plan-generate.js +301 -0
- package/dist/catalog-plan-prompt.js +73 -0
- package/dist/catalog-plan.js +471 -0
- package/dist/catalog-scaffold.js +255 -0
- package/dist/catalog-types.js +4 -0
- package/dist/catalog.js +606 -0
- package/dist/dashboard.js +980 -0
- package/dist/deliverable-trash.js +148 -0
- package/dist/deliverable.js +97 -0
- package/dist/dist-freshness.js +150 -0
- package/dist/doc-index.js +424 -0
- package/dist/exec-agent-config.js +172 -0
- package/dist/exec-agent-git-state.js +136 -0
- package/dist/exec-agent-protected-config.js +276 -0
- package/dist/exec-events.js +250 -112
- package/dist/exec-evidence.js +317 -0
- package/dist/exec-format.js +45 -0
- package/dist/exec-limit.js +202 -0
- package/dist/exec-parent-validation.js +169 -0
- package/dist/exec-pipeline-state.js +160 -0
- package/dist/exec-plans.js +1016 -0
- package/dist/exec-project.js +25 -11
- package/dist/exec-protection-handoff.js +169 -0
- package/dist/exec-provider-scaffold.js +99 -0
- package/dist/exec-register-resume.js +196 -0
- package/dist/exec-register.js +281 -0
- package/dist/exec-reporter.js +329 -0
- package/dist/exec-results.js +510 -0
- package/dist/exec-run-lock.js +149 -0
- package/dist/exec-run.js +4953 -0
- package/dist/exec-schedule-calendar.js +86 -9
- package/dist/exec-schedule-cpm.js +30 -12
- package/dist/exec-schedule-gantt-chart-render.js +428 -0
- package/dist/exec-schedule-gantt-chart-scope.js +111 -0
- package/dist/exec-schedule-gantt-chart.js +2 -0
- package/dist/exec-schedule-hash.js +34 -25
- package/dist/exec-schedule-index.js +200 -67
- package/dist/exec-schedule-initial.js +100 -0
- package/dist/exec-schedule-progress.js +51 -26
- package/dist/exec-schedule-ready.js +71 -27
- package/dist/exec-schedule.js +171 -93
- package/dist/exec-shared.js +146 -25
- package/dist/exec-strategy.js +547 -0
- package/dist/exec-task-view.js +64 -0
- package/dist/exec-trial.js +895 -0
- package/dist/exec-worktree-command.js +426 -0
- package/dist/exec-worktree-ops.js +847 -0
- package/dist/exec-worktree.js +359 -0
- package/dist/exec.js +744 -192
- package/dist/frontmatter-namespace.js +48 -0
- package/dist/git-environment.js +23 -0
- package/dist/grade-result.js +137 -0
- package/dist/grade.js +2456 -0
- package/dist/index-command.js +103 -0
- package/dist/job.js +1081 -0
- package/dist/kata-command.js +303 -0
- package/dist/kata.js +187 -0
- package/dist/package-paths.js +15 -0
- package/dist/practice-id.js +24 -0
- package/dist/register-date.js +122 -0
- package/dist/register-events.js +363 -0
- package/dist/register-history.js +323 -0
- package/dist/register-item.js +455 -0
- package/dist/register-migrate-timestamps.js +176 -0
- package/dist/register.js +2199 -0
- package/dist/review-plan.js +199 -0
- package/dist/review-types.js +1 -0
- package/dist/role-types.js +1 -0
- package/dist/routine.js +814 -0
- package/dist/schedule-approach.js +252 -0
- package/dist/schedule-build.js +552 -0
- package/dist/schedule-phase-sets.js +73 -0
- package/dist/schedule-strategy-generate.js +812 -0
- package/dist/schedule-strategy-profiles.js +276 -0
- package/dist/schedule.js +420 -0
- package/dist/spawn-self.js +28 -0
- package/dist/specdojo-config.js +133 -39
- package/dist/specdojo.js +55 -7
- package/dist/template-frontmatter.js +89 -0
- package/dist/template-resolution.js +92 -0
- package/dist/timeline-build.js +334 -0
- package/dist/timeline.js +107 -0
- package/dist/watch.js +313 -0
- package/dist/yaml-pages-command.js +28 -0
- package/dist/yaml-pages.js +180 -0
- package/dist/yaml-schema-modeline.js +49 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
- package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
- package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
- package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
- package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
- package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
- package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
- package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
- package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
- package/docs/ja/specdojo/guides/kata-guide.md +89 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/review-guide.md +428 -0
- package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
- package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
- package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
- package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
- package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
- package/docs/ja/specdojo/guides/waza-guide.md +224 -0
- package/docs/ja/specdojo/index.md +33 -0
- package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
- package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
- package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
- package/docs/ja/specdojo/references/command-reference.md +718 -0
- package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
- package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
- package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/atc-sample.md +41 -0
- package/docs/ja/specdojo/samples/bac-sample.md +38 -0
- package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
- package/docs/ja/specdojo/samples/bds-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-sample.md +38 -0
- package/docs/ja/specdojo/samples/bps-sample.md +38 -0
- package/docs/ja/specdojo/samples/br-sample.md +40 -0
- package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
- package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cld-sample.md +38 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-sample.md +38 -0
- package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
- package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
- package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
- package/docs/ja/specdojo/samples/dec-sample.md +39 -0
- package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
- package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
- package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/etc-sample.md +38 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
- package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
- package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
- package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
- package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/itc-sample.md +38 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/mm-sample.md +35 -0
- package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
- package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
- package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
- package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
- package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
- package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
- package/docs/ja/specdojo/samples/opd-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
- package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
- package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
- package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
- package/docs/ja/specdojo/samples/otp-sample.md +68 -0
- package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
- package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
- package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
- package/docs/ja/specdojo/samples/pr-sample.md +39 -0
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
- package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
- package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
- package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
- package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
- package/docs/ja/specdojo/samples/sac-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-sample.md +38 -0
- package/docs/ja/specdojo/samples/sld-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-sample.md +38 -0
- package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
- package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
- package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/uis-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-sample.md +38 -0
- package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
- package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
- package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
- package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
- package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
- package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
- package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
- package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
- package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
- package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
- package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
- package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
- package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
- package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
- package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
- package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
- package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
- package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
- package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
- package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
- package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
- package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
- package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
- package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
- package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
- package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
- package/docs/ja/specdojo/templates/opr-template.md +85 -0
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
- package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
- package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
- package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
- package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
- package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
- package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
- package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
- package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
- package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
- package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
- package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
- package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
- package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
- package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
- package/docs/ja/specdojo/templates/stsd-template.md +57 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
- package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
- package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
- package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
- package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
- package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
- package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
- package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
- package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
- package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
- package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
- package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
- package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
- package/package.json +120 -24
- package/templates/claude/README.md +46 -0
- package/templates/claude/agents/claude-expert-review-executor.md +14 -0
- package/templates/claude/agents/claude-review-executor.md +14 -0
- package/templates/claude/settings.edit.json +6 -0
- package/templates/claude/settings.report.json +6 -0
- package/templates/claude/settings.review.json +7 -0
- package/templates/codex/README.md +61 -0
- package/templates/codex/agents/codex-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
- package/templates/codex/agents/codex-review-executor.toml +10 -0
- package/templates/copilot/README.md +41 -0
- package/templates/copilot/exec-defaults-snippet.yaml +28 -0
- package/templates/copilot/pm-members-snippet.yaml +44 -0
- package/templates/opencode/README.md +41 -0
- package/templates/opencode/agents/opencode-executor.md +59 -0
- package/templates/opencode/agents/opencode-reporter.md +26 -0
- package/templates/opencode/agents/opencode-review-executor.md +48 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物と実践の型
|
|
10
|
+
|
|
11
|
+
このフェーズは、成果物とその実践の型一式を一貫した一組として作成・整備する。成果物本体と、それに紐づく rulebook / recipe / sample / template を同一タスクで編集する。
|
|
12
|
+
|
|
13
|
+
成果物(主対象):
|
|
14
|
+
|
|
15
|
+
- `name`: _DELIVERABLE_NAME_
|
|
16
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
17
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
18
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
19
|
+
|
|
20
|
+
実践の型(rulebook frontmatter の宣言から解決):
|
|
21
|
+
|
|
22
|
+
- rulebook: `_RULEBOOK_REF_`(state: `_RULEBOOK_STATE_`)
|
|
23
|
+
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
24
|
+
- recipe: `_RECIPE_REF_`(state: `_RECIPE_STATE_`)
|
|
25
|
+
- sample: `_SAMPLE_REF_`(state: `_SAMPLE_STATE_`)
|
|
26
|
+
- template: `_TEMPLATE_REF_`(state: `_TEMPLATE_STATE_`)
|
|
27
|
+
|
|
28
|
+
`existing` は既存文書の編集対象、`missing` は宣言されたパスにファイルが無い新規作成対象、`unresolved` は宣言からパスを解決できず要否・宣言の確認が必要な状態を表す。`unresolved` のパスを命名規則から推測して作成しない。
|
|
29
|
+
|
|
30
|
+
result: `_RESULT_REF_`
|
|
31
|
+
|
|
32
|
+
_PROJECT_CONTEXT_
|
|
33
|
+
|
|
34
|
+
## 3. owner ロールとしての記述ポイント
|
|
35
|
+
|
|
36
|
+
成果物本体は frontmatter の `owner` に記載された role の視点で記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
|
|
37
|
+
|
|
38
|
+
- owner role: **_OWNER_ROLE_LABEL_**
|
|
39
|
+
- 責務: _OWNER_ROLE_NOTE_
|
|
40
|
+
|
|
41
|
+
このロールが重視するレビュー観点:
|
|
42
|
+
|
|
43
|
+
_OWNER_ROLE_VIEWPOINTS_
|
|
44
|
+
|
|
45
|
+
## 4. 進め方
|
|
46
|
+
|
|
47
|
+
まず実践の型の作成条件に照らして rulebook / recipe / sample / template の要否を判断する。必要な型だけを成果物と相互に矛盾しない一組として作成・整備し、不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言する。rulebook 自体が不要なら成果物カタログへ `rulebook: not-needed` と宣言する。成果物を主対象とし、そこから一般化した規定・作り方・例・雛形を必要な実践の型に反映する。各対象は実際に読み込んだうえで、既存があれば評価し、維持/修正/作り直しを判断する。必要だが既存が無ければ新規作成する。
|
|
48
|
+
|
|
49
|
+
作成条件は [[specdojo:kata-guide]] の `実践の型を作る条件` を正本とする。`_MISSING_` の参照は、rulebook frontmatter で `not-needed` と宣言済みなら作成しない。`undecided` なら要否を判断し、必要な型を整備して ID を宣言するか、不要として `not-needed` へ更新する。項目省略は必要だが未整備であるため作成対象に含める。
|
|
50
|
+
|
|
51
|
+
### grade result から展開された finding
|
|
52
|
+
|
|
53
|
+
_GRADE_FINDINGS_
|
|
54
|
+
|
|
55
|
+
1. 既存文書の finding: plan に展開された finding は severity にかかわらず、message と同じ viewpoint ID の判定根拠を修正要件として読み、指摘された問題を解消するよう該当箇所を修正する。修正後、問題が判定根拠に照らして解消したことを確認する。未解消、根拠不足、または判断不能の finding は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。修正後は `grade plan --changed-only` の対象になるため、再評価で構造・整合性が劣化していないことを確認する。
|
|
56
|
+
2. 成果物(主対象): `depends_on` の決定事項・用語・制約と整合させ、owner ロールの責務に集中して記述する。既存記述があれば内容を評価し、活かせる部分は維持、古い・矛盾する部分は修正、前提と合わない場合は作り直す。内部情報だけで判断できない一般的な観点・用語・標準があり、実行 agent が Web 検索能力を持つ場合は、関連情報を取得して出典を添える。
|
|
57
|
+
3. rulebook: 必要と判断した場合だけ、成果物の構造を一般化し、章構成・必須項目・禁止事項・判定基準を、同種成果物へ適用できる規定として整理する。rulebook は [[specdojo:rulebook-authoring-standard]](章立て・Frontmatter 規約・記述ルール・禁止事項の正本)に従う。
|
|
58
|
+
4. recipe: 必要と判断した場合だけ、良い成果物を作るための問い・観点・深掘り手順・レビュー観点を、再利用できる作成手順として整理する。
|
|
59
|
+
5. sample: 必要と判断した場合だけ、粒度・文体・表の書き方が伝わる最小の完成例にする。プロジェクト固有の値は一般化またはプレースホルダ化する。sample は [[specdojo:sample-authoring-standard]](構成・記述ルール・共通サンプル文脈・禁止事項の正本)に従い、rulebook / recipe と矛盾しないように作成する。
|
|
60
|
+
6. template: 必要と判断した場合だけ、章構成の骨組みとプレースホルダを配置した雛形にする。成果物固有の内容は持ち込まない。template は [[specdojo:template-authoring-standard]](構成・プレースホルダ規約・禁止事項の正本)に従い、埋めた結果が rulebook の本文構成と矛盾しないように作成する。
|
|
61
|
+
|
|
62
|
+
実践の型は成果物の丸写しにせず、同種成果物に再利用できる形に一般化する。構造・必須項目・禁止事項は rulebook を正とし、recipe / sample / template は rulebook と矛盾しないように揃える。
|
|
63
|
+
|
|
64
|
+
内容の根拠としてよい文書は、この plan に記載された対象(成果物・rulebook / 併せて適用する rulebook / recipe / sample / template)、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストに限定する。これら以外を成果物の内容の根拠にしない。ただし bootstrap では例外として、同種で `status: ready` の文書を手本として参照してよい(次項参照)。判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
65
|
+
|
|
66
|
+
ここで整備した実践の型は後続の refine-pass で凍結し、編集しない。本タスクの実行に必要な bootstrap の進め方は、このセクションで完結する。approach 全体の定義を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
67
|
+
|
|
68
|
+
### 4.1. 同種の ready 文書を手本にする
|
|
69
|
+
|
|
70
|
+
bootstrap では実践の型が未整備なため、構造・記法・慣行の揺れ(毎回ゼロから設計し直すことによる churn)を避ける目的で、同種で `status: ready` の文書を手本にする。
|
|
71
|
+
|
|
72
|
+
- 成果物・rulebook・recipe・sample・template のそれぞれについて、同じ種別で `status: ready` の文書があれば、その章構成・粒度・文体・表の書き方・プレースホルダの置き方などを手本にし、確立済みの形に倣う。
|
|
73
|
+
- 手本にするのは形(構造・記法・慣行)であり、内容は丸写ししない。当該成果物の内容は `depends_on` とプロジェクト文脈に基づいて書く。
|
|
74
|
+
- 手本が複数ある場合は、対象に最も近い種別・粒度のものを優先する。`status: ready` の同種文書が無い場合は、手本なしで `depends_on` と対象領域の慣行から組み立てる。
|
|
75
|
+
- 手本にした文書は result の `進め方と実践の型の適用` セクションに記録する。
|
|
76
|
+
|
|
77
|
+
### 4.2. 既存物の評価と作り直しの判断
|
|
78
|
+
|
|
79
|
+
- 各対象に既存記述がある場合は、まず内容を読み、根拠(成果物・`depends_on`・同種の `ready` 文書・対象領域の慣行)と整合するかを評価する。
|
|
80
|
+
- 整合するものは維持し、過不足・陳腐化・矛盾がある部分のみ修正する。基準として機能しないほど内容が古い・薄い場合に限り作り直す。
|
|
81
|
+
- 既存が無い、または参照範囲から外れた対象は、成果物・`depends_on`・同種の `ready` 文書を手本に新規作成する。
|
|
82
|
+
|
|
83
|
+
### 4.3. 判断根拠の記録
|
|
84
|
+
|
|
85
|
+
成果物と各実践の型について、評価・作成・修正・維持の判断根拠を result に残す。記録先は次のとおり。
|
|
86
|
+
|
|
87
|
+
- 成果物と各実践の型の作成・修正・維持の判断、手本にした同種 `ready` 文書、相互整合の取り方、矛盾時に rulebook を正とした箇所、丸写しを避けるための一般化、Web 出典: result の `進め方と実践の型の適用` セクション。
|
|
88
|
+
|
|
89
|
+
## 5. 完了の狙い
|
|
90
|
+
|
|
91
|
+
この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って成果物と実践の型を整備する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
|
|
92
|
+
|
|
93
|
+
_DONE_CRITERIA_GOALS_
|
|
94
|
+
|
|
95
|
+
## 6. 仕上げの品質チェック
|
|
96
|
+
|
|
97
|
+
成果物と実践の型の更新が一通り終わった後、内容の質を上げる仕上げとして、次の4操作を1回だけ通しで実施する。これは単発の仕上げ操作であり、観点別の自己レビュー・修正ループではない。同じ観点での再確認を繰り返さず1巡で終え、多観点での検証は後続の独立した review task に委ねる。
|
|
98
|
+
|
|
99
|
+
1. 不要記述の削除: rulebook の必須要素にも「完了の狙い」に示された `done_criteria` にも寄与していない記述を削除する。
|
|
100
|
+
2. 重複記述の統合: 同じ内容が同一文書内、または成果物と実践の型の間で重複している場合は、内容が最も適切な1箇所を正本と定めて統合し、他は要約または正本への参照に置き換える。統合で情報が失われる場合は、不足分を正本側へ取り込んでから他方を整理する。
|
|
101
|
+
3. 可読性のための分割: 1つの節・段落・表に複数の論点が混在して読み取りにくい箇所を、節・箇条書き・表へ分割する。分割は rulebook が定める章構成の範囲内で行い、章構成そのものを崩さない。
|
|
102
|
+
4. 論理整合の確認: 用語・定義・前提・手順の順序が、文書内および成果物と実践の型の間で矛盾していないかを確認し、矛盾があれば整える(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
103
|
+
|
|
104
|
+
この4操作は既存の記述の整理として行い、「進め方」で定めた根拠の範囲を超える内容は追記しない。削除・統合・分割の可否を判断できない箇所は、無理に整理せず _TODO_ / _ASSUMPTION_ として論点を残す。実施した削除・統合・分割と、その判断根拠は result の `進め方と実践の型の適用` セクションに記録する。
|
|
105
|
+
|
|
106
|
+
## 7. 完了手順
|
|
107
|
+
|
|
108
|
+
1. 「このフェーズで行うこと」と「進め方」に従って、成果物と必要な rulebook / recipe / sample / template、成果物カタログの rulebook 宣言、および rulebook frontmatter の3種の要否宣言を更新する。
|
|
109
|
+
2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
|
|
110
|
+
3. 「仕上げの品質チェック」の4操作を1回だけ実施する(成果物と各実践の型の相互整合の確認を含む)。
|
|
111
|
+
4. 共通規約に従って、必要な整形・静的検査を実行する。
|
|
112
|
+
5. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
|
|
113
|
+
|
|
114
|
+
## 8. 異常終了の条件
|
|
115
|
+
|
|
116
|
+
- 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
|
|
117
|
+
- 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
|
|
118
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
119
|
+
|
|
120
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
## 共通: 記法・成果物規約
|
|
2
|
+
|
|
3
|
+
この規約は、生成される全 exec plan に共通で適用される。result の完了条件、他文書を参照する際のリンク記法、成果物の状態(status)の扱いを統一する。
|
|
4
|
+
|
|
5
|
+
- result(review plan の場合は review result)への記入は、タスク完了に必須の作業である。成果物の編集とは別に、最後に必ず実施する。
|
|
6
|
+
- 終了コード 0 で完了する前に、result の必須セクションをすべて実際の内容で埋め、プレースホルダ(_TODO_ など)や未記入のセクションを残さない。
|
|
7
|
+
- 成果物に変更が不要と判断した場合でも、result の記入は省略しない。変更不要と判断した理由と根拠を result に記入してから完了する。
|
|
8
|
+
- result が未記入・プレースホルダのまま終了コード 0 で終了すると、runner は成果物未完了(block)として扱い、タスクはやり直しになる。完了前に result の記入漏れがないことを必ず確認する。
|
|
9
|
+
- result の frontmatter は scaffold 済みの構造を正本とする。`id` / `task_id` / `mode` / `project_id` / `plan_ref` / `agent` / `execution` / `approach` / `targets` はキーの追加・削除・改名をせず、scaffold された値のまま維持する。見出し構成(`# Edit Result` などの H1、`## 1.` 以降の章立て)も独自の構成に置き換えない。埋めるのは本文セクションの `_TODO_` プレースホルダの中身だけである。`status` と `completed_at` は完了処理(runner 側)が更新するため、自分で書き換えない。
|
|
10
|
+
- 文書へのリンクは、対象文書が既に存在する場合は `[[id|title]]` 形式で記載する(`id` は project 修飾 doc id)。
|
|
11
|
+
- リンクを表(テーブル)のセル内に置く場合は、区切りの `|` を `[[id\|title]]` のようにエスケープする。エスケープしないと列がずれて表が壊れ、prettier 整形でセルが分割されて固定化される。
|
|
12
|
+
- まだ存在しない文書を参照する場合は、`[[...]]` ではなく `` `id` `` または `` `filename` `` のようにバッククォートで仮置きする。
|
|
13
|
+
- Markdown の自由記述では、`_` を含む識別子・フィールド名(例: `depends_on`)を必ずインラインコードで囲む。result に描画される executor evidence や reporter の自由記述も同じ記法にする。
|
|
14
|
+
- 成果物 frontmatter の `status` を `ready` に変更しない。`ready` への昇格は人間のみが行うため、`draft` のまま据え置く(exec のコミット時ガードでも昇格はブロックされる)。
|
|
15
|
+
- plan に「プロジェクトコンテキスト」章がある場合、そこに挙がる文書はプロジェクト共通の前提を読むための参照であり、成果物 frontmatter の `based_on` へ転記しない。参照して得た前提は本文の記述内容へ反映する。
|
|
16
|
+
- 成果物 frontmatter の `based_on` に書けるのは、その成果物の `depends_on` の推移閉包に含まれる先行成果物だけである。閉包外の ID を書くと `catalog validate` が「`based_on` が `depends_on` の推移閉包に含まれていません」としてエラーになり、コミットがブロックされる。`based_on` を増やす必要が生じた場合は、自分で転記せず、根拠不足として result に記録する。
|
|
17
|
+
- ファイルの読み取り・書き込み・編集は、作業ディレクトリ(カレントディレクトリ)からの相対パスで指定する。絶対パスを自分で組み立てたり、作業ディレクトリ名を推測して指定したりしない(作業ディレクトリ名の取り違えは外部パス扱いになり拒否される)。
|
|
18
|
+
- 編集・書き込みが作業ディレクトリ外(`external_directory`)として拒否された場合、原因はパス指定の誤り(誤った絶対パス・ディレクトリ名の取り違え)である。bash の heredoc などへ回避的に切り替えず、相対パスに直したうえで同じ編集ツールで再実行する。
|
|
19
|
+
- 整形・静的検査は、この plan の完了手順または本共通規約で明示されたコマンドを実行する。変更対象に必要な test、build、schema 検証は、plan に個別記載がなくても実行してよい。同じ test script では対象限定と全件を同一 executor run 内で連続実行せず、どちらか一方に絞る。下表、plan、またはプロジェクト標準が全件 test を求める場合は、全件を1回だけ実行して対象限定の実行を省く。この制約は executor が sandbox 内で実行する test script の回数に対するものであり、親検証に設定された ID のコマンドは対象外である(親 runner が別途実行する)。実行したコマンド・対象・結果は result に記録する。
|
|
20
|
+
- executor / reporter pipeline で親 runner の検証が設定されている場合、executor は設定済み ID に対応するコマンドを sandbox 内で実行せず、executor 終了後に親 runner が固定許可リストから実行して evidence へ追記する。`validate-schema` は `npm run validate:schema`、`test-unit` は `npm run test:unit`、`test-integration` は `npm run test:integration` に対応する。executor は親検証と同じコマンドの対象限定版も追加せず、二重実行しない。
|
|
21
|
+
- Markdown 成果物を編集した後は、`npx prettier --write <対象ファイル>` で整形し、`npx markdownlint <対象ファイル>` で静的検査を実施する。検査でエラーが出た場合は修正してから完了とする。
|
|
22
|
+
- YAML 成果物を編集した後は、対応 schema `_SCHEMA_REF_` に従って記述し、`npm run validate:schema:file -- --schema _SCHEMA_REF_ --data <対象ファイル>` で schema 検査を実施する。検査でエラーが出た場合は修正してから完了とする。
|
|
23
|
+
- 終了する前に、コミット時に実行される検査(pre-commit 相当)を先回りで実行し、失敗をすべて修正してから完了する。コミット時に初めて失敗が判明すると commit がブロックされ、成果物の内容が完成していてもタスクは block になる。
|
|
24
|
+
- 実行対象は、変更したファイルの種別で判断する。下表のうち、変更したファイルが該当する行の検査をすべて実行する。該当行がない場合は追加の検査は不要である。ただし親検証に設定された ID のコマンドは下表よりも優先し、executor は実行しない。下表に同じコマンドが挙がっていても、親 runner の実行に委ねる。
|
|
25
|
+
- 検査コマンドの正本はリポジトリの hook 設定(`lefthook.yml` など)である。下表と設定が食い違う場合は設定側に合わせ、実行したコマンドと結果を result に記録する。`specdojo` コマンドは、リポジトリで定められた起動方法(`npx tsx src/specdojo.ts <subcommand>` など)で実行する。
|
|
26
|
+
|
|
27
|
+
| 変更したファイル | 実行する検査 |
|
|
28
|
+
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
29
|
+
| `*.md` | `npx prettier --write <対象ファイル>`、`npx markdownlint <対象ファイル>` |
|
|
30
|
+
| `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml` | `npx prettier --write <対象ファイル>` |
|
|
31
|
+
| `src/`、`tests/`、`scripts/`、`tools/`、`tsconfig*.json` | `npm run typecheck` |
|
|
32
|
+
| `src/`、`tests/`、`docs/ja/specdojo/templates/`、`docs/ja/specdojo/exec-templates/`、`vitest.config.*` | pipeline executor は `npm run test:unit`、それ以外は `npm test`(`test-unit` が親検証に設定されている場合は executor では実行しない) |
|
|
33
|
+
| `docs/ja/projects/` 配下 | `specdojo catalog validate` |
|
|
34
|
+
| `dct-*.yaml` | `specdojo catalog build` |
|
|
35
|
+
| `pjr-index.md` | `specdojo register build` |
|
|
36
|
+
| `sch-*.yaml` | `specdojo exec refresh` |
|
|
37
|
+
| `docs/` 配下 | `specdojo index build` |
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Cross-deliverable Dedup Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
bootstrap 完了後の成果物群を一度だけ横断し、各論点の正本を選択する。正本へ詳細を集約し、他文書の重複記述を、単独可読性に必要な短い要約と正本への参照へ置き換える。
|
|
10
|
+
|
|
11
|
+
## 2. 対象成果物
|
|
12
|
+
|
|
13
|
+
frontmatter の `targets` と以下の一覧が、このタスクで変更できる全成果物である。対象外ファイルは変更しない。
|
|
14
|
+
|
|
15
|
+
_TARGET_DELIVERABLES_
|
|
16
|
+
|
|
17
|
+
- `result`: `_RESULT_REF_`
|
|
18
|
+
|
|
19
|
+
## 3. 進め方
|
|
20
|
+
|
|
21
|
+
1. 対象成果物をすべて読み、同じ事実・判断・理由・手順を詳述している重複候補を論点単位で抽出する。文字列一致や長さだけで重複と判定しない。
|
|
22
|
+
2. 文書の責務、成果物カタログの `overview` / `done_criteria`、既存の `based_on` / `depends_on`、下流からの参照方向を基準に、各論点の正本を一つ選ぶ。
|
|
23
|
+
3. 正本に、論点の結論・判断理由・制約・例外・必要な追跡情報を集約する。既存の正しい固有記述は尊重し、全面的に書き直さない。
|
|
24
|
+
4. 他文書では、単独で責務を理解するための短い要約を残し、詳細を正本への `[[id|title]]` 参照へ置き換える。参照先が存在することを確認する。
|
|
25
|
+
5. 対象成果物ごとに `done_criteria`、文書固有の観点、rulebook / schema の必須情報、`based_on` / `depends_on` とトレーサビリティが維持されていることを確認する。不足や矛盾は憶測で埋めず、_TODO_ / _ASSUMPTION_ として根拠と次の行動を残す。
|
|
26
|
+
|
|
27
|
+
短さ自体を目的にしない。背景、判断理由、例外、制約、成果物固有の責務、単独可読性に必要な要約は保持する。review viewpoint は後続 review で重複の再発を検出するために使い、この pass は検出済みの重複を実際に修正する。
|
|
28
|
+
|
|
29
|
+
## 4. result への記録
|
|
30
|
+
|
|
31
|
+
result には、次を論点と文書が追跡できる粒度で記録する。
|
|
32
|
+
|
|
33
|
+
- 詳細を集約・変更した正本文書と論点
|
|
34
|
+
- 要約・参照へ置き換えた文書、置換前の重複論点、参照先
|
|
35
|
+
- 意図的に残した重複、その文書固有の必要性
|
|
36
|
+
- `done_criteria`、トレーサビリティ、文書責務、`based_on` / `depends_on` を確認した結果
|
|
37
|
+
|
|
38
|
+
## 5. 完了手順
|
|
39
|
+
|
|
40
|
+
1. 「進め方」に従って対象成果物だけを更新する。
|
|
41
|
+
2. 対象成果物ごとの必須情報と追跡性が維持されていることを確認する。
|
|
42
|
+
3. 共通規約に従って、必要な整形・静的検査を実行する。
|
|
43
|
+
4. result の必須セクションを実際の内容で埋め、_TODO_ を残さない。
|
|
44
|
+
|
|
45
|
+
## 6. 異常終了の条件
|
|
46
|
+
|
|
47
|
+
- 対象不足・正本を選べない重大な矛盾・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
|
|
48
|
+
- 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
|
|
49
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
50
|
+
|
|
51
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,74 @@
|
|
|
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
|
+
rulebook / recipe / sample / template に原則縛られないため、対象成果物の文脈から記載内容を組み立てる。次の手順で記載内容を決める。
|
|
33
|
+
|
|
34
|
+
1. `depends_on` に挙がった成果物を読み、前提・決定事項・用語・制約を把握し、それらと整合する内容にする。
|
|
35
|
+
2. `name`・`overview` とレビュー観点から、この成果物が答えるべき問いと記載すべき項目の仮説を立てる。各レビュー観点を満たす記述を必ず含める。
|
|
36
|
+
3. プロジェクト文脈(背景・目的・関係者の意図)を `depends_on` の成果物や関連ドキュメントから確認し、仮説を裏付けるか修正する。
|
|
37
|
+
4. 内部情報だけで判断できない一般的な観点・用語・標準があり、実行 agent が Web 検索能力を持つ場合は、関連情報を取得して出典を添える。Web 検索能力がない場合は、利用可能な内部情報の範囲で判断し、確認できない事項を result に記録する。
|
|
38
|
+
5. 仮説と収集した情報をもとに成果物を記述する。判断に迷う箇所は _TODO_ / _ASSUMPTION_ で残し、根拠と次のアクションを書く。
|
|
39
|
+
|
|
40
|
+
記載にあたっては次を守る。
|
|
41
|
+
|
|
42
|
+
- 対象成果物に既存の記述がある場合は、まず内容を確認する。`depends_on` の最新の決定事項やプロジェクト文脈と矛盾する、または前提が変わって古くなった記述は破棄する。古くなっていない記述は活かし、不足分を加筆・補強する。破棄・加筆の判断根拠を result の `進め方と実践の型の適用` セクションに残す。
|
|
43
|
+
- 実践の型より、対象領域の類似成果物の実例とプロジェクト文脈を優先し、実践の型は矛盾しない範囲の参考にとどめる。
|
|
44
|
+
- 実践の型とプロジェクト文脈が矛盾する場合は、プロジェクト文脈を優先し、その理由を記録する。
|
|
45
|
+
- この plan のフェーズ説明とレビュー観点を満たすことを主な基準にする。
|
|
46
|
+
|
|
47
|
+
本タスクの実行に必要な freeform の進め方は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
48
|
+
|
|
49
|
+
### 4.1. 判断根拠の記録
|
|
50
|
+
|
|
51
|
+
仮説と収集した情報をもとにした判断根拠を result に残す。記録先は次のとおり。
|
|
52
|
+
|
|
53
|
+
- 仮説の根拠、参照した `depends_on` 成果物、Web 出典、優先した実例・プロジェクト文脈、実践の型を補助に使った場合の判断根拠、実践の型とプロジェクト文脈が矛盾しプロジェクト文脈を優先した箇所とその理由、既存記述の破棄・加筆の根拠: result の `進め方と実践の型の適用` セクション。
|
|
54
|
+
|
|
55
|
+
## 5. 完了の狙い
|
|
56
|
+
|
|
57
|
+
この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って組み立てる中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
|
|
58
|
+
|
|
59
|
+
_DONE_CRITERIA_GOALS_
|
|
60
|
+
|
|
61
|
+
## 6. 完了手順
|
|
62
|
+
|
|
63
|
+
1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
|
|
64
|
+
2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
|
|
65
|
+
3. 共通規約に従って、必要な整形・静的検査を実行する。
|
|
66
|
+
4. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
|
|
67
|
+
|
|
68
|
+
## 7. 異常終了の条件
|
|
69
|
+
|
|
70
|
+
- 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
|
|
71
|
+
- 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
|
|
72
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
73
|
+
|
|
74
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,109 @@
|
|
|
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
|
+
対象成果物に必要と宣言された rulebook / recipe は、指定されたファイルを実際に読み込んだうえで、次の役割に沿って参照する。読み込まずに記憶や推測で代替しない。
|
|
33
|
+
|
|
34
|
+
参照ファイル(成果物カタログの rulebook ID と rulebook frontmatter から解決。`_MISSING_` は `undecided`、`not-needed`、未整備、または `kind: generated` による非適用を表す。fully-guided では通常 `not-needed` の項目だけが該当する):
|
|
35
|
+
|
|
36
|
+
- rulebook: `_RULEBOOK_REF_`
|
|
37
|
+
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
38
|
+
- recipe: `_RECIPE_REF_`
|
|
39
|
+
|
|
40
|
+
1. rulebook: `_MISSING_` でなければ指定された rulebook を読み込み、成果物が必須要素をすべて満たし、禁止事項に抵触していないかを構造面の基準として確認する。
|
|
41
|
+
2. 併せて適用する rulebook: `_MISSING_` でない場合は各ファイルを読み込み、記法など主 rulebook が委譲したルールに従う。主 rulebook と矛盾する場合は主 rulebook を正とする。
|
|
42
|
+
3. recipe: `_MISSING_` でなければ指定された recipe を読み込み、示された問い・観点・深掘り手順に沿って内容を組み立てる。
|
|
43
|
+
|
|
44
|
+
磨き込みでは sample / template は読み込まない。粒度・文体・表現・章構成は、既存の対象成果物を基準としてそろえる。複数の文書間で記述に矛盾がある場合は rulebook を正とする。
|
|
45
|
+
|
|
46
|
+
### grade result から展開された finding
|
|
47
|
+
|
|
48
|
+
_GRADE_FINDINGS_
|
|
49
|
+
|
|
50
|
+
plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
|
|
51
|
+
|
|
52
|
+
参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / 併せて適用する rulebook / recipe、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。成果物の作成・更新は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
53
|
+
|
|
54
|
+
本タスクの実行に必要な fully-guided の参照方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
55
|
+
|
|
56
|
+
### 4.1. 必要な実践の型が存在しない・内容が薄い場合
|
|
57
|
+
|
|
58
|
+
- `not-needed` ではない rulebook / recipe が存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を result の `進め方と実践の型の適用` セクションに記録する。
|
|
59
|
+
- 不足分は、存在する他の実践の型と `depends_on` 成果物(いずれも plan 記載の文書)、および既存の対象成果物で補う。実践の型の欠落を理由にレビュー観点を未達にしない。
|
|
60
|
+
- 章構成は既存の対象成果物を骨組みとし、判断に迷う場合は rulebook の構成を正とする。
|
|
61
|
+
- 実践の型そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、申し送りに残す。
|
|
62
|
+
|
|
63
|
+
### 4.2. 既存記述の扱い
|
|
64
|
+
|
|
65
|
+
- 対象成果物に既存の記述がある場合は、まず内容を確認し、既存記述を尊重する。既存記述の破棄や全面的な書き換えは原則として行わず、既存記述を基礎として不足分を加筆・補強する。
|
|
66
|
+
- 次のいずれかに該当する箇所は、既存記述であっても修正対象とする。修正はいずれも該当箇所に閉じた最小限にとどめる。
|
|
67
|
+
- `depends_on` の最新の決定事項と明確に矛盾する箇所。
|
|
68
|
+
- 手順1で確認した rulebook の必須要素が欠落している箇所、rulebook の禁止事項に抵触している箇所、および rulebook が定める章構成に適合していない箇所。
|
|
69
|
+
- 同一成果物内で同じ内容が複数箇所に重複している箇所。
|
|
70
|
+
- rulebook の必須要素にも「完了の狙い」に示された `done_criteria` にも寄与していない記述。
|
|
71
|
+
- 上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しない。既存記述が rulebook の許容範囲内(例: 複数の構成が認められている場合の一方の選択)であれば、他章との見た目の整合を理由に、より詳細な構成や長い記述へ書き換えない。
|
|
72
|
+
- rulebook 不適合の修正は、既存記述の内容を保持したまま rulebook の章構成へ移し替え、欠落した必須要素を補い、禁止事項に該当する記述形式を改める作業として行う。内容の全面書き換えはしない。移し替え先が定まらない既存記述は、下記の削除対象に該当しない限り削除せず、内容が最も近い章に残したうえで、その判断を result に記録する。
|
|
73
|
+
- 重複記述は、内容が最も適切な1箇所を正本と定めて統合し、他の箇所は要約または正本の章への参照に置き換える。統合で情報が失われる場合は、不足分を正本側に取り込んでから他方を整理する。
|
|
74
|
+
- rulebook の必須要素にも `done_criteria` にも寄与していない記述は削除する。削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保する。
|
|
75
|
+
- 既存記述が古いか判断できない場合、rulebook への不適合か意図的な逸脱か判断できない場合、および必須要素・`done_criteria` に寄与するか判断できない場合は、破棄せず _TODO_ / _ASSUMPTION_ で論点を残す。
|
|
76
|
+
- 加筆・修正・統合・削除の判断根拠を result の `進め方と実践の型の適用` セクションに残す。削除・統合した記述については、対象箇所と根拠が後から追える粒度で記録する。
|
|
77
|
+
|
|
78
|
+
### 4.3. 根拠のない具体化の禁止
|
|
79
|
+
|
|
80
|
+
- ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けが取れる場合に限る。
|
|
81
|
+
- 既存記述が曖昧・不完全(ファイル名のみでパスが無い、値が未確定など)であっても、裏付けが無ければ推測で具体化しない。完成度を上げる目的だけで、もっともらしい値を断定的に書き加えない。
|
|
82
|
+
- 裏付けが無く判断できない箇所は、既存の曖昧な記述を残したまま _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
83
|
+
|
|
84
|
+
### 4.4. 判断根拠の記録
|
|
85
|
+
|
|
86
|
+
参照した文書・参照しなかった文書と、その判断根拠を result に残す。記録先は次のとおり。
|
|
87
|
+
|
|
88
|
+
- 参照した rulebook / recipe の使い分け、矛盾時に rulebook を正とした箇所、欠落・薄い実践の型の扱い、既存記述の加筆・修正・統合・削除の根拠、具体化を見送った箇所とその理由: result の `進め方と実践の型の適用` セクション。
|
|
89
|
+
|
|
90
|
+
## 5. 完了の狙い
|
|
91
|
+
|
|
92
|
+
この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って実践の型に沿って記述する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
|
|
93
|
+
|
|
94
|
+
_DONE_CRITERIA_GOALS_
|
|
95
|
+
|
|
96
|
+
## 6. 完了手順
|
|
97
|
+
|
|
98
|
+
1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
|
|
99
|
+
2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
|
|
100
|
+
3. 共通規約に従って、必要な整形・静的検査を実行する。
|
|
101
|
+
4. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
|
|
102
|
+
|
|
103
|
+
## 7. 異常終了の条件
|
|
104
|
+
|
|
105
|
+
- 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
|
|
106
|
+
- 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
|
|
107
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
108
|
+
|
|
109
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Job Plan: _JOB_NAME_
|
|
4
|
+
|
|
5
|
+
## 1. このRunで行うこと
|
|
6
|
+
|
|
7
|
+
_JOB_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. Job Run
|
|
10
|
+
|
|
11
|
+
- `job_id`: _JOB_ID_
|
|
12
|
+
- `run_id`: _RUN_ID_
|
|
13
|
+
- `scheduled_at`: _SCHEDULED_AT_
|
|
14
|
+
- `result`: `_RESULT_REF_`
|
|
15
|
+
|
|
16
|
+
入力:
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
_JOB_INPUTS_
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## 3. 対象成果物
|
|
23
|
+
|
|
24
|
+
_JOB_TARGETS_
|
|
25
|
+
|
|
26
|
+
対象パス:
|
|
27
|
+
|
|
28
|
+
_JOB_PATHS_
|
|
29
|
+
|
|
30
|
+
_JOB_EXECUTION_
|
|
31
|
+
|
|
32
|
+
## 4. 完了手順
|
|
33
|
+
|
|
34
|
+
1. 指示と入力に従って対象成果物を更新する。
|
|
35
|
+
2. 必要な整形・静的検査を実行する。
|
|
36
|
+
3. resultの必須セクションを記入し、`_TODO_`を残したまま終了しない。
|
|
37
|
+
|
|
38
|
+
## 5. 異常終了の条件
|
|
39
|
+
|
|
40
|
+
- 入力不足、対象不明、検査未解消の場合は異常終了する。
|
|
41
|
+
- agent自身はJob Runの状態やcheckpointを変更しない。runnerが終了結果を反映する。
|
|
42
|
+
|
|
43
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,82 @@
|
|
|
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
|
+
対象成果物に紐づく recipe を、指定されたファイルを実際に読み込んだうえで主な基準として参照する。読み込まずに記憶や推測で代替しない。
|
|
33
|
+
|
|
34
|
+
主な基準とする recipe(rulebook frontmatter から解決): `_RECIPE_REF_`(`_MISSING_` の場合は「recipe が存在しない・内容が薄い場合」に従う)。
|
|
35
|
+
|
|
36
|
+
1. recipe: 指定された recipe を読み込み、示された構成・問い・観点・深掘り手順に沿って成果物を組み立てる。
|
|
37
|
+
2. recipe が答えを示さない箇所は、`depends_on` 成果物およびプロジェクトコンテキストとの整合で補う。参照してよい文書は、この plan に記載された recipe、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストに限る。plan に列挙されていない他のプロジェクト文書を独自に探索・参照せず、判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
38
|
+
|
|
39
|
+
成果物は、冗長な記述や内容の重複を避け、簡潔でわかりやすく記載する。
|
|
40
|
+
|
|
41
|
+
rulebook / sample / template は未成熟と判断されているため、存在しても構造・文体・粒度の必須基準としては扱わない。recipe の指示が他の文書と矛盾する場合は recipe を優先する。
|
|
42
|
+
|
|
43
|
+
本タスクの実行に必要な recipe-guided の参照方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
44
|
+
|
|
45
|
+
### 4.1. recipe が存在しない・内容が薄い場合
|
|
46
|
+
|
|
47
|
+
- recipe は recipe-guided の唯一の主基準であるため、存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を result の `進め方と実践の型の適用` セクションに記録する。
|
|
48
|
+
- その場合は `depends_on` 成果物とこの plan の記述(フェーズ説明・レビュー観点)を主な根拠に組み立て、何を recipe の代わりに根拠としたかを明示する。
|
|
49
|
+
- recipe そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、申し送りに残す。
|
|
50
|
+
|
|
51
|
+
### 4.2. 既存記述の扱い
|
|
52
|
+
|
|
53
|
+
- 対象成果物に既存の記述がある場合は、まず内容を確認し、既存記述を尊重する。既存記述の破棄や全面的な書き換えは原則として行わず、既存記述を基礎として不足分を加筆・補強する。
|
|
54
|
+
- `depends_on` の最新の決定事項と明確に矛盾する箇所に限り、矛盾を解消する最小限の修正にとどめる。既存記述が古いか判断できない場合は破棄せず、_TODO_ / _ASSUMPTION_ で論点を残す。
|
|
55
|
+
- 加筆・修正の判断根拠を result の `進め方と実践の型の適用` セクションに残す。
|
|
56
|
+
|
|
57
|
+
### 4.3. 判断根拠の記録
|
|
58
|
+
|
|
59
|
+
参照した文書と判断根拠を result に残す。記録先は次のとおり。
|
|
60
|
+
|
|
61
|
+
- recipe を参照した箇所、recipe で判断できず補助材料で判断した箇所、rulebook / sample / template を基準にしなかった理由と代わりに根拠にした内容、既存記述の加筆・修正の根拠: result の `進め方と実践の型の適用` セクション。
|
|
62
|
+
|
|
63
|
+
## 5. 完了の狙い
|
|
64
|
+
|
|
65
|
+
この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って実践の型に沿って記述する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
|
|
66
|
+
|
|
67
|
+
_DONE_CRITERIA_GOALS_
|
|
68
|
+
|
|
69
|
+
## 6. 完了手順
|
|
70
|
+
|
|
71
|
+
1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
|
|
72
|
+
2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
|
|
73
|
+
3. 共通規約に従って、必要な整形・静的検査を実行する。
|
|
74
|
+
4. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
|
|
75
|
+
|
|
76
|
+
## 7. 異常終了の条件
|
|
77
|
+
|
|
78
|
+
- 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
|
|
79
|
+
- 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
|
|
80
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
81
|
+
|
|
82
|
+
_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 の recipe 宣言から解決):
|
|
20
|
+
|
|
21
|
+
- `kind`: recipe
|
|
22
|
+
- `path`: `_RECIPE_REF_`
|
|
23
|
+
- `state`: `_RECIPE_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
|
+
参照の向きを「成果物 → recipe」に切り替え、対象成果物に紐づく recipe を「見直す対象」として編集する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで判断する。読み込まずに記憶や推測で代替しない。
|
|
43
|
+
|
|
44
|
+
### grade result から展開された finding
|
|
45
|
+
|
|
46
|
+
_GRADE_FINDINGS_
|
|
47
|
+
|
|
48
|
+
1. 見直し対象の recipe を読み込み、現状の問い・観点・深掘り手順・レビュー観点を把握する。
|
|
49
|
+
2. plan に展開された finding は severity にかかわらず、message と同じ viewpoint ID の判定根拠を修正要件として読み取る。message と判定根拠から指摘の根拠となる規範を特定し、対象 recipe の frontmatter から辿れる rulebook、該当する執筆標準のうち必要な文書を読み、指摘された問題を解消するよう該当箇所を修正する。
|
|
50
|
+
3. 修正後、各 finding の問題が判定根拠に照らして解消したことを確認する。未解消、根拠不足、または判断不能の finding は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
|
|
51
|
+
4. 複数の成果物・review result・対象領域の慣行を根拠に、それらが良い内容の作成に役立っているかを見直す。
|
|
52
|
+
5. 成果物で繰り返し不足する内容や review で繰り返し指摘される箇所があれば、それを引き出す問い・観点を recipe に追加する。
|
|
53
|
+
6. 既存記述のうち、根拠と整合しない・陳腐化したものは見直し、整合するものは維持する。
|
|
54
|
+
|
|
55
|
+
finding の修正後は、再評価で構造・整合性が劣化していないことを確認する。
|
|
56
|
+
|
|
57
|
+
見直した recipe は [[specdojo:recipe-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従う。rulebook と記述が矛盾しないように更新する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
58
|
+
|
|
59
|
+
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な recipe メンテナンスの進め方は、このセクションで完結する。
|
|
60
|
+
|
|
61
|
+
### 4.1. 見直しの根拠が不足する場合
|
|
62
|
+
|
|
63
|
+
- finding の message と判定根拠、対象 recipe から辿れる rulebook、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂を判断できない場合に限り、根拠不足として見送る。成果物または review result がないことだけを理由に見送らない。
|
|
64
|
+
- 見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result の `進め方と実践の型の適用` セクションに記録する。
|
|
65
|
+
- 根拠不足のまま推測で recipe を改訂しない。確証が得られた範囲に改訂を限定し、残りは申し送りに残す。
|
|
66
|
+
- 見直し対象の recipe が存在しない場合は、根拠とした成果物群から新規に作成する。
|
|
67
|
+
|
|
68
|
+
### 4.2. 判断根拠の記録
|
|
69
|
+
|
|
70
|
+
見直しの根拠とした規範・成果物・review result と判断根拠を result に残す。記録先は次のとおり。
|
|
71
|
+
|
|
72
|
+
- 根拠とした規範・成果物・review result、改訂・維持した記述とその根拠、矛盾時に rulebook を正とした箇所: result の `進め方と実践の型の適用` セクション。
|
|
73
|
+
|
|
74
|
+
## 5. 完了手順
|
|
75
|
+
|
|
76
|
+
1. 「このフェーズで行うこと」に従って recipe を更新する。
|
|
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_
|