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,429 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:schedule-design-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
supersedes:
|
|
7
|
+
- specdojo-deliverables-to-schedule-guide
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Schedule設計ガイド
|
|
11
|
+
|
|
12
|
+
Schedule Design Guide
|
|
13
|
+
|
|
14
|
+
Schedule の役割、`sch-strategy` から `sch-track` への展開、タスク粒度、依存関係、CPM の考え方を説明します。コマンドの短い使い方は [CLIコマンドリファレンス](../references/command-reference.md) を参照します。
|
|
15
|
+
|
|
16
|
+
**対象読者**
|
|
17
|
+
|
|
18
|
+
- 成果物を実行タスクへ展開し、順序、反復、依存関係を設計するプロジェクト計画担当者、Schedule 作成者
|
|
19
|
+
|
|
20
|
+
**この文書で分かること**
|
|
21
|
+
|
|
22
|
+
- Schedule ファイルの責務、生成フロー、タスクIDと粒度、実行要件、依存関係、CPM
|
|
23
|
+
|
|
24
|
+
**次に読む文書**
|
|
25
|
+
|
|
26
|
+
- 実行手順は [Schedule実行運用ガイド](schedule-operation-guide.md)、exec 設定は [exec設定ガイド](exec-config-guide.md)、`approach` による実践の型の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照してください。
|
|
27
|
+
|
|
28
|
+
## 1. Scheduleの基本
|
|
29
|
+
|
|
30
|
+
Schedule が扱う責務と、責務ごとに分かれたファイルの役割を示します。
|
|
31
|
+
|
|
32
|
+
### 1.1. Scheduleの役割
|
|
33
|
+
|
|
34
|
+
Schedule は「いつ、どの順序で、誰が実行するか」を定義する層です。成果物のパスや完了条件は成果物カタログが持ち、Schedule は成果物IDを参照して実行タスクへ展開します。
|
|
35
|
+
|
|
36
|
+
| 定義する内容 | 担当ファイル |
|
|
37
|
+
| ---------------- | ------------------------------ |
|
|
38
|
+
| WHAT / DONE | 成果物カタログ(`dct-*.yaml`) |
|
|
39
|
+
| WHEN / ORDER | Schedule(`sch-*.yaml`) |
|
|
40
|
+
| エージェント定義 | `pm-members.yaml` |
|
|
41
|
+
| 実行共通設定 | `.specdojo/exec-defaults.yaml` |
|
|
42
|
+
|
|
43
|
+
#### 1.1.1. 成果物カタログとの責務分担
|
|
44
|
+
|
|
45
|
+
成果物カタログは「何を管理対象とするか・どこに作成し何を満たせば完了か」を扱い、Schedule は「いつ・誰が・どの順で作業するか」を扱います。両者の責務は次のように分かれます。
|
|
46
|
+
|
|
47
|
+
| 観点 | 成果物カタログ | Schedule |
|
|
48
|
+
| ------------------ | -------------------------------------- | ---------------------- |
|
|
49
|
+
| 主目的 | 成果物の論理定義と完了単位の定義 | 実行計画 |
|
|
50
|
+
| 問い | 何がどこに完成すればよいか | いつ誰が何をするか |
|
|
51
|
+
| 単位 | 成果物 | 実行タスク |
|
|
52
|
+
| 成果物ID | 定義する | 参照する |
|
|
53
|
+
| 配置先・成果物パス | `kind: work` の `path` で持つ | 原則持たない |
|
|
54
|
+
| 完了条件 | `kind: work` の `done_criteria` で持つ | 原則持たない |
|
|
55
|
+
| action | 持たない | 持つ |
|
|
56
|
+
| 日付 | 持たない | 持つ |
|
|
57
|
+
| 担当者 | 原則持たない | 持つ |
|
|
58
|
+
| 依存関係 | 成果物間の根拠程度 | 実行順序の依存 |
|
|
59
|
+
| status | カタログ定義文書の状態として持つ | タスクの実行状態を持つ |
|
|
60
|
+
|
|
61
|
+
成果物カタログから Schedule への定義の流れは次のとおりです。
|
|
62
|
+
|
|
63
|
+
```mermaid
|
|
64
|
+
flowchart LR
|
|
65
|
+
START(( )) -->|管理対象成果物・path・<br/>done_criteriaを定義| A["成果物カタログ"]
|
|
66
|
+
A -->|成果物IDを参照し<br/>action・日付・担当を付与| C["Schedule"]
|
|
67
|
+
C --> END(( ))
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
各層の詳細なルールは、それぞれの rulebook を正本とします。
|
|
71
|
+
|
|
72
|
+
- 成果物カタログ: [成果物カタログ(ドメイン別)作成ルール](../rulebooks/dct-rulebook.md)
|
|
73
|
+
- Schedule: [スケジュール作成ルール](../rulebooks/sch-rulebook.md)
|
|
74
|
+
|
|
75
|
+
### 1.2. Scheduleファイル
|
|
76
|
+
|
|
77
|
+
Schedule は用途別に4種類のファイルで管理します。
|
|
78
|
+
|
|
79
|
+
| ファイル | 役割 |
|
|
80
|
+
| --------------------------- | ------------------------------------------------ |
|
|
81
|
+
| `sch-milestones.yaml` | プロジェクト全体のマイルストーン計画 |
|
|
82
|
+
| `sch-defaults.yaml` | 全 Schedule 共通のカレンダーや開始日のデフォルト |
|
|
83
|
+
| `sch-strategy-<track>.yaml` | track schedule の自動生成ルール |
|
|
84
|
+
| `sch-track-<track>.yaml` | 展開済みの Task / Milestone 定義 |
|
|
85
|
+
|
|
86
|
+
`sch-strategy-<track>.yaml` は `schedule build` の生成入力であり、DCT・Timeline・`approach_rules`・Kata grade・標準 profile から `schedule strategy generate` で更新できます。`schedule build` 後は `sch-track-<track>.yaml` が実行対象になります。
|
|
87
|
+
|
|
88
|
+
strategy の scope は catalog と成果物の二段階で指定します。`scope.catalogs[].local_ids` を省略すると、従来どおりその catalog で `include_kinds` に一致する全成果物が対象です。指定した場合は一致する成果物との積集合だけが対象となり、`approach_rules` と `owner_rules` はその部分集合を重複なく網羅します。カタログに存在しない `local_id`、選択外の rule、rule の欠落・重複はエラーになります。
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
scope:
|
|
92
|
+
catalogs:
|
|
93
|
+
- id: prj-0001:dct-data-flow
|
|
94
|
+
path: /docs/ja/projects/prj-0001/010-deliverables-catalog/dct-data-flow.yaml
|
|
95
|
+
local_ids: [cdfd-onboarding, cdfd-plan]
|
|
96
|
+
include_kinds: [work]
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
同じ成果物を複数 strategy が選択しても構いません。生成 task ID は `T-<TRACK>-<local_id>-<suffix>` なので、各 track の作成・レビュー・完了状態は `exec refresh` と dashboard で別々に扱われます。成果物カタログを定義する track は Timeline の `catalog_status: primary` で示し、別 track による再修正はその定義責任や所属ドメインを変更しません。`schedule strategy generate` は既存 strategy の catalog ごとの `local_ids` を維持し、選択外の成果物には rule やタスクを生成しません。
|
|
100
|
+
|
|
101
|
+
計画成果物を Schedule に載せるプロジェクトでは、専用の `planning` ドメインと `planning` トラックを用います。人または agent が更新する計画入力は `kind: work`、track と milestones は `kind: generated` としてカタログへ登録します。ただし `sch-strategy-planning` 自身は `kind: control` とするか planning scope 外へ置き、strategy が自身の作成タスクを生成する循環を避けます。`dct-<domain>.yaml` 自身と `generated/` 配下の表示用生成物は Schedule 対象にしません。
|
|
102
|
+
|
|
103
|
+
## 2. sch-trackの生成
|
|
104
|
+
|
|
105
|
+
strategy から track への生成フロー、展開する情報、反復、タスクIDの導出を示します。
|
|
106
|
+
|
|
107
|
+
### 2.1. 生成フロー
|
|
108
|
+
|
|
109
|
+
`sch-track-<track>.yaml` は原則として手書きせず、次の流れで生成します。
|
|
110
|
+
|
|
111
|
+
```text
|
|
112
|
+
成果物カタログ(dct-*.yaml)+ Timeline + strategy の approach_rules + Kata grade
|
|
113
|
+
-> specdojo schedule strategy generate --track <track>
|
|
114
|
+
-> sch-strategy-<track>.yaml
|
|
115
|
+
-> specdojo schedule build --track <track> --force
|
|
116
|
+
-> sch-track-<track>.yaml
|
|
117
|
+
-> specdojo exec refresh
|
|
118
|
+
-> generated/ready.json, cpm.md, gantt-chart.svg など
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
実行するコマンドは次のとおりです。
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
specdojo schedule build --project <project-id> --track <track> --force
|
|
125
|
+
specdojo exec refresh --project <project-id>
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
新規または再判定した track では、先に次を実行します。
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
specdojo schedule strategy generate --project <project-id> --track <track> \
|
|
132
|
+
--default-owner <role> --gate-owner <role> --milestone-owner <role> --dry-run
|
|
133
|
+
specdojo schedule strategy generate --project <project-id> --track <track> \
|
|
134
|
+
--default-owner <role> --gate-owner <role> --milestone-owner <role>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
`phase_sets`、`cycles`、`iterations`、フェーズ追加削除、`phase_suffix`、依存関係、ゲートを変更した場合は、`schedule build` を先に実行してから `exec refresh` を実行します。
|
|
138
|
+
|
|
139
|
+
`--track` は生成・上書きする `sch-track-<track>.yaml` を指定します。一方、`sch-milestones.yaml` はプロジェクト全体の正本であるため、同じ `schedule_path` にあるすべての `sch-strategy-*.yaml` から毎回再構築します。別 track のマイルストーンは保持され、削除された strategy や定義から生成されなくなったマイルストーンだけが除去されます。
|
|
140
|
+
|
|
141
|
+
再構築時は、既存ファイルに残るマイルストーン ID の並びを維持し、新しく生成された ID を末尾へ追加します。既存項目の内容は最新の strategy から全面置換するため、表示順を安定させながら定義変更を反映できます。既存ファイルがない初回生成では、strategy ファイル名順に並びます。
|
|
142
|
+
|
|
143
|
+
`sch-milestones.yaml` の `status` は、既存ファイルの再構築時には変更しません。対象 track や他の strategy の `status` にかかわらず、人が昇格・降格した状態を保持します。初回生成時だけ `draft` とし、build の成功を理由に自動昇格しません。
|
|
144
|
+
|
|
145
|
+
全 strategy のいずれかに検証エラー、project ID の不一致、マイルストーン ID の重複がある場合、`schedule build` は不完全な `sch-track-<track>.yaml` や `sch-milestones.yaml` を書き込まずに停止します。`--dry-run` でも全 strategy を評価し、プロジェクト全体のマイルストーン生成結果を表示します。
|
|
146
|
+
|
|
147
|
+
### 2.2. トラックへ展開する情報
|
|
148
|
+
|
|
149
|
+
`sch-strategy-<track>.yaml`(生成入力)から `sch-track-<track>.yaml`(生成物)への展開では、タスク単位で確定する実行情報だけを展開します。
|
|
150
|
+
|
|
151
|
+
| 展開する情報 | 理由 |
|
|
152
|
+
| ------------------ | -------------------------------------------------------- |
|
|
153
|
+
| `name` | 実行者が作業を識別するために必要 |
|
|
154
|
+
| `description` | エージェント・人間が実行時に参照するフェーズ指示 |
|
|
155
|
+
| `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
|
|
156
|
+
| `owner` | 誰が実行するかを決定するために必要 |
|
|
157
|
+
| `duration_days` | CPM 計算に必要 |
|
|
158
|
+
| `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
|
|
159
|
+
|
|
160
|
+
トラック全体に共通する生成ルールや設計意図は strategy に留めます。
|
|
161
|
+
|
|
162
|
+
| strategy に留める情報 | 理由 |
|
|
163
|
+
| --------------------------------- | ---------------------------------------------------------------- |
|
|
164
|
+
| `phase_sets` の定義 | フェーズ構成は strategy が SSOT。定義全体はトラックへ複製しない |
|
|
165
|
+
| `owner_rules` | どの `local_id` を誰が担当するかのルール。トラックには展開しない |
|
|
166
|
+
| `cross_domain_dependencies` | 依存関係の設計意図。トラックには解決済み `depends_on` として反映 |
|
|
167
|
+
| `phase_gates`・`group_milestones` | 生成ロジック。トラックにはマイルストーンとして展開済み |
|
|
168
|
+
|
|
169
|
+
`description` をトラックへ展開するのは、エージェントや人間が plan ファイルだけを読んで実行できるようにするためです。strategy を参照させる方式は plan 生成時にファイルが 2 つ必要になり、自己完結性が損なわれます。
|
|
170
|
+
|
|
171
|
+
反復タスクには、実行時にタスク ID の文字列解析へ依存しないよう、生成元を表す `phase_set`・`phase_id`・`phase_suffix` と、該当する `cycle`・`iteration` を展開します。
|
|
172
|
+
|
|
173
|
+
`cross_deliverable_passes` から生成する横断タスクは、成果物別の `local_id` を持たず、明示された複数の `target_local_ids` を持ちます。これにより、一つの横断タスクの対象を plan frontmatter の `targets` と commit scope へ同じ順序で展開できます。
|
|
174
|
+
|
|
175
|
+
### 2.3. phase_setsの反復
|
|
176
|
+
|
|
177
|
+
個別 `phase_set` の反復と、`phase_sets` シーケンス全体の反復は別の階層として扱います。
|
|
178
|
+
|
|
179
|
+
| フィールド | 意味 | 省略時 |
|
|
180
|
+
| ------------ | --------------------------------------------------- | ------ |
|
|
181
|
+
| `iterations` | 個別 `phase_set` の総実行回数 | `1` |
|
|
182
|
+
| `cycles` | `sequence` に指定した `phase_sets` 全体の総実行回数 | `1` |
|
|
183
|
+
|
|
184
|
+
```yaml
|
|
185
|
+
default_phase_sets:
|
|
186
|
+
cycles: 2
|
|
187
|
+
sequence:
|
|
188
|
+
- phase_set: first-pass
|
|
189
|
+
iterations: 2
|
|
190
|
+
- phase_set: finalize-pass
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
この例は次の順序に展開されます。
|
|
194
|
+
|
|
195
|
+
```text
|
|
196
|
+
cycle 1: first-pass #1 -> first-pass #2 -> finalize-pass
|
|
197
|
+
cycle 2: first-pass #1 -> first-pass #2 -> finalize-pass
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
反復しない場合は、従来どおり配列形式も使えます。
|
|
201
|
+
|
|
202
|
+
```yaml
|
|
203
|
+
default_phase_sets: [first-pass, finalize-pass]
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
`cycles` と `iterations` は追加回数ではなく総実行回数です。
|
|
207
|
+
|
|
208
|
+
### 2.4. タスクID
|
|
209
|
+
|
|
210
|
+
タスク ID は `T-<TRACK>-<local_id>-<phase_suffix>` を基礎にし、反復する場合だけ `-C<cycle>` と `-I<iteration>` を末尾に付けます。`id:` フィールドは `sch-track` の YAML に書かず、自動導出します。
|
|
211
|
+
|
|
212
|
+
```text
|
|
213
|
+
# 反復なし
|
|
214
|
+
T-LAUNCH-prj-overview-010
|
|
215
|
+
|
|
216
|
+
# phase_sets 全体のみ反復
|
|
217
|
+
T-LAUNCH-prj-overview-010-C01
|
|
218
|
+
|
|
219
|
+
# 個別 phase_set のみ反復
|
|
220
|
+
T-LAUNCH-prj-overview-010-I01
|
|
221
|
+
|
|
222
|
+
# 両方を反復
|
|
223
|
+
T-LAUNCH-prj-overview-010-C01-I01
|
|
224
|
+
|
|
225
|
+
# 横断タスク
|
|
226
|
+
T-LAUNCH-project-definition-dedup-060
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
`cycles` が `2` 以上の場合だけ `C`、`iterations` が `2` 以上の場合だけ `I` を付けます。両方を使う場合の順序は `C`、`I` です。
|
|
230
|
+
|
|
231
|
+
横断タスクは `T-<TRACK>-<cross_deliverable_pass.id>-<task_suffix>` とします。成果物の `local_id` を代表値として使わないため、対象群をタスク ID から推測せず `target_local_ids` を参照します。
|
|
232
|
+
|
|
233
|
+
#### 2.4.1. 成果物群を横断する直列 pass
|
|
234
|
+
|
|
235
|
+
成果物別 phase を複製せず、明示した成果物群を一度だけ共同編集する場合は `cross_deliverable_passes` を使います。
|
|
236
|
+
|
|
237
|
+
```yaml
|
|
238
|
+
cross_deliverable_passes:
|
|
239
|
+
- id: project-definition-dedup
|
|
240
|
+
name: プロジェクト定義の正本選択・重複整理
|
|
241
|
+
task_suffix: "060"
|
|
242
|
+
duration_days: 0.5
|
|
243
|
+
owner: ARC
|
|
244
|
+
after_gate: G-LAUNCH-bootstrap-pass
|
|
245
|
+
before_phase_set: refine-pass
|
|
246
|
+
execution: agent
|
|
247
|
+
mode: edit
|
|
248
|
+
approach: cross-deliverable-dedup
|
|
249
|
+
proficiency: expert
|
|
250
|
+
scope:
|
|
251
|
+
catalogs:
|
|
252
|
+
- prj-0001:dct-project-definition
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
各 entry は scope の成果物数にかかわらず一つのタスクへ展開されます。そのタスクは `after_gate` に依存し、scope 内の `before_phase_set` の先頭タスクが横断タスクに依存します。このため、完了ゲート → 横断タスク → 成果物別 phase の順序を保ちつつ、横断作業の重複生成を防げます。
|
|
256
|
+
|
|
257
|
+
scope は `catalogs`、`groups`、`local_ids` の和集合で明示します。少なくとも二つの成果物へ解決できる必要があります。すでに全 phase 完了として `initial_state` に登録された成果物は対象群と plan targets には含めますが、後続 phase のブロック対象にはしません。
|
|
258
|
+
|
|
259
|
+
## 3. 実行要件とフェーズ解決
|
|
260
|
+
|
|
261
|
+
phase ごとの実行要件の定義方法と、`exec refresh` 時にどう解決されるかを示します。
|
|
262
|
+
|
|
263
|
+
### 3.1. フェーズと実行要件
|
|
264
|
+
|
|
265
|
+
`sch-strategy-<track>.yaml` の各フェーズには、実行種別と作業要件を定義できます。
|
|
266
|
+
|
|
267
|
+
```yaml
|
|
268
|
+
phase_sets:
|
|
269
|
+
first-pass:
|
|
270
|
+
- id: enrich
|
|
271
|
+
name: 調査・補強
|
|
272
|
+
execution: agent
|
|
273
|
+
task_suffix: "020"
|
|
274
|
+
mode: edit
|
|
275
|
+
capabilities: [web_search]
|
|
276
|
+
proficiency: expert
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
| フィールド | 用途 |
|
|
280
|
+
| -------------- | ------------------------------------------ |
|
|
281
|
+
| `execution` | `agent` または `human`。省略時は `agent` |
|
|
282
|
+
| `mode` | `edit` または `review`。省略時は `edit` |
|
|
283
|
+
| `approach` | plan テンプレートの進め方を選ぶ |
|
|
284
|
+
| `capabilities` | 必要なツールや能力を示す |
|
|
285
|
+
| `proficiency` | 必要な習熟度を示す |
|
|
286
|
+
| `agent` | executor / reporter を nickname で指名する |
|
|
287
|
+
|
|
288
|
+
`approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。エージェント選択の詳細は [exec設定ガイド](exec-config-guide.md) を参照します。
|
|
289
|
+
|
|
290
|
+
### 3.2. executor / reporter pipeline
|
|
291
|
+
|
|
292
|
+
一つの agent が成果物編集から result 記入までを担う従来フローを分割する場合、`execution: agent` の phase に任意の `agent_pipeline` を定義します。pipeline は executor、reporter の 2 stage 固定で、この順序を入れ替えたり一方を省略したりできません。
|
|
293
|
+
|
|
294
|
+
```yaml
|
|
295
|
+
phase_sets:
|
|
296
|
+
first-pass:
|
|
297
|
+
- id: enrich
|
|
298
|
+
name: 調査・補強
|
|
299
|
+
execution: agent
|
|
300
|
+
task_suffix: "020"
|
|
301
|
+
mode: edit
|
|
302
|
+
agent:
|
|
303
|
+
executor: codex-expert-executor
|
|
304
|
+
reporter: gemma-reporter
|
|
305
|
+
agent_pipeline:
|
|
306
|
+
stages:
|
|
307
|
+
- stage_role: executor
|
|
308
|
+
capabilities: [web_search]
|
|
309
|
+
proficiency: expert
|
|
310
|
+
- stage_role: reporter
|
|
311
|
+
proficiency: normal
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
| stage | 順序 | 責務 | 選択要件 |
|
|
315
|
+
| ---------- | ---- | ----------------------------------- | --------------------------------------- |
|
|
316
|
+
| `executor` | 1 | 成果物の編集と検証を行う | stage の `capabilities` / `proficiency` |
|
|
317
|
+
| `reporter` | 2 | evidence から構造化された結果を作る | stage の `capabilities` / `proficiency` |
|
|
318
|
+
|
|
319
|
+
- `agent_pipeline` は phase 単位の任意設定です。省略した phase は従来の単一 agent フローのまま動作します。
|
|
320
|
+
- pipeline を指定した phase は agent 実行専用です。`execution: human` と併用できません。
|
|
321
|
+
- `mode` と `approach` は phase 全体へ適用し、各 stage の agent 選択要件は stage 内の `capabilities` と `proficiency` で定義します。
|
|
322
|
+
- 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に `pm-members.yaml` の nickname を指定します。
|
|
323
|
+
- `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。`owner_rules[].phase_overrides[].agent` では成果物単位に指名を上書きできます。
|
|
324
|
+
- by-name の agent が rate limit になった場合は別 agent へ自動フォールバックせず、タスクを待機状態にします。再開時も同じ agent を使い、緊急の差し替えだけを CLI の stage override で行います。
|
|
325
|
+
- 登録簿の項目(`exec run --register`)は per-item のパイプライン宣言を持たないため、`agent_pipeline` の YAML 定義は使いません。代わりに `--executor-by <nickname>` と `--reporter-by <nickname>` を両方指定すると、同じ executor/reporter 2段階(evidence の受け渡し・result 描画を含む)で実行します。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `exec run` を参照します。
|
|
326
|
+
|
|
327
|
+
### 3.3. `bootstrap` と `retrofit` のフェーズ順序
|
|
328
|
+
|
|
329
|
+
実践の型が未整備で、かつ既存実装から成果物を作成・補正する場合、`bootstrap` と `retrofit` を一つの phase に混在させません。次の順序を推奨します。
|
|
330
|
+
|
|
331
|
+
1. `bootstrap`: 代表成果物と rulebook / recipe / sample / template を一式で初期整備する。
|
|
332
|
+
2. `retrofit` edit: DCT の `evidence_refs` から各成果物を新設・補正する。
|
|
333
|
+
3. `cross-deliverable-dedup`: 必要な場合だけ、成果物間の正本選択と重複整理を行う。
|
|
334
|
+
4. `fully-guided`: 整備済みの実践の型に沿って内容を磨き込む。
|
|
335
|
+
5. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
|
|
336
|
+
6. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
|
|
337
|
+
|
|
338
|
+
`retrofit` を使う成果物には、事前に DCT の `evidence_refs` を宣言します。実装エビデンスは Schedule の依存関係ではなく調査入力であるため、`depends_on` や `targets` へ複製しません。
|
|
339
|
+
|
|
340
|
+
### 3.4. exec refresh時のフェーズ解決
|
|
341
|
+
|
|
342
|
+
`exec refresh` は、`sch-track-<track>.yaml` のタスクを入力にし、対応する `sch-strategy-<track>.yaml` からフェーズ情報を解決して `ready.json` へ記録します。plan ファイルは `exec refresh` では生成せず、`exec plan` または `exec run` が必要時に生成します。
|
|
343
|
+
|
|
344
|
+
```text
|
|
345
|
+
sch-track task
|
|
346
|
+
local_id, phase_suffix, cycle, iteration
|
|
347
|
+
-> sch-strategy の phase_set / phase を解決
|
|
348
|
+
-> mode, approach, capabilities, proficiency を確定
|
|
349
|
+
-> generated/ready.json に記録
|
|
350
|
+
-> exec plan / exec run が plan を生成
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
`mode`、`approach`、`execution`、`capabilities`、`proficiency` だけを変更した場合は `exec refresh` で反映できます。タスク構造が変わる変更をした場合は `schedule build --force` が必要です。
|
|
354
|
+
|
|
355
|
+
### 3.5. intent 宣言と approach の決定論的導出
|
|
356
|
+
|
|
357
|
+
phase や owner rule に書く `approach` は、タスクの目的と実践の型が使える状態かどうかで決まります。目的は strategy の `approach_rules`、利用可能性は Kata に保存された grade を正本とし、strategy 生成時に facts を収集して都度導出します。
|
|
358
|
+
|
|
359
|
+
| 段階 | 正本・担当 | 出力 |
|
|
360
|
+
| -------- | -------------------------------------- | ------------------------------------------------------------ |
|
|
361
|
+
| 目的宣言 | strategy の `approach_rules` | 7 種の `intent` と必要な target / scope |
|
|
362
|
+
| 品質評価 | `specdojo grade` | grade result サイドカーの保存済み `verdict` |
|
|
363
|
+
| 事実収集 | コード | 実在、要否宣言、参照切れ、実装エビデンス |
|
|
364
|
+
| 規則適用 | コード(`schedule strategy generate`) | 成果物ごとの approach |
|
|
365
|
+
| 構造生成 | コード(`schedule strategy generate`) | scope・profile・owner・gate・依存・milestone を持つ strategy |
|
|
366
|
+
|
|
367
|
+
- `TaskIntent` 7 種は `author-deliverable`、`bootstrap-kata-set`、`reflect-implementation`、`deduplicate-across-deliverables`、`improve-kata`、`confirm-deliverable`、`confirm-with-kata-set` です。同じ track や owner rule 内でも成果物ごとに別の rule へ分けられます。
|
|
368
|
+
- `author-deliverable` は grade が `pass` の Kata を利用可能とし、`fully-guided` / `recipe-guided` / `freeform` を導出します。他の intent は目的別の `bootstrap` / `retrofit` / 横断整理 / maintenance / finalize 系へ一意に写像します。
|
|
369
|
+
- `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
|
|
370
|
+
- intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
|
|
371
|
+
- 標準 profile は `bootstrap`、`retrofit`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
|
|
372
|
+
- owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
|
|
373
|
+
- generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
|
|
374
|
+
|
|
375
|
+
コマンドの使い方は [CLIコマンドリファレンス](../references/command-reference.md) の `schedule strategy(決定論的な strategy 生成)`、`approach` ごとの進め方は [実践の進め方ガイド](ryu-guide.md) を参照します。
|
|
376
|
+
|
|
377
|
+
## 4. タスク設計の品質
|
|
378
|
+
|
|
379
|
+
タスク粒度、依存関係、CPM、典型的な失敗パターンを示します。
|
|
380
|
+
|
|
381
|
+
### 4.1. タスク粒度
|
|
382
|
+
|
|
383
|
+
Task は AI Agent が一度の実行で完了できる粒度にします。
|
|
384
|
+
|
|
385
|
+
| 指標 | 推奨 |
|
|
386
|
+
| --------------- | ---------------- |
|
|
387
|
+
| `duration_days` | `0.125` から `1` |
|
|
388
|
+
| 変更ファイル数 | 1から5 |
|
|
389
|
+
| 責務 | 1つ |
|
|
390
|
+
|
|
391
|
+
大きすぎる Task は分割し、小さすぎて独立完了できない Task は統合します。
|
|
392
|
+
|
|
393
|
+
`cross_deliverable_passes` は一つの論点整理責務を成果物群へ適用する例外であり、変更ファイル数より意味的なまとまりを優先します。scope を広げすぎず、正本を相互に選択できる成果物群ごとに分けます。
|
|
394
|
+
|
|
395
|
+
### 4.2. 依存関係
|
|
396
|
+
|
|
397
|
+
依存関係は最小限にします。依存が多いほど並列実行できる Ready タスクが減ります。
|
|
398
|
+
|
|
399
|
+
```text
|
|
400
|
+
良い例:
|
|
401
|
+
migration -> repository -> api endpoint
|
|
402
|
+
|
|
403
|
+
悪い例:
|
|
404
|
+
migration -> repository -> api -> test -> docs -> release
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
Ready タスク数の目安は同時に5から20件です。これを下回る状態が続く場合は依存関係を見直します。
|
|
408
|
+
|
|
409
|
+
### 4.3. CPMとクリティカルパス
|
|
410
|
+
|
|
411
|
+
`specdojo exec refresh` は Schedule から CPM(Critical Path Method)を計算します。
|
|
412
|
+
|
|
413
|
+
```text
|
|
414
|
+
generated/cpm.md
|
|
415
|
+
generated/critical-path.md
|
|
416
|
+
```
|
|
417
|
+
|
|
418
|
+
Slack が `0` の Task はクリティカルパスに乗ります。これらの遅延はプロジェクト全体の遅延に直結するため、優先して Ready にします。
|
|
419
|
+
|
|
420
|
+
### 4.4. Anti-patterns
|
|
421
|
+
|
|
422
|
+
| Anti-pattern | 問題 |
|
|
423
|
+
| ---------------------------------- | -------------------------------------------------------------------- |
|
|
424
|
+
| 巨大 Task(1日以上) | 一度のエージェント実行で完了しにくい |
|
|
425
|
+
| 過剰依存チェーン | Ready タスクが少なくなり並列性が落ちる |
|
|
426
|
+
| `duration_days: 0` の Task | ゼロ期間は Milestone を使う |
|
|
427
|
+
| `depends_on` の省略 | 前提なしでも `[]` と明示する |
|
|
428
|
+
| 成果物パスを Schedule に直接書く | パスは成果物カタログが管理する |
|
|
429
|
+
| `sch-strategy` に agent 個体を書く | strategy は作業要件を持ち、agent 個体は `pm-members.yaml` に集約する |
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:schedule-operation-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Schedule実行運用ガイド
|
|
9
|
+
|
|
10
|
+
Schedule Execution Operation Guide
|
|
11
|
+
|
|
12
|
+
Schedule(`sch-track-*.yaml`)から生成したタスクを、自動実行または手動実行する手順を説明します。3つの実行経路(schedule / register / routine)の比較と選び方は [exec運用ガイド](exec-operation-guide.md) を、Schedule自体の設計は [Schedule設計ガイド](schedule-design-guide.md) を参照します。
|
|
13
|
+
|
|
14
|
+
**対象読者**
|
|
15
|
+
|
|
16
|
+
- Schedule のタスクを自動または手動で実行する開発者、運用者
|
|
17
|
+
|
|
18
|
+
**この文書で分かること**
|
|
19
|
+
|
|
20
|
+
- 自動実行のフローと注意点、手動実行の各ステップ、plan を確認してから実行する方法
|
|
21
|
+
|
|
22
|
+
**次に読む文書**
|
|
23
|
+
|
|
24
|
+
- 実行経路の選び方は [exec運用ガイド](exec-operation-guide.md)、register 実行は [登録簿運用ガイド](register-operation-guide.md)、時刻条件による起動は [routine運用ガイド](routine-operation-guide.md) を参照してください。
|
|
25
|
+
- エージェント設定は [exec設定ガイド](exec-config-guide.md)、worktree隔離の段階操作は [exec worktree運用ガイド](exec-worktree-guide.md) を参照してください。
|
|
26
|
+
|
|
27
|
+
## 1. 自動実行
|
|
28
|
+
|
|
29
|
+
`exec run --auto` で Ready タスクを選び、worktree 隔離と状態追跡を伴って実行する経路です。
|
|
30
|
+
|
|
31
|
+
### 1.1. 自動実行フロー
|
|
32
|
+
|
|
33
|
+
`exec run --auto` は Ready タスクを選び、worktree 隔離と状態追跡を伴って実行します。
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
exec refresh
|
|
37
|
+
-> ready.json に Ready タスクを出力
|
|
38
|
+
exec run --auto [--loop]
|
|
39
|
+
-> Ready タスクを選択
|
|
40
|
+
-> phase 要件と pm-members.yaml から agent を解決
|
|
41
|
+
-> plan / result を生成
|
|
42
|
+
-> claim
|
|
43
|
+
-> task worktree を作成
|
|
44
|
+
-> exec branch に checkpoint commit
|
|
45
|
+
-> agent command を実行
|
|
46
|
+
-> 成功: result と成果物を commit / merge commit 1件で統合 / complete
|
|
47
|
+
-> 失敗: result を blocked に更新 / block / worktree を保持
|
|
48
|
+
exec refresh
|
|
49
|
+
-> 次の Ready タスクを更新
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`--loop --parallel <n>` では、最初に最大 `n` 件を起動した後、1件の agent が終了するたびに root 側の統合処理を終えて `exec refresh` を実行し、空いた枠へ次の Ready タスクを投入します。他の実行中 task の完了を待たないため、長時間 task と短時間 task が混在しても短時間 task の枠を継続利用できます。`--loop` を指定しない場合は、開始時に選択した最大 `n` 件だけを実行して終了します。
|
|
53
|
+
|
|
54
|
+
代表コマンド:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# 1バッチ実行して終了する
|
|
58
|
+
specdojo exec run --project <project-id> --auto --parallel 5
|
|
59
|
+
|
|
60
|
+
# Ready がなくなるまで連続実行する
|
|
61
|
+
specdojo exec run --project <project-id> --auto --loop --parallel 5
|
|
62
|
+
|
|
63
|
+
# FIFO順で実行する
|
|
64
|
+
specdojo exec run --project <project-id> --auto --strategy fifo
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### 1.2. auto実行中の注意点
|
|
68
|
+
|
|
69
|
+
`--auto` と `--loop` は root の現在ブランチへ task ごとの merge commit を繰り返します(checkpoint commit は exec branch 側に置き、root には plan / result / claim event の複製が未commitのまま残ります)。同じ作業ツリーで並行して手作業を行う場合は、次の安全ガードに注意します。
|
|
70
|
+
|
|
71
|
+
| 状況 | 挙動 |
|
|
72
|
+
| --------------------------------------------------------------------------- | ------------------------------------------------- |
|
|
73
|
+
| root index に stage 済み変更がある | checkpoint 前に停止する |
|
|
74
|
+
| root の未commit変更(runner が置いた複製を除く)と merge 対象パスが重複する | merge 前に停止する |
|
|
75
|
+
| agent が失敗して `blocked` になる | worktree を保持し、auto の Ready 選択から除外する |
|
|
76
|
+
| プロセス中断で `doing` が残る | `exec resume` で再開する |
|
|
77
|
+
|
|
78
|
+
parallel 実行中でも、claim、checkpoint、merge、complete、`exec refresh` は runner が直列化します。agent プロセスだけを並列に走らせ、root 側の状態更新や Ready 再計算は1件ずつ処理します。
|
|
79
|
+
|
|
80
|
+
agent が成功した後、runner は commit / merge / worktree 削除へ進む前に、最新の event log から task state を再構築し、`exec complete` と同じ完了可否を検証します。task が `doing` でない場合や、実行 actor が claim actor と一致しない場合は統合を中止し、成果物を未統合のまま worktree に保持します。これにより、`exec resume --by` などで別 actor を指定しても、Schedule が `doing` のまま成果物だけが統合される状態を防ぎます。
|
|
81
|
+
|
|
82
|
+
auto 実行と並行して人が作業する場合は、別ブランチの worktree を作成して編集します。
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
git worktree add ../specdojo-edit -b <edit-branch>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## 2. 手動実行
|
|
89
|
+
|
|
90
|
+
自動実行がまとめて行う各段階を、人が確認しながら順に進める経路です。
|
|
91
|
+
|
|
92
|
+
### 2.1. 手動実行フロー
|
|
93
|
+
|
|
94
|
+
`exec run --auto` の処理を手で分ける場合は、次の順に実行します。タスクを確認せず次のタスクをそのまま claim してよい場合は、手順 2〜4 の代わりに `--dry-run` なしの `exec scheduler` を 1 回実行します(自動選択と claim をまとめて行う)。
|
|
95
|
+
|
|
96
|
+
`exec scheduler` は、タスクIDを指定せずに次のタスクを claim するためのコマンドです。claim にあたって次の保護が働きます。
|
|
97
|
+
|
|
98
|
+
- プロジェクトレベルのロックを取得し、複数の runner が同じタスクを同時に claim しません。
|
|
99
|
+
- `owner` と actor のロール整合をチェックし、担当ロールの一致しないタスクは選びません。
|
|
100
|
+
- 同じ actor に `doing` のタスクが残っている場合は、多重 claim を防ぐため拒否します。
|
|
101
|
+
|
|
102
|
+
選択戦略は `--strategy` で切り替えます(`critical-first` 既定 / `fifo`)。選択結果の確認だけを行う場合は `--dry-run` を付けます。
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
# 1. Ready と CPM を最新化する
|
|
106
|
+
specdojo exec refresh --project <project-id>
|
|
107
|
+
|
|
108
|
+
# 2. 次のタスクを確認する
|
|
109
|
+
specdojo exec scheduler --project <project-id> --by <actor> --dry-run
|
|
110
|
+
|
|
111
|
+
# 3. 実行コマンドと agent 解決結果を確認する
|
|
112
|
+
specdojo exec run --project <project-id> --task <task-id> --dry-run
|
|
113
|
+
|
|
114
|
+
# 4. claim する(--msg 省略時は固定メッセージ "claim task" が記録される)
|
|
115
|
+
specdojo exec claim \
|
|
116
|
+
--project <project-id> \
|
|
117
|
+
--task <task-id> \
|
|
118
|
+
--by <actor>
|
|
119
|
+
|
|
120
|
+
# 5. 実行する
|
|
121
|
+
specdojo exec run --project <project-id> --task <task-id>
|
|
122
|
+
|
|
123
|
+
# 6. 完了を記録する(--msg 省略時は固定メッセージ "complete task" が記録される)
|
|
124
|
+
specdojo exec complete \
|
|
125
|
+
--project <project-id> \
|
|
126
|
+
--by <actor>
|
|
127
|
+
|
|
128
|
+
# 7. 次の Ready を更新する
|
|
129
|
+
specdojo exec refresh --project <project-id>
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
`exec complete` は `--task` を省略できます。`--by` で指定した actor の `doing` タスクが1件だけの場合は、そのタスクを完了対象として解決します。対象が0件の場合はエラー、複数件の場合は曖昧性を避けるため `--task <task-id>` の指定を要求します。
|
|
133
|
+
|
|
134
|
+
worktree 隔離を人が段階確認しながら実行する場合は [exec worktree運用ガイド](exec-worktree-guide.md) を参照します。
|
|
135
|
+
|
|
136
|
+
### 2.2. planを確認してから実行する
|
|
137
|
+
|
|
138
|
+
plan を先に生成して内容を確認・編集してから実行できます。
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
specdojo exec plan --project <project-id> --task <task-id>
|
|
142
|
+
specdojo exec run --project <project-id> --plan <execution-path>/exec/plans/<task-id>-plan.md
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
schedule に無い成果物を catalog から直接 plan 化する場合は `--deliverable <local_id>` を使います。
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
specdojo exec plan --project <project-id> --deliverable <local_id>
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
plan / result の命名、再実行、アーカイブは [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照します。
|