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,440 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:exec-operation-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# exec運用ガイド
|
|
9
|
+
|
|
10
|
+
Exec Operation Guide
|
|
11
|
+
|
|
12
|
+
`specdojo exec` が扱う3つの実行経路(schedule / register / routine)の関心事と選び方、中断・訂正・再実行、human タスクの扱いを説明します。経路ごとの実行手順は、schedule実行が [Schedule実行運用ガイド](schedule-operation-guide.md)、register実行が [登録簿運用ガイド](register-operation-guide.md)、routineによる定期起動が [routine運用ガイド](routine-operation-guide.md) です。コマンド一覧は [CLIコマンドリファレンス](../references/command-reference.md) を参照します。
|
|
13
|
+
|
|
14
|
+
**対象読者**
|
|
15
|
+
|
|
16
|
+
- Schedule や登録簿のタスクを人またはエージェントで実行・監視する開発者、運用者
|
|
17
|
+
|
|
18
|
+
**この文書で分かること**
|
|
19
|
+
|
|
20
|
+
- 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い
|
|
21
|
+
|
|
22
|
+
**次に読む文書**
|
|
23
|
+
|
|
24
|
+
- schedule タスクの自動・手動実行は [Schedule実行運用ガイド](schedule-operation-guide.md)、登録簿運用は [登録簿運用ガイド](register-operation-guide.md)、routineによる定期実行は [routine運用ガイド](routine-operation-guide.md) を参照してください。
|
|
25
|
+
- エージェント設定は [exec設定ガイド](exec-config-guide.md)、plan・result の管理は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md)、手動隔離実行は [exec worktree運用ガイド](exec-worktree-guide.md) を参照してください。
|
|
26
|
+
|
|
27
|
+
## 1. execの基本
|
|
28
|
+
|
|
29
|
+
exec が扱う関心事、タスクの出どころによる実行経路の選び方、代表的なユースケースを示します。
|
|
30
|
+
|
|
31
|
+
### 1.1. execの関心事
|
|
32
|
+
|
|
33
|
+
`exec` は次の関心事を分けて扱います。
|
|
34
|
+
|
|
35
|
+
| 関心事 | 内容 | 代表コマンド |
|
|
36
|
+
| ---------------- | --------------------------------------------------------- | ---------------------------------------------- |
|
|
37
|
+
| plan生成 | schedule または catalog から作業指示を作る | `exec plan` / `exec run` |
|
|
38
|
+
| 状態追跡 | claim / complete / reopen / block などの event を記録する | `exec claim` / `exec complete` / `exec reopen` |
|
|
39
|
+
| 隔離 | task worktree で成果物変更を隔離する | `exec run --worktree` / `exec worktree` |
|
|
40
|
+
| スケジューリング | Ready と CPM から次タスクを選んで claim する | `exec scheduler` / `exec run --auto` |
|
|
41
|
+
|
|
42
|
+
既定の `exec run --task` はカレントリポジトリで単発実行し、状態イベントや worktree を作りません。
|
|
43
|
+
|
|
44
|
+
### 1.2. 実行経路の使い分け
|
|
45
|
+
|
|
46
|
+
agent にタスクを実行させる経路は、実行対象の出どころによって schedule 実行と register 実行の 2 つがあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(schedule / register)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
|
|
47
|
+
|
|
48
|
+
| 観点 | schedule 実行 | register 実行 | routine(トリガー層) |
|
|
49
|
+
| ------------ | ----------------------------------------- | ------------------------------------------------- | ---------------------------------------- |
|
|
50
|
+
| 実行対象 | `sch-track-*.yaml` のタスク(依存グラフ) | `generated/pjr-index.md` の項目 | `rtn-*.yaml` の定義(実体は左の 2 経路) |
|
|
51
|
+
| 代表コマンド | `exec run --task` / `exec run --auto` | `exec run --register` | `routine run --due` |
|
|
52
|
+
| 起動 | 人、または routine(`job-exec-auto`) | 人、または routine(`job-register-sweep`) | 外部スケジューラ(cron / CI) |
|
|
53
|
+
| 状態追跡 | exec events(claim / complete / block) | register の遷移(in-progress / review / waiting) | `last_run` の記録のみ |
|
|
54
|
+
| 隔離 | worktree(`--worktree` / `--auto`) | in-place のみ | -(実行経路へ委譲) |
|
|
55
|
+
| 終端の扱い | `complete` event(human finalize で確定) | 人が確認して `register close` | -(発火の記録のみ) |
|
|
56
|
+
| 典型用途 | 計画された成果物の作成・レビュー・確定 | 立ち上げ時の課題・判断、進行中の計画外対応・調査 | 日次スイープ・夜間バッチなどの定期実行 |
|
|
57
|
+
|
|
58
|
+
迷った場合は次で判断します。
|
|
59
|
+
|
|
60
|
+
- 成果物カタログと依存関係に基づく計画済みの作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
|
|
61
|
+
- 立ち上げ時の未整理な課題・判断、または進行中に発生した計画外の単発対応・調査で、台帳として追跡したいものは register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。手順は [登録簿運用ガイド](register-operation-guide.md))。
|
|
62
|
+
- 上記のどちらかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
|
|
63
|
+
|
|
64
|
+
register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。立ち上げ時の個票で目的・スコープ・対象成果物を決定したら、カタログ作成の個票を完了し、以後の計画済み作業を schedule のタスクとして管理します。
|
|
65
|
+
|
|
66
|
+
登録の判断、type の選び方、個票の作成などの台帳運用は [登録簿運用ガイド](register-operation-guide.md) を参照します。
|
|
67
|
+
|
|
68
|
+
#### 反復可能なJob
|
|
69
|
+
|
|
70
|
+
週報作成や更新文書の翻訳は、完了済みの同一Schedule taskを再実行するのではなく、期間やrevision範囲ごとに新しい実行単位を生成する必要があります。また、定常作業の実行履歴をregisterへ起票し続けると、課題・判断の台帳という責務が曖昧になります。
|
|
71
|
+
|
|
72
|
+
このため、Schedule/Registerとは別の実行対象の出どころとしてJobを使用します。Jobは再利用可能な作業定義、Job Runは入力を確定した1回限りの実行単位とし、plan生成後のagent実行は既存exec基盤を共用します。手動実行は`exec run --job <job-id> --input key=value`、定期起動はroutineの`action.kind: job`を使用します。詳細は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
|
|
73
|
+
|
|
74
|
+
### 1.3. ユースケース別の選び方
|
|
75
|
+
|
|
76
|
+
| やりたいこと | 代表コマンド | 状態追跡 | worktree |
|
|
77
|
+
| --------------------------------------- | ------------------------------------- | --------------- | -------- |
|
|
78
|
+
| 1 task をカレントで軽く実行する | `exec run --task` | なし | なし |
|
|
79
|
+
| 1 task をカレントで実行し進捗へ反映する | `exec run --task --track-state` | あり | なし |
|
|
80
|
+
| 1 task を隔離して実行する | `exec run --task --worktree` | あり | あり |
|
|
81
|
+
| Ready 順に自動実行する | `exec run --auto` | あり | あり |
|
|
82
|
+
| 登録簿の項目を agent に実行させる | `exec run --register` | register の遷移 | なし |
|
|
83
|
+
| 登録簿の複数項目を指定順に直列実行する | `exec run --register PJR-A PJR-B` | register の遷移 | なし |
|
|
84
|
+
| plan を確認してから実行する | `exec plan` -> `exec run --plan` | 任意 | 任意 |
|
|
85
|
+
| worktree の各段階を人が確認する | `exec worktree prepare` から `remove` | 手動 | あり |
|
|
86
|
+
| 同じplanで複数agentを比較する | `exec trial run` | なし | agent別 |
|
|
87
|
+
|
|
88
|
+
`exec run --register ... --register-commit` は、各IDのcommit後にhookによる整形差分を同じcommitへ収束させ、対象差分が残っていないことを検証します。登録簿・派生ビュー・当該plan/resultはrunner管理パスとして扱い、その他の実行前からある利用者変更はcommitしません。過去の未commit plan/resultを検出した場合は、現在のIDへ混ぜず警告します。
|
|
89
|
+
|
|
90
|
+
schedule タスクの自動実行・手動実行の具体的な手順は [Schedule実行運用ガイド](schedule-operation-guide.md)、routine の定義と実行は [routine運用ガイド](routine-operation-guide.md) を参照してください。
|
|
91
|
+
|
|
92
|
+
### 1.4. project単位の実行ロック
|
|
93
|
+
|
|
94
|
+
`exec run` は、実行対象 project の `execution_path/exec/.locks/exec-run.lock` を run 全体で保持します。同じ project に対する手動実行、routine、CI の `exec run` は同時に進まず、1つの run 内の `--parallel` worker だけが並列に動きます。`exec resume` も同じロックへ参加するため、再開処理と新規実行も重なりません。`exec cycle` は再開・古い track の再生成・状態再計算・`--auto` loop の一連の step をこの単一ロック内で保持し、step 間に他の実行が割り込まないことを保証します。
|
|
95
|
+
|
|
96
|
+
ロックは別プロセスの heartbeat で更新されます。正常終了時は `finally` で解放し、プロセスが異常終了して heartbeat が stale になった場合は、後続 run がロックを安全に奪取します。
|
|
97
|
+
|
|
98
|
+
busy 時の動作は `--if-busy <skip|wait|fail>` で選びます。既定は `fail` です。
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# 手動実行の既定: busy ならエラー終了
|
|
102
|
+
specdojo exec run --project <project-id> --auto
|
|
103
|
+
|
|
104
|
+
# busy なら実行せず正常終了
|
|
105
|
+
specdojo exec run --project <project-id> --auto --if-busy skip
|
|
106
|
+
|
|
107
|
+
# ロックが空くまで待ってから実行
|
|
108
|
+
specdojo exec run --project <project-id> --auto --if-busy wait
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### 1.5. 実行eventの保存粒度
|
|
112
|
+
|
|
113
|
+
Schedule taskの状態eventは、`execution_path/exec/events/`へ1 event 1 JSONファイルで保存されます。ファイル名はUTC時刻、actor、task ID、event種別、衝突回避用の乱数を含みます。`exec refresh`などの読取処理は全eventを時系列に並べ、foldして現在状態を再構成します。この保存規範の正本は[[sysd-cross-cutting-policy|SpecDojo システム設計横断ルール]]の`scp-STA-001`です。
|
|
114
|
+
|
|
115
|
+
この粒度の目的は並列数を増やすことではありません。project単位の実行ロックとtaskのclaimがあるため、taskごとの1ファイルへ集約しても排他は設計できます。1 event 1 JSONを維持する理由は、状態変更を既存ファイルのread-modify-writeではなく新規ファイルの追加として表し、次を保つためです。
|
|
116
|
+
|
|
117
|
+
- 既存eventを変更せず、1回の状態遷移をGitの1ファイル追加として確認できます。
|
|
118
|
+
- malformed eventをファイル単位で特定し、履歴全体へ暗黙にfoldすることを防げます。
|
|
119
|
+
- `reopen`や`release`による訂正を過去eventの書換えではなく後続eventとして残せます。
|
|
120
|
+
|
|
121
|
+
task単位への集約は技術的には可能ですが、現在の形式とは互換でない変更です。読取側の混在形式対応、既存eventの時系列を保つ移行、移行前後のfold結果の一致検証が必要になります。2026-09-01時点の対象projectでは606ファイル、JSON本文の合計は227,784 byteで、JSONはdoc-indexの走査対象外です。ファイル数に起因する検証時間、Git操作、ストレージなどの運用上の問題は確認されていないため、現時点では集約しません。将来、計測可能な問題が生じた場合は、ファイル数ではなく影響指標と移行時のfold結果一致を受入条件として別の変更で判断します。
|
|
122
|
+
|
|
123
|
+
### 1.6. 同一planによるagent比較
|
|
124
|
+
|
|
125
|
+
`exec trial run` は、既存planを生成し直さず、その同じ内容を複数agentへ渡して独立したworktreeで試行します。trialはSchedule eventとregisterの状態遷移を更新しないため、本来のタスクを完了・review・waitingへ進めません。
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
specdojo exec trial run \
|
|
129
|
+
--project <project-id> \
|
|
130
|
+
--plan <existing-plan-path> \
|
|
131
|
+
--base <commit-before-completed-work> \
|
|
132
|
+
--agent <agent-a> <agent-b> \
|
|
133
|
+
--reporter-by <shared-reporter> \
|
|
134
|
+
--parallel 2
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
`--base`にはcommit-ishを指定でき、省略時はHEADを使います。完了済みtodoの統合前commitを指定すると、同じplanを作業前の状態から再試行できます。指定値は完全なcommitへ解決し、実行開始時のHEADを統合済み成果の参照commitとして保存します。baseがそのHEADの祖先か、plan内のリポジトリ相対パスが起点ツリーに存在するかも事前に確認します。結果と警告は`comparison.json`の`base`へ記録され、`status`でも確認できます。planファイル自体が古い起点に存在しなくても、コマンドで指定した現在のplan内容を全trialへ渡します。
|
|
138
|
+
|
|
139
|
+
executorとreporterを組で比較する場合は、`--agent` / `--reporter-by`の代わりに次のように指定します。
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
specdojo exec trial run \
|
|
143
|
+
--project <project-id> \
|
|
144
|
+
--plan <existing-plan-path> \
|
|
145
|
+
--base <commit-before-completed-work> \
|
|
146
|
+
--pair <executor-a>=<reporter-a> <executor-b>=<reporter-b>
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
`--agent`だけならreporterなし、`--agent`と`--reporter-by`なら全trialで同じreporter、`--pair`ならtrialごとのreporterを使います。比較記録の`reporter_mode`にはそれぞれ`none` / `shared` / `paired`を保存します。
|
|
150
|
+
|
|
151
|
+
比較記録は`execution_path/exec/trials/<comparison-id>/comparison.json`へ集約します。planと実際のpromptのSHA-256、base commitと互換性確認、agent別の所要時間、終了コード、変更ファイル、検証結果、executor構造化出力を記録します。所要時間はexecutor、親検証、trial全体を分け、親検証の実行時間がagent比較へ混入しないようにします。検証件数もexecutor報告と親runner実行を分け、executorの`passed` / `failed` / `not_run`と報告総数を保存します。理由付きの`not_run`は意図した省略、報告件数の不足は未報告として比較できます。reporterについては構造化出力の成否、形式試行回数、形式再試行回数、結果、失敗理由に加え、失敗分類(`reported_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`)を記録します。判断の質、文章の質、範囲の遵守は機械指標と混ぜず、`exec trial rate`で1〜5と注記を記録します。
|
|
152
|
+
|
|
153
|
+
`pipeline.parent_validations`が設定されている場合、trialも通常のpipelineと同様にexecutor成功後・reporter起動前に各worktreeで親検証を実行します。結果は`source: runner`としてevidenceへ追記され、失敗したtrialは採用可能な`succeeded`になりません。executorが失敗して親検証へ進めなかった場合も`parent_validation.status: not_run`として比較記録と`trial status`に表示します。これにより、採用前に親検証の不足を確認できます。
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
specdojo exec trial status --project <project-id> --comparison <comparison-id>
|
|
157
|
+
specdojo exec trial rate \
|
|
158
|
+
--project <project-id> \
|
|
159
|
+
--comparison <comparison-id> \
|
|
160
|
+
--trial <agent> \
|
|
161
|
+
--judgment-quality 4 \
|
|
162
|
+
--writing-quality 3 \
|
|
163
|
+
--scope-adherence 5 \
|
|
164
|
+
--notes "human review notes"
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
評価後は成功したtrialを1つだけ採用します。`adopt`は選択したbranchを現在branchへmergeし、残りのworktreeとbranchを破棄します。採用前に`trial status`の親検証状態とexecutorの報告総数・`not_run`件数を確認します。`not_run`の理由は`comparison.json`の`executor.validations`で確認できます。破棄後も中央の比較記録とagent別evidenceは残ります。どれも採用しない場合は`discard`を使います。
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
specdojo exec trial adopt \
|
|
171
|
+
--project <project-id> \
|
|
172
|
+
--comparison <comparison-id> \
|
|
173
|
+
--trial <agent>
|
|
174
|
+
|
|
175
|
+
specdojo exec trial discard --project <project-id> --comparison <comparison-id>
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
1回の比較だけでは`pm-members.yaml`を自動変更しません。人が客観指標と主観評価を確認し、複数タスクで傾向が再現した場合にpriorityやcapabilitiesを更新します。この判断方針も比較記録の`agent_selection`へ保存されます。
|
|
179
|
+
|
|
180
|
+
agent起動時はhook由来の`GIT_DIR`などを継承せず、各trialのcwdからGit repositoryを解決します。trial前後でagent worktreeのHEADまたは監視対象のlocal configが変化した場合、そのtrialは`agent-git-state-write:`で失敗し、採用対象になりません。別worktreeで行われたrunnerの遷移commitと、runnerが作成したbranchの表示用metadataは検知対象に含めません。
|
|
181
|
+
|
|
182
|
+
## 2. 中断・訂正・再実行
|
|
183
|
+
|
|
184
|
+
実行が途中で止まった場合、完了判定そのものを訂正する場合、利用制限で中断した場合の戻し方を扱います。これらは schedule 実行を主な対象としますが、`reopen` を除き register 実行にも共通する考え方です。
|
|
185
|
+
|
|
186
|
+
### 2.1. Git状態変更を検知した場合の復旧
|
|
187
|
+
|
|
188
|
+
`agent-git-state-write:`が出た場合、またはhook内のテストが実repositoryを変更した疑いがある場合は、そのworktreeを統合せず保持して原因を確認します。最初に`git rev-parse --git-common-dir`で全worktreeが共有するrepositoryを特定し、`git config --local --list --show-origin`で`core.bare`とfixture用identityの混入を記録します。`git status`が`fatal: this operation must be run in a work tree`となる場合は、repositoryの管理者が影響範囲を確認したうえで共有repositoryに対して`git config --local core.bare false`を実行します。`user.name` / `user.email`は`git config --local --get-all <key>`で値を確認し、事故で追加された値だけを`git config --local --unset-all <key> '<value-regex>'`で除去します。正当なlocal設定を一括削除してはいけません。最後に`git status`と`git fsck`でrepositoryが復旧したことを確認します。
|
|
189
|
+
|
|
190
|
+
`fields=HEAD`の場合は`git reflog`、`git log --oneline --decorate <起動前HEAD>..HEAD`、`git show --stat <commit>`で混入commitと変更前HEADを特定します。`git fetch origin`後に`git branch -r --contains <commit>`と`git tag --contains <commit>`を確認し、remote branchまたはtagへ到達していないことを確定してから破棄します。成果が不要なら対象exec / trial worktreeを破棄し、未統合branchを削除します。必要な成果が含まれる場合は、汚染branchを直接mergeせず、許可対象のファイル差分だけを新しいworktreeへ適用してrunner管理のcommitとして取り込みます。remoteへ到達済みの場合は履歴を書き換えず、管理者がrevertと関係者通知を行います。共有済み履歴のresetやforce pushは行いません。
|
|
191
|
+
|
|
192
|
+
### 2.2. blockedタスクの復帰
|
|
193
|
+
|
|
194
|
+
`blocked` は人の判断や外部対応が必要な障害を表します。状況に応じて次のコマンドを使います。
|
|
195
|
+
|
|
196
|
+
| 状況 | コマンド | 結果 |
|
|
197
|
+
| --------------------------------- | ------------------------- | ---------------------------- |
|
|
198
|
+
| 中断で `doing` のまま | `exec resume` | 既存 worktree 上で継続 |
|
|
199
|
+
| pipeline の reporter で `blocked` | `exec resume --task <id>` | executor evidence から再開 |
|
|
200
|
+
| pipeline の統合段で `blocked` | `exec resume --task <id>` | agent を起動せず統合だけ再開 |
|
|
201
|
+
| 障害を解消し同じ試行を続ける | `exec unblock` | `blocked -> doing` |
|
|
202
|
+
| 試行を破棄して最初からやり直す | `exec release` | `blocked -> todo` |
|
|
203
|
+
| 着手前のタスクを恒久的に中止する | `exec cancel` | `todo -> cancelled` |
|
|
204
|
+
|
|
205
|
+
`release` は `doing` / `blocked` の試行を破棄して `todo` に戻します。`cancel` は `todo` のタスクを終端状態にする操作です。
|
|
206
|
+
|
|
207
|
+
executor / reporter pipeline では、run ごとの `exec/evidence/<task>/<run>/pipeline-state.json` に各段(executor / reporter と、runner が担う統合段 `integrate`)の状態、agent、試行回数、evidence / result 参照を保存します。reporter 失敗の block event は `pipeline_stage=reporter`、統合失敗の block event は `pipeline_stage=integrate` を持ち、どちらも `pipeline_state_ref` から同じ run を再開します。`exec resume --task <task-id>` は state に応じて reporter または統合段だけを再開し、完了済みの agent 段を重複実行しません。
|
|
208
|
+
|
|
209
|
+
stage agent を明示する場合は次のように指定します。片方を省略すると、その stage は要件と優先度から自動選択されます。
|
|
210
|
+
|
|
211
|
+
```bash
|
|
212
|
+
specdojo exec resume \
|
|
213
|
+
--project <project-id> \
|
|
214
|
+
--task <task-id> \
|
|
215
|
+
--executor-by <executor-nickname> \
|
|
216
|
+
--reporter-by <reporter-nickname>
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
specdojo exec release \
|
|
221
|
+
--project <project-id> \
|
|
222
|
+
--task <task-id> \
|
|
223
|
+
--by <actor>
|
|
224
|
+
|
|
225
|
+
specdojo exec refresh --project <project-id>
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
調査用 worktree も即座に破棄したい場合だけ `--reset-worktree` を付けます。
|
|
229
|
+
|
|
230
|
+
```bash
|
|
231
|
+
specdojo exec release \
|
|
232
|
+
--project <project-id> \
|
|
233
|
+
--task <task-id> \
|
|
234
|
+
--by <actor> \
|
|
235
|
+
--reset-worktree
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
`--reset-worktree` は未commitの result や成果物変更を破棄します。内容を確認したい場合は、先に [exec worktree運用ガイド](exec-worktree-guide.md) の `status` を使います。
|
|
239
|
+
|
|
240
|
+
### 2.3. 完了済みタスクをtodoに戻す
|
|
241
|
+
|
|
242
|
+
完了条件を満たしていないのに `complete` した場合など、完了判定そのものを訂正するときは `exec reopen` を使います。単に追加作業が発生した場合は、完了履歴を訂正せず新しい schedule task として計画します。
|
|
243
|
+
|
|
244
|
+
```bash
|
|
245
|
+
specdojo exec reopen \
|
|
246
|
+
--project <project-id> \
|
|
247
|
+
--task <task-id> \
|
|
248
|
+
--by <human-actor> \
|
|
249
|
+
--msg "completion criteria unmet"
|
|
250
|
+
|
|
251
|
+
specdojo exec refresh --project <project-id>
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
`reopen` は `reopen` event を追記し、`done -> todo` へ遷移させます。対応する `complete` event は削除しないため、「一度完了と判断した後、理由を記録して再開した」という履歴が残ります。
|
|
255
|
+
|
|
256
|
+
次の条件をすべて満たす必要があります。
|
|
257
|
+
|
|
258
|
+
- 対象が schedule に存在する task で、現在の状態が `done` です。
|
|
259
|
+
- `--task`、`--by`、`--msg` を明示します。
|
|
260
|
+
- `--by` が `pm-members.yaml` で `type: human` の member です。
|
|
261
|
+
- 対象に依存する後続 task に `doing`、`blocked`、`done` がありません。
|
|
262
|
+
|
|
263
|
+
後続 task も完了済みの場合は、依存グラフの下流から順に `reopen` します。後続 task が `doing` / `blocked` の場合は、先に同じ試行を完了させるか、`exec release` で `todo` に戻します。これにより、完了していない依存先を前提に後続 task が進行・完了している状態を防ぎます。
|
|
264
|
+
|
|
265
|
+
`reopen` は plan、result、成果物、Git 履歴を削除・復元しません。完了済み plan は `exec/plans/done/` に残り、次の `exec plan` / `exec run` で新しい固定名 plan を生成します。再 claim 時は固定名 result を再利用し、新しい試行の状態と時刻に更新します。
|
|
266
|
+
|
|
267
|
+
```bash
|
|
268
|
+
specdojo exec claim --project <project-id> --task <task-id> --by <actor> --msg "rerun"
|
|
269
|
+
specdojo exec run --project <project-id> --task <task-id>
|
|
270
|
+
specdojo exec complete --project <project-id> --task <task-id> --by <actor> --msg "rerun done"
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
### 2.4. 完了済みタスクの再実行
|
|
274
|
+
|
|
275
|
+
完了済み(`done`)タスクをやり直す場合は、既定の軽量実行でそのまま実行します。状態イベントは追加されず、変更は作業ツリーに残ります。
|
|
276
|
+
|
|
277
|
+
```bash
|
|
278
|
+
specdojo exec run --project <project-id> --task <task-id>
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
完了判定を取り消して Schedule の進捗として再度記録する場合は、先に `reopen` して `todo` に戻し、その後 `claim`、`run`、`complete` を明示的に行います。`complete` が正しく、追加作業だけが必要な場合は元の task を `reopen` せず、新しい task として計画します。
|
|
282
|
+
|
|
283
|
+
### 2.5. レートリミット対応
|
|
284
|
+
|
|
285
|
+
AI モデルの rate limit に達した場合、`exec run` は `.specdojo/exec-defaults.yaml` の `rate_limit_policy` に従います。
|
|
286
|
+
|
|
287
|
+
| 状況 | 代表対応 |
|
|
288
|
+
| -------------------------------- | ----------------------------------------------------------------------- |
|
|
289
|
+
| 別 provider / agent の候補がある | 次候補へ切り替え、独立した Ready task は継続する |
|
|
290
|
+
| reset / retry-after を取得できる | 再開時刻と worktree を block event に保持し、`exec resume --due` で再開 |
|
|
291
|
+
| 時刻不明で明示 cooldown がある | 設定済み cooldown から再開時刻を記録する |
|
|
292
|
+
| 時刻不明で cooldown もない | 時刻を推定せず、通常の blocked として人に委ねる |
|
|
293
|
+
| `quota_exhausted` | 自動再開せず、別 provider が無ければ人に委ねる |
|
|
294
|
+
|
|
295
|
+
定時起動する場合は routine から `job-exec-resume` を参照します。due 判定と `blocked -> doing` の確保は scheduler lock 内で行われるため、多重起動でも同じ task を重複実行しません。詳細は [routine運用ガイド](routine-operation-guide.md) を参照してください。
|
|
296
|
+
|
|
297
|
+
```yaml
|
|
298
|
+
id: rtn-exec-limit-resume
|
|
299
|
+
enabled: true
|
|
300
|
+
interval: 15m
|
|
301
|
+
action:
|
|
302
|
+
kind: job
|
|
303
|
+
job: job-exec-resume
|
|
304
|
+
inputs:
|
|
305
|
+
parallel: "2"
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
延期 task の再開に続けて Ready task も自動実行したい場合は、`job-exec-resume` と `job-exec-auto` を別 routine に分けず、`job-exec-cycle` を使います。再開 → doc-index 再構築 → 古い track の再生成 → 状態再計算 → `--auto` loop を単一の project 実行ロック内で順次実行するため、実行順が routine ファイル名順や cron 時刻差に依存せず、step 間に手動実行・別 routine・CI が割り込みません。
|
|
309
|
+
|
|
310
|
+
track の再生成では、`exec validate` の警告と同じ鮮度判定を使います。`sch-track-<track>.yaml` がないか、`sch-strategy-<track>.yaml` の更新時刻が track より新しい場合だけ、`schedule build --track <track> --force` を実行します。再生成が不要ならコマンドも追加ログも発生しません。再生成に失敗した場合は、古い track のまま Ready task を選ばず cycle を停止します。単発の `exec run` と `exec refresh` は自動再生成しません。再開対象が再延期されても、依存しない Ready task の実行は継続します。詳細は [routine運用ガイド](routine-operation-guide.md) の順次実行(exec-cycle)を参照してください。
|
|
311
|
+
|
|
312
|
+
provider別の `max_concurrency` や agent 選択は [exec設定ガイド](exec-config-guide.md) を参照します。
|
|
313
|
+
|
|
314
|
+
### 2.6. executor / reporter pipelineの実行と復旧
|
|
315
|
+
|
|
316
|
+
`agent_pipeline` を持つ phase のタスクは、executor(成果物の編集と検証)と reporter(evidence から result を構成)の 2 stage で実行されます。実行コマンドは従来と同じで、stage の agent を固定したい場合だけ `--executor-by` / `--reporter-by` を足します。
|
|
317
|
+
|
|
318
|
+
```bash
|
|
319
|
+
specdojo exec run --project <project-id> --task <task-id> --worktree
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
run ごとの実行記録は `<execution_path>/exec/evidence/<task-id>/<run-id>/` に残ります。停止位置と再開可否はここを見て判断します。
|
|
323
|
+
|
|
324
|
+
| ファイル | 確認できること |
|
|
325
|
+
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
326
|
+
| `pipeline-state.json` | 各 stage の状態(`succeeded` / `failed` / `rate_limited`)・actor・試行回数 |
|
|
327
|
+
| `evidence.json` | executor の変更ファイル、diff サマリ、検証結果、最終メッセージ、executor / reporter のログ参照 |
|
|
328
|
+
| `executor.log` | executor の出力抜粋(秘匿値は伏せ字化、64KiB で切り詰め) |
|
|
329
|
+
| `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行別の生出力(秘匿値は伏せ字化、各ストリーム 64KiB で切り詰め) |
|
|
330
|
+
|
|
331
|
+
agent ログは人が調査するための参照先で、reporter には渡りません。reporter が受け取るのは plan と `evidence.json` と出力スキーマだけです。失敗理由の要約だけでは原因が分からない場合は、`evidence.json` の `log_refs` から stdout / stderr を個別に確認します。ログは Git 管理対象の evidence ディレクトリにありますが、失敗中の worktree では未コミットのため、`--force-restart` などで破棄する前に確認します(詳細は [exec設定ガイド](exec-config-guide.md) の `evidence とログの引き渡し方針`)。
|
|
332
|
+
|
|
333
|
+
stage 別の失敗と対応は次のとおりです。
|
|
334
|
+
|
|
335
|
+
| 失敗 | 状態の見え方 | 対応 |
|
|
336
|
+
| ----------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------- |
|
|
337
|
+
| executor の異常終了 | executor が `failed`、reporter は `pending` | 原因を解消し `exec unblock` で継続、または `exec release` でやり直す |
|
|
338
|
+
| executor の rate limit | executor が `rate_limited`、block に再開時刻 | `レートリミット対応` と同じ(`exec resume --due`) |
|
|
339
|
+
| reporter のプロセス失敗 | executor が `succeeded`、reporter が `failed` | `exec resume --task <task-id>` で reporter から再開する |
|
|
340
|
+
| reporter の出力形式エラー | reporter を最大3回再実行した後に `failed` | 同上(executor は再実行されない) |
|
|
341
|
+
| 親 runner の検証失敗 | evidence の `source: runner` が `failed` | 原因を解消して reporter を再開する(親検証だけ再実行される) |
|
|
342
|
+
| reporter の `outcome=blocked` | result が `blocked` になり `block_reason` に理由が残る | 理由を読み、成果物側の不足を解消してから再実行する |
|
|
343
|
+
| commit / merge / 撤去の失敗 | executor・reporter が `succeeded`、統合が `failed` | `exec resume --task <task-id>` で統合段だけ再開する |
|
|
344
|
+
|
|
345
|
+
reporter で止まったタスクは、同じ claim のまま reporter だけを再開できます。再開時は `pipeline-state.json` と executor evidence の task ID / run ID の一致を確認し、一致しない場合や欠損している場合は evidence を再利用せず、新しい run として executor から実行し直します。保存済みの親 runner 検証だけが失敗している場合は、現在の worktree でその固定許可リスト検証を再実行し、結果を evidence へ反映してから reporter を起動します。`source: executor` の検証失敗は成果物側の記録なので、この経路では再評価しません。
|
|
346
|
+
|
|
347
|
+
```bash
|
|
348
|
+
specdojo exec resume \
|
|
349
|
+
--project <project-id> \
|
|
350
|
+
--task <task-id> \
|
|
351
|
+
--reporter-by <reporter-nickname>
|
|
352
|
+
```
|
|
353
|
+
|
|
354
|
+
executor と reporter が成功した後の commit・merge・worktree 撤去で止まった場合、`exec resume --task <task-id>` は agent を起動せず、`pipeline-state.json` の `integrate` 段から統合だけを再開します。前回の merge が完了している場合は exec branch を再 merge せず、runner が残した lifecycle 差分を確認したうえで worktree 撤去と `exec complete` だけを行います。通常実行の成功時は `integrate.status=succeeded`、失敗時は `failed` と block event の `pipeline_state_ref` が残ります。
|
|
355
|
+
|
|
356
|
+
### 2.7. register実行の再開
|
|
357
|
+
|
|
358
|
+
register 実行(`exec run --register --worktree`)を executor/reporter パイプラインで走らせた場合、途中で止まった run は止まった段から再開できます。register 実行は exec events を持たないため、再開は `exec resume` ではなく `exec run --register` の `--resume` で行います。
|
|
359
|
+
|
|
360
|
+
```bash
|
|
361
|
+
specdojo exec run \
|
|
362
|
+
--project <project-id> \
|
|
363
|
+
--register <PJR-ID> \
|
|
364
|
+
--worktree \
|
|
365
|
+
--resume
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
再開する段は、対象 worktree に残っている最新 run の `pipeline-state.json` から自動的に決まります。指定するオプションはどの段でも同じです。
|
|
369
|
+
|
|
370
|
+
| 再開段 | 対象の状態 | 実行する内容 |
|
|
371
|
+
| ----------- | -------------------------------------------------- | ------------------------------------------------------------------- |
|
|
372
|
+
| `executor` | executor が `running` / `rate_limited` / `blocked` | 同じ plan/result と既存 worktree を使い、新しい checkpoint で再実行 |
|
|
373
|
+
| `reporter` | executor が `succeeded`、reporter が未完了 | reporter だけを起動し、成功後に統合まで進む |
|
|
374
|
+
| `integrate` | executor と reporter が `succeeded`、統合が未完了 | agent を起動せず、commit → merge → worktree 撤去だけ行う |
|
|
375
|
+
|
|
376
|
+
executor のプロセス結果は、親 runner 検証を始める前に `executor.log` と `evidence.json` へ保存し、`pipeline-state.json` の executor を `succeeded` へ更新します。親検証中にプロセスが中断した場合、`--resume` は保存済みの executor evidence を再利用し、不足している親検証を実行してから reporter へ進みます。agent 実行中の中断で executor が `running` のまま残った場合は、未コミット成果を含む既存 worktree を破棄せず、同じ plan/result を入力に executor から再実行します。`--executor-by` / `--reporter-by` を省略した場合は state に記録された各 agent を引き継ぎます。
|
|
377
|
+
|
|
378
|
+
`agent-config-write` または `agent-git-state-write` が executor を止めた場合は、通常の実装失敗を示す `failed` と区別して executor を `blocked` と記録します。申し送りを人または orchestrator が適用し、agent 由来の保護対象差分や Git 状態変更を worktree から解消した後、`--resume` は既存成果を保持したまま executor から再開します。申し送りを適用せず保護対象差分を残したまま再開した場合、executor が完了しても統合前の保護検査で再び block し、worktree を保持します。
|
|
379
|
+
|
|
380
|
+
reporter 段の再開の入力は、`pipeline-state.json`(stage 状態と plan / result の参照)と `evidence.json`(executor の変更・検証結果・最終メッセージ)です。`--reporter-by` を省略した場合は、その run で使った reporter agent を state から引き継ぎます。保存済みの親 runner 検証が失敗しているか不足していれば、Schedule 実行と同様に再実行して evidence を更新します。再開が成功した後は通常実行と同じ経路で、result の記入と status 更新、成果物の commit、統合ブランチへの merge、`register review` までを行います。
|
|
381
|
+
|
|
382
|
+
統合段の再開は、executor と reporter が成功したまま commit・merge・worktree 撤去のいずれかが失敗した run が対象です。worktree は統合が完了したときにだけ撤去されるため、reporter 成功済みの worktree が残っていること自体が統合の未完了を意味します。この再開では agent を1つも起動せず、worktree に残っている成果物と記入済み result をそのまま統合します。前回の試行で merge まで完了していた場合は、取り込み済みの exec ブランチを再 merge せずに残りの手順(worktree 撤去と `register review`)だけを進めます。再開の開始時に項目は `in-progress` へ戻り、成功なら `review`、失敗なら `waiting` へ遷移するため、再試行の成否は登録簿の状態とイベントに残ります。統合段の進捗(開始と失敗)は `pipeline-state.json` の `integrate` にも記録します。
|
|
383
|
+
|
|
384
|
+
再開できるかどうかは、対象 worktree の最新 run だけで判定します。次の場合は worktree・exec ブランチ・未コミットの成果を一切変更せず、理由を出力して終了コード 1 で終わります。
|
|
385
|
+
|
|
386
|
+
| 状況 | 扱い |
|
|
387
|
+
| ---------------------------------------------------- | ------------------------------------------------------------ |
|
|
388
|
+
| 項目の exec worktree が無い | 再開せず、通常の再実行を促す |
|
|
389
|
+
| 最新 run の executor が `pending` / `failed` | 再開せず、通常の再実行を促す(古い run へは遡らない) |
|
|
390
|
+
| 最新 run の executor が `rate_limited` / `blocked` | 既存 worktree の executor 段から再開する |
|
|
391
|
+
| succeeded executor の `evidence.json` が欠損・不整合 | executor の記録を再利用できないため拒否する |
|
|
392
|
+
| 親検証の設定 ID が変更・欠損 | 現在の固定許可リストで親検証を再実行して evidence を更新する |
|
|
393
|
+
| result を worktree から復元できない | 再開の入力が揃わないため拒否する |
|
|
394
|
+
| 再開した段が再び失敗した | worktree と成果を保持したまま `waiting` へ戻す |
|
|
395
|
+
|
|
396
|
+
再開可能な run が残っている項目を `--resume` なしで再実行しようとした場合は、worktree を破棄する手前で中断します(未統合の成果を失わないための保護)。破棄したうえで最初からやり直す場合は `--force-restart` を明示します。
|
|
397
|
+
|
|
398
|
+
```bash
|
|
399
|
+
# executor の成果ごと破棄して、plan 生成からやり直す
|
|
400
|
+
specdojo exec run --project <project-id> --register <PJR-ID> --worktree --force-restart \
|
|
401
|
+
--executor-by <executor-nickname> --reporter-by <reporter-nickname>
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
## 3. humanタスクの実行
|
|
405
|
+
|
|
406
|
+
`execution: human` のタスク(finalize など)はエージェントを起動しません。`exec run` / `exec worktree agent` で agent による実行を強制する場合は、登録済み agent の nickname を `--by` で明示します。人が result を作業の入口として、最終確認・修正と確定を行います。
|
|
407
|
+
|
|
408
|
+
human task の plan は生成しません。対象タスクを claim すると、`exec claim` が `execution: human`、`approach`、`targets` を持つ result を scaffold します。この result が作業指示と確認記録の正本です。確定手順は [Human Finalize 実行レシピ](../recipes/exec-human-finalize-recipe.md)、共通規約は [Human Finalize 実行標準](../standards/exec-human-finalize-standard.md)を参照します。
|
|
409
|
+
|
|
410
|
+
確定作業のスコープは `approach` で明示します。`finalize` は成果物のみを確定し、`bootstrap-finalize` は bootstrap と対になり、成果物と実践の型(rulebook / recipe / sample / template)をまとめて確定します。claim が scaffold する result には、done_criteria の確認チェックリストと確定対象のチェックリストが焼き込まれます。確認・昇格の記録はこの result のチェックリストに残します。
|
|
411
|
+
|
|
412
|
+
実行者に依らず、進捗(Ready・phase gate・CPM)へ反映するため状態イベントを記録します。
|
|
413
|
+
|
|
414
|
+
```bash
|
|
415
|
+
# 1. Ready を更新する(human plan は生成しない)
|
|
416
|
+
specdojo exec refresh --project <project-id>
|
|
417
|
+
|
|
418
|
+
# 2. claim して result を生成する
|
|
419
|
+
specdojo exec claim \
|
|
420
|
+
--project <project-id> \
|
|
421
|
+
--task <task-id> \
|
|
422
|
+
--by <actor> \
|
|
423
|
+
--msg "finalize"
|
|
424
|
+
|
|
425
|
+
# 3. 人が result に従って最終確認・修正し、成果物 frontmatter の status を ready に更新する
|
|
426
|
+
# result の 確認チェックリスト / 確定対象 にチェックを付け、
|
|
427
|
+
# 確定判断 を記入する(差し戻し理由や修正内容があれば 備考 に残す)
|
|
428
|
+
|
|
429
|
+
# 4. 完了を記録する
|
|
430
|
+
specdojo exec complete \
|
|
431
|
+
--project <project-id> \
|
|
432
|
+
--task <task-id> \
|
|
433
|
+
--by <actor> \
|
|
434
|
+
--msg "finalized"
|
|
435
|
+
|
|
436
|
+
# 5. 次の Ready を更新する
|
|
437
|
+
specdojo exec refresh --project <project-id>
|
|
438
|
+
```
|
|
439
|
+
|
|
440
|
+
成果物の `status` を `ready` に昇格できるのは人だけです。エージェント実行では、`ready` へ昇格させるコミットは exec のガードで拒否されます。
|