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,282 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:routine-operation-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# routine運用ガイド
|
|
9
|
+
|
|
10
|
+
Routine Operation Guide
|
|
11
|
+
|
|
12
|
+
`routine` は `rtn-*.yaml` の定義に基づき、Schedule の依存グラフとは独立にタスクを定期実行する、時刻条件のトリガー層です。routine 自体は実行機構を持たず、何を実行するかは Job Definition に委ねます。Job が schedule 実行または register 実行を呼び出します。実行経路の比較は [exec運用ガイド](exec-operation-guide.md) を参照します。
|
|
13
|
+
|
|
14
|
+
routineは、既存の未完了Schedule/Register項目を探索するほか、再利用可能なJob Definitionから期間・revisionごとのJob Runを生成できます。週報や変更文書の翻訳は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
|
|
15
|
+
|
|
16
|
+
継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。文書の選択、各文書の executor / reporter 実行、`grade apply --path --analysis-from` の逐次処理は `tools/grade/run-per-document.sh` が持ちます。定期 Job は `--stages 1` で codex 単段を選びます。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
|
|
17
|
+
|
|
18
|
+
**対象読者**
|
|
19
|
+
|
|
20
|
+
- 日次スイープや夜間バッチなど、時刻条件で繰り返す作業を運用する開発者、運用者
|
|
21
|
+
|
|
22
|
+
**この文書で分かること**
|
|
23
|
+
|
|
24
|
+
- routine の定義ファイル、due 判定と実行、`action.job` による Job への委譲
|
|
25
|
+
|
|
26
|
+
**次に読む文書**
|
|
27
|
+
|
|
28
|
+
- schedule 実行の詳細は [Schedule実行運用ガイド](schedule-operation-guide.md)、register 実行の詳細は [登録簿運用ガイド](register-operation-guide.md) を参照してください。
|
|
29
|
+
- レートリミット再開のための routine 例は [exec運用ガイド](exec-operation-guide.md) の `中断・訂正・再実行` を参照してください。
|
|
30
|
+
|
|
31
|
+
## 1. routineの定義
|
|
32
|
+
|
|
33
|
+
`routine` は `rtn-*.yaml` の定義に基づき、Schedule の依存グラフとは独立にタスクを定期実行します。CLI は常駐しません。外部スケジューラ(cron / CI の scheduled workflow)から `routine run --due` を冪等に呼び出す前提です。
|
|
34
|
+
|
|
35
|
+
定義は `.specdojo/specdojo.config.json` の `routines_path` 配下に `rtn-<slug>.yaml` として置き、`id` はファイル名と一致させます。
|
|
36
|
+
|
|
37
|
+
```yaml
|
|
38
|
+
id: rtn-daily-register-sweep
|
|
39
|
+
name: 登録簿 open todo の日次スイープ
|
|
40
|
+
enabled: true
|
|
41
|
+
interval: 1d
|
|
42
|
+
action:
|
|
43
|
+
kind: job
|
|
44
|
+
job: job-register-sweep
|
|
45
|
+
inputs:
|
|
46
|
+
types: todo
|
|
47
|
+
priorities: high
|
|
48
|
+
statuses: open
|
|
49
|
+
limit: "3"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### 1.1. 複数 action の順次実行
|
|
53
|
+
|
|
54
|
+
通常は `action` に1つの Job を指定します。複数の独立した委譲単位を同じ実行機会で順序保証したい場合は、`action` に1件以上の配列を指定します。各要素は `kind: job` と参照する Job、入力を持ちます。
|
|
55
|
+
|
|
56
|
+
```yaml
|
|
57
|
+
id: rtn-staged-execution
|
|
58
|
+
enabled: true
|
|
59
|
+
interval: 1d
|
|
60
|
+
action:
|
|
61
|
+
- kind: job
|
|
62
|
+
job: job-exec-auto
|
|
63
|
+
inputs:
|
|
64
|
+
strategy: fifo
|
|
65
|
+
parallel: "1"
|
|
66
|
+
- kind: job
|
|
67
|
+
job: job-exec-auto
|
|
68
|
+
inputs:
|
|
69
|
+
strategy: critical-first
|
|
70
|
+
parallel: "2"
|
|
71
|
+
- kind: job
|
|
72
|
+
job: job-final-check
|
|
73
|
+
inputs:
|
|
74
|
+
mode: strict
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure` または `skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
|
|
78
|
+
|
|
79
|
+
配列 action の実行後は、通常の `last_result` に加えて段ごとの `index`(1始まり)、`kind`、`result` を `last_action_results` へ記録します。単一オブジェクトの action では `last_action_results` を記録せず、既存の状態形式を維持します。
|
|
80
|
+
|
|
81
|
+
```json
|
|
82
|
+
{
|
|
83
|
+
"last_result": "failure",
|
|
84
|
+
"last_action_results": [
|
|
85
|
+
{ "index": 1, "kind": "job", "result": "failure" },
|
|
86
|
+
{ "index": 2, "kind": "job", "result": "success" },
|
|
87
|
+
{ "index": 3, "kind": "job", "result": "success" }
|
|
88
|
+
]
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### 1.2. exec を経由しない specdojo action
|
|
93
|
+
|
|
94
|
+
agent を呼ばず、読み取りと派生生成だけを行うコマンド(`dashboard build` など)は、`action.kind: specdojo` で specdojo のサブコマンドを直接起動できます。`exec run` を経由しないため実行ロックを取らず、grade や register の実行中でも skip されません。`args` には `exec` と `--project` を含められず、`--project` は routine が付与します。
|
|
95
|
+
|
|
96
|
+
```yaml
|
|
97
|
+
id: rtn-dashboard-refresh
|
|
98
|
+
enabled: true
|
|
99
|
+
trigger:
|
|
100
|
+
cron: "0 * * * *"
|
|
101
|
+
timezone: Asia/Tokyo
|
|
102
|
+
policy:
|
|
103
|
+
missed_run: skip
|
|
104
|
+
overlap: skip
|
|
105
|
+
action:
|
|
106
|
+
kind: specdojo
|
|
107
|
+
args: [dashboard, build]
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Job Definition を持たないため、実行記録は `generated/routine-runs.jsonl` の 1 行だけで、Job Run と evidence は作られません。agent を呼ぶ処理や成果物を変更する処理には使わず、`kind: job` を使います。
|
|
111
|
+
|
|
112
|
+
### 1.2. grade の単段評価
|
|
113
|
+
|
|
114
|
+
Kata と成果物の定期評価は、`codex-expert-executor` と `gemma-reporter` の単段で実行します。`job-grade-kata` と `job-grade-deliverable` は `tools/grade/run-per-document.sh --stages 1` を起動し、条件付きの後続段は持ちません。変更済み・未評価・段未完了を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`limit: 15` を入力します。
|
|
115
|
+
|
|
116
|
+
成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
|
|
117
|
+
|
|
118
|
+
`rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日6時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
|
|
119
|
+
|
|
120
|
+
両 routine では、Job の `task.precondition` が `grade list` を使って script の selection-v4 と同じ変更済み・未評価・再試行可能な段未完了の和集合、辞書順、対象種別、件数上限を先に評価します。連続失敗上限に達した文書は `grade state --exhausted` で同じ和集合に加えてから件数上限を適用し、処理対象からは外して report-only 対象にします。処理対象も report-only 対象も0件なら Job Run、plan、result、evidence を作らず、command と analysis reporter も起動しません。routine はこの結果を `skipped` として受け取り、`routine-state.json` の `last_run` / `last_result` と、cron の場合は `last_scheduled_for` を更新します。
|
|
121
|
+
|
|
122
|
+
| 段 | executor / reporter | 対象と役割 |
|
|
123
|
+
| --- | ------------------------------------------ | ------------------------------------------ |
|
|
124
|
+
| 1 | `codex-expert-executor` / `gemma-reporter` | 対象文書をリファレンスなしで評価し確定する |
|
|
125
|
+
|
|
126
|
+
Job runnerは、この入口をmaterialize済みの引数で1回起動し、コマンド、終了コード、stdout/stderrをevidenceへ記録します。コマンドが成功した場合だけanalysis reporterが、未完了の段、失敗の切り分け、verdict と score の偏りを判断します。executor、reporter、対象種別、件数上限はscriptの引数またはJobの`inputs`から解決します。
|
|
127
|
+
|
|
128
|
+
scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。3段構成から単段へ切り替えた時点で、現在本文に対して有効な `stage_total: 3` の state が残っている場合は、既存評価を完了済みとみなして state を削除します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
|
|
129
|
+
|
|
130
|
+
## 2. due判定と実行
|
|
131
|
+
|
|
132
|
+
最終実行時刻と結果は `<routines-path>/generated/routine-state.json` に記録され、`interval`(`30m` / `6h` / `1d` / `1w` 形式)が経過したものを due と判定します。配列 action の場合は段別結果も同じ state に記録します。多重起動は lock で防ぐため、外部スケジューラが重複起動しても同じ routine が二重に走ることはありません。
|
|
133
|
+
|
|
134
|
+
実行履歴は `<routines-path>/generated/routine-runs.jsonl` へ1実行1行で追記します。各行は `routine_id`、`scheduled_for`、`started_at`、`completed_at`、`result`、`job_run_ids` を持ち、`docs/specdojo/schemas/v1/routine-run.schema.yaml` に従います。最新状態だけを持つ `routine-state.json` は due 判定、追記履歴は dashboard の日別実績表示に使います。
|
|
135
|
+
|
|
136
|
+
単一オブジェクトの `action.kind`、配列の各要素の `kind` とも `job` だけを受け付けます。routine は `job-*.yaml` から一意な Job Run を生成して `exec run --job` へ委譲し、コマンド、入力の型・値域、冪等キーは Job Definition が担います。旧 `register` / `exec-auto` / `exec-resume` / `exec-cycle` kind は 2026-09-09 に廃止し、同等の command Job へ移行しました。
|
|
137
|
+
|
|
138
|
+
| Job | 動作 |
|
|
139
|
+
| -------------------- | ------------------------------------------------------------------------------------- |
|
|
140
|
+
| `job-register-sweep` | flat list 入力で登録簿を絞り込み、選択した項目を `exec run --register` 相当で実行する |
|
|
141
|
+
| `job-exec-auto` | `exec run --auto` を実行する |
|
|
142
|
+
| `job-exec-resume` | `exec resume --due` を実行する |
|
|
143
|
+
| `job-exec-cycle` | `exec cycle` を実行する |
|
|
144
|
+
|
|
145
|
+
週報Jobを毎週金曜日17時(Asia/Tokyo)に起動する例です。
|
|
146
|
+
|
|
147
|
+
```yaml
|
|
148
|
+
id: rtn-weekly-report
|
|
149
|
+
enabled: true
|
|
150
|
+
trigger:
|
|
151
|
+
cron: "0 17 * * 5"
|
|
152
|
+
timezone: Asia/Tokyo
|
|
153
|
+
action:
|
|
154
|
+
kind: job
|
|
155
|
+
job: job-weekly-report
|
|
156
|
+
inputs:
|
|
157
|
+
period: "{{scheduled_at | iso_week}}"
|
|
158
|
+
policy:
|
|
159
|
+
missed_run: all
|
|
160
|
+
overlap: skip
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# due な routine をまとめて実行する(cron / CI から呼ぶ想定)
|
|
165
|
+
specdojo routine run --project <project-id> --due
|
|
166
|
+
|
|
167
|
+
# 特定の routine を due 判定と無関係に即時実行する
|
|
168
|
+
specdojo routine run --project <project-id> --id rtn-daily-register-sweep
|
|
169
|
+
|
|
170
|
+
# 実行内容を確認する(実行も last_run 記録もしない)
|
|
171
|
+
specdojo routine run --project <project-id> --due --dry-run
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次回の cron tick に委ねます。
|
|
175
|
+
|
|
176
|
+
```text
|
|
177
|
+
[routine] skipped rtn-daily-register-sweep: job action skipped
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
`routine-state.json` の `last_result` は `success`、`failure`、`skipped` のいずれかです。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
|
|
181
|
+
|
|
182
|
+
### 2.1. devcontainerでのcron設定
|
|
183
|
+
|
|
184
|
+
このリポジトリのdevcontainerでは、`.devcontainer/specdojo-routine.cron`をcron設定のテンプレートとして管理します。コンテナ起動時に`.devcontainer/post-start.sh`がワークスペースの絶対パスを埋め込み、`/etc/cron.d/specdojo-routine`へ登録してcronを起動します。これはユーザーcrontabではないため、`crontab -l`には表示されません。
|
|
185
|
+
|
|
186
|
+
現在のテンプレートは、devcontainerが稼働している間、`prj-0001`のdueなroutineを毎時0分(Asia/Tokyo)に確認します。どの routine がどの時刻に動くかは各 `rtn-*.yaml` の cron で決まり、成果物評価は1時、Kata 評価は6時、dashboard 更新は毎時です。
|
|
187
|
+
|
|
188
|
+
```cron
|
|
189
|
+
TZ=Asia/Tokyo
|
|
190
|
+
CRON_TZ=Asia/Tokyo
|
|
191
|
+
|
|
192
|
+
*/5 * * * * node /usr/bin/date -u +\%Y-\%m-\%dT\%H:\%M:\%SZ > __WORKSPACE_DIR__/logs/routine-cron-heartbeat.log
|
|
193
|
+
0 0,1,5,6,8,16 * * * node cd __WORKSPACE_DIR__ && /usr/local/bin/node dist/specdojo.js routine run --project prj-0001 --due >> logs/routine-exec-cycle.log 2>&1
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
登録内容と稼働状態は次のコマンドで確認します。
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
# /etc/cron.dへ登録された内容
|
|
200
|
+
sudo cat /etc/cron.d/specdojo-routine
|
|
201
|
+
|
|
202
|
+
# cronプロセス
|
|
203
|
+
pgrep -a cron
|
|
204
|
+
|
|
205
|
+
# routine定義とdue状態
|
|
206
|
+
specdojo routine validate --project prj-0001
|
|
207
|
+
specdojo routine list --project prj-0001
|
|
208
|
+
|
|
209
|
+
# 実行対象だけを確認する(実行・状態更新なし)
|
|
210
|
+
specdojo routine run --project prj-0001 --due --dry-run
|
|
211
|
+
|
|
212
|
+
# cron実行後のログ(初回実行前はファイルが存在しない)
|
|
213
|
+
tail -n 100 logs/routine-exec-cycle.log
|
|
214
|
+
|
|
215
|
+
# cronデーモンの生存確認。稼働中なら5分ごとに更新される
|
|
216
|
+
cat logs/routine-cron-heartbeat.log
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
`post-start.sh` は cron の起動直後の status 確認に失敗した場合、その失敗を無視せず終了します。起動後の停止は `routine-exec-cycle.log` だけでは「due 対象なし」と区別できないため、`routine-cron-heartbeat.log` の最終時刻が10分以上更新されていないことを検知条件にします。devcontainerが停止している時刻のcronは実行されません。また、外部cronの起動時刻とroutine定義の`trigger.cron`は独立した設定です。特定時刻に確実にdue判定を行う構成では、`.devcontainer/specdojo-routine.cron`と対象の`rtn-*.yaml`で時刻・タイムゾーンを一致させます。プロジェクトIDや実行時刻を変更する場合は両方を更新し、コンテナを再起動して`post-start.sh`による再登録後に上記コマンドで確認します。
|
|
220
|
+
|
|
221
|
+
## 3. 実行経路への委譲
|
|
222
|
+
|
|
223
|
+
routine 自体は実行機構を持たないトリガー層です。何を実行するかは `action.job` の Job Definition に委ねられ、状態追跡も Job が呼ぶ schedule 実行または register 実行の規則に従います。routine は発火結果として `last_run` と `last_result`、配列 action では `last_action_results` を記録します。
|
|
224
|
+
|
|
225
|
+
### 3.1. 既存項目の再探索と実行単位の反復
|
|
226
|
+
|
|
227
|
+
次の2種類を区別します。
|
|
228
|
+
|
|
229
|
+
| 種類 | 例 | 現行routineでの扱い |
|
|
230
|
+
| -------------------- | --------------------------------------- | ------------------------------------ |
|
|
231
|
+
| 既存項目の再探索 | openな高優先度todoを毎日最大3件消化する | `job-register-sweep`へ入力を渡す |
|
|
232
|
+
| 既存計画の継続 | ReadyなSchedule taskを夜間に進める | `job-exec-auto`へ入力を渡す |
|
|
233
|
+
| 新しい実行単位の反復 | 毎週分の週報を作る | `kind: job`で期間ごとのRunを生成する |
|
|
234
|
+
| checkpoint差分の反復 | 前回成功後に更新された文書を翻訳する | Jobのcheckpointを使用する |
|
|
235
|
+
|
|
236
|
+
`interval: 1w`は前回実行から7日が経過したかを判定します。「毎週金曜日17時」のような暦上の予定は`trigger.cron`と`trigger.timezone`で定義します。取りこぼした実行枠は`policy.missed_run: skip|latest|all`で扱います。`skip`は現在の分が cron に一致するときだけ実行し、停止中の枠を再実行しません。実行中の重複起動は`policy.overlap: skip`で扱います。
|
|
237
|
+
|
|
238
|
+
### 3.2. 順次実行(exec-cycle)
|
|
239
|
+
|
|
240
|
+
延期 task の再開と Ready task の自動実行を続けて動かしたいとき、`job-exec-resume` と `job-exec-auto` を別々の routine に分けると、実行順は routine ファイルの列挙順や複数 routine の cron 時刻差に依存します。先行 routine が想定時間を超えると後続 routine が busy skip され、次回の発火まで進みません。
|
|
241
|
+
|
|
242
|
+
`job-exec-cycle` は 1 つの routine で次の5 step を固定順で順次実行します。step の順序は routine ファイル名順や cron 時刻差に依存しません。
|
|
243
|
+
|
|
244
|
+
1. `exec-resume --due`(再開時刻を迎えた retryable な利用制限 task の再開)
|
|
245
|
+
2. `index build`(`.specdojo/doc-index.json` の再構築)
|
|
246
|
+
3. 古い track の再生成(必要な track ごとの `schedule build --force`)
|
|
247
|
+
4. schedule 状態の再計算(`exec validate` と `exec refresh`)
|
|
248
|
+
5. `exec run --auto`(Ready task の実行。`loop` 指定時は Ready がなくなるまで反復)
|
|
249
|
+
|
|
250
|
+
step 3 は、`sch-track-<track>.yaml` がないか、`sch-strategy-<track>.yaml` の更新時刻が track より新しい場合だけ実行します。これは `exec validate` の警告と同じ判定です。該当 track がなければ step 3 のコマンドとログを省略します。再生成に失敗した場合は古い track のまま状態再計算や auto 実行へ進みません。自動再生成は `exec cycle` に限定し、単発の `exec run` と `exec refresh` の動作は変えません。
|
|
251
|
+
|
|
252
|
+
`index build` を状態再計算より前に挟むのは、直前の step(`resume` や、前回 routine 実行の取りこぼし)が新設した成果物を、Ready task の plan 生成が参照できるようにするためです。これを省くと、ある task が新設した成果物を同じ project の後続 task が wikilink/ID 参照で解決できず、生成された plan に `Unresolved ID reference` の警告が残ることがあります。`loop` 指定時は、auto step 内のラウンドを跨ぐたびにも `index build` → 古い track の再生成 → `exec refresh` の順で再実行されます。前ラウンドで新設された成果物を解決できるだけでなく、strategy の更新で追加された次 track の task も同じ cycle の次ラウンドから Ready 選択できます。
|
|
253
|
+
|
|
254
|
+
一連の処理は単一の project 実行ロック内で保持されます。step 間に手動実行・別 routine・CI の `exec run` / `exec resume` は割り込めません。後続 step は自身でロックを取り直さないため、同一 routine 実行の後続 step を busy skip することもありません。
|
|
255
|
+
|
|
256
|
+
step 単位の失敗方針は次のとおりで、`[cycle] summary: ...` に step ごとの結果が出力されます。
|
|
257
|
+
|
|
258
|
+
| step | 失敗時の扱い |
|
|
259
|
+
| ---------- | ---------------------------------------------------------------------------------- |
|
|
260
|
+
| `resume` | 再延期や失敗があっても中断しない。依存しない Ready task の実行を継続する |
|
|
261
|
+
| `index` | `index build` は後続 step の参照解決の前提のため、失敗したら残りの step を中止する |
|
|
262
|
+
| `schedule` | 古い track の再生成に失敗したら状態再計算と auto step を中止する |
|
|
263
|
+
| `refresh` | `validate` / `refresh` は Ready 選択の前提のため、失敗したら auto step を中止する |
|
|
264
|
+
| `auto` | 失敗を記録する。以降の step はない |
|
|
265
|
+
|
|
266
|
+
いずれかの step が失敗すると routine 実行全体は失敗(終了コード 1)になり、`routine-state.json` の `last_result` は `failure` を記録します。開始時に project が busy の場合だけ `--if-busy` 方針(既定は routine 経由で `skip`)が適用され、`skipped` として記録されます。再開対象が 0 件でも状態再計算と auto 実行へ進みます。
|
|
267
|
+
|
|
268
|
+
```yaml
|
|
269
|
+
id: rtn-exec-cycle
|
|
270
|
+
enabled: true
|
|
271
|
+
interval: 30m
|
|
272
|
+
action:
|
|
273
|
+
kind: job
|
|
274
|
+
job: job-exec-cycle
|
|
275
|
+
inputs:
|
|
276
|
+
strategy: critical-first
|
|
277
|
+
parallel: "2"
|
|
278
|
+
loop: "true"
|
|
279
|
+
max_rounds: "5"
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
`strategy` / `loop` / `max_rounds` は auto step に、`parallel` は resume step と auto step の両方に適用されます。単体の `exec resume` / `exec run --auto` はこれまでどおり利用でき、routine からは対応する Job を参照します。
|
|
@@ -0,0 +1,230 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:ryu-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: draft
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 実践の進め方ガイド
|
|
9
|
+
|
|
10
|
+
Ryu Guide
|
|
11
|
+
|
|
12
|
+
タスクの目的と実践の型(rulebook / recipe / sample / template)の整備状況に応じて、成果物の作成・更新・レビューをどの進め方(`approach`)で進めるかを説明します。
|
|
13
|
+
|
|
14
|
+
SpecDojo は道場のメタファーとして、進め方(`approach`)を「Ryu(流)」と呼びます。「Ryu」は本ガイドで進め方を説明するための愛称・分類であり、`approach` フィールドの名称や値そのもの(`fully-guided` など)を変更するものではありません。実際のフィールド名・値は従来どおりです。
|
|
15
|
+
|
|
16
|
+
**対象読者**
|
|
17
|
+
|
|
18
|
+
- 成果物を作成・更新・レビューする人、エージェント
|
|
19
|
+
|
|
20
|
+
**この文書で分かること**
|
|
21
|
+
|
|
22
|
+
- `approach` の選び方と一覧、参照の共通原則、実践の型メンテナンスの進め方、review への適用
|
|
23
|
+
|
|
24
|
+
**次に読む文書**
|
|
25
|
+
|
|
26
|
+
- 実践の型そのものの役割と使い分けは [実践の型活用ガイド](kata-guide.md) を参照してください。
|
|
27
|
+
- `approach` をタスクに設定し schedule で実行する方法は [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
|
|
28
|
+
|
|
29
|
+
## 1. 整備状況に応じた進め方(approach)
|
|
30
|
+
|
|
31
|
+
`approach`(進め方)は、タスクの目的と、対象成果物の rulebook / recipe / sample / template がどれだけ整備されているかに応じて選ぶプロファイルです。判断は次のように分担します。手作業でも schedule 実行でも考え方は同じです。
|
|
32
|
+
|
|
33
|
+
| 判断 | 正本・担当 | 根拠・出力 |
|
|
34
|
+
| ---------------------------------------------------------- | -------------------------------------- | --------------------------------- |
|
|
35
|
+
| タスク目的 | strategy の `approach_rules` | 成果物ごとの `intent` |
|
|
36
|
+
| 内容が作成・更新基準として信頼できるか | `specdojo grade` | grade result の `verdict` |
|
|
37
|
+
| 実在・要否宣言・参照切れ・実装エビデンスと approach の導出 | コード(`schedule strategy generate`) | 生成 strategy の phase `approach` |
|
|
38
|
+
|
|
39
|
+
実行時は strategy から生成された `approach` に従います。導出規則は [Schedule設計ガイド](schedule-design-guide.md) の `intent 宣言と approach の決定論的導出` を参照してください。
|
|
40
|
+
|
|
41
|
+
実践の型そのものの役割と使い分けは [実践の型活用ガイド](kata-guide.md) を参照してください。本ガイドは、それらを `approach` に応じてどこまで基準にするかという進め方を扱います。
|
|
42
|
+
|
|
43
|
+
### 1.1. approach の選び方
|
|
44
|
+
|
|
45
|
+
進め方は、まずタスクの目的で分かれ、通常の成果物作成・更新では実践の型の整備状況でさらに分かれます。`fully-guided` / `recipe-guided` / `freeform` は実践の型をどこまで基準にするかを表します。`retrofit` は実装先行時の現在動作調査、`bootstrap` / `cross-deliverable-dedup`・各 `*-maintenance`・`finalize` 系は、それぞれの目的に応じて選ぶ進め方です。
|
|
46
|
+
|
|
47
|
+
```mermaid
|
|
48
|
+
flowchart TD
|
|
49
|
+
P{"タスクの目的"}
|
|
50
|
+
P -->|"成果物を作成・更新する"| M{"実践の型の整備状況"}
|
|
51
|
+
M -->|"必要な型が揃い信頼できる"| FG["fully-guided"]
|
|
52
|
+
M -->|"recipe のみ使える"| RG["recipe-guided"]
|
|
53
|
+
M -->|"実践の型に頼れない"| FF["freeform"]
|
|
54
|
+
FG --> W["雛形から開始 → 内容を記述 → レビュー"]
|
|
55
|
+
RG --> W
|
|
56
|
+
FF --> W
|
|
57
|
+
P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
|
|
58
|
+
P -->|"成果物と実践の型を新規に一括整備"| BS["bootstrap"]
|
|
59
|
+
P -->|"成果物群の重複を整理"| DD["cross-deliverable-dedup"]
|
|
60
|
+
P -->|"実践の型を見直す"| MT["各 maintenance<br/>成果物 → 実践の型"]
|
|
61
|
+
P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
|
|
65
|
+
|
|
66
|
+
### 1.2. approach 一覧
|
|
67
|
+
|
|
68
|
+
`approach` は、目的に応じて「成果物の作成・更新」「初期整備・実装反映・横断整理」「実践の型のメンテナンス」「human による確定」の4種に分けられます。以下の表にある edit / review は plan テンプレート、result は実行記録のテンプレートです。テンプレートには各 `approach` で行う具体的な手順が定義されています。mode や execution に対応する専用テンプレートがない場合のフォールバック規則は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照してください。
|
|
69
|
+
|
|
70
|
+
#### 1.2.1. 成果物の作成・更新
|
|
71
|
+
|
|
72
|
+
実践の型をどこまで作成・更新の基準にするかを切り替える進め方です。
|
|
73
|
+
|
|
74
|
+
```mermaid
|
|
75
|
+
flowchart LR
|
|
76
|
+
RB["rulebook<br/>構造・必須事項・禁止事項"]
|
|
77
|
+
RC["recipe<br/>問い・組み立て方"]
|
|
78
|
+
SP["sample<br/>粒度・文体・表現"]
|
|
79
|
+
TP["template<br/>開始時の雛形"]
|
|
80
|
+
CTX["類似成果物・<br/>プロジェクト文脈"]
|
|
81
|
+
D["成果物"]
|
|
82
|
+
|
|
83
|
+
RB -->|fully-guided| D
|
|
84
|
+
RC -->|fully-guided / recipe-guided| D
|
|
85
|
+
SP -->|fully-guided| D
|
|
86
|
+
TP -->|fully-guided| D
|
|
87
|
+
CTX -->|freeform| D
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
| `approach` | 参照方針と進め方 | 対応テンプレート |
|
|
91
|
+
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
92
|
+
| `fully-guided` | 必要と宣言された rulebook / recipe / sample / template をそれぞれの役割に沿って使う。利用する template があればそこから開始し、rulebook と矛盾する場合は rulebook を正とする | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
93
|
+
| `recipe-guided` | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
94
|
+
| `freeform` | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
95
|
+
|
|
96
|
+
#### 1.2.2. 初期整備・実装反映・横断整理
|
|
97
|
+
|
|
98
|
+
成果物と実践の型を一式で立ち上げる場合、既存実装から成果物を補正する場合、または複数成果物の重複を整理する場合に使います。
|
|
99
|
+
|
|
100
|
+
```mermaid
|
|
101
|
+
flowchart LR
|
|
102
|
+
BS["bootstrap"]
|
|
103
|
+
D["成果物"]
|
|
104
|
+
K["rulebook / recipe /<br/>sample / template"]
|
|
105
|
+
S["scope 内の<br/>複数成果物"]
|
|
106
|
+
DD["cross-deliverable-dedup<br/>正本を選択"]
|
|
107
|
+
C["正本+要約・参照"]
|
|
108
|
+
|
|
109
|
+
BS -->|初期作成| D
|
|
110
|
+
BS -->|初期作成| K
|
|
111
|
+
D <-->|構造・用語・粒度を整合| K
|
|
112
|
+
E["DCT evidence_refs<br/>実装エビデンス"] --> RF["retrofit<br/>一致・乖離を判定"] --> D
|
|
113
|
+
S --> DD --> C
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
| `approach` | 参照方針と進め方 | 対応テンプレート |
|
|
117
|
+
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
118
|
+
| `bootstrap` | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
|
|
119
|
+
| `retrofit` | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
|
|
120
|
+
| `cross-deliverable-dedup` | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
|
|
121
|
+
|
|
122
|
+
`retrofit` では、実装を現在動作(AS-IS)の根拠、既存成果物・決定記録・プロジェクトコンテキストを意図された仕様の根拠、`done_criteria` を成果物が満たすべき目的として扱います。三者が一致すれば成果物へ反映し、実装が意図された仕様と異なる場合は実装へ無条件に合わせず、乖離と修正対象候補を result に記録します。実装から確認できない目的・業務判断・将来方針は推測しません。
|
|
123
|
+
|
|
124
|
+
#### 1.2.3. 実践の型のメンテナンス
|
|
125
|
+
|
|
126
|
+
通常の成果物作業とは参照の向きを逆にし、成果物や review result を根拠として対象の実践の型を見直します。
|
|
127
|
+
|
|
128
|
+
```mermaid
|
|
129
|
+
flowchart LR
|
|
130
|
+
E["複数の成果物・<br/>review result・慣行"]
|
|
131
|
+
RB["rulebook"]
|
|
132
|
+
RC["recipe"]
|
|
133
|
+
SP["sample"]
|
|
134
|
+
TP["template"]
|
|
135
|
+
|
|
136
|
+
E -->|rulebook-maintenance| RB
|
|
137
|
+
E -->|recipe-maintenance| RC
|
|
138
|
+
E -->|sample-maintenance| SP
|
|
139
|
+
E -->|template-maintenance| TP
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
| `approach` | 見直す対象 | 対応テンプレート |
|
|
143
|
+
| ---------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
144
|
+
| `rulebook-maintenance` | rulebook | [edit](../exec-templates/xep-rulebook-maintenance-template.md) / [review](../exec-templates/xrp-rulebook-maintenance-template.md) |
|
|
145
|
+
| `recipe-maintenance` | recipe | [edit](../exec-templates/xep-recipe-maintenance-template.md) / [review](../exec-templates/xrp-recipe-maintenance-template.md) |
|
|
146
|
+
| `sample-maintenance` | sample | [edit](../exec-templates/xep-sample-maintenance-template.md) / [review](../exec-templates/xrp-sample-maintenance-template.md) |
|
|
147
|
+
| `template-maintenance` | template | [edit](../exec-templates/xep-template-maintenance-template.md) / [review](../exec-templates/xrp-template-maintenance-template.md) |
|
|
148
|
+
|
|
149
|
+
rulebook frontmatter で `not-needed` と宣言された型はメンテナンス対象ではなく、strategy へ対応する `*-maintenance` フェーズを生成しません。作成が必要になった場合は、先に要否判断の根拠と rulebook frontmatter の宣言を更新します。
|
|
150
|
+
|
|
151
|
+
#### 1.2.4. human による確定
|
|
152
|
+
|
|
153
|
+
`execution: human` と組み合わせ、確認対象の `status` を `ready` へ昇格する確定プロファイルです。`ready` への昇格は human のみが行えます。
|
|
154
|
+
|
|
155
|
+
```mermaid
|
|
156
|
+
flowchart LR
|
|
157
|
+
H["human"]
|
|
158
|
+
D["成果物"]
|
|
159
|
+
K["rulebook / recipe /<br/>sample / template"]
|
|
160
|
+
F["finalize"]
|
|
161
|
+
BF["bootstrap-finalize"]
|
|
162
|
+
DR["成果物<br/>status: ready"]
|
|
163
|
+
AR["成果物と実践の型<br/>status: ready"]
|
|
164
|
+
|
|
165
|
+
H --> F
|
|
166
|
+
D --> F --> DR
|
|
167
|
+
H --> BF
|
|
168
|
+
D --> BF
|
|
169
|
+
K --> BF --> AR
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
| `approach` | 確定対象と進め方 | 対応テンプレート |
|
|
173
|
+
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
|
|
174
|
+
| `finalize` | human が `done_criteria` を確認し、必要なら最小限の修正を加え、成果物のみを `ready` へ昇格する | [result](../exec-templates/xer-human-finalize-template.md) |
|
|
175
|
+
| `bootstrap-finalize` | `bootstrap` と対になり、human が成果物と rulebook / recipe / sample / template をまとめて確認し、それぞれを `ready` へ昇格する | [result](../exec-templates/xer-human-bootstrap-finalize-template.md) |
|
|
176
|
+
|
|
177
|
+
`approach` を指定しない場合は、存在するすべての実践の型をそれぞれの役割に沿って活用します。schedule で `approach` をどこで設定し `exec refresh` でどう解決するかは [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
|
|
178
|
+
|
|
179
|
+
これらの `approach` に沿って作業する plan は、`specdojo exec plan` または `specdojo exec run` で生成できます。plan・result の生成規則は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md)、実行手順は [exec運用ガイド](exec-operation-guide.md) を参照してください。
|
|
180
|
+
|
|
181
|
+
### 1.3. 参照の共通原則
|
|
182
|
+
|
|
183
|
+
`approach` にかかわらず適用する原則です。
|
|
184
|
+
|
|
185
|
+
- 矛盾時の優先: `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
186
|
+
- 参照範囲: `fully-guided` / `recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
187
|
+
- 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
|
|
188
|
+
- 根拠のない具体化の禁止: `freeform` を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。review では、対象成果物中の具体的記述が参照範囲の文書で裏付けられているかを確認し、裏付けが確認できない場合は unclear として findings に残します。
|
|
189
|
+
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
190
|
+
- 判定基準の優先: `done_criteria` やレビュー観点(`RVP-NNN`)が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
191
|
+
|
|
192
|
+
## 2. 実践の型メンテナンスの進め方
|
|
193
|
+
|
|
194
|
+
`rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` は、通常の成果物作業とは参照の向きが逆になる進め方です。作成・更新かレビューかを `mode`(`edit` / `review`)で表す点は他の `approach` と同じです。
|
|
195
|
+
|
|
196
|
+
メンテナンスのタスクでは、対象の実践の型を「見直す対象」として扱い、複数の成果物・review result・対象領域の慣行を根拠に、次の観点で妥当性を見直します。対象の実践の型に finding がある場合は、finding の message と同じ viewpoint の判定根拠から指摘の根拠となる規範を特定し、紐づく rulebook / recipe / sample / template や執筆標準も必要な根拠として読みます。たとえば rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として照合します。
|
|
197
|
+
|
|
198
|
+
| `approach` | 見直す対象 | 主な見直し観点 |
|
|
199
|
+
| ---------------------- | ---------- | ---------------------------------------------------------------- |
|
|
200
|
+
| `rulebook-maintenance` | rulebook | 章構成、必須項目、禁止事項、判定基準 |
|
|
201
|
+
| `recipe-maintenance` | recipe | 問い、観点、深掘り手順、レビュー観点 |
|
|
202
|
+
| `sample-maintenance` | sample | 粒度、文体、表の書き方、完成例としての妥当性 |
|
|
203
|
+
| `template-maintenance` | template | 章構成の骨組み、プレースホルダの配置・網羅性、雛形としての妥当性 |
|
|
204
|
+
|
|
205
|
+
根拠の種別を一律に必須化せず、finding ごとに指摘の解消を判定できる資料を使います。成果物または review result がないことだけを理由に根拠不足とは判定しません。finding の message と判定根拠、対象の実践の型から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても修正内容を確定できない場合に限り、根拠不足として見送ります。見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result に記録します。
|
|
206
|
+
|
|
207
|
+
実践の型メンテナンスは自動で差し込まれません。schedule で実行する場合は、`approach: rulebook-maintenance` のように対象を指定した phase / phase_set を `sch-strategy-<track>.yaml` に明示的に記述します([Schedule設計ガイド](schedule-design-guide.md))。
|
|
208
|
+
|
|
209
|
+
## 3. review への適用
|
|
210
|
+
|
|
211
|
+
review でも「整備状況に応じた進め方(approach)」を同じ基準で適用します。レビューでは「成果物を組み立てる」のではなく「成果物が満たすべき基準に照らして確認する」ため、次のように読み替えます。
|
|
212
|
+
|
|
213
|
+
通常の成果物編集では観点別の自己レビューを行わず、`done_criteria` を「完了の狙い」として扱います。多観点での判定と証跡は独立したレビューが担います。以下の `approach` ごとの参照方針は、編集時の記述とレビューの双方に適用します。
|
|
214
|
+
|
|
215
|
+
- `fully-guided`: rulebook の必須要素・禁止事項、recipe の問いとレビュー観点、sample の粒度・文体との整合を確認します。template がある場合は、章構成が雛形と整合しているか、プレースホルダが残っていないかを確認します。あわせて、成果物中の具体的な実装事実(ファイルパス・コマンド・設定値など)が参照範囲の文書で裏付けられているかを確認し、裏付けが無ければ unclear とします。
|
|
216
|
+
- `recipe-guided`: recipe の問いとレビュー観点に照らして確認し、rulebook / sample / template の構造・文体は基準にしません。
|
|
217
|
+
- `freeform`: カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に、目的達成・構造・粒度・既存慣行との整合を確認します。
|
|
218
|
+
- `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`: 「実践の型メンテナンスの進め方」に従い、対象の実践の型が見直しに値するかという向きで確認観点を読み替えます。
|
|
219
|
+
- `approach` に関わらず、evidence・notes は対象成果物・実践の型を実際に読んで得た具体的な観察に限ります。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱いません。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先し findings に記録します。
|
|
220
|
+
- 判断の根拠をレビュー結果に残します。
|
|
221
|
+
|
|
222
|
+
## 4. 関連ドキュメント
|
|
223
|
+
|
|
224
|
+
- [実践の型活用ガイド](kata-guide.md): rulebook / recipe / sample / template それぞれの役割と使い分け
|
|
225
|
+
- [実践体系構成ガイド](practice-system-composition-guide.md): 実践の型を含む実践体系の種別と役割
|
|
226
|
+
- [Schedule設計ガイド](schedule-design-guide.md): `approach` をタスクに設定し schedule で実行する方法
|
|
227
|
+
- [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md): `exec plan` / `exec run` による plan・result の生成・命名・再実行
|
|
228
|
+
- [exec運用ガイド](exec-operation-guide.md): exec plan を使った実行フロー
|
|
229
|
+
- [レビューガイド](review-guide.md): レビューの進め方と、実践の型の活用方法
|
|
230
|
+
- [遂行の技活用ガイド](waza-guide.md): プロジェクトコンテキストなど plan 生成時に渡す設定
|