specdojo 0.7.0 → 0.9.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/.github/agents/specdojo-orchestrator.md +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -13,29 +13,16 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
Migration Test Plan (MTP) Documentation Rules
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
移行手順と結果の妥当性を事前に検証し、当日の失敗確率を下げるための内容を定義します。
|
|
16
|
+
移行テスト計画(リハーサル計画)の記述基準を定めます。移行手順と結果の妥当性を事前に検証し、当日の失敗確率を下げるための内容を定義します。
|
|
18
17
|
|
|
19
18
|
## 1. 全体方針
|
|
20
19
|
|
|
21
|
-
`mtp-index
|
|
22
|
-
|
|
23
|
-
-
|
|
24
|
-
- テスト環境/データ準備を事前に固定する
|
|
25
|
-
- 検証観点(件数/差分/業務シナリオ)と合否基準を明記する
|
|
26
|
-
- 差異発生時の扱い(許容/修正/再実行)を明文化する
|
|
27
|
-
- 結果報告フォーマットとGO/NO-GO判断プロセスを定義する
|
|
28
|
-
|
|
29
|
-
運用方針:
|
|
30
|
-
|
|
31
|
-
- 原則 `mtp-index` を作成し、全体の計画(SSOT)を1つにまとめる
|
|
32
|
-
- `mtp-<term>` は、ウェーブ分割・責任分界・対象の独立性が高い場合に限り追加する
|
|
33
|
-
- `mtp-<term>` を追加する場合でも、共通方針・全体日程・GO/NO-GOの基準点は `mtp-index` を正とする
|
|
20
|
+
- **目的と適用範囲**: `mtp-index` / `mtp-<term>` に、再現可能なリハーサル計画と評価基準を定義し、GO/NO-GO判断の根拠を提供する。
|
|
21
|
+
- **全体と分冊**: 原則 `mtp-index` に全体の計画をまとめる。ウェーブ分割・責任分界・対象の独立性が高い場合に限り `mtp-<term>` を追加し、共通方針・全体日程・GO/NO-GOの基準点は `mtp-index` を正とする。
|
|
22
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
34
23
|
|
|
35
24
|
## 2. 位置づけ
|
|
36
25
|
|
|
37
|
-
`mtp-index` / `mtp-<term>` と他ドキュメントの関係を示します。必要に応じて Mermaid による図を使用してよい。
|
|
38
|
-
|
|
39
26
|
- `mip-index`:移行の合意・判断のSSOT(成功条件・カットオーバー骨格を含む)
|
|
40
27
|
- `dmd-index` / `dmd-<term>`:データ移行の詳細設計(マッピング/変換/検証)
|
|
41
28
|
- **`mtp-index` / `mtp-<term>`:リハーサル計画・検証設計(観点/手順/証跡)**
|
|
@@ -44,29 +31,24 @@ Migration Test Plan (MTP) Documentation Rules
|
|
|
44
31
|
|
|
45
32
|
## 3. ファイル命名・ID規則
|
|
46
33
|
|
|
47
|
-
- `id`
|
|
34
|
+
- `id` のローカル部分は `mtp-index` または `mtp-<term>`(kebab-case。例: `mtp-cutover-rehearsal`)。
|
|
48
35
|
- ファイル名は `mtp-010-移行テスト計画.md` / `mtp-020-移行テスト計画-<term>.md` 等、プロジェクト内で一意になるように命名する。
|
|
49
|
-
- `<term>` は用語集(GL)の論理名キー(英小文字kebab-case
|
|
36
|
+
- `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる。表示名は H1 / ファイル名で日本語を使用してよい。
|
|
50
37
|
|
|
51
38
|
## 4. 推奨 Frontmatter 項目
|
|
52
39
|
|
|
53
40
|
### 4.1. 設定内容
|
|
54
41
|
|
|
55
|
-
|
|
42
|
+
共通の必須項目・型制約はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とし、SpecDojo の項目は `specdojo:` 配下に置く。文書名は Frontmatter の `title` ではなく本文先頭の H1 に書く。
|
|
56
43
|
|
|
57
|
-
| 項目 |
|
|
58
|
-
| ---------- |
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
| title | 移行テスト計画: <対象名> | ○ |
|
|
62
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
63
|
-
| based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
|
|
64
|
-
| supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
|
|
44
|
+
| 項目 | MTP 固有の設定 | 必須 |
|
|
45
|
+
| ---------- | ---------------------------- | ---- |
|
|
46
|
+
| `type` | `test` 固定 | ○ |
|
|
47
|
+
| `rulebook` | `specdojo:mtp-rulebook` 固定 | ○ |
|
|
65
48
|
|
|
66
49
|
### 4.2. 推奨ルール
|
|
67
50
|
|
|
68
|
-
- `based_on`
|
|
69
|
-
- `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)
|
|
51
|
+
- `based_on` には移行判断に直接利用した作成済みの成果物のみ列挙する。成果物カタログに `depends_on` がある場合は、その推移閉包内に限定する。
|
|
70
52
|
|
|
71
53
|
## 5. 本文構成(標準テンプレ)
|
|
72
54
|
|
|
@@ -84,106 +66,68 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
84
66
|
| 8 | GO/NO-GO判断プロセス | ○ |
|
|
85
67
|
| 9 | 関連ドキュメント | ○ |
|
|
86
68
|
|
|
87
|
-
補足:
|
|
88
|
-
|
|
89
|
-
- `mtp-index` は「全体」を扱い、複数 `mtp-<term>` がある場合は各termの位置づけと差分を示す
|
|
90
|
-
- `mtp-<term>` は term固有の内容に寄せ、共通方針や全体基準の重複記載を避ける(必要なら `mtp-index` へ参照する)
|
|
91
|
-
- 「関連ドキュメント」セクションは **必須** とし、分冊が無い場合でも `(なし)` または `(本書のみ)` を明記して空欄にしない
|
|
92
|
-
|
|
93
69
|
## 6. 記述ガイド
|
|
94
70
|
|
|
95
71
|
### 6.1. 概要(`index` / `<term>`)
|
|
96
72
|
|
|
97
|
-
生成する本文の見出しは **## 1. 概要(`index` / `<term>`)**
|
|
98
|
-
|
|
99
73
|
- 何のリハーサルを、どの目的で行うかを 1〜3 行で示す
|
|
100
74
|
- `mip-index` と整合すること
|
|
101
75
|
- `mtp-<term>` の場合は「term固有の目的・範囲(何を含み、何を含まないか)」を明記する
|
|
102
76
|
|
|
103
77
|
### 6.2. リハーサル回数とスケジュール
|
|
104
78
|
|
|
105
|
-
生成する本文の見出しは **## 2. リハーサル回数とスケジュール**
|
|
106
|
-
|
|
107
79
|
- 実施回数、実施日程、実施目的を明記する
|
|
108
80
|
- `mtp-<term>` の場合は、term固有の日程と全体日程の関係(ウェーブ順/前提)を明記する
|
|
109
81
|
|
|
110
|
-
推奨フォーマット(表):
|
|
111
|
-
|
|
112
82
|
| 回数 | 予定日 | 目的 | 完了条件 |
|
|
113
83
|
| ---- | ------ | ---- | -------- |
|
|
114
84
|
|
|
115
85
|
### 6.3. テスト環境/データ準備
|
|
116
86
|
|
|
117
|
-
生成する本文の見出しは **## 3. テスト環境/データ準備**
|
|
118
|
-
|
|
119
87
|
- 環境(staging/検証環境等)と前提設定を明記する
|
|
120
88
|
- データ準備(データセットID、初期化/後始末)を明記する
|
|
121
89
|
- 可能なら、データ準備の責任者と手順参照先(runbook等)を示す
|
|
122
90
|
|
|
123
91
|
### 6.4. 検証観点(件数/差分/業務シナリオ)
|
|
124
92
|
|
|
125
|
-
生成する本文の見出しは **## 4. 検証観点(件数/差分/業務シナリオ)**
|
|
126
|
-
|
|
127
93
|
- 件数照合、差分検知、業務シナリオ検証の観点を整理する
|
|
128
94
|
- `dmd-*` で定義した検証(件数/重要値/許容差)と整合すること
|
|
129
95
|
|
|
130
|
-
推奨フォーマット(表):
|
|
131
|
-
|
|
132
96
|
| 観点 | 方法 | 期待値 |
|
|
133
97
|
| ---- | ---- | ------ |
|
|
134
98
|
|
|
135
99
|
### 6.5. 合否基準
|
|
136
100
|
|
|
137
|
-
生成する本文の見出しは **## 5. 合否基準**
|
|
138
|
-
|
|
139
101
|
- 合格基準、許容誤差、判断者を明記する
|
|
140
102
|
- 重要な合否基準(停止許容/差分許容/重大障害)を最低限含める
|
|
141
103
|
|
|
142
|
-
推奨フォーマット(表):
|
|
143
|
-
|
|
144
104
|
| 項目 | 基準 | 判定者 |
|
|
145
105
|
| ---- | ---- | ------ |
|
|
146
106
|
|
|
147
107
|
### 6.6. 差異発生時の扱い(許容/修正/再実行)
|
|
148
108
|
|
|
149
|
-
生成する本文の見出しは **## 6. 差異発生時の扱い(許容/修正/再実行)**
|
|
150
|
-
|
|
151
109
|
- 許容できる差異、修正が必要な差異、再実行条件を明記する
|
|
152
110
|
- 再実行の上限(回数/期限)と判断者を可能な限り明記する
|
|
153
111
|
|
|
154
112
|
### 6.7. 結果報告フォーマット
|
|
155
113
|
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
- 報告に必要な項目(日時/結果/差異/証跡)を明記する
|
|
114
|
+
- 報告に必要な項目(日時/結果/差異/所要時間/証跡/GO・NO-GO案と未決事項)を明記する。未決事項は論点と移行判断への影響を示す
|
|
159
115
|
- 報告先(チケット/共有フォルダ/リポジトリ)を可能な限り明記する
|
|
160
116
|
|
|
161
|
-
推奨フォーマット(表):
|
|
162
|
-
|
|
163
117
|
| 項目 | 記載内容 |
|
|
164
118
|
| ---- | -------- |
|
|
165
119
|
|
|
166
120
|
### 6.8. GO/NO-GO判断プロセス
|
|
167
121
|
|
|
168
|
-
生成する本文の見出しは **## 8. GO/NO-GO判断プロセス**
|
|
169
|
-
|
|
170
122
|
- 判断プロセス、判断主体、必要な証跡を明記する
|
|
171
|
-
- `mtp
|
|
172
|
-
- `mtp-<term>` は term固有の判定点がある場合のみ追記し、全体判断の正は `mtp-index` とする
|
|
123
|
+
- `mtp-<term>` は term固有の判定点がある場合のみ追記する
|
|
173
124
|
|
|
174
125
|
### 6.9. 関連ドキュメント
|
|
175
126
|
|
|
176
|
-
生成する本文の見出しは **## 9. 関連ドキュメント**
|
|
177
|
-
|
|
178
127
|
- `mtp-index` の場合:各 `mtp-<term>`(分冊)への導線を必ず記載する
|
|
179
128
|
- `mtp-<term>` の場合:`mtp-index` への導線(本体SSOT)を必ず記載する
|
|
180
129
|
- 分冊が無い場合でも `(なし)` または `(本書のみ)` を明記する
|
|
181
130
|
|
|
182
|
-
推奨フォーマット(箇条書き):
|
|
183
|
-
|
|
184
|
-
- `<doc-id>`:<説明>
|
|
185
|
-
- `<doc-id>`:<説明>
|
|
186
|
-
|
|
187
131
|
## 7. 禁止事項
|
|
188
132
|
|
|
189
133
|
| 禁止事項 | 理由 |
|
|
@@ -197,158 +141,137 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
197
141
|
|
|
198
142
|
## 8. サンプル(最小・整合版)
|
|
199
143
|
|
|
200
|
-
|
|
144
|
+
以下は架空の対象・日付による最小例である。
|
|
201
145
|
|
|
202
146
|
### 8.1. `mtp-index`(全体SSOT・入口)
|
|
203
147
|
|
|
204
|
-
```
|
|
148
|
+
```markdown
|
|
205
149
|
---
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
status: draft
|
|
210
|
-
|
|
211
|
-
|
|
150
|
+
specdojo:
|
|
151
|
+
id: mtp-index
|
|
152
|
+
type: test
|
|
153
|
+
status: draft
|
|
154
|
+
rulebook: specdojo:mtp-rulebook
|
|
155
|
+
based_on: [mip-index]
|
|
212
156
|
---
|
|
213
157
|
|
|
214
|
-
|
|
158
|
+
# 移行テスト計画: 全体
|
|
215
159
|
|
|
216
|
-
|
|
160
|
+
## 1. 概要(index)
|
|
217
161
|
|
|
218
|
-
|
|
219
|
-
本書は移行テスト計画のSSOTであり、term固有の詳細は `mtp-<term>` に分離する。
|
|
162
|
+
受注システムの移行手順と結果を事前検証する。全体の計画を本書、判定点の詳細を `mtp-cutover-rehearsal` に定める。
|
|
220
163
|
|
|
221
|
-
|
|
164
|
+
## 2. リハーサル回数とスケジュール
|
|
222
165
|
|
|
223
|
-
| 回数 | 予定日 | 目的
|
|
224
|
-
| ---- | ---------- |
|
|
225
|
-
| 1 | 2026-03-01 |
|
|
226
|
-
| 2 | 2026-03-15 | 差異検知と再現確認
|
|
166
|
+
| 回数 | 予定日 | 目的 | 完了条件 |
|
|
167
|
+
| ---- | ---------- | ------------------ | ------------------------ |
|
|
168
|
+
| 1 | 2026-03-01 | 手順の実行確認 | 全工程完了・所要時間計測 |
|
|
169
|
+
| 2 | 2026-03-15 | 差異検知と再現確認 | 差異0または許容内 |
|
|
227
170
|
|
|
228
|
-
|
|
171
|
+
## 3. テスト環境/データ準備
|
|
229
172
|
|
|
230
|
-
-
|
|
231
|
-
- データ: 受注データセット `DS-ORDER-01`
|
|
232
|
-
- 初期化/後始末: リハーサル前に staging を初期化し、終了後は run_id 単位でログを保全する
|
|
173
|
+
staging に受注データセット `DS-ORDER-01` を投入する。実行前に初期化し、終了後は `run_id` 単位でログを保全する。
|
|
233
174
|
|
|
234
|
-
|
|
175
|
+
## 4. 検証観点(件数/差分/業務シナリオ)
|
|
235
176
|
|
|
236
|
-
| 観点 | 方法
|
|
237
|
-
| ------------ |
|
|
238
|
-
| 件数照合 | 旧/新件数比較
|
|
239
|
-
| 差分検知 | 重要項目の差分抽出
|
|
240
|
-
| 業務シナリオ |
|
|
177
|
+
| 観点 | 方法 | 期待値 |
|
|
178
|
+
| ------------ | ------------------ | --------------------------- |
|
|
179
|
+
| 件数照合 | 旧/新件数比較 | 差分0 |
|
|
180
|
+
| 差分検知 | 重要項目の差分抽出 | `dmd-order-data` の許容差内 |
|
|
181
|
+
| 業務シナリオ | 受注→請求を実行 | 成功・重大障害0 |
|
|
241
182
|
|
|
242
|
-
|
|
183
|
+
## 5. 合否基準
|
|
243
184
|
|
|
244
|
-
| 項目 | 基準
|
|
245
|
-
| ---------- |
|
|
246
|
-
| 件数差異 | 0
|
|
247
|
-
| 重要値差異 |
|
|
248
|
-
| 所要時間 |
|
|
249
|
-
| 重大障害 | 0
|
|
185
|
+
| 項目 | 基準 | 判定者 |
|
|
186
|
+
| ---------- | ---------------------------- | ---------- |
|
|
187
|
+
| 件数差異 | 0 | 業務責任者 |
|
|
188
|
+
| 重要値差異 | 「検証観点」の許容差内 | 業務責任者 |
|
|
189
|
+
| 所要時間 | `mip-index` の停止許容時間内 | 運用責任者 |
|
|
190
|
+
| 重大障害 | 0 | PO |
|
|
250
191
|
|
|
251
|
-
|
|
192
|
+
## 6. 差異発生時の扱い(許容/修正/再実行)
|
|
252
193
|
|
|
253
|
-
-
|
|
254
|
-
-
|
|
255
|
-
-
|
|
194
|
+
- 許容差内: 本番影響がないことを確認し、原因とともに記録する。
|
|
195
|
+
- 許容差超: 原因修正後に最大1回再実行する。移行責任者が判断する。
|
|
196
|
+
- 重大障害: NO-GO候補としてPOへエスカレーションする。
|
|
256
197
|
|
|
257
|
-
|
|
198
|
+
## 7. 結果報告フォーマット
|
|
258
199
|
|
|
259
|
-
|
|
260
|
-
| -------- | ------------------------------------ |
|
|
261
|
-
| 日時 | 実施日/開始終了時刻 |
|
|
262
|
-
| 結果 | 合格/不合格 |
|
|
263
|
-
| 差異 | 差分件数・重要値差分・原因/対応 |
|
|
264
|
-
| 所要時間 | 全体/主要工程別 |
|
|
265
|
-
| 証跡 | ログ/レポート参照先(run_id, URL等) |
|
|
266
|
-
| 判断 | GO/NO-GO案、未解決事項 |
|
|
200
|
+
チケットに次の項目を記録する。
|
|
267
201
|
|
|
268
|
-
|
|
202
|
+
| 項目 | 記載内容 |
|
|
203
|
+
| -------- | -------------------------------- |
|
|
204
|
+
| 日時 | 実施日・開始終了時刻 |
|
|
205
|
+
| 結果 | 合格/不合格 |
|
|
206
|
+
| 差異 | 差分件数・重要値差分・原因/対応 |
|
|
207
|
+
| 所要時間 | 全体/主要工程別 |
|
|
208
|
+
| 証跡 | `run_id` とログ・レポート参照先 |
|
|
209
|
+
| 判断 | GO/NO-GO案、未決の論点と本番影響 |
|
|
269
210
|
|
|
270
|
-
|
|
271
|
-
- 判断入力: リハーサル結果報告、差分一覧、重大障害一覧、所要時間計測
|
|
272
|
-
- 判断結果: GO / 条件付きGO / NO-GO(延期)
|
|
211
|
+
## 8. GO/NO-GO判断プロセス
|
|
273
212
|
|
|
274
|
-
|
|
213
|
+
移行責任者が結果報告・差分一覧・重大障害一覧・所要時間を集約し、POがGO / 条件付きGO / NO-GO(延期)を判断する。
|
|
275
214
|
|
|
276
|
-
|
|
277
|
-
- (必要に応じて追加)`mtp-wave1`:ウェーブ1のリハーサル計画(環境/データセット/合否基準の差分)
|
|
278
|
-
- (必要に応じて追加)`mtp-wave2`:ウェーブ2のリハーサル計画(環境/データセット/合否基準の差分)
|
|
215
|
+
## 9. 関連ドキュメント
|
|
279
216
|
|
|
280
|
-
|
|
217
|
+
- `mtp-cutover-rehearsal`: カットオーバーの判定点とロールバック前提。
|
|
218
|
+
```
|
|
281
219
|
|
|
282
220
|
### 8.2. `mtp-<term>`(個別:例)
|
|
283
221
|
|
|
284
|
-
```
|
|
222
|
+
```markdown
|
|
285
223
|
---
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
status: draft
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
- dmd-order-data
|
|
293
|
-
supersedes: []
|
|
224
|
+
specdojo:
|
|
225
|
+
id: mtp-cutover-rehearsal
|
|
226
|
+
type: test
|
|
227
|
+
status: draft
|
|
228
|
+
rulebook: specdojo:mtp-rulebook
|
|
229
|
+
based_on: [mip-index]
|
|
294
230
|
---
|
|
295
|
-
```
|
|
296
231
|
|
|
297
|
-
|
|
232
|
+
# 移行テスト計画: カットオーバーリハーサル
|
|
298
233
|
|
|
299
|
-
|
|
300
|
-
共通の合否基準とGO/NO-GO判断は `mtp-index` を正とし、本書は term 固有の詳細のみを扱う。
|
|
234
|
+
## 1. 概要(cutover-rehearsal)
|
|
301
235
|
|
|
302
|
-
|
|
236
|
+
受付停止〜差分抽出〜投入〜接続切替〜利用開始の判定点GO1〜GO5と所要時間を確認する。共通基準は `mtp-index` に従う。
|
|
303
237
|
|
|
304
|
-
|
|
305
|
-
| ---- | ---------- | ------------------ | ----------------- |
|
|
306
|
-
| 1 | 2026-03-01 | 手順の実行確認 | 全工程完了 |
|
|
307
|
-
| 2 | 2026-03-15 | 差異検知と再現確認 | 差異0または許容内 |
|
|
238
|
+
## 2. リハーサル回数とスケジュール
|
|
308
239
|
|
|
309
|
-
|
|
240
|
+
全体日程の第1回で全工程の実行、第2回で差異0または許容内であることを確認する。
|
|
310
241
|
|
|
311
|
-
|
|
312
|
-
- データ: `DS-ORDER-01`
|
|
313
|
-
- 実行前条件: 旧系相当データが投入済みであること、外部I/Fは sandbox 接続であること
|
|
242
|
+
## 3. テスト環境/データ準備
|
|
314
243
|
|
|
315
|
-
|
|
244
|
+
`mtp-index` の staging・データセットを使用する。旧系相当データの投入と外部I/Fの sandbox 接続を開始条件とする。
|
|
316
245
|
|
|
317
|
-
|
|
318
|
-
| -------------- | ------------------------------ | -------- |
|
|
319
|
-
| 判定点の成立性 | GO1〜GO5での完了条件チェック | 全て成立 |
|
|
320
|
-
| スモーク | 切替後に代表API/画面を確認 | 成功 |
|
|
321
|
-
| 差分検知 | 抽出〜投入ログと差分一覧の確認 | 許容差内 |
|
|
246
|
+
## 4. 検証観点(件数/差分/業務シナリオ)
|
|
322
247
|
|
|
323
|
-
|
|
248
|
+
| 観点 | 方法 | 期待値 |
|
|
249
|
+
| -------- | ------------------------------------------------ | --------------------------- |
|
|
250
|
+
| 判定点 | `cop-cutover-runbook` のGO1〜GO5の完了条件を確認 | 全て成立 |
|
|
251
|
+
| スモーク | GO4の接続切替後に代表API/画面を確認 | 全項目成功 |
|
|
252
|
+
| 差分検知 | 抽出〜投入ログと差分一覧を照合 | `dmd-order-data` の許容差内 |
|
|
324
253
|
|
|
325
|
-
|
|
326
|
-
| ------------------------- | -------------- | ---------- |
|
|
327
|
-
| GO4(接続切替)後スモーク | 全項目成功 | 運用責任者 |
|
|
328
|
-
| 主要工程所要時間 | 停止許容時間内 | 運用責任者 |
|
|
329
|
-
| 重大障害 | 0 | PO |
|
|
254
|
+
## 5. 合否基準
|
|
330
255
|
|
|
331
|
-
|
|
256
|
+
共通基準は `mtp-index` に従う。運用責任者がGO4後のスモーク全項目成功と主要工程の停止許容時間内での完了を、POが重大障害0を判定する。
|
|
332
257
|
|
|
333
|
-
|
|
334
|
-
- GO4で失敗:接続先を旧系へ戻す(ロールバック)→ NO-GO(延期)案。
|
|
335
|
-
- 軽微な差異:許容差内なら記録し、次回までに原因調査。
|
|
258
|
+
## 6. 差異発生時の扱い(許容/修正/再実行)
|
|
336
259
|
|
|
337
|
-
|
|
260
|
+
- GO2/GO3失敗: 原因修正後に最大1回再実行し、不可ならNO-GO案とする。
|
|
261
|
+
- GO4失敗: 接続先を旧系へ戻し、NO-GO案とする。
|
|
262
|
+
- 軽微な差異: 許容差内なら記録し、次回までに原因を調査する。
|
|
338
263
|
|
|
339
|
-
|
|
264
|
+
## 7. 結果報告フォーマット
|
|
340
265
|
|
|
341
|
-
|
|
342
|
-
| ------------ | -------------------------------------------- |
|
|
343
|
-
| 判定点 | GO1〜GO5の結果(完了条件/実績時刻/所要時間) |
|
|
344
|
-
| ロールバック | 実施の有無、実施理由、復旧完了時刻 |
|
|
266
|
+
`mtp-index` のチケットに共通項目を記録し、GO1〜GO5の完了条件・実績時刻・所要時間、ロールバックの有無・理由・復旧完了時刻を加える。
|
|
345
267
|
|
|
346
|
-
|
|
268
|
+
## 8. GO/NO-GO判断プロセス
|
|
347
269
|
|
|
348
|
-
|
|
270
|
+
個別判定点の結果を記録し、全体判断は `mtp-index` に従う。
|
|
349
271
|
|
|
350
|
-
|
|
272
|
+
## 9. 関連ドキュメント
|
|
351
273
|
|
|
352
|
-
- `mtp-index
|
|
353
|
-
- `cop-cutover-runbook
|
|
354
|
-
- `dmd-order-data
|
|
274
|
+
- `mtp-index`: 全体方針・合否基準・判断プロセス。
|
|
275
|
+
- `cop-cutover-runbook`: 判定点と当日手順。
|
|
276
|
+
- `dmd-order-data`: 抽出・変換・検証の詳細。
|
|
277
|
+
```
|
|
@@ -13,20 +13,19 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
Non-Functional Requirements Availability Documentation Rules
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
可用性要件は、業務継続に必要な稼働率と復旧目標を定量で記述する。
|
|
16
|
+
本書は、非機能要件のうち可用性(停止許容・復旧目標)を定義する `nfr-availability` の作成ルールを定める。
|
|
18
17
|
|
|
19
18
|
## 1. 全体方針
|
|
20
19
|
|
|
21
|
-
- 可用性は稼働率、許容停止時間、RTO/RPO
|
|
20
|
+
- 可用性は稼働率、許容停止時間、RTO/RPO で定量的に定義する。
|
|
22
21
|
- 対象時間帯と除外条件(計画メンテ等)を必ず明記する。
|
|
23
|
-
-
|
|
22
|
+
- 監視・復旧判断に結びつけて要件化する。
|
|
23
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。文書の整形・lint はリポジトリの検証で扱い、「測定・検証方法」に含めない。
|
|
24
24
|
|
|
25
25
|
## 2. 位置づけと用語定義(必要に応じて)
|
|
26
26
|
|
|
27
27
|
### 2.1. 位置づけ
|
|
28
28
|
|
|
29
|
-
- `nfr-availability`:可用性要求の正本
|
|
30
29
|
- `nfr-index`:NFR全体の入口
|
|
31
30
|
- `sac-*` / `stc-*`:可用性要件の検証先
|
|
32
31
|
- `opd-*` / `opr-*`:障害対応・復旧手順
|
|
@@ -49,19 +48,14 @@ Non-Functional Requirements Availability Documentation Rules
|
|
|
49
48
|
|
|
50
49
|
### 4.1. 設定内容
|
|
51
50
|
|
|
52
|
-
|
|
51
|
+
許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
|
|
53
52
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
| id | `nfr-availability` | ○ |
|
|
57
|
-
| type | `requirement` 固定 | ○ |
|
|
58
|
-
| title | 非機能要件: 可用性 | ○ |
|
|
59
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
-
| part_of | `nfr-index` | 任意 |
|
|
53
|
+
- `specdojo.id` は `nfr-availability`、`specdojo.type` は `requirement`、`specdojo.rulebook` は `specdojo:nfr-availability-rulebook` とする。
|
|
54
|
+
- `specdojo.part_of` には `nfr-index` を置く。
|
|
61
55
|
|
|
62
56
|
### 4.2. 推奨ルール
|
|
63
57
|
|
|
64
|
-
-
|
|
58
|
+
- 重要業務時間帯(営業時間、締め時刻)の根拠文書を `specdojo.based_on` に挙げ、本文の対象時間帯と揃える。
|
|
65
59
|
|
|
66
60
|
## 5. 本文構成(標準テンプレ)
|
|
67
61
|
|
|
@@ -100,13 +94,13 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
100
94
|
|
|
101
95
|
生成する本文の見出しは **## 4. 測定・検証方法**
|
|
102
96
|
|
|
103
|
-
-
|
|
97
|
+
- 要件IDごとに、監視値・障害訓練・復旧試験による測定方法と判定時期を定める。
|
|
104
98
|
|
|
105
99
|
### 6.5. 関連ドキュメント導線
|
|
106
100
|
|
|
107
101
|
生成する本文の見出しは **## 5. 関連ドキュメント導線**
|
|
108
102
|
|
|
109
|
-
- `
|
|
103
|
+
- 「位置づけ」の文書と設計判断の `dec-*` を、種別・ドキュメントID・目的の表で紐づける。
|
|
110
104
|
|
|
111
105
|
## 7. 禁止事項
|
|
112
106
|
|
|
@@ -118,68 +112,48 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
118
112
|
|
|
119
113
|
## 8. サンプル
|
|
120
114
|
|
|
121
|
-
|
|
115
|
+
注:形式の輪郭を示す最小例。成果物の見出しは `## 1...` から始まる。
|
|
122
116
|
|
|
123
117
|
```yaml
|
|
124
118
|
---
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
status: draft
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
supersedes: []
|
|
119
|
+
specdojo:
|
|
120
|
+
id: nfr-availability
|
|
121
|
+
type: requirement
|
|
122
|
+
status: draft
|
|
123
|
+
rulebook: specdojo:nfr-availability-rulebook
|
|
124
|
+
part_of: [nfr-index]
|
|
132
125
|
---
|
|
133
126
|
```
|
|
134
127
|
|
|
135
128
|
### 8.1. 概要(対象・目的)(例)
|
|
136
129
|
|
|
137
|
-
本書は、GCS
|
|
138
|
-
非機能要件を定義する。
|
|
139
|
-
業務継続に必要な稼働率と障害時の復旧目標を定量化し、SLA および障害対応の
|
|
140
|
-
判断基準として運用する。
|
|
130
|
+
本書は、GCS 基幹システムの稼働率と復旧目標を定量化し、障害対応の判断基準とする。
|
|
141
131
|
|
|
142
132
|
### 8.2. 適用範囲・除外条件(例)
|
|
143
133
|
|
|
144
|
-
| 項目 | 内容
|
|
145
|
-
| ------------ |
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
| 計画停止除外 | 月次メンテナンス(第2日曜 02:00–06:00) |
|
|
149
|
-
| 外部依存除外 | 決済 PSP 障害・物流 API 障害 |
|
|
150
|
-
| 測定開始時点 | 本番リリース後の初回稼働月から |
|
|
134
|
+
| 項目 | 内容 |
|
|
135
|
+
| ------------ | --------------------------------------- |
|
|
136
|
+
| 対象時間帯 | 24 時間 365 日 |
|
|
137
|
+
| 計画停止除外 | 月次メンテナンス(第2日曜 02:00–06:00) |
|
|
151
138
|
|
|
152
139
|
### 8.3. 可用性要件一覧(例)
|
|
153
140
|
|
|
154
|
-
| id | 内容 | 指標 | 基準
|
|
155
|
-
| ----------- | ----------------------------------------- | ---------- |
|
|
156
|
-
| nfr-avl-001 | 基幹 API は月間稼働率を維持する | 月間稼働率 | 99.9% 以上
|
|
157
|
-
| nfr-avl-002 | P1 障害時は目標時間内に復旧する | RTO | 60 分以内
|
|
158
|
-
| nfr-avl-003 | P1 障害時のデータ損失を目標範囲内に収める | RPO | 5 分以内
|
|
159
|
-
| nfr-avl-004 | P2 障害時は目標時間内に復旧する | RTO | 4 時間以内 | 営業時間内対応 |
|
|
160
|
-
| nfr-avl-005 | 単一ノード障害でサービスを継続できること | 冗長構成 | Active-Standby | フェイルオーバー 30 秒以内 |
|
|
161
|
-
| nfr-avl-006 | バッチ処理の計画時間超過を防止する | 完了率 | 99% 以上 | 日次バッチ対象 |
|
|
162
|
-
| nfr-avl-007 | DR サイト切替は基準時間内に完了すること | DR-RTO | 4 時間以内 | 年次 DR 訓練で検証 |
|
|
141
|
+
| id | 内容 | 指標 | 基準 | 備考 |
|
|
142
|
+
| ----------- | ----------------------------------------- | ---------- | ---------- | ---------------------- |
|
|
143
|
+
| nfr-avl-001 | 基幹 API は月間稼働率を維持する | 月間稼働率 | 99.9% 以上 | 計画停止除外 |
|
|
144
|
+
| nfr-avl-002 | P1 障害時は目標時間内に復旧する | RTO | 60 分以内 | OPR 手順で検証 |
|
|
145
|
+
| nfr-avl-003 | P1 障害時のデータ損失を目標範囲内に収める | RPO | 5 分以内 | WAL + レプリケーション |
|
|
163
146
|
|
|
164
147
|
### 8.4. 測定・検証方法(例)
|
|
165
148
|
|
|
166
|
-
| 要件ID | 測定方法 | 判定タイミング
|
|
167
|
-
| ----------- | ---------------------------------------------- |
|
|
168
|
-
| nfr-avl-001 | 外形監視(HTTP ヘルスチェック 1 分間隔)で算出 | 月次運用レビュー
|
|
169
|
-
| nfr-avl-002 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー
|
|
170
|
-
| nfr-avl-003 | バックアップ復元試験でデータ差分を確認 | 四半期復元試験
|
|
171
|
-
| nfr-avl-004 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー | SRE |
|
|
172
|
-
| nfr-avl-005 | フェイルオーバー試験で切替時間を計測 | リリース前 / 四半期 | Infra / SRE |
|
|
173
|
-
| nfr-avl-006 | バッチジョブ監視ダッシュボードで完了率を集計 | 日次確認 | Ops |
|
|
174
|
-
| nfr-avl-007 | 年次 DR 訓練の実測値 | 年次 DR 訓練 | SRE / PM |
|
|
149
|
+
| 要件ID | 測定方法 | 判定タイミング |
|
|
150
|
+
| ----------- | ---------------------------------------------- | ---------------- |
|
|
151
|
+
| nfr-avl-001 | 外形監視(HTTP ヘルスチェック 1 分間隔)で算出 | 月次運用レビュー |
|
|
152
|
+
| nfr-avl-002 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー |
|
|
153
|
+
| nfr-avl-003 | バックアップ復元試験でデータ差分を確認 | 四半期復元試験 |
|
|
175
154
|
|
|
176
155
|
### 8.5. 関連ドキュメント導線(例)
|
|
177
156
|
|
|
178
|
-
| 種別
|
|
179
|
-
|
|
|
180
|
-
|
|
|
181
|
-
| 受入条件 | sac-\* | 可用性要件の合否判定基準 | 必須 |
|
|
182
|
-
| システム試験 | stc-\* | フェイルオーバー・DR 試験 | 必須 |
|
|
183
|
-
| 運用設計 | opd-\* | 監視・アラート・復旧判断基準 | 必須 |
|
|
184
|
-
| 運用手順 | opr-\* | 障害一次対応・DR 切替手順 | 必須 |
|
|
185
|
-
| 判断記録 | dec-\* | 冗長構成・DR 方式の設計判断 | 任意 |
|
|
157
|
+
| 種別 | ドキュメントID | 目的 |
|
|
158
|
+
| -------- | -------------- | ------------------------ |
|
|
159
|
+
| 受入条件 | sac-\* | 可用性要件の合否判定基準 |
|