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
|
@@ -4,35 +4,156 @@ specdojo:
|
|
|
4
4
|
type: ui
|
|
5
5
|
status: draft
|
|
6
6
|
rulebook: specdojo:uis-rulebook
|
|
7
|
+
part_of: []
|
|
8
|
+
based_on: []
|
|
7
9
|
---
|
|
8
10
|
|
|
9
|
-
#
|
|
11
|
+
# 駄菓子屋きぬや 販売登録画面 画面仕様
|
|
10
12
|
|
|
11
|
-
## 1.
|
|
13
|
+
## 1. 概要
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
駄菓子屋きぬやの店員・店主が、来店客の購入商品と預かり金を登録し、販売を確定して釣銭を確認する GUI 画面である。販売の記録漏れと金額の計算誤りを減らし、店番を交代しても同じ手順で現金販売を完了できるようにする。
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
### 1.1. 利用環境と対象範囲
|
|
16
18
|
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
19
|
+
- 単一店舗のタブレット 1 台で、認証済みの担当者が 1 件ずつ取引する。
|
|
20
|
+
- 商品コードは手入力するか、入力欄を選択した状態でバーコードスキャナから読み取るし、スキャンで商品追加を確定する。
|
|
21
|
+
- 本画面は現金販売を扱う。つけ販売・返品・確定後の取消は別業務とする。
|
|
22
|
+
- _ASSUMPTION_: 店舗サービスに接続して商品情報の取得と会計確定を行う(「メモ / 将来課題」)。
|
|
20
23
|
|
|
21
|
-
##
|
|
24
|
+
## 2. 対象ユーザー/利用目的
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
|
|
26
|
+
| 対象ユーザー | 利用場面・目的 | 許可される操作 |
|
|
27
|
+
| ------------ | ---------------------------------------------------------- | ---------------- |
|
|
28
|
+
| 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す | 「操作」の全操作 |
|
|
29
|
+
| 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する | 店員と同じ |
|
|
25
30
|
|
|
26
|
-
|
|
31
|
+
画面を操作するのは店員・店主で、来店客には担当者が合計請求金額と釣銭を伝える。
|
|
27
32
|
|
|
28
|
-
|
|
29
|
-
| ------------ | ---------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [画面仕様](../rulebooks/uis-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 業務ユーザー視点の画面の利用目的や表示項目、操作を定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など | 要点のみ記載 |
|
|
33
|
+
## 3. 表示項目
|
|
33
34
|
|
|
34
|
-
|
|
35
|
+
### 3.1. 入力・明細・集計
|
|
35
36
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
37
|
+
| 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機 |
|
|
38
|
+
| ------------------------ | ---- | ------------------------------------------------ | -------- | ------------------------------------------------------ |
|
|
39
|
+
| 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012`。回復操作でも同じ番号を使う |
|
|
40
|
+
| 担当者 | 識別 | 認証済みの担当者の表示名 | 不可 | 例「店主」 |
|
|
41
|
+
| 取引開始日時 | 識別 | 店舗時刻の年月日・時分 | 不可 | 新規販売開始時に設定し、再試行で変えない |
|
|
42
|
+
| 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 | 初期値は空。追加成功時に空へ戻し、失敗時は保持 |
|
|
43
|
+
| 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」 |
|
|
44
|
+
| 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 | 商品追加時に取得 |
|
|
45
|
+
| 明細の数量 | 入力 | 購入数量、個単位 | 可 | 初回追加は 1。同じ商品の追加で 1 増加 |
|
|
46
|
+
| 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新 |
|
|
47
|
+
| 現在庫数 | 一覧 | 販売可能な数量、個単位 | 不可 | 在庫の判定時に更新 |
|
|
48
|
+
| 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0 点 |
|
|
49
|
+
| 税抜小計 | 集計 | 合計請求金額から内税額を引いた金額 | 不可 | 初期値は 0 円 |
|
|
50
|
+
| 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0 円 |
|
|
51
|
+
| 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0 円 |
|
|
52
|
+
| 預かり金額 | 入力 | 来店客から受け取った金額、円単位 | 可 | 初期値は空。明細更新後も保持して再判定 |
|
|
53
|
+
| 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 | 預かり金額が無効・不足の間は「未計算」 |
|
|
54
|
+
| 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 | 「状態と操作可否」 |
|
|
55
|
+
| 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 | 解消時に消す |
|
|
56
|
+
|
|
57
|
+
集計は明細の更新ごとに計算し直す。商品台帳は税込単価と税率区分(8% または 10%)を持つ。税率別に税込明細小計を合算し、合算額 × 税率 ÷(100 + 税率)の 1 円未満を切り捨てて内税額とする。請求額に内税額を加算しない。
|
|
58
|
+
|
|
59
|
+
### 3.2. 表示値の確認例
|
|
60
|
+
|
|
61
|
+
| 商品 | 単価 | 税率区分 | 数量 | 明細小計 |
|
|
62
|
+
| ---------------- | ------ | -------- | ---- | -------- |
|
|
63
|
+
| きなこ棒(袋) | 108 円 | 8% | 2 個 | 216 円 |
|
|
64
|
+
| おもちゃ入り菓子 | 110 円 | 10% | 1 個 | 110 円 |
|
|
65
|
+
|
|
66
|
+
この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326 円で 0 円、325 円で「未計算」となる。
|
|
67
|
+
|
|
68
|
+
## 4. 操作
|
|
69
|
+
|
|
70
|
+
### 4.1. 状態と操作可否
|
|
71
|
+
|
|
72
|
+
| 状態 | 可能な操作 | 状態を抜ける条件 |
|
|
73
|
+
| ------------ | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
74
|
+
| 登録中 | 結果確認・再ログイン以外の操作 | 会計確定の受付で「会計処理中」。中止に同意すると店舗待機画面へ |
|
|
75
|
+
| 会計処理中 | 状態表示の確認 | 成功時は販売完了画面へ。未確定と確認できる失敗は「登録中」。通信切断・30 秒の応答待ち超過は「結果確認待ち」 |
|
|
76
|
+
| 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」 | 確定済みは販売完了画面へ。元の確定処理が終わって未確定と確認できれば「登録中」。処理継続中・照会失敗はこの状態を保持 |
|
|
77
|
+
|
|
78
|
+
登録中の取得・変更操作は 1 件ずつ処理し、その処理中は他の登録操作を無効化する。認証失効・権限不足時は「再ログイン」だけを許す。
|
|
79
|
+
|
|
80
|
+
### 4.2. 操作ごとの前提と結果
|
|
81
|
+
|
|
82
|
+
取引中止・再ログインは「遷移」、入力条件は「バリデーション」、回復は「エラー表示と利用者の次の手」に従う。
|
|
83
|
+
|
|
84
|
+
| 操作名 | 対象 | 前提条件 | 結果 |
|
|
85
|
+
| ------------ | -------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------- |
|
|
86
|
+
| 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 未追加の商品は数量 1 の行を追加し、追加済みの商品は数量を 1 増やす |
|
|
87
|
+
| 数量変更 | 明細の数量 | 登録中。対象明細がある | 数量と集計を更新する |
|
|
88
|
+
| 明細削除 | 明細の「削除」 | 登録中。対象明細がある | 行を削除して集計を更新する。最終行の削除後は空の明細表示へ戻る |
|
|
89
|
+
| 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持し、有効なら釣銭を計算する |
|
|
90
|
+
| 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開き、選んだ商品を商品追加と同じ条件で反映する |
|
|
91
|
+
| 会計確定 | 「会計確定」 | 登録中。確定時の条件を満たす | 販売記録と在庫引落をまとめて確定し、販売完了画面へ |
|
|
92
|
+
| 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を取り直し、成功時に元の追加・変更を 1 回反映する |
|
|
93
|
+
| 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会する。新たな会計確定要求は出さない |
|
|
94
|
+
|
|
95
|
+
会計確定は販売記録と在庫引落の両方が成功した時点を完了とし、片方だけの成功を完了と表示しない。同じ取引番号で確定を再実行しても、販売記録と在庫引落は各 1 回とする。
|
|
96
|
+
|
|
97
|
+
「読み直し」は直前に失敗した商品取得・在庫確認を対象とし、入力の修正、別の明細操作、追加・変更の成功で解除する。
|
|
98
|
+
|
|
99
|
+
## 5. 遷移
|
|
100
|
+
|
|
101
|
+
本画面の識別子は `uis-sales-register` とする。
|
|
102
|
+
|
|
103
|
+
| 遷移名 | 契機 | 遷移元 | 遷移先 | 条件 | 引き渡し情報・入力の扱い |
|
|
104
|
+
| ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ | ------------------------------------------------------------------ |
|
|
105
|
+
| 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない | 新規取引番号と担当者。空の明細と未入力の預かり金で開始 |
|
|
106
|
+
| 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 | なし。明細・入力を保持 |
|
|
107
|
+
| 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み | 選択した商品コード |
|
|
108
|
+
| 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る | なし。保持した明細・入力へ戻る |
|
|
109
|
+
| 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 | 取引番号。入力を保持 |
|
|
110
|
+
| 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄 |
|
|
111
|
+
| 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る | なし。保持した明細・入力へ戻る |
|
|
112
|
+
| 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可 |
|
|
113
|
+
| 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 | 復帰先と取引番号。入力と取引状態を保持 |
|
|
114
|
+
| 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある | 保持した取引へ戻る。会計結果が不明なら結果確認待ちで戻る |
|
|
115
|
+
|
|
116
|
+
販売完了画面は釣銭の手渡し確認とレシート発行を担い、印刷失敗時の再発行も同画面で扱う(販売登録へ戻して再会計しない)。権限が回復しない場合はログイン画面に留まる。
|
|
117
|
+
|
|
118
|
+
## 6. バリデーション
|
|
119
|
+
|
|
120
|
+
違反時の状態の扱いは「エラー表示と利用者の次の手」の対応エラーの行に従う。
|
|
121
|
+
|
|
122
|
+
| 対象 | 必須性 | 条件 | 判定時点 | 対応エラー |
|
|
123
|
+
| ---------------------- | ---------------- | ----------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
|
|
124
|
+
| 商品コード | 商品追加時に必須 | 半角数字 8 桁。先頭の 0 を保持し、前後空白や記号を許さない | 商品追加時、スキャン確定時 | 商品コード形式不正 |
|
|
125
|
+
| 商品の存在・販売可否 | 商品追加時に必須 | 商品台帳にあり、販売中である | 商品追加時と会計確定時 | 商品コード未登録、販売対象外 |
|
|
126
|
+
| 数量 | 各明細で必須 | 半角数字による 1〜999 の整数。空欄・符号・小数・文字を許さない | 商品追加時、数量変更時、会計確定時 | 数量形式・範囲不正 |
|
|
127
|
+
| 在庫との相関 | 各明細で必須 | 同一商品をまとめた数量が最新の現在庫数以下 | 商品追加時、数量変更時、会計確定時 | 在庫不足 |
|
|
128
|
+
| 販売価格 | 確定時に必須 | 追加時の税込単価と最新の単価が一致 | 会計確定時 | 販売価格変更 |
|
|
129
|
+
| 明細の有無 | 確定時に必須 | 明細 1 件以上 | 会計確定前 | なし。0 件では「会計確定」を無効化 |
|
|
130
|
+
| 預かり金額の形式・範囲 | 確定時に必須 | 半角数字による 0〜999999 の整数、円単位。空欄・符号・小数・桁区切りを許さない | 入力変更時と会計確定前 | 預かり金形式・範囲不正。空欄・形式不正の間は「会計確定」を無効化 |
|
|
131
|
+
| 預かり金額との相関 | 確定時に必須 | 預かり金額が合計請求金額以上 | 預かり金入力時、明細更新時、会計確定時 | 預かり金額不足 |
|
|
132
|
+
|
|
133
|
+
会計確定時の違反では販売記録も在庫引落も確定しない。数量は 1・999 を許し、0・1000・1.5 を拒否する。在庫数 3 の商品は数量 3 を許し、4 を拒否する。金額の境界は「表示値の確認例」に従う。
|
|
134
|
+
|
|
135
|
+
## 7. エラー表示と利用者の次の手
|
|
136
|
+
|
|
137
|
+
| エラー事象 | 発生条件 | 表示要点 | 状態の扱い | 利用者の次の手 |
|
|
138
|
+
| ---------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------- |
|
|
139
|
+
| 商品コード形式不正 | 「バリデーション」の商品コード | 「商品コードを 8 桁の数字で入力してください」 | 入力を保持。明細・集計は変えない | コードを直して「商品追加」するか、「商品検索」 |
|
|
140
|
+
| 商品コード未登録 | 入力コードが商品台帳にない | 「商品コードが登録されていません」と入力コード | 入力を保持。明細は追加しない | 入力を確かめるか「商品検索」で選ぶ |
|
|
141
|
+
| 販売対象外 | 追加時または確定時に販売停止を検出 | 「現在販売できない商品です」と商品名 | 確定せず登録中を保持 | 別の商品を選ぶか、明細内なら「明細削除」 |
|
|
142
|
+
| 数量形式・範囲不正 | 「バリデーション」の数量 | 「数量は 1〜999 の整数で入力してください」と対象商品 | 前の有効明細と集計を保持し、修正入力を残す | 数量を直すか、購入しないなら「明細削除」 |
|
|
143
|
+
| 在庫不足(初回追加) | 未追加の商品の現在庫数が 0 | 「在庫が不足しています」と商品名、現在庫数 0 | 行は作らず、入力・既存明細を保持 | 追加を取りやめるか、別の商品を追加する |
|
|
144
|
+
| 在庫不足(既存明細) | 再追加・数量変更・会計確定時に数量が現在庫数を超える | 「在庫が不足しています」と商品名、現在庫数 | 入力と直前の有効明細・集計を保持 | 数量を現在庫数以下へ直す。現在庫数 0 か購入をやめるなら「明細削除」 |
|
|
145
|
+
| 預かり金形式・範囲不正 | 「バリデーション」の預かり金額の形式・範囲 | 「預かり金額を 0〜999999 円の整数で入力してください」 | 入力を保持。釣銭は未計算 | 桁区切りなどを除いて預かり金額を直す |
|
|
146
|
+
| 預かり金額不足 | 預かり金額が合計請求金額未満 | 「預かり金が不足しています」と不足額 | 登録中を保持。釣銭は未計算 | 不足分を受け取り、預かり金額を直して「会計確定」 |
|
|
147
|
+
| 販売価格変更 | 確定時に単価の変更を検出 | 「価格が変わりました。金額を確認してください」と変更商品、旧単価・新単価 | 最新価格で計算し直し、預かり金は保持 | 新しい請求額を伝えて「会計確定」 |
|
|
148
|
+
| 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過 | 「商品情報を取得できません」と「読み直し」 | 入力と有効な明細を保持。追加・変更は未反映 | 接続を確かめて「読み直し」 |
|
|
149
|
+
| 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答 | 「会計を確定できませんでした」と取引番号 | 登録中へ戻る。販売・在庫は未更新、入力を保持 | 接続の復旧後に再度「会計確定」。再発時は店主へ取引番号を伝える |
|
|
150
|
+
| 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過 | 「会計結果を確認してください」と取引番号、「結果確認」 | 結果確認待ちへ移る | 接続の復旧後に「結果確認」。未確定と確認できた場合だけ登録を再開 |
|
|
151
|
+
| 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗 | 「会計結果をまだ確認できません」と取引番号 | 結果確認待ちを保持 | 再度「結果確認」。復旧しない場合は店主へ取引番号を伝える |
|
|
152
|
+
| 認証失効 | 登録中または結果確認時に認証失効を検出 | 「再ログインしてください」 | 入力と状態を保持。会計要求後なら結果確認待ち | 「再ログイン」で再認証し、結果確認待ちなら「結果確認」 |
|
|
153
|
+
| 権限不足 | 画面への進入時または操作時に販売登録権限がない | 「販売登録の権限がありません」 | 進入を拒否。操作中は入力を保持して変更を止め、会計要求後は結果確認待ち | 「再ログイン」へ進み、店主に担当者の権限確認を頼む |
|
|
154
|
+
|
|
155
|
+
## 8. メモ / 将来課題
|
|
156
|
+
|
|
157
|
+
- _ASSUMPTION_: 店舗サービスとの接続が営業中に復旧しない場合は、店主が取引番号と状況を控えて開発担当へ連絡し、紙の販売記録で続けるかを判断する。採用前に、復旧後に同じ取引を照会できることと、結果不明の取引を紙と二重に記録しないことを確かめる。
|
|
158
|
+
- 電子マネー・QR 決済は初期の現金販売に含めない。導入時は決済方法と取消手順を決め、預かり金・会計確定・結果確認への影響を整理する。
|
|
159
|
+
- 入力欄の選択を要しない連続スキャンは初期の入力方式に含めない。導入時は誤読・重複追加時の修正手順を決める。
|
|
@@ -313,15 +313,44 @@ Markdown 文書の最新の継続品質評価は、プロジェクトの `<execu
|
|
|
313
313
|
|
|
314
314
|
未充足条件がある場合だけ `done_criteria.unsatisfied` を置き、条件 ID をキー、その条件の `roles` を値として記録します。これにより詳細を grade result へ複製せず、次の確認担当を特定できます。詳細 YAML は `grade-done-criteria.schema.yaml` に従い、成果物と同じ `content_hash` を持ちます。
|
|
315
315
|
|
|
316
|
-
`findings[].line` は Frontmatter
|
|
316
|
+
`findings[].line` は Markdown では Frontmatter を除く本文、YAML ではコメント・メタ情報を含む元ファイル全体での指摘行(1始まり)、`anchor` は評価時点の該当行の引用です。`message` は executor が出力した原文を正本として保存し、前回 finding の一致にも使います。`message_ja` は表示専用で、判定、score、severity、引き継ぎに使いません。旧サイドカーのように `message_ja` がない場合は `message` を表示します。本文編集で行番号がずれた場合は `anchor` を照合に使います。`grade validate` はサイドカーの文書 ID・対象・件数・内容ハッシュを成果物と突き合わせます。
|
|
317
317
|
|
|
318
|
-
|
|
318
|
+
再評価で前回の正本の `message` または `message_ja` と同じ finding が残る場合は未解消として扱い、severity を前回より引き下げません。grade plan は前回の指摘を `message_ja`(なければ `message`)で示すため、英語を正本にした旧サイドカーの指摘は日本語で再掲され、その日本語が新しい正本になります。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に severity を引き下げる根拠を含めます。
|
|
319
319
|
|
|
320
|
-
executor
|
|
320
|
+
executor は判定根拠と新しい finding を日本語で出力し、その原文を `message` と `message_ja` の両方に保存します(PJR-YYDS、2026-11-16。それまでは英語を正本にしていました)。英語の finding は、日本語訳のない旧サイドカーの英語の正本が原文のまま再掲された場合などに限られます。`tools/grade/run-per-document.sh` は、英語 finding が残る場合だけ機械変換後に `gemma26-translator` で日本語へ翻訳し、`message_ja` に保存します。`grade run` は翻訳しません。モデルへ渡すのは英語文だけの配列であり、対応する index はコード側で管理します。`grade translation-plan` は元のインラインコードをそのまま残し、新しいインラインコードやバッククォートを加えず、固有名詞・識別子以外の英語の語句を日本語へ訳すよう求めます。`grade localize` は件数が一致するとき、各訳文が空でないこと、仮名を含むこと、元の文と訳文のインラインコードの多重集合が一致することを検証し、合格した項目だけを採用します。不合格項目は1件ずつ1回だけ再翻訳し、再び不合格なら `message_ja` に正本の `message` を保存します。件数が一致しない場合は全項目を不合格とします。
|
|
321
321
|
|
|
322
322
|
機械変換では、finding の severity が許す level 上限を超えた viewpoint だけを上限まで下げます。level を上げる補正や、viewpoint・severity・line の変更は行いません。補正した場合は `level_corrections` に viewpoint、`original_level`、`corrected_level` を保存します。
|
|
323
323
|
|
|
324
|
-
サイドカーは `grade-result.schema.yaml`
|
|
324
|
+
サイドカーは `grade-result.schema.yaml` に従います。評価対象は Markdown と YAML(`.yaml` / `.yml`)です。YAML は `validate:schema` と共通の処理で最上位または `x-spec-meta` のメタ情報を読み、ファイル全体を評価し、その内容からハッシュを取ります。`id`・`type`・`status`・`rulebook` がない YAML は理由を表示して対象から外します。JSON は評価対象外です。
|
|
325
|
+
|
|
326
|
+
### 6.3. 文書の改訂・廃止とライフサイクル変更管理(`supersedes` と `deprecated`)
|
|
327
|
+
|
|
328
|
+
成果物ドキュメントの改訂(置き換え)や廃止に伴う変更管理、および参照元への波及影響の追跡は、以下の共通規則に従います。
|
|
329
|
+
|
|
330
|
+
- **`supersedes` による置き換え(改訂)**:
|
|
331
|
+
- 文書の設計・仕様の大幅な見直しにより新たな文書を作成する場合、新文書の Frontmatter(独立 YAML ではトップレベル)の `supersedes` に置き換え対象の旧文書 ID 配列を指定します。
|
|
332
|
+
- 旧文書は `status: deprecated` に移行し、新文書が `status: ready` へ昇格した時点で置き換えを完了とします。軽微な修正や誤字修正は同一文書の改訂とし、`supersedes` による新文書作成は行いません。
|
|
333
|
+
- 新文書の概要または変更履歴に、旧文書からの主な変更点、改訂理由、および移行期間を明記します。
|
|
334
|
+
- **`deprecated` への移行(非推奨化・廃止)**:
|
|
335
|
+
- 業務仕様の廃止や機能縮退に伴い文書を運用終了とする場合、ファイルを直接削除せず `status: deprecated` に更新して移行期間を設けます。
|
|
336
|
+
- 文書冒頭(導入・概要)に、廃止理由、代替手段(後継文書 ID や代替業務運用)、および廃止時期を明記します。
|
|
337
|
+
- `status` が `deprecated` の文書を、新規または有効な文書の `based_on` や参照先にしてはなりません。有効な上位文書または後継文書へ参照を更新します。
|
|
338
|
+
- **影響追跡(波及分析)と関係成果物の追従**:
|
|
339
|
+
- 改訂または廃止対象の文書を参照しているすべての成果物(ダウンストリーム)を特定し、次の観点で追従更新します。
|
|
340
|
+
- **一覧・カタログ**: 業務イベント一覧(BEL)、業務データ辞書一覧、カタログなどの対応行のリンクを新文書へ付け替え、状態(非推奨・置換)を同期します。
|
|
341
|
+
- **プロセス・フロー仕様**: 業務プロセス仕様(BPS)などの処理ステップ、トリガー、判断において参照している旧仕様を新仕様へ付け替え、完了条件・分岐を見直します。
|
|
342
|
+
- **データ仕様・スキーマ**: 業務データ辞書(BDD)、概念クラス図(CCD)、データストア仕様(CDSD)の関連エンティティ・項目・許容値との整合性を再照合します。
|
|
343
|
+
- **実装コード**: 仕様を参照している型定義、ドメインロジック、イベント発行・購読コードを特定し、追従修正または互換性を維持します。
|
|
344
|
+
- **テスト仕様・受入条件**: 業務受入条件(BAC)、テストシナリオ・ケース(ATC / ITC / UTC)を抽出し、判定条件・期待値の更新と再検証を行います。
|
|
345
|
+
- **担当 Role code の責務分担**:
|
|
346
|
+
- **BA**: 業務影響分析の主担当。仕様改訂・廃止に伴う業務境界、業務プロセス、ルール、データの波及影響を洗い出し、改訂案および参照元仕様の更新案を作成します。
|
|
347
|
+
- **PO**: 廃止・置き換えの意思決定と承認。`deprecated` 移行および新文書の `ready` 昇格を最終判断します。
|
|
348
|
+
- **ARC**: 成果物間の構造整合性、スキーマ・インターフェース・技術制約への影響を検証します。
|
|
349
|
+
- **DEV**: 実装コード・型定義・スキーマの特定と追従修正を担います。
|
|
350
|
+
- **QE**: 影響を受けるテスト仕様・受入条件の特定と再検証・品質確認を担います。
|
|
351
|
+
- **PM**: 改訂・廃止に伴う波及更新タスク(PJR 項目)の起票と移行スケジュールを管理します。
|
|
352
|
+
- **未決事項・課題の PJR への引き継ぎ**:
|
|
353
|
+
- 改訂・廃止の過程で生じた未決事項、恒久的なリスク、課題、変更要求、決定事項は、文書内の未確定ラベル(`_TODO_`, `_UNDECIDED_`, `_ASSUMPTION_`)のまま放置せず、PJR(リスク登録簿 `pm-risk-register`、課題管理簿 `pm-issue-log`、変更要求ログ `pm-change-request-log`、決定記録 `pm-decision-log`、または PJR 登録項目)へ担当 Role code と転送先レコードを明記して引き継ぎます。
|
|
325
354
|
|
|
326
355
|
## 7. 成果物の値制約
|
|
327
356
|
|
|
@@ -884,10 +884,11 @@ specdojo deliverable trash --project prj-0001 --local-id cdfd-register-operation
|
|
|
884
884
|
| 概念データストア定義 | Conceptual Data Store Definition | cdsd- | cdsd-common, cdsd-sales |
|
|
885
885
|
| 保管場所定義 | Storage Location Definition | sld- | sld-common, sld-sales |
|
|
886
886
|
| ステータス定義(状態一覧・状態遷移図) | Status Definition | stsd- | stsd-product |
|
|
887
|
-
|
|
|
887
|
+
| 分類一覧 | Code Table | cdt- | cdt-product |
|
|
888
888
|
| 業務プロセス仕様 | Business Process Specification | bps- | bps-order-flow |
|
|
889
889
|
| ビジネスルール | Business Rule | br- | br-discount |
|
|
890
890
|
| 画面仕様 | UI Specification | uis- | uis-order-edit |
|
|
891
|
+
| CLI仕様 | CLI Specification | clis- | clis-exec-commands |
|
|
891
892
|
| 帳票仕様 | Business Document Specification | bds- | bds-order-summary |
|
|
892
893
|
| システム化機能 | System Function | sf- | sf-index, sf-product-register |
|
|
893
894
|
| 業務イベント仕様 | Business Event Specification | bes- | bes-index, bes-order-approved |
|
|
@@ -906,6 +907,7 @@ specdojo deliverable trash --project prj-0001 --local-id cdfd-register-operation
|
|
|
906
907
|
| システム設計-全体構成 | System Design Index | sysd- | sysd-index |
|
|
907
908
|
| システム設計-重要フロー | System Design Critical Flows | sysd- | sysd-critical-flows |
|
|
908
909
|
| システム設計-横断ルール | System Design Cross-cutting Policy | sysd- | sysd-cross-cutting-policy |
|
|
910
|
+
| デザインシステム | Design System Specification | dss- | dss-common, dss-store-gui |
|
|
909
911
|
| 非機能要件 | Non-Functional Requirements | nfr- | nfr-performance |
|
|
910
912
|
| システム受入条件 | System Acceptance Criteria | sac- | sac-performance |
|
|
911
913
|
| テスト戦略・方針 | Test Strategy and Policy | tsp- | tsp-index |
|
|
@@ -20,22 +20,23 @@ Job Definition Standard
|
|
|
20
20
|
|
|
21
21
|
## 2. 基本方針
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- 決定論的な手順は script または CLI へ実装し、`mode: command` の `task.command` から入口を呼ぶ。複数の入口を順に実行する場合は `task.steps` を使う。
|
|
24
24
|
- `task.command` は materialize 時に入力を展開して Run へ凍結し、runner が agent の sandbox 外で直接実行する。
|
|
25
25
|
- 対象選択を伴う command Job は任意の `task.precondition` で選択を先に評価できる。skip 条件を満たした場合は Job Run と付随成果物を作らない。
|
|
26
26
|
- command Job が同じプロジェクトの `specdojo exec` を子プロセスとして呼ぶ場合、runner が保持する project 実行 lock の token を子へ継承する。子は owner token の一致を検証した場合だけ再取得を省略し、Job 全体の排他範囲を維持する。
|
|
27
27
|
- 判断(観測した結果の解釈、失敗の切り分け、次の行動の提案)が必要な command Job だけ、`task.analysis` で reporter agent と判断内容を指定する。
|
|
28
28
|
- `edit` / `review` Job は従来どおり agent に作業を委譲し、`task.description` に判断内容を書く。
|
|
29
29
|
- 委譲先の agent は nickname で指名する。`capabilities` / `proficiency` による間接指定は、指名が不要な場合に限る。
|
|
30
|
+
- `task.proficiency` は `low` / `normal` / `high` / `expert` / `frontier` を受け付ける。最上位の `frontier` は、`task.agent` で指名するか `task.proficiency: frontier` を明示した場合だけ候補にする。provider の起動設定は [[specdojo:exec-config-guide|exec 設定ガイド]] に従う。
|
|
30
31
|
- 同じ論理実行に対して同じ Run を作れるよう、Job が使う値は `inputs`、`job_id`、`scheduled_at`、前回成功 checkpoint に限定する。Run ID 確定後の task と checkpoint では `job_run_id` も参照できる。
|
|
31
32
|
|
|
32
33
|
### 2.1. 判断と手順の切り分け基準
|
|
33
34
|
|
|
34
|
-
次の表で「手順」に該当する記述は `task.description`
|
|
35
|
+
次の表で「手順」に該当する記述は `task.description` へ書かず、`task.steps` または script / CLI へ移す。
|
|
35
36
|
|
|
36
37
|
| 区分 | 判定基準 | 記述場所 | 例 |
|
|
37
38
|
| ---- | ---------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
|
|
38
|
-
| 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | script / CLI と `task.command`
|
|
39
|
+
| 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | `task.steps` または script / CLI と `task.command` | 対象文書の列挙、段の順序制御、1件ごとの CLI 実行 |
|
|
39
40
|
| 手順 | 同じ操作を対象ごとに繰り返す | script / CLI と `task.command` | 全件ループ、対象0件時の分岐 |
|
|
40
41
|
| 判断 | 観測した結果を解釈し、複数の説明のどれが妥当かを選ぶ | `task.analysis.description` または `task.description` | 失敗が rate limit か agent の失敗かの切り分け |
|
|
41
42
|
| 判断 | 事実から次の行動(再開・見直し・エスカレーション)を決める | `task.analysis.description` または `task.description` | 閾値の見直し要否、再開可否の判断 |
|
|
@@ -77,7 +78,7 @@ Job Definition Standard
|
|
|
77
78
|
### 3.4. 責務境界と粒度
|
|
78
79
|
|
|
79
80
|
- 1つの Job は1つの委譲単位に対応させる。同じ処理を条件違いで繰り返すために Job を分割してはならない。条件差は `inputs` で表す。
|
|
80
|
-
- 実行順序を Job の分割で表現してはならない。順序は
|
|
81
|
+
- 実行順序を Job の分割で表現してはならない。順序は `task.steps` または script / CLI が持ち、routine の `action` 配列は独立した委譲単位の並びにだけ使う。
|
|
81
82
|
- Job は起動時刻を持たない。時刻条件は routine または外部スケジューラが持つ。
|
|
82
83
|
- Job は agent 実行エンジンを持たない。plan 生成、agent 選択、result、worktree、commit は `exec` 実行基盤へ委ねる。
|
|
83
84
|
|
|
@@ -101,6 +102,20 @@ Job Definition Standard
|
|
|
101
102
|
- `job_run_id` は `idempotency_key` から導出されるため、`run.idempotency_key` では参照できない。
|
|
102
103
|
- 同じ `scheduled_at` を明示した手動・routine 起動は同じ実行枠として重複排除する。`scheduled_at` を省略した手動起動は起動ごとに新しい実行枠とする。
|
|
103
104
|
|
|
105
|
+
### 3.7. command Job の順次実行
|
|
106
|
+
|
|
107
|
+
`task.command` の代わりに非空の `task.steps` を指定すると、runner は各段のプロセス終了を待ってから次を実行する。両方の併記、agent mode での使用、`task.partial_exit_code` との併用は認めない。各段の `id` は Job 内で一意な小文字 slug、`command` は非空とし、入力 template を materialize 時に解決して Run へ凍結する。
|
|
108
|
+
|
|
109
|
+
- 各段の `on_failure` は自身の失敗・延期後の `stop`(既定)または `continue`。続行しても既に発生した失敗を成功へ読み替えない。
|
|
110
|
+
- 段は終了コード 0 で成功、75 で延期、それ以外(signal・起動不能を含む)で失敗とする。未実行の後続段も理由付きの `deferred` として `attempts[].steps` に保存する。全段が成功した場合だけ Run は `succeeded`、失敗・延期があれば `failed`。CLI は失敗を含めば 1、延期だけなら 75 を返す。
|
|
111
|
+
- 終了コードだけでは完了を表せないコマンドには `completion` を必ず指定する。`path` は repository 内の相対パス(JSON、YAML、Markdown frontmatter)、`field` はドット区切りのキー、`succeeded` は成功状態の非空リスト、任意の `deferred` は延期状態のリスト。終了コード 0 に加え、そのフィールドが成功状態に一致する場合だけ成功とする。ファイル欠落・不正、キー欠落、未指定の状態は失敗とする。CLI が最新状態を生成する必要があれば、同じ段の command の最後で refresh する。ログの文言から完了を判定しない。
|
|
112
|
+
- sequence は project 実行 lock を排他的に取得するまで待つ。`task.lock_wait_seconds` は待機上限の秒数(非負整数、既定 3600、0 は即時判定)。この Job の外側の `--if-busy` より定義を優先する。上限超過では precondition・段・analysis を実行せず、全段を延期として記録する。
|
|
113
|
+
- lock は全段の終了まで保持し、同一 project の子 exec は検証済み token を継承する。先行プロセスのログや `pgrep` は監視しない。同じ論理 Run の同時起動は別の guard で拒否し、待機中の記録を上書きしない。
|
|
114
|
+
- 各段の任意の `timeout_seconds`(1〜2147483 の整数)は lock 待機を含む command 全体の上限。超過は延期とし、POSIX では command のプロセス群を停止してから後続へ進む。grade 独自の lock を待つ場合は `grade run --if-busy wait` と併用する。
|
|
115
|
+
- 各段の状態を直ちに保存し、実行済み段には終了コード・時刻・command evidence 参照を残す。同じ実行枠の retry は新しい attempt として全段を先頭から実行する。段のコマンドには冪等な操作、既存の resume、grade の再開機能を使う。
|
|
116
|
+
|
|
117
|
+
例と routine / cron の接続は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照する。
|
|
118
|
+
|
|
104
119
|
## 4. 値制約・判定基準
|
|
105
120
|
|
|
106
121
|
| 項目 | 必須 | 判定基準 |
|
|
@@ -108,7 +123,8 @@ Job Definition Standard
|
|
|
108
123
|
| `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
|
|
109
124
|
| `task.mode` | ○ | `edit` / `review` / `command` |
|
|
110
125
|
| `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
|
|
111
|
-
| `task.command` | 条件 | `command`
|
|
126
|
+
| `task.command` | 条件 | `command` で `task.steps` といずれか一方が必須。入力展開後も非空 |
|
|
127
|
+
| `task.steps` | 条件 | `command` の順次実行。第3.7節に従う |
|
|
112
128
|
| `task.partial_exit_code` | 任意 | `command` だけで使用する1〜255の終了コード。明示した値だけを`partial`とする |
|
|
113
129
|
| `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
|
|
114
130
|
| `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
|
|
@@ -123,7 +139,7 @@ Job Definition Standard
|
|
|
123
139
|
|
|
124
140
|
## 5. 記述例
|
|
125
141
|
|
|
126
|
-
次の grade Job は
|
|
142
|
+
次の grade Job は `grade run` で変更済みの Kata を評価する例です。成果物の grade には project の `catalog_path` が必要です。
|
|
127
143
|
|
|
128
144
|
```yaml
|
|
129
145
|
task:
|
|
@@ -133,12 +149,11 @@ task:
|
|
|
133
149
|
command: "{{specdojo}} grade list --target kata --changed-only --project {{project_id}}"
|
|
134
150
|
skip_when: empty-output
|
|
135
151
|
command: |
|
|
136
|
-
|
|
137
|
-
cat logs/grade/runs/per-document/{{job_run_id}}/results.tsv
|
|
152
|
+
{{specdojo}} grade run --run-id {{job_run_id}} --target kata --changed-only --project {{project_id}}
|
|
138
153
|
analysis:
|
|
139
154
|
agent: claude-reporter
|
|
140
155
|
description: |
|
|
141
|
-
command evidence と
|
|
156
|
+
command evidence と grade run の出力から未完了の文書の有無、失敗の切り分け、
|
|
142
157
|
閾値の見直し要否を判断して報告する。
|
|
143
158
|
paths:
|
|
144
159
|
- docs/ja/specdojo/rulebooks
|
|
@@ -104,6 +104,7 @@ specdojo:
|
|
|
104
104
|
- 用語はファイル内で統一し、`index` / `overview` などの命名ゆれを持ち込まない。
|
|
105
105
|
- 用語定義を置く場合は、本文構成の見出し名や記述ガイドを単に言い換えて重複させない。重複になる場合は用語定義を省略する。
|
|
106
106
|
- `推奨 Frontmatter 項目` の記述は [document-metadata-standard.md](document-metadata-standard.md) に従う。
|
|
107
|
+
- 成果物の改訂・廃止、置き換え(`supersedes`)、非推奨化(`deprecated`)、および参照元(一覧・プロセス・データ・実装・テスト)への影響追跡と担当 Role code の記載要件は、[[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。各 rulebook は自系統の成果物における具体的な追従対象と役割分担を定義する。
|
|
107
108
|
- `ファイル命名・ID規則` は [docs-structure-guide.md](../guides/docs-structure-guide.md) に従う。
|
|
108
109
|
- `target_format` がある場合は、本文ルール・記述例を対象フォーマットに合わせる。未記載の場合は markdown を対象とみなす(`Frontmatter 規約` 参照)。
|
|
109
110
|
- `target_format: yaml` / `json` の場合は、Frontmatter と同等の先頭メタ項目、ルートキー、必須キー、型制約を実装可能な粒度で定義する。
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bac-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: requirement
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:bac-rulebook
|
|
12
|
+
based_on: _BASED_ON_
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# _DELIVERABLE_NAME_
|
|
16
|
+
|
|
17
|
+
_DELIVERABLE_OVERVIEW_
|
|
18
|
+
|
|
19
|
+
## 1. 概要
|
|
20
|
+
|
|
21
|
+
- 受入対象: _TODO_
|
|
22
|
+
- 対象者・業務課題: _TODO_
|
|
23
|
+
- 業務価値・対応するシナリオ ID: _TODO_
|
|
24
|
+
- 利用場面・対象範囲(開始点・終了点): _TODO_
|
|
25
|
+
- 対象外・委譲先: _TODO_
|
|
26
|
+
- 根拠: _TODO_
|
|
27
|
+
|
|
28
|
+
| 役割 | 確認・合意する内容 |
|
|
29
|
+
| ---------------- | ------------------ |
|
|
30
|
+
| _CONFIRMER_ROLE_ | _TODO_ |
|
|
31
|
+
| _APPROVER_ROLE_ | _TODO_ |
|
|
32
|
+
|
|
33
|
+
## 2. 受入条件
|
|
34
|
+
|
|
35
|
+
共通前提: _TODO_
|
|
36
|
+
|
|
37
|
+
### 2.1. BAC-01 _SCENARIO_NAME_
|
|
38
|
+
|
|
39
|
+
根拠(業務仕様の文書・項目 ID): _TODO_
|
|
40
|
+
|
|
41
|
+
#### 2.1.1. 前提
|
|
42
|
+
|
|
43
|
+
- 開始状態: _TODO_
|
|
44
|
+
- 入力: _TODO_
|
|
45
|
+
- 担当者・権限: _TODO_
|
|
46
|
+
- 共通前提との差分: _TODO_
|
|
47
|
+
|
|
48
|
+
#### 2.1.2. 操作
|
|
49
|
+
|
|
50
|
+
- 担当者・業務行為: _TODO_
|
|
51
|
+
|
|
52
|
+
#### 2.1.3. 期待結果
|
|
53
|
+
|
|
54
|
+
- 状態・記録の変化: _TODO_
|
|
55
|
+
- 停止時に確定しないもの: _TODO_
|
|
56
|
+
- 引き継ぎ先・内容・再開条件: _TODO_
|
|
57
|
+
|
|
58
|
+
<!-- ケース表は条件差分がある場合に使用する。不要なら削除する。 -->
|
|
59
|
+
|
|
60
|
+
| ケース ID | 条件・入力 | 期待結果(観測点) |
|
|
61
|
+
| --------- | ---------- | ------------------ |
|
|
62
|
+
| _CASE_ID_ | _TODO_ | _TODO_ |
|
|
63
|
+
|
|
64
|
+
#### 2.1.4. 判定方法
|
|
65
|
+
|
|
66
|
+
| 対応する期待結果・ケース ID | 確認者 | 確認時点 | 観測先(証跡) | 照合対象 |
|
|
67
|
+
| --------------------------- | ------ | -------- | -------------- | -------- |
|
|
68
|
+
| _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
69
|
+
|
|
70
|
+
## 3. メモ / 将来課題
|
|
71
|
+
|
|
72
|
+
<!-- 未決事項がない場合は表を「なし」に置き換える。 -->
|
|
73
|
+
|
|
74
|
+
| 論点 | 影響するシナリオ ID・受入への影響 | 担当・判断者 | 判断時点・解消条件 | 追跡先 |
|
|
75
|
+
| --------------- | --------------------------------- | ------------ | ------------------ | ------ |
|
|
76
|
+
| _TODO_: _ISSUE_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bes-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: requirement
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:bes-rulebook
|
|
12
|
+
based_on: _BASED_ON_
|
|
13
|
+
supersedes: []
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# 業務イベント: _EVENT_NAME_
|
|
17
|
+
|
|
18
|
+
_TODO_: 解消する業務上の混同、対象範囲、定義を利用できると判断する基準を簡潔に記入する。共通の目的や用語は上位の正本を参照する。
|
|
19
|
+
|
|
20
|
+
_TODO_: 上位一覧の文書 ID と対応イベントを記入する。未存在の参照は ID をインラインコードで仮置きする。
|
|
21
|
+
|
|
22
|
+
## 1. 何が起きたか
|
|
23
|
+
|
|
24
|
+
_TODO_: 対象と確定した事実を過去形で記入する。一回の発生単位、含めない隣接する出来事、対象外と適用未判定の業務を区別する。
|
|
25
|
+
|
|
26
|
+
_TODO_: 業務定義・公開可否を承認する人間、判断時期、承認条件と記録先を記入する。未確認の担当割当は仮定として示す。
|
|
27
|
+
|
|
28
|
+
## 2. いつ
|
|
29
|
+
|
|
30
|
+
_TODO_: 観測できる成立時点を記入し、要求時点や後処理の完了時点と区別する。繰り返し・一括要求がある場合は個別の発生時点を記入する。
|
|
31
|
+
|
|
32
|
+
## 3. 誰が/何が
|
|
33
|
+
|
|
34
|
+
| 起点区分 | 要求する主体 | 事実を成立させる主体 | 主体ごとの責務・差異 |
|
|
35
|
+
| ------------- | ------------ | -------------------- | ---------------------- |
|
|
36
|
+
| _ORIGIN_KIND_ | _REQUESTER_ | _CONFIRMING_ACTOR_ | _ACTOR_RESPONSIBILITY_ |
|
|
37
|
+
|
|
38
|
+
_TODO_: システム・調整役の名称を使う場合は、本文での意味と責務を記入する。
|
|
39
|
+
|
|
40
|
+
## 4. 発生条件
|
|
41
|
+
|
|
42
|
+
- _TODO_: 共通の成立条件と根拠となる状態定義・業務ルールの参照を記入する。
|
|
43
|
+
- _TODO_: 起点別に成立条件が異なる場合は、その差分を記入する。
|
|
44
|
+
- _TODO_: 発生しない条件と、確定後の処理を委ねる先を記入する。
|
|
45
|
+
|
|
46
|
+
_TODO_: 未決事項がある場合は関連する章に、内容、利用への影響、決定者、確認担当、判断時期、記録先を記入する。該当しなければこの記入指示を削除する。
|
|
47
|
+
|
|
48
|
+
## 5. 事実データ
|
|
49
|
+
|
|
50
|
+
| 項目 | 業務上の意味 | 必要になる条件 |
|
|
51
|
+
| ----------- | ------------------ | --------------- |
|
|
52
|
+
| _FACT_ITEM_ | _BUSINESS_MEANING_ | _REQUIRED_WHEN_ |
|
|
53
|
+
|
|
54
|
+
_TODO_: データモデルとの対応を記入する。相関情報が必要なら、同じとみなす単位と照合先を記入し、物理項目名・構造は正本へ委ねる。相関が不要ならその理由を記入する。
|
|
55
|
+
|
|
56
|
+
_TODO_: 境界や相関の解釈が分かれる場合は、発生有無・回数や同一要求への帰属を判断できる確認例を表で記入する。確認例を別の章に置いた場合や不要な場合はこの記入指示を削除する。
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:br-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: rule
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:br-rulebook
|
|
12
|
+
based_on: _BASED_ON_
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# _DELIVERABLE_NAME_
|
|
16
|
+
|
|
17
|
+
_DELIVERABLE_OVERVIEW_
|
|
18
|
+
|
|
19
|
+
## 1. 概要
|
|
20
|
+
|
|
21
|
+
- 業務価値: _TODO_: この判断が守る価値と根拠。
|
|
22
|
+
- 利用者・適用場面: _TODO_: 呼出元の業務、判定前に満たす条件。
|
|
23
|
+
- 適用範囲: _TODO_: 対象となるものと時点。
|
|
24
|
+
- 対象外: _TODO_: 隣接する判断・手順への委譲先。
|
|
25
|
+
|
|
26
|
+
## 2. 入力
|
|
27
|
+
|
|
28
|
+
| 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
|
|
29
|
+
| ------ | ---------------- | -------- | ---------------------- |
|
|
30
|
+
| _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
31
|
+
|
|
32
|
+
## 3. ルール(判定/計算)
|
|
33
|
+
|
|
34
|
+
### 3.1. 判定規則
|
|
35
|
+
|
|
36
|
+
_TODO_: 規則の識別子を付け、適用順、条件、結果を記入する。比較・計算の単位、境界値、同順位、項目ごとの欠損、代替規則を該当する範囲で定める。
|
|
37
|
+
|
|
38
|
+
### 3.2. 判定例
|
|
39
|
+
|
|
40
|
+
| 例 | 入力・前提 | 適用規則 | 期待結果 |
|
|
41
|
+
| ------ | ---------- | -------- | -------- |
|
|
42
|
+
| _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
43
|
+
|
|
44
|
+
## 4. 出力
|
|
45
|
+
|
|
46
|
+
| 出力 | 意味・単位または区分 | 利用先 |
|
|
47
|
+
| ------ | -------------------- | ------ |
|
|
48
|
+
| _TODO_ | _TODO_ | _TODO_ |
|
|
49
|
+
|
|
50
|
+
## 5. 例外 / 異常系
|
|
51
|
+
|
|
52
|
+
| ID | 状況 | 扱い | 利用者の次の手 |
|
|
53
|
+
| ------ | ------ | ------ | -------------- |
|
|
54
|
+
| _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
55
|
+
|
|
56
|
+
## 6. メモ / 将来課題
|
|
57
|
+
|
|
58
|
+
_TODO_: 未決事項がなければ「なし」と記入する。ある場合は共通ラベルを付け、次の表に記入する。
|
|
59
|
+
|
|
60
|
+
| 論点 | 判断依頼先 | 判断時点 | 下流への影響・必要な根拠 |
|
|
61
|
+
| ------ | ---------- | -------- | ------------------------ |
|
|
62
|
+
| _TODO_ | _TODO_ | _TODO_ | _TODO_ |
|
|
63
|
+
|
|
64
|
+
_TODO_: 未決事項の解消・承認を含め、承認可能となる条件を記入する。
|