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
|
@@ -3,330 +3,103 @@ specdojo:
|
|
|
3
3
|
id: specdojo:bac-rulebook
|
|
4
4
|
type: rulebook
|
|
5
5
|
deliverable_type: requirement
|
|
6
|
-
status:
|
|
7
|
-
|
|
6
|
+
status: ready
|
|
7
|
+
target_format: markdown
|
|
8
|
+
recipe: specdojo:bac-recipe
|
|
8
9
|
sample: specdojo:bac-sample
|
|
9
|
-
template:
|
|
10
|
+
template: specdojo:bac-template
|
|
10
11
|
---
|
|
11
12
|
|
|
12
13
|
# 業務受入条件 作成ルール
|
|
13
14
|
|
|
14
|
-
Business Acceptance Criteria
|
|
15
|
+
Business Acceptance Criteria Documentation Rulebook
|
|
15
16
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
BAC は「業務側から見て、このシステムで業務が回せる」ことを確認するための受入条件を定義します。
|
|
17
|
+
業務担当者が「この仕組みで業務を進められる」と判断するための受入条件を、受入テスト設計に渡せる粒度で定めます。
|
|
19
18
|
|
|
20
19
|
## 1. 全体方針
|
|
21
20
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
21
|
+
- [[specdojo:deliverables-reference|成果物リファレンス]] の業務受入条件として、業務仕様が利用者の課題を解決するかを合意・確認する基準を定める。仕様が存在するだけでは業務を進められると判断できないため、利用場面と確認できる結果へ具体化する。
|
|
22
|
+
- 1 文書で一つの受入対象(一連の結果として業務担当者が受け入れる業務の範囲)を扱い、対象者の課題と期待価値に結び付くシナリオを選ぶ。
|
|
23
|
+
- 決定済みの業務仕様を受入条件へ変換する。新しい業務判断、閾値、例外承認を BAC で確定しない。
|
|
24
|
+
- 期待結果は状態、記録、引き継ぎなど観測できる事実にする。実装や画面の手順を受入基準の代替にしない。
|
|
25
|
+
- 共通事項は上位の index・標準を正本とし、構文・値・保存構造は schema・リファレンスへ委譲する。
|
|
26
|
+
- 共通の運用: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
|
|
27
|
+
|
|
28
|
+
## 2. 位置づけ
|
|
26
29
|
|
|
27
|
-
|
|
30
|
+
BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に業務としての成立を確認する要求であり、設計と受入テスト設計への入力になる。テストの詳細手順と実行結果は含めない。
|
|
28
31
|
|
|
29
|
-
|
|
30
|
-
| -------- | ------------------------------------------------------ |
|
|
31
|
-
| BAC | 業務受入条件。業務側の観点での受け入れ基準(期待結果) |
|
|
32
|
-
| 受入対象 | 業務として実現したい能力(例: 商品販売) |
|
|
33
|
-
| シナリオ | 具体的な業務シナリオ(例: 顧客が商品を購入する) |
|
|
34
|
-
| 前提 | シナリオ開始前の条件(前提状態、準備) |
|
|
35
|
-
| 操作 | 業務の実行(業務イベントや操作の要約) |
|
|
36
|
-
| 期待結果 | 観測可能な事実(状態変化、記録、通知など) |
|
|
32
|
+
[[specdojo:track-design-guide|トラック設計ガイド]] の品質仕様カテゴリで業務仕様を受け取り、受入テスト仕様とその実施へ渡す。BPS の業務の流れ、BR の判断規則、UIS の利用者操作、BES の業務イベントを業務の開始から結果まで横断して確認し、各仕様の定義は入力元を正本とする。
|
|
37
33
|
|
|
38
34
|
## 3. ファイル命名・ID規則
|
|
39
35
|
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
- `title`: 「業務受入条件: 商品販売」など。
|
|
36
|
+
- ファイル名は受入対象を表す `bac-<subject>.md` を推奨し、配置は成果物カタログに従う。連番や日本語名を採用する場合は、同じ対象の ID とパスの対応をカタログで一意にし、表示順や表示名の変更だけでは ID を変えない。
|
|
37
|
+
- 新規 ID は `<project-id>:bac-<subject>` のようにプロジェクトを表す authority と対象のローカル ID を組み合わせる。既存文書は宣言された ID を使い、ファイル名から別の ID を推測しない。共通規則は [[specdojo:docs-structure-guide|ドキュメント構造ガイド]] に従う。
|
|
38
|
+
- シナリオには文書内で一意な識別子を付ける。ケース表を用いる場合も行 ID を持たせ、根拠やテスト設計から追跡できるようにする。
|
|
44
39
|
|
|
45
40
|
## 4. 推奨 Frontmatter 項目
|
|
46
41
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
| 項目 | 説明 | 必須 |
|
|
50
|
-
| ---- | ---- | ---- |
|
|
51
|
-
|
|
52
|
-
| id | 受入条件ID(`bac-...`) | ○ |
|
|
53
|
-
| type | `requirement` 固定 | ○ |
|
|
54
|
-
| title | 受入条件名(例: 業務受入条件: 商品販売) | ○ |
|
|
55
|
-
| status | `draft`/`ready`/`deprecated` | ○ |
|
|
56
|
-
| part_of | 上位BAC ID(分割している場合) | 任意 |
|
|
57
|
-
| based_on | 根拠となる仕様ID(BPS/BR/UIS/BES/BEL 等) | 任意 |
|
|
58
|
-
| supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
|
|
59
|
-
|
|
60
|
-
推奨:
|
|
61
|
-
|
|
62
|
-
- `based_on` に、受入対象の仕様IDを列挙します(例: `bps-...`, `br-...`, `uis-...`, `bes-...`)。
|
|
63
|
-
- BR や BPS 側の `tests` から BAC を参照できるよう、ID は安定させます(名前を変える場合は `supersedes` を使う)。
|
|
64
|
-
|
|
65
|
-
## 5. 本文構成(標準テンプレ)
|
|
66
|
-
|
|
67
|
-
各 BAC ファイルは以下の見出しを順番に並べます。
|
|
68
|
-
|
|
69
|
-
1. 概要
|
|
70
|
-
2. 受入条件
|
|
71
|
-
3. メモ / 将来課題
|
|
72
|
-
|
|
73
|
-
## 6. 記述ガイド詳細
|
|
42
|
+
メタ情報の型・許可値・キーの配置・必須項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
|
|
74
43
|
|
|
75
|
-
|
|
44
|
+
- `type` は業務受入基準を表す `requirement` とし、必須の `rulebook` に本 rulebook の ID を宣言する。
|
|
45
|
+
- `based_on` は受入条件の根拠となる先行成果物を示す。カタログ管理下では `depends_on` の範囲に従い、プロジェクト文脈をそのまま転記しない。
|
|
46
|
+
- `part_of` は親 BAC がある場合、`supersedes` は旧 BAC を置き換える場合に用いる。
|
|
47
|
+
- 要求の充足やテストからの検証関係はメタ情報標準の「型付き参照」を使う。根拠を示す `based_on` と区別し、独自の関係キーを追加しない。
|
|
76
48
|
|
|
77
|
-
|
|
78
|
-
- 可能であれば、対象の業務イベント(BEV)や業務プロセス(BPS)を言及し、`based_on` と整合させます。
|
|
49
|
+
## 5. 本文要件
|
|
79
50
|
|
|
80
|
-
|
|
51
|
+
見出し順・表・記入欄の骨組みは frontmatter で宣言した template を正本とする。内容の成立条件は次のとおり。
|
|
81
52
|
|
|
82
|
-
|
|
83
|
-
|
|
53
|
+
| 扱う内容 | 必須 | 成立条件 |
|
|
54
|
+
| --------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
55
|
+
| 概要 | ○ | 受入対象、対象者、守る価値、利用場面、対象範囲と対象外、根拠が分かる。業務側の確認者と合意対象を示す |
|
|
56
|
+
| 受入条件 | ○ | シナリオごとに ID、根拠、前提、操作、期待結果、判定方法を対応させる。正常経路と、業務上結果が異なる例外・停止・再開を必要な範囲で扱う |
|
|
57
|
+
| メモ / 将来課題 | ○ | 未確定事項の論点と、影響するシナリオ・当面の扱いを記す。未決がなければ「なし」と明記する |
|
|
84
58
|
|
|
85
|
-
###
|
|
59
|
+
### 5.1. シナリオの記述規約
|
|
86
60
|
|
|
87
|
-
|
|
61
|
+
- 前提は開始時点の状態、必要な入力、権限を記す。共通前提は受入条件の冒頭に一度だけ置き、例外シナリオでは異なる前提を明示する。
|
|
62
|
+
- 操作は担当者による業務行為を示す。期待結果は操作後の変化に加え、停止時に確定してはならない記録と次の担当への引き継ぎを示す。
|
|
63
|
+
- 判定方法は必須とし、期待結果の各項目に確認者、確認時点、観測先(記録・画面・帳票等)、照合対象を対応させる。前提と入力から期待結果を導けない箇所は未決事項へ送る。
|
|
64
|
+
- 同じ操作と観測点で条件だけが変わる場合はケース表へまとめてよい。停止範囲や再開先が異なる場合はシナリオを分ける。
|
|
88
65
|
|
|
89
|
-
|
|
66
|
+
### 5.2. 確認完了の条件
|
|
90
67
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
68
|
+
- 概要の価値・対象範囲に必要なシナリオがそろい、各シナリオの根拠と `based_on` が有効な先行成果物へ解決できる。カタログ管理下では依存関係とも整合する。
|
|
69
|
+
- 全シナリオに前提・操作・観測可能な期待結果・判定方法があり、正常経路と必要な例外・停止・再開を判断できる。
|
|
70
|
+
- 受入の合否を左右する未確定事項が残っていない。文書の確定を受入試行の合格実績とは扱わない。
|
|
94
71
|
|
|
95
|
-
|
|
72
|
+
## 6. 記述ガイド
|
|
96
73
|
|
|
97
|
-
|
|
98
|
-
- `#### 前提`(箇条書き)
|
|
99
|
-
- `#### 操作`(箇条書き。クリック手順の逐語列挙ではなく、業務行為として要約)
|
|
100
|
-
- `#### 期待結果`(箇条書き。状態変化/記録/通知などの観測点)
|
|
101
|
-
- `#### 判定方法`(任意。どこを見て合否判定するか)
|
|
74
|
+
### 6.1. 概要
|
|
102
75
|
|
|
103
|
-
|
|
76
|
+
- 判断基準: 対象者の業務課題・期待価値、利用場面、対象範囲と対象外、業務側の確認者・合意者を必ず記す。各価値をどのシナリオ ID で確認するかを示し、対象外を別 BAC で扱う場合は参照先を添える。上位の Why は要約と参照で引き継ぐ。
|
|
77
|
+
- 良い例: 「家族が店番しても販売と在庫を記録して引き継げることを BAC-01 で確認し、店主代表が受入に合意する。返品と仕入れは対象外とする」。
|
|
78
|
+
- 悪い例: 「システムが正常に動くこと」。利用者、対象、成立する業務が不明である。
|
|
104
79
|
|
|
105
|
-
|
|
106
|
-
- 「操作」は業務イベントや業務行為に寄せ、UI は必要最低限の要約に留める。
|
|
107
|
-
- 「期待結果」は検証不能な曖昧表現(「正しく処理される」等)を避け、観測できる事実に分解する。
|
|
80
|
+
### 6.2. 受入条件
|
|
108
81
|
|
|
109
|
-
|
|
82
|
+
- 判断基準: 前提と操作から期待結果が決まり、確認者が証跡で合否を判断できること。業務仕様の判断自体は参照先を正本とする。
|
|
83
|
+
- 良い例: 「在庫が 5 個の商品の 2 個販売を確定する。販売記録が 1 件残り、在庫が 3 個になる。家族利用者代表が確定後に両記録を照合する」。
|
|
84
|
+
- 悪い例: 「確定ボタンを押すと正しく処理される」。観測点がなく、画面操作に依存している。
|
|
110
85
|
|
|
111
|
-
|
|
86
|
+
#### 6.2.1. 差分と例外の書き分け
|
|
112
87
|
|
|
113
|
-
-
|
|
114
|
-
-
|
|
88
|
+
- ケース表の推奨列は「ケース ID / 条件・入力 / 期待結果(観測点)」。操作と判定方法は共通部分に置き、同じ内容を各行に繰り返さない。
|
|
89
|
+
- 良い例: 同じ販売操作で数量だけが異なる場合は表にまとめ、記録不能の場合は別シナリオで未確定の状態と引き継ぎ先を示す。
|
|
90
|
+
- 悪い例: 正常完了、入力不足、再開を一つの「エラーなら対応する」にまとめる。業務を続けられる条件が判別できない。
|
|
115
91
|
|
|
116
|
-
|
|
92
|
+
### 6.3. メモ / 将来課題
|
|
117
93
|
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
| ケース | 条件/入力 | 操作 | 期待結果(観測点) |
|
|
124
|
-
| ------ | --------- | ---- | ------------------ |
|
|
125
|
-
| C1 | … | … | … |
|
|
126
|
-
|
|
127
|
-
※ ケース表を使う場合でも、「期待結果(観測点)」は検証可能な事実として具体化してください。
|
|
128
|
-
|
|
129
|
-
### 6.3 メモ / 将来課題
|
|
130
|
-
|
|
131
|
-
- 未確定の運用(例: 締め処理、例外時の扱い)や、将来追加したい Scenario を記録します。
|
|
94
|
+
- 判断基準: 現行の受入を止める論点と将来の拡張を区別でき、影響するシナリオと当面の扱いが分かること。確認・追記作業には `_TODO_`、意思決定待ちには `_UNDECIDED_` を付け、解決したら確定内容へ更新してラベルを外す。
|
|
95
|
+
- 将来追加するシナリオは対象外の範囲と追加条件を残す。`based_on` 先や受入範囲の変更時は影響するシナリオと期待値を特定し、変更後の業務条件が確定するまで旧条件で受入を確定しない。
|
|
96
|
+
- 良い例: 「`_UNDECIDED_`: 記録不能時に販売を続けるか。現行は記録可能な場合に限定し、当該経路の受入は保留して現行シナリオの合格で代替しない」。
|
|
97
|
+
- 悪い例: 「例外は今後検討」。影響範囲と当面の扱いが不明である。
|
|
132
98
|
|
|
133
99
|
## 7. 禁止事項
|
|
134
100
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
| 期待結果が曖昧(「正しく処理される」等) | 検証不能 |
|
|
141
|
-
|
|
142
|
-
## 8. よくある誤りと対策
|
|
143
|
-
|
|
144
|
-
- シナリオが UI 手順書になっている → 「操作」を業務行為に要約し、「期待結果」を観測可能な事実に寄せる。
|
|
145
|
-
- 期待結果が 10 個以上に肥大 → シナリオを分割するか、期待結果を整理(“必須の観測点”に絞る)。
|
|
146
|
-
- 例外系が抜けている → 代表的な異常(在庫不足、入力不備、締め済み等)をシナリオで追加する。
|
|
147
|
-
|
|
148
|
-
## 9. サンプル(簡易)
|
|
149
|
-
|
|
150
|
-
```markdown
|
|
151
|
-
---
|
|
152
|
-
id: bac-sale-checkout
|
|
153
|
-
type: requirement
|
|
154
|
-
title: 業務受入条件: 商品販売
|
|
155
|
-
status: draft
|
|
156
|
-
part_of: []
|
|
157
|
-
based_on:
|
|
158
|
-
- bps-sale-checkout
|
|
159
|
-
- bes-sale-checkout
|
|
160
|
-
- br-sale-total-calc
|
|
161
|
-
supersedes: []
|
|
162
|
-
---
|
|
163
|
-
|
|
164
|
-
## 概要
|
|
165
|
-
|
|
166
|
-
レジ会計時に、商品販売(会計確定)が業務として成立し、売上と在庫が正しく記録されること。
|
|
167
|
-
|
|
168
|
-
## 受入条件
|
|
169
|
-
|
|
170
|
-
### シナリオ: 顧客が商品を購入する
|
|
171
|
-
|
|
172
|
-
#### 前提
|
|
173
|
-
|
|
174
|
-
- 顧客がレジに商品を持参している
|
|
175
|
-
- 商品の在庫が十分にある
|
|
176
|
-
|
|
177
|
-
#### 操作
|
|
178
|
-
|
|
179
|
-
- レジ担当者が会計を確定する
|
|
180
|
-
|
|
181
|
-
#### 期待結果
|
|
182
|
-
|
|
183
|
-
- 売上が記録される
|
|
184
|
-
- 商品の在庫が減少する
|
|
185
|
-
|
|
186
|
-
## メモ / 将来課題
|
|
187
|
-
|
|
188
|
-
- 将来: 返品・取消の受入条件を追加する。
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
### 9.2 サンプル(複合・長め)
|
|
192
|
-
|
|
193
|
-
「複合シナリオ」の例です(発注→入荷→請求→支払までの一連を、同一の受入対象として確認)。
|
|
194
|
-
|
|
195
|
-
ここでは、レビューしやすさのために **同一受入対象に対する代表パターン(正常系)と例外(差異)** を、別シナリオとして並べています。
|
|
196
|
-
|
|
197
|
-
```markdown
|
|
198
|
-
---
|
|
199
|
-
id: bac-procurement-order-to-payment
|
|
200
|
-
type: requirement
|
|
201
|
-
title: 業務受入条件: 仕入(発注〜入荷〜支払)
|
|
202
|
-
status: draft
|
|
203
|
-
part_of: []
|
|
204
|
-
based_on:
|
|
205
|
-
- bps-procurement-order
|
|
206
|
-
- bps-procurement-receive
|
|
207
|
-
- bps-accounting-payment
|
|
208
|
-
- bes-purchase-order-confirmed
|
|
209
|
-
- bes-goods-receipt-confirmed
|
|
210
|
-
- bes-invoice-received
|
|
211
|
-
- bes-payment-confirmed
|
|
212
|
-
supersedes: []
|
|
213
|
-
---
|
|
214
|
-
|
|
215
|
-
## 概要
|
|
216
|
-
|
|
217
|
-
在庫補充のための仕入で、発注・入荷・支払までの一連が業務として成立し、在庫・仕入・支払の記録が矛盾なく追跡できること。
|
|
218
|
-
|
|
219
|
-
## 受入条件
|
|
220
|
-
|
|
221
|
-
この受入対象では、少なくとも次を確認します。
|
|
222
|
-
|
|
223
|
-
- 正常系: 発注→入荷→請求→支払までが完了し、相互に追跡できる
|
|
224
|
-
- 例外: 入荷で数量差異が発生した場合でも、差異と未完了(未入荷残)が追跡できる
|
|
225
|
-
|
|
226
|
-
### シナリオ: 発注から入荷・請求・支払までが完了する(数量一致)
|
|
227
|
-
|
|
228
|
-
#### 前提
|
|
229
|
-
|
|
230
|
-
- 商品Aの在庫が発注点以下である
|
|
231
|
-
- 仕入先Sが取引可能(取引停止ではない)である
|
|
232
|
-
- 仕入先Sの支払条件が登録されている
|
|
233
|
-
|
|
234
|
-
#### 操作
|
|
235
|
-
|
|
236
|
-
- 発注担当者が商品Aを数量10で発注確定する
|
|
237
|
-
- 仕入先Sから商品Aが数量10で納品され、入荷検品を確定する
|
|
238
|
-
- 経理担当者が仕入先Sの請求書(発注分)を受領する
|
|
239
|
-
- 経理担当者が支払を確定する
|
|
240
|
-
|
|
241
|
-
#### 期待結果
|
|
242
|
-
|
|
243
|
-
- 発注が記録される
|
|
244
|
-
- 発注には発注番号、仕入先、発注明細(商品、数量、単価)が保持される
|
|
245
|
-
- 入荷が記録される
|
|
246
|
-
- 入荷には入荷日、仕入先、入荷明細(商品、数量)が保持される
|
|
247
|
-
- 在庫が数量10増加する
|
|
248
|
-
- 請求が記録される
|
|
249
|
-
- 請求には請求番号、仕入先、対象期間、請求金額が保持される
|
|
250
|
-
- 支払が記録される
|
|
251
|
-
- 支払には支払日、仕入先、支払金額、支払方法が保持される
|
|
252
|
-
- 発注・入荷・請求・支払が相互に追跡できる(参照関係を辿れる)
|
|
253
|
-
|
|
254
|
-
### シナリオ: 入荷検品で数量差異があり、差異と未入荷残が追跡できる(不足)
|
|
255
|
-
|
|
256
|
-
#### 前提
|
|
257
|
-
|
|
258
|
-
- 仕入先Sが取引可能(取引停止ではない)である
|
|
259
|
-
- 仕入先Sの支払条件が登録されている
|
|
260
|
-
- 発注担当者が商品Aを数量10で発注確定している(同一の発注番号を持つ)
|
|
261
|
-
- 仕入先Sから商品Aが数量9で納品される(発注数量に対して不足がある)
|
|
262
|
-
|
|
263
|
-
#### 操作
|
|
264
|
-
|
|
265
|
-
- 入荷検品を確定する
|
|
266
|
-
|
|
267
|
-
#### 期待結果
|
|
268
|
-
|
|
269
|
-
- 入荷が記録される
|
|
270
|
-
- 入荷数量は数量9として記録される
|
|
271
|
-
- 発注に対する差異(不足1)が記録される
|
|
272
|
-
- 不足1は、同一の発注に紐づく未完了(未入荷残)として追跡できる
|
|
273
|
-
- 在庫が数量9増加する
|
|
274
|
-
|
|
275
|
-
## メモ / 将来課題
|
|
276
|
-
|
|
277
|
-
- 将来: 不足分の追加入荷(分納)で未入荷残が解消される Scenario を追加する。
|
|
278
|
-
- 将来: 請求書が「発注数量基準」か「入荷実績基準」かの違いを扱う Scenario を追加する。
|
|
279
|
-
- 将来: 値引・返品・訂正(請求訂正、支払取消)を扱う Scenario を追加する。
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
### 9.3 サンプル(役割/目的 + ケース表)
|
|
283
|
-
|
|
284
|
-
「役割/目的」の明記と、「ケース表」で差分をまとめる例です。
|
|
285
|
-
|
|
286
|
-
```markdown
|
|
287
|
-
---
|
|
288
|
-
id: bac-sale-payment-method
|
|
289
|
-
type: requirement
|
|
290
|
-
title: 業務受入条件: 会計確定(支払方法の記録)
|
|
291
|
-
status: draft
|
|
292
|
-
part_of: []
|
|
293
|
-
based_on:
|
|
294
|
-
- bps-sale-checkout
|
|
295
|
-
- br-sale-total-calc
|
|
296
|
-
supersedes: []
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
## 概要
|
|
300
|
-
|
|
301
|
-
レジ会計の確定時に、支払方法の違いにかかわらず、売上が記録され、支払方法が追跡できること。
|
|
302
|
-
|
|
303
|
-
役割: レジ担当者 / 目的: 会計確定の結果として、売上と支払方法を記録し追跡できる
|
|
304
|
-
|
|
305
|
-
## 受入条件
|
|
306
|
-
|
|
307
|
-
### シナリオ: 会計確定が支払方法別に成立する
|
|
308
|
-
|
|
309
|
-
#### 前提
|
|
310
|
-
|
|
311
|
-
- 顧客がレジに商品を持参している
|
|
312
|
-
- 商品の在庫が十分にある
|
|
313
|
-
|
|
314
|
-
#### 操作
|
|
315
|
-
|
|
316
|
-
- 会計を確定する(支払方法を選択して確定する)
|
|
317
|
-
|
|
318
|
-
#### ケース一覧
|
|
319
|
-
|
|
320
|
-
| ケース | 条件/入力(支払方法) | 期待結果(観測点) |
|
|
321
|
-
| ------ | --------------------- | ------------------------------------------------------- |
|
|
322
|
-
| C1 | 現金 | 売上が記録され、支払方法=現金として追跡できる |
|
|
323
|
-
| C2 | キャッシュレス | 売上が記録され、支払方法=キャッシュレスとして追跡できる |
|
|
324
|
-
|
|
325
|
-
#### 判定方法(任意)
|
|
326
|
-
|
|
327
|
-
- 売上記録(レジ記録)で、売上の作成と支払方法の記録が確認できる
|
|
328
|
-
|
|
329
|
-
## メモ / 将来課題
|
|
330
|
-
|
|
331
|
-
- 将来: 支払方法別の明細(例: 釣銭、手数料、入金/未入金の扱い)を追加する。
|
|
332
|
-
```
|
|
101
|
+
- 物理テーブル、SQL、実装クラス、詳細 API、クリック手順を業務条件として書かない。
|
|
102
|
+
- schema・リファレンスの値・構文・構造の詳細を再掲しない。確認に必要な正本の参照を示す。
|
|
103
|
+
- 「問題ない」「正しく処理される」だけで期待結果や判定方法を代替しない。
|
|
104
|
+
- 根拠のない数値、判断権限、例外承認を追加しない。未決事項を合格済み・承認済みとして扱わない。
|
|
105
|
+
- 業務仕様の全文、テストの詳細手順、受入実績を BAC の本文へ複写しない。
|