specdojo 0.6.0 → 0.8.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 +3 -2
- package/CHANGELOG.md +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- 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 +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -25
- 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/register-resume.js +69 -42
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- 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 +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- 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 +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -32
- 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 +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- 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 +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- 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.js +149 -15
- package/dist/shared/grade-result.js +17 -1
- 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/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -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 +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- 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 +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -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 +471 -74
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +146 -99
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- 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 +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -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 +132 -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/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-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/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -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 +164 -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/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-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- 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 +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -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/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bac-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:bac-rulebook
|
|
7
|
+
sample: specdojo:bac-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 業務受入条件 作成レシピ
|
|
11
|
+
|
|
12
|
+
Business Acceptance Criteria Writing Recipe
|
|
13
|
+
|
|
14
|
+
業務仕様から利用者が受け入れられる状態を取り出し、前提・行為・結果・証跡へ具体化する作成手順です。正常完了だけでなく、判断を止める場面と次の担当へ渡す情報を掘り下げます。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 上位の業務目的から、誰が何をできずに困っているかを引き継ぎ、受入で守る価値を絞る。
|
|
19
|
+
- 業務が成立したと言える状態を先に書き、その状態へ至る前提と行為を逆算する。実装方式と詳細なテスト操作は後続の担当へ渡す。
|
|
20
|
+
- 業務仕様の判断とシナリオ ID、確認する証跡を結ぶ。根拠がない期待値は新たに決めず、判断依頼として残す。
|
|
21
|
+
|
|
22
|
+
## 2. 作成前に集める情報
|
|
23
|
+
|
|
24
|
+
| 項目 | 集める情報・問い |
|
|
25
|
+
| -------------- | ------------------------------------------------------------------------------------------ |
|
|
26
|
+
| 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか。どの場面でその価値を確認するか |
|
|
27
|
+
| 業務の境界 | 何が起点で、どの記録や引き継ぎまでできれば終わるか |
|
|
28
|
+
| 確定済みの根拠 | BPS・業務ルール・プロジェクト受入条件のどの判断を確認するか |
|
|
29
|
+
| 前提 | 必要な状態、入力、判断権限は何か。不足すると何が止まるか |
|
|
30
|
+
| 証跡と関係者 | 誰がいつ何を照合し、誰が業務的妥当性を承認するか |
|
|
31
|
+
| 未決事項 | 期待値を決める材料はそろっているか。誰の判断をいつまでに得るか。現行の受入を止めるか |
|
|
32
|
+
| 改訂時の影響 | 根拠の変更・廃止はどのシナリオへ及ぶか。旧 ID や期待値を参照する仕様・設計・テストはどれか |
|
|
33
|
+
|
|
34
|
+
## 3. 全体の作成手順
|
|
35
|
+
|
|
36
|
+
1. 概要に受入対象、価値、利用場面、範囲と対象外を書く。価値ごとに確認する場面を選び、確認者と承認者が合意する内容をそろえる。
|
|
37
|
+
2. 受入条件に、代表的な正常完了を一つ書く。開始状態を前提、担当者の業務行為を操作、終了状態を期待結果へ分け、根拠と ID を添える。
|
|
38
|
+
3. 期待結果の各項目に、確認時点・確認者・証跡を対応させて判定方法を書く。確認できない結果は観測可能な記録か状態へ具体化する。
|
|
39
|
+
4. 不足・拒否・途中変更などで結果が変わる場面を加える。同じ行為と観測点で入力だけが違う場合はケース表で差分を示す。
|
|
40
|
+
5. 概要の価値とシナリオ ID を結び、確認できない価値や根拠のないシナリオを見つける。未確定の期待値はメモ / 将来課題へ移し、影響、判断依頼先、解消時点、追跡先を整理する。
|
|
41
|
+
6. 改訂では旧 ID・条件の参照元を検索し、変更する期待結果、判定方法、後続テストを洗い出す。未決の業務判断は入力元へ戻し、BA の影響整理を QE・ARC・PO の確認と PM の追従作業管理へ渡す。
|
|
42
|
+
|
|
43
|
+
## 4. 各章の書き方
|
|
44
|
+
|
|
45
|
+
### 4.1. 概要
|
|
46
|
+
|
|
47
|
+
- 問い: この受入に合格すると、誰が次にどの業務を進められるか。隣の業務の判断まで引き受けていないか。
|
|
48
|
+
- 具体化: 利用者の困りごとを一つ選び、開始点と終了点を先に決める。価値を確認するシナリオ ID を添え、対象外の業務を別文書で扱うならその参照先を示す。
|
|
49
|
+
- 良い例: 「家族が店番しても販売・在庫を記録して引き継げる」。悪い例: 「販売画面を作る」。手段だけで受入の価値を表していない。
|
|
50
|
+
|
|
51
|
+
### 4.2. 受入条件
|
|
52
|
+
|
|
53
|
+
- 問い: その前提でその行為を行ったとき、何が変わり、何が変わらないか。別の人も同じ証跡から合否を判断できるか。
|
|
54
|
+
- 具体化: 一つの記録を照合する場面から始め、正常、入力不足、停止後の再開で異なる結果を探す。必要な数値には単位と確認時点を添える。期待結果を一項目ずつ読み、確認者・確認時点・観測先・照合対象に抜けがないか確かめる。
|
|
55
|
+
- 良い例: 「数量 2 の販売後に在庫が 5 から 3 へ減ることを確定後の記録で照合する」。悪い例: 「在庫が正しい」。確認する差分を特定できない。
|
|
56
|
+
|
|
57
|
+
### 4.3. メモ / 将来課題
|
|
58
|
+
|
|
59
|
+
- 問い: どのシナリオの期待値が未確定で、誰の判断があれば何を再開できるか。現行の受入、期限、依存先へどの影響が及ぶか。
|
|
60
|
+
- 具体化: 確認・追記作業は `_TODO_`、意思決定待ちは `_UNDECIDED_` で区別し、解消条件を添える。現行の受入や追従作業に影響する論点は、BA が影響を整理して PM へ PJR 登録候補として渡し、登録後は個票への参照で追跡する。将来拡張は追加条件を考え、未決がなければ「なし」で閉じる。
|
|
61
|
+
- 良い例: 「記録不能時の販売継続は店主代表が当該シナリオ作成前に判断する。BA が販売停止への影響を整理して PM へ渡し、登録後は個票を追跡する」。悪い例: 「例外は後で追加」。影響と判断の追跡先が分からない。
|
|
62
|
+
|
|
63
|
+
## 5. 深掘り手順
|
|
64
|
+
|
|
65
|
+
1. 概要の価値からシナリオをたどり、確認されない価値と、価値・根拠に結び付かないシナリオを探す。
|
|
66
|
+
2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。担当者の権限や入力の不足で止める範囲を掘り下げる。
|
|
67
|
+
3. 行為の途中で入力や対象が変わる場面を置き、以前の記録をそのまま利用できるかを確認する。
|
|
68
|
+
4. 停止後に次の担当が受け取る情報をたどり、再開に必要な状態と証跡を特定する。根拠で判断できないものは未決事項へ戻す。
|
|
69
|
+
|
|
70
|
+
## 6. 良い例 / 悪い例
|
|
71
|
+
|
|
72
|
+
| 観点 | 良い例 | 悪い例 | 良し悪しを分ける点 |
|
|
73
|
+
| ---- | -------------------------------------------- | ------------------------------ | ------------------------------------ |
|
|
74
|
+
| 根拠 | 業務仕様の入力不足の扱いをシナリオで確認する | 書き手が不足時の既定値を決める | 決定済みの判断を受入へ変換しているか |
|
|
75
|
+
| 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する | 業務行為として読めるか |
|
|
76
|
+
| 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する | 未確定の範囲と次の手が分かるか |
|
|
77
|
+
| 判定 | 確定後の販売記録と在庫差分を照合する | 動けば合格とする | 証跡から再現可能か |
|
|
78
|
+
|
|
79
|
+
## 7. レビュー観点
|
|
80
|
+
|
|
81
|
+
| 観点 | 確認する問い |
|
|
82
|
+
| ---------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
83
|
+
| 業務価値 | 各シナリオの必要性を利用者の課題または根拠の判断から説明できるか |
|
|
84
|
+
| 観測可能性 | 前提・操作と期待結果がつながり、確認時点と証跡を特定できるか |
|
|
85
|
+
| 例外と継承 | 止める判断・記録と、次の担当の行為を区別できるか |
|
|
86
|
+
| 責務境界 | 新しい承認規則や実装方式を受入条件の中で決めていないか |
|
|
87
|
+
| 合意と継承 | BA の整理した範囲を QE が検証へ、ARC が設計へ引き継げるか。PO が判断する合意対象と PM が追跡する残作業を特定できるか |
|
|
88
|
+
|
|
89
|
+
## 8. 仕上げチェック
|
|
90
|
+
|
|
91
|
+
- シナリオ ID と根拠をたどれ、同じ意味のケースを重ねていない。改訂時は旧参照と期待値の更新先を特定できる。
|
|
92
|
+
- 共有前提と例外の前提が両立し、未決の値を確定済みの期待結果へ混ぜていない。
|
|
93
|
+
- 構文・保存構造・詳細テスト操作を整理し、必要な観測点、確認者、承認待ちの影響を残している。
|
|
94
|
+
- 条件を合意できる状態と試行済みの合格実績を区別し、準備作業や未決事項を解消済みとして扱っていない。
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bes-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:bes-rulebook
|
|
7
|
+
sample: specdojo:bes-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 業務イベント仕様 作成レシピ
|
|
11
|
+
|
|
12
|
+
Business Event Specification Writing Recipe
|
|
13
|
+
|
|
14
|
+
起点が違っても同じ出来事と呼べるか、どの時点の何を事実として残すかを具体化するための手順です。業務上の混同を減らし、別の担当者も発生有無とデータの意味を判断できる記述へつなげます。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 上位の業務目的とイベント一覧から、誰が何を取り違えて困るのかを一つ選びます。その混同を解消する事実の境界を本書で定めます。
|
|
19
|
+
- 成立と不成立の場面を並べてから、何が起きたか、いつ、誰が/何が、発生条件、事実データの五章を書きます。処理後の手順や実装方式は委譲先へ分けます。
|
|
20
|
+
- 各主張を、上位イベント・状態定義・データモデルのどれで確認できるかたどります。確認できない境界は推測で埋めず、判断者と確認時期を添えて残します。
|
|
21
|
+
|
|
22
|
+
## 2. 作成前に集める情報
|
|
23
|
+
|
|
24
|
+
| 入力 | 確かめる問い |
|
|
25
|
+
| ---------------- | -------------------------------------------------------------------------- |
|
|
26
|
+
| 業務目的と利用者 | 定義が曖昧だと、誰が何を誤って数えたり引き継いだりするか |
|
|
27
|
+
| 上位イベント一覧 | どの出来事を詳細化するか。共通の対象範囲と個別の差分は何か |
|
|
28
|
+
| 似た出来事 | 要求、受付、確定、着手、処理完了を区別する必要があるか |
|
|
29
|
+
| 起点と主体 | 人の指名、自動判断、一括要求などで成立する事実が変わるか |
|
|
30
|
+
| 状態と業務ルール | 成立直前の状態をどこで判定するか。条件と判断ロジックの正本は何か |
|
|
31
|
+
| データモデル | 対象、取引、要求、実行をどう区別するか。既存の識別情報で相関を説明できるか |
|
|
32
|
+
| 承認と未決事項 | 誰が業務定義を承認するか。確認担当、判断期限、記録先が決まっているか |
|
|
33
|
+
|
|
34
|
+
## 3. 全体の作成手順
|
|
35
|
+
|
|
36
|
+
1. 解消する混同と対象業務を一文にし、読者が発生有無・回数を判定できることを利用の基準にします。
|
|
37
|
+
2. 「何が起きたか」に、一回分の事実と含めない出来事を書きます。適用範囲が不明なら、確認できた業務と未判定の業務を分けます。
|
|
38
|
+
3. 「いつ」に、成立を観測できる時点を書きます。要求から後処理までを時系列に並べ、どこで初めて事実になるかを選びます。
|
|
39
|
+
4. 「誰が/何が」に、要求者と成立させる主体を並べます。起点が異なっても境界が同じかを比較します。
|
|
40
|
+
5. 「発生条件」に、共通条件、起点別の差分、不成立条件を書きます。正本にある判断ロジックをコピーせず、何を満たした事実なのかへ絞ります。
|
|
41
|
+
6. 「事実データ」に、その時点で分かる情報だけを置きます。一括要求は二件以上を紙上で並べ、要求と個別対象を混同しない相関情報を探します。
|
|
42
|
+
7. 発生・相関の確認例から判断を説明します。未決事項には判断者、確認担当、時期、記録先を付け、承認前に引き渡せる範囲を明示します。
|
|
43
|
+
|
|
44
|
+
## 4. 各章の書き方
|
|
45
|
+
|
|
46
|
+
### 4.1. 何が起きたか
|
|
47
|
+
|
|
48
|
+
問いは「誰のどの混同を防ぐ事実か」「同じ要求で二件確定したら一回か二回か」です。名詞だけでなく、対象と成立した事実を一文にします。
|
|
49
|
+
|
|
50
|
+
良い例は「一取引の会計が確定した。複数明細でも一回」。避けたい例は「販売処理」で、事実と処理を区別できません。
|
|
51
|
+
|
|
52
|
+
### 4.2. いつ
|
|
53
|
+
|
|
54
|
+
問いは「成立したと言える最初の観測点はどこか」「同じ排他区間で行う別の処理も同じ出来事なのか」です。処理の近さと業務上の同一性を分けて考えます。
|
|
55
|
+
|
|
56
|
+
良い例は「会計確定を記録した時点」。避けたい例は「会計中」で、発生前後を分けられません。
|
|
57
|
+
|
|
58
|
+
### 4.3. 誰が/何が
|
|
59
|
+
|
|
60
|
+
問いは「要求者と確定する主体は同じか」「人の判断とシステムの記録の責任はどこで分かれるか」です。名称を役割、構成要素、実際の担当者のどれとして使うか確かめます。
|
|
61
|
+
|
|
62
|
+
良い例は「店番担当が要求し、販売管理システムが確定を記録する」。避けたい例は「担当が実行する」で、何を担当したかが分かりません。
|
|
63
|
+
|
|
64
|
+
### 4.4. 発生条件
|
|
65
|
+
|
|
66
|
+
問いは「直前まで同じでも、何が欠けたら発生しないか」「今の依存文書だけで全業務への適用を判断できるか」です。成立する例の条件を一つだけ外して、不成立の境界を探します。
|
|
67
|
+
|
|
68
|
+
良い例は「未確定の取引で受領を確認して確定した場合。合計表示だけでは発生しない」。避けたい例は「条件が揃えば発生する」で、確認すべき条件が隠れます。
|
|
69
|
+
|
|
70
|
+
### 4.5. 事実データ
|
|
71
|
+
|
|
72
|
+
問いは「各項目は何を区別するために必要か」「最後にしか分からない件数を最初の事実にしていないか」「実行 ID で同じ要求をたどれる根拠はあるか」です。データモデルの項目名を先に決めず、意味と単位から対応を確認します。
|
|
73
|
+
|
|
74
|
+
良い例は「取引番号で確定と明細を対応付ける」。避けたい例は「時刻が近いので同じ要求」とする推定です。
|
|
75
|
+
|
|
76
|
+
## 5. 深掘り手順
|
|
77
|
+
|
|
78
|
+
1. 事実の境界で意見が分かれたら、同じ操作でも発生しない例を一つ示し、何を観測できていないか確認します。
|
|
79
|
+
2. 自動・一括で説明が崩れたら、二つの要求にそれぞれ複数の対象を置き、要求、対象、実行の対応を書き出します。既存モデルで対応できなければ未決事項にします。
|
|
80
|
+
3. 根拠が参照範囲にないときは、必要な文書 ID と依存追加の必要性を記録します。確認済みの範囲まで書き、未確認の業務を恒久的に除外する結論は出しません。
|
|
81
|
+
|
|
82
|
+
## 6. 良い例 / 悪い例
|
|
83
|
+
|
|
84
|
+
| 観点 | 良い例 | 悪い例 | 判断の違い |
|
|
85
|
+
| -------- | ---------------------------------------------------------------- | ---------------------------- | ------------------------------ |
|
|
86
|
+
| 発生単位 | 一取引に複数明細があっても確定は一回 | 複数の場合も扱う | 数える単位を決められるか |
|
|
87
|
+
| 観測時点 | 確定記録の成立時。印字完了は後処理 | 正常に終了した時 | 何の終了かが分かるか |
|
|
88
|
+
| 未決事項 | 判断者と確認担当を分け、設計着手前に判断結果をレビュー結果へ記録 | 後で確認する | 誰がいつ何を決めるかたどれるか |
|
|
89
|
+
| 相関情報 | 同じ要求の二件は同じ相関情報、別要求では区別する | 同じ実行 ID を使えばよいはず | 根拠のある単位で関連付けるか |
|
|
90
|
+
|
|
91
|
+
## 7. レビュー観点
|
|
92
|
+
|
|
93
|
+
| 観点 | 確認する問い | 主な確認者 |
|
|
94
|
+
| ---------------- | ------------------------------------------------------ | ---------- |
|
|
95
|
+
| 業務価値 | 解消したい混同と、定義した発生境界が対応するか | BA |
|
|
96
|
+
| 業務承認 | 対象範囲と未決事項を判断する人間を識別できるか | PO |
|
|
97
|
+
| 技術への引き渡し | 状態定義とデータモデルに照合でき、未確認部分が分かるか | ARC |
|
|
98
|
+
| 確認可能性 | 同じ場面から発生有無・回数・相関を判断できるか | QE |
|
|
99
|
+
|
|
100
|
+
## 8. 仕上げチェック
|
|
101
|
+
|
|
102
|
+
- 用いた主体名と識別情報の意味が、五章の間で変わっていないことを確認します。
|
|
103
|
+
- 発生条件を満たさない例と、成立後の処理が失敗する例を混同していないことを確認します。
|
|
104
|
+
- 確認できた範囲と未判定の範囲を区別し、判断者・時期・記録先のない論点を残していないことを確認します。
|
|
105
|
+
- 本文に残した情報が発生時点で観測でき、後処理の手順や正本の項目定義を重複していないことを確認します。
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:br-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:br-rulebook
|
|
7
|
+
sample: specdojo:br-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ビジネスルール 作成レシピ
|
|
11
|
+
|
|
12
|
+
Business Rule Writing Recipe
|
|
13
|
+
|
|
14
|
+
業務担当者の判断を、実装と検証へ引き継げる条件・結果に具体化するための作成手順です。特に境界、欠損、競合する条件と未決事項を掘り下げます。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 上位の業務目的から、この判断が誤った場合に誰が何に困るかを確認する。
|
|
19
|
+
- 入力と期待する結果を対にして書き、判断の仕方を業務用語で説明する。画面操作や保存方式は、それを定める後続成果物へ渡す。
|
|
20
|
+
- 根拠文書・規則・判定例を結び、判断が変わったときに影響箇所を追えるようにする。不足する根拠は業務担当者への問いに戻す。
|
|
21
|
+
|
|
22
|
+
## 2. 作成前に集める情報
|
|
23
|
+
|
|
24
|
+
| 項目 | 集める情報・問い |
|
|
25
|
+
| -------- | ---------------------------------------------------------- |
|
|
26
|
+
| 利用場面 | 誰がどの業務の途中で判断し、誤判定で何が起きるか |
|
|
27
|
+
| 境界 | 直前までに何が確定し、直後にどの業務へ結果を渡すか |
|
|
28
|
+
| 判断材料 | 必要な概念項目、単位、比較時点、入力の出所 |
|
|
29
|
+
| 結果 | 正常な結果、対象なし、判定できない場合をどう見分けるか |
|
|
30
|
+
| 根拠 | 決定済みの条件、参照文書とその作成状況、承認が要る変更 |
|
|
31
|
+
| 未決事項 | 誰へ何を判断してもらい、いつまでに決まらないと何が止まるか |
|
|
32
|
+
|
|
33
|
+
## 3. 全体の作成手順
|
|
34
|
+
|
|
35
|
+
1. 概要で「どの場面で何を判断するか」を一文にし、守る価値と対象外を添える。
|
|
36
|
+
2. 入力で、最初の具体例に必要な項目を書き出す。単位と比較時点をそろえる。
|
|
37
|
+
3. ルール(判定/計算)で、その例の結果になる理由を条件に変換する。等号・同順位・未設定の例へ広げ、適用順を決める。
|
|
38
|
+
4. 出力で、結果を受け取る相手が次の業務を選べる意味を添える。
|
|
39
|
+
5. 例外 / 異常系で、入力不備と参照失敗を通したときに、業務が続くかを確かめる。
|
|
40
|
+
6. メモ / 将来課題へ根拠不足と未決の判断を集め、依頼先、判断時点、下流の制約を残す。
|
|
41
|
+
|
|
42
|
+
## 4. 各章の書き方
|
|
43
|
+
|
|
44
|
+
| 章 | 書き手が答える問い | 具体化のコツ |
|
|
45
|
+
| ------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------ |
|
|
46
|
+
| 概要 | この判断は誰のどの困りごとを減らすか。前後の手順と重複しないか | 実際の利用場面を一つ選び、開始条件と対象外を切り分ける |
|
|
47
|
+
| 入力 | その材料が一つ欠けても判断できるか。どの時点の数値を使うか | 項目を一つずつ隠して、仮のゼロで代用していないか調べる |
|
|
48
|
+
| ルール(判定/計算) | なぜその結果になるか。条件が同時成立したらどちらを優先するか | 境界の直前・一致・直後を並べ、期待値の異なる理由を説明する |
|
|
49
|
+
| 出力 | 結果を受け取る人は何を判断できるか。対象なしと失敗を区別できるか | 結果の意味を言葉にし、利用先に不要な内部計算値を除く |
|
|
50
|
+
| 例外 / 異常系 | 間違った値を使い続けた場合の業務影響は何か | 停止・代替・対象外のそれぞれで、結果の有効性と回復の行動を確認する |
|
|
51
|
+
| メモ / 将来課題 | どの証拠または誰の判断があれば確定できるか | 現行範囲を変える論点と、確認作業だけの不足を分けて依頼する |
|
|
52
|
+
|
|
53
|
+
## 5. 深掘り手順
|
|
54
|
+
|
|
55
|
+
1. 代表例を業務担当者へ説明し、根拠のない条件や、業務価値へつながらない計算を見つける。
|
|
56
|
+
2. 境界値、欠損、競合する条件で結果が変わる箇所を探す。文字列比較なら大小文字や数字を含む例で同順位の決着が変わらないかを問う。
|
|
57
|
+
3. 順位規則なら一つの項目だけが欠ける場合と、全件で計算できない場合を分ける。両者を同じ代替規則にしてよい根拠を確かめる。
|
|
58
|
+
4. 決められない期待値を作らず、選択肢によって変わる下流の作業とともに判断依頼へ戻す。
|
|
59
|
+
|
|
60
|
+
## 6. 良い例 / 悪い例
|
|
61
|
+
|
|
62
|
+
| 観点 | 良い例 | 悪い例 | 良し悪しを分ける点 |
|
|
63
|
+
| ---------- | ---------------------------------------------------------------------------------- | ------------------------ | ---------------------------------- |
|
|
64
|
+
| 境界 | 「発注点と等しければ不足なし」 | 「少なければ不足」 | 等号で結果を確定できるか |
|
|
65
|
+
| 入力の不足 | 「予約数がないと販売可能数を算出できない」 | 「空欄はたぶんゼロ」 | 業務根拠のある扱いか |
|
|
66
|
+
| 利用先 | 「不足判定を在庫確認担当へ返す。発注確定は担当者が行う」 | 「不足なら自動発注する」 | 判断から別の責務へ飛躍していないか |
|
|
67
|
+
| 未決事項 | 「閾値変更は店主代表に導入承認前の判断を依頼する。未決なら新閾値の実装を保留する」 | 「閾値は後で考える」 | 次の判断と影響が追えるか |
|
|
68
|
+
|
|
69
|
+
## 7. レビュー観点
|
|
70
|
+
|
|
71
|
+
| 観点 | 確認する問い |
|
|
72
|
+
| ------------ | ------------------------------------------------------------------ |
|
|
73
|
+
| 業務的な理由 | 主要な条件がどの課題・価値・決定に由来するか説明できるか |
|
|
74
|
+
| 再現性 | 二人が同じ具体例に別の期待値を付ける余地はないか |
|
|
75
|
+
| 引継ぎ | 正常結果と例外から、利用者が次に行う業務を選べるか |
|
|
76
|
+
| 責務境界 | 手順、構文、保存構造を、それを定める成果物へ委譲できているか |
|
|
77
|
+
| 判断待ち | 未決事項の影響する規則・例と、判断を依頼する相手を結び付けられるか |
|
|
78
|
+
|
|
79
|
+
## 8. 仕上げチェック
|
|
80
|
+
|
|
81
|
+
- 概要から入力、判定、出力、例外、残る判断へ読み進めて、参照していない材料や使われない結果がない。
|
|
82
|
+
- 判定例は本文で説明した条件から導け、未決の期待値を確定済みの値として示していない。
|
|
83
|
+
- 同じ条件を表・文章・擬似コードで繰り返さず、変更する箇所を一つに絞れている。
|
|
84
|
+
- 上位の目的の再掲と実装の詳細を整理し、必要な根拠の参照と未決事項の引継ぎが残っている。
|
|
@@ -11,45 +11,45 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Conceptual Data Flow Diagram Overview Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
業務または運用の全体像を、プロセス領域のまとまりと、それらが読み書きするデータの関係として示すための作成手順です。今の方式(プロセスグループ別 CDFD を置く方式)と、系統の関係を描く方式(区分を代表ノードにし、各系統をユースケース別 CDFD で詳細化する方式)から選びます。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
18
|
- 最初に、対象業務・運用の範囲と、プロセス領域・データストアの候補を粗く書き出します。
|
|
19
|
-
-
|
|
20
|
-
-
|
|
19
|
+
- 次に、各章の問いに答えながら、目的、適用範囲、プロセス領域の表、データストア、概念データフロー(概要)、詳細 CDFD 一覧を具体化します。
|
|
20
|
+
- 最後に、レビュー観点で「表と図の名称が対応し、受け渡しが図で読み取れるか」「領域単位の詳細を書きすぎていないか」を確認します。
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
この成果物は、プロセスグループまたは区分とデータストアの名称を軸に、プロセス領域の表・データストア・図・詳細 CDFD 一覧の四点を対応させ、上位の業務目的を領域分割の理由として引き継ぎます。領域内の手順や実装方式は作り込まず、各要素の対応関係で判断を追跡できるようにします(Trace)。
|
|
23
23
|
|
|
24
24
|
## 2. 作成前に集める情報
|
|
25
25
|
|
|
26
|
-
| 項目
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
| 対象範囲
|
|
30
|
-
| 対象外
|
|
31
|
-
| 領域候補
|
|
32
|
-
|
|
|
33
|
-
| 主な担当
|
|
34
|
-
| 起点イベント
|
|
35
|
-
| データストア
|
|
36
|
-
| 保管先
|
|
37
|
-
| 主要な受け渡し
|
|
38
|
-
| 物理保管
|
|
39
|
-
| 外部主体
|
|
40
|
-
| 横断ユースケース
|
|
41
|
-
| 未決事項
|
|
26
|
+
| 項目 | 集める情報 |
|
|
27
|
+
| ------------------ | --------------------------------------------------------------------------------------------------------------- |
|
|
28
|
+
| 全体像 | 対象業務を構成するプロセス領域のまとまりと、読み書きするデータの関係 |
|
|
29
|
+
| 対象範囲 | 開始点、終了点、対象業務、組織、システム境界 |
|
|
30
|
+
| 対象外 | 補助操作、領域内の手順、実装詳細、別成果物が責任を持つ事項 |
|
|
31
|
+
| 領域候補 | 固有の業務目的、主な担当、起点イベントを持つ責務のまとまり |
|
|
32
|
+
| グループ・区分候補 | 業務の性質が近い領域のまとまり。系統の関係を描く方式では、系統・実行サイクル・調整役などの区分 |
|
|
33
|
+
| 主な担当 | 各領域を主に担うロール、複数ロールが担う場合の管理責任、人間の最終判断者 |
|
|
34
|
+
| 起点イベント | 各領域の開始を判定できる出来事 |
|
|
35
|
+
| データストア | 各グループまたは区分が参照・更新する論理的な正本と、その内容。マスタ・構成かトランザクションかの区分 |
|
|
36
|
+
| 保管先 | データストアの物理的な所在。実装が先にある場合は確定値、設計中は候補、概念段階では扱わない |
|
|
37
|
+
| 主要な受け渡し | グループまたは区分とデータストアの間で移動する情報・物、区分間の実行要求、調整役の直接読み書きと CLI 経由の区別 |
|
|
38
|
+
| 物理保管 | 現物(商品・現金など)を保管する場所(物の流れを図示する場合) |
|
|
39
|
+
| 外部主体 | 対象範囲外から入力を渡す人・組織・システムと、結果を受け取る主体。対象範囲内の参加者は含めない |
|
|
40
|
+
| 横断ユースケース | 今の方式では複数グループをまたぐ業務、系統の関係を描く方式では各系統の流れ |
|
|
41
|
+
| 未決事項 | 境界、名称、責務、判断者、保管先が未確定な論点と、影響、決定者、決定時期 |
|
|
42
42
|
|
|
43
43
|
## 3. 全体の作成手順
|
|
44
44
|
|
|
45
|
-
1.
|
|
45
|
+
1. 全体像として示す関係を 1〜2 文で書き、開始点、終了点、対象外を定義します。
|
|
46
46
|
2. 開始から結果利用までの業務成果を並べ、起点イベントと最終出力が異なるまとまりへ分け、各まとまりへ安定した領域 ID を付けます。
|
|
47
47
|
3. 一覧、検索、状態参照、検証、dry-run など、独立した業務成果を持たない候補を支援先の領域へ戻します。
|
|
48
|
-
4.
|
|
49
|
-
5.
|
|
50
|
-
6.
|
|
51
|
-
7.
|
|
52
|
-
8.
|
|
48
|
+
4. 業務の性質が近い領域を、今の方式ではプロセスグループへ、系統の関係を描く方式では区分へまとめ、8 以下にします。各節には領域の表だけを置き、必要なら PDCA 列を追加します。受け渡しの正本は図とし、主要入力・主要出力の箇条書きは置きません。
|
|
49
|
+
5. 各グループまたは区分が参照・更新するデータストアを集め、更新契機でマスタ・構成データとトランザクションデータに区分し、一覧にします。保管先は確定度に応じて列を置くか省略します。
|
|
50
|
+
6. グループまたは区分を代表ノードにし、データストアとの関係と区分間の要求を名詞のラベル付きの線で描きます。16 ノードを超える場合は選択した方式で分けます。系統の関係を描く方式ではデータの種類で分け、区分の位置をそろえ、線のない区分を省きます。調整役の指示は別図にし、直接読み書きするストアだけを調整役につなぎます。
|
|
51
|
+
7. 今の方式ではプロセスグループ別 CDFD の表と、横断業務のユースケース別 CDFD の表を作ります。系統の関係を描く方式では、各系統の流れをユースケース別 CDFD の表に載せます。
|
|
52
|
+
8. 名称を使って領域表、データストア、図、詳細 CDFD 一覧を突き合わせ、重複、欠落、名称ゆれを解消します。
|
|
53
53
|
9. 確定できない論点は影響と決定時期を添えて未決事項へ分離します。
|
|
54
54
|
|
|
55
55
|
## 4. 各章の書き方
|
|
@@ -58,17 +58,17 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
58
58
|
|
|
59
59
|
問い:
|
|
60
60
|
|
|
61
|
-
-
|
|
62
|
-
-
|
|
61
|
+
- どの業務または運用の全体像を示しますか。
|
|
62
|
+
- その全体像を構成するプロセス領域のまとまりと、読み書きするデータの関係は何ですか。
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
全体像として何を示すかを 1〜2 文で書きます。例えば「店舗運営の全体像として、仕入・販売・在庫・顧客・締めと、それらが読み書きするデータの関係を示す」とします。PO の承認や引き継ぎなどの作業、読み手の役割は目的に含めません。対象範囲と領域分割の PO 承認記録は、目的とは別に `ready` 昇格の完成判定で確認します。
|
|
65
65
|
|
|
66
66
|
### 4.2. 適用範囲
|
|
67
67
|
|
|
68
68
|
問い:
|
|
69
69
|
|
|
70
70
|
- どの出来事から、どの成果または判断までを扱いますか。
|
|
71
|
-
-
|
|
71
|
+
- 領域内部として選択した方式の詳細 CDFD へ委ねるものと、業務成果を持たないため補助操作として除外するものは何ですか。
|
|
72
72
|
- 人間が責任を持つ判断と、AI Agent やシステムが支援できる処理の境界はどこですか。対応する責任分担文書はありますか。
|
|
73
73
|
- 特定プロジェクトの実行計画・スケジュール上のフェーズ名を、前提知識のない読者への説明なく持ち込んでいませんか。
|
|
74
74
|
|
|
@@ -79,12 +79,11 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
79
79
|
問い:
|
|
80
80
|
|
|
81
81
|
- 各領域には、他の領域と区別できる固有の起点イベントと業務成果がありますか。定義系の領域の起点を実行の契機で書いていませんか。
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
- データストアの名称は「データストア」と一致していますか。
|
|
82
|
+
- グループまたは区分の見出しと領域表から、そのまとまりの業務目的が読み取れますか。
|
|
83
|
+
- 各領域は一つのグループまたは区分にだけ属していますか。PDCA を示す場合は任意の列にしていますか。
|
|
85
84
|
- 主な担当を「全員」だけで終わらせず、管理責任のロールを示していますか。
|
|
86
85
|
|
|
87
|
-
|
|
86
|
+
グループまたは区分ごとに節を設け、領域 ID、プロセス領域、業務目的、主な担当、起点イベントの表だけを置きます。PDCA は任意の列です。受け渡しは図を正本とし、主要入力・主要出力の箇条書きは置きません。業務目的は手段名ではなく、対象者が利用する成果または維持したい状態で書きます。領域を分けるか迷う場合は、起点、最終出力、更新する正本の三点を比較します。領域内部の詳細は選択した方式の詳細 CDFD へ委ねます。
|
|
88
87
|
|
|
89
88
|
### 4.4. データストア
|
|
90
89
|
|
|
@@ -92,7 +91,7 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
92
91
|
|
|
93
92
|
- 各データストアは、何の正本かが分かる名称ですか。生成物の場合は生成元、退避先の場合は退避対象が主な内容に書かれていますか。
|
|
94
93
|
- 区分は更新契機で判定していますか。定義から生成される生成物を、生成元と同じ区分にしていませんか。
|
|
95
|
-
- 保管先の列を置く場合、確定度に合った書き方(確定値、`_UNDECIDED_
|
|
94
|
+
- 保管先の列を置く場合、確定度に合った書き方(確定値、`_UNDECIDED_`、列の省略)になっていますか。保管先を共有・包含する場合は、論理境界と共有相手を注記していますか。
|
|
96
95
|
- リポジトリ基盤や開発環境の設定など、業務データでないものを除外していますか。
|
|
97
96
|
|
|
98
97
|
マスタ・構成データとトランザクションデータの 2 表に分けます。図に置くデータストアはこの一覧の行と一対一にするため、図で使いたい名称をここで確定します。
|
|
@@ -101,27 +100,28 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
101
100
|
|
|
102
101
|
問い:
|
|
103
102
|
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
103
|
+
- 今の方式と、系統の関係を描く方式のどちらを使いますか。凡例または章冒頭で宣言していますか。
|
|
104
|
+
- 代表ノードはグループまたは区分ごとに一つで、名称と含む領域 ID をラベルにしていますか。`subgraph` で囲んでいませんか。
|
|
105
|
+
- データストアは一覧の各行と一対一で名称が一致していますか。同じストアを複数図に再掲する場合も同じ名称ですか。
|
|
106
|
+
- 線のラベルは、何がどこからどこへ渡るか分かる名詞ですか。区分から区分への「対応要求」「実行要求」なども名詞のラベルで描いていますか。
|
|
107
|
+
- 対象範囲内の参加者を外部主体にしていませんか。外部主体は対象範囲外の入力元・出力先だけですか。
|
|
108
|
+
- 16 ノードを超える場合、選択した方式で分割していますか。今の方式ではデータストアの区分または使い方の流れで分け、名称を統一していますか。
|
|
109
|
+
- 系統の関係を描く方式では、データの種類で分けた図の間で区分の位置がそろっていますか。受け渡しの線のない区分をその図から省き、各区分をいずれかの図に出していますか。配置制御の非表示の線を受け渡しとして数えていませんか。
|
|
110
|
+
- 系統の関係を描く方式では、調整役(Orchestrator)をデータの図から外し、必要なら指示の図を別に設けていますか。調整役からストアへの線は直接の読み書きだけですか。CLI 経由のものはデータの図で該当区分からの線になっていますか。
|
|
111
|
+
- 図の題は業務の言葉で付けていますか。図の説明は、図から読み取れることを 1 文で書き、作図の約束は凡例に任せていますか。
|
|
111
112
|
|
|
112
|
-
|
|
113
|
+
系統の関係を描く方式では、例えば「PDCA のプロセスとデータの関係」「プロセスを実行する設定・構成情報の流れ」「Orchestrator による PDCA の調整」の 3 図にします。実行要求をトランザクションの図だけに限定する規則は設けず、調整役の指示は指示の図に描きます。グループや区分の内部は詳細 CDFD へ委ねます。物の流れがある場合は物理保管も図の要素として扱い、線種は採用した記法の凡例に従います。
|
|
113
114
|
|
|
114
115
|
### 4.6. 詳細 CDFD 一覧
|
|
115
116
|
|
|
116
117
|
問い:
|
|
117
118
|
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
- ユースケース別 CDFD の表に載せた業務は、複数のグループを横断し、順序と引き渡し条件を定める必要がありますか。単一グループに閉じる業務を載せていませんか。
|
|
119
|
+
- 選択した方式に応じた詳細 CDFD の役割分担を示していますか。状態の定義と遷移は STSD を正本にしていますか。
|
|
120
|
+
- 今の方式では、プロセスグループ別 CDFD の表に全グループが 1 行ずつあり、各領域がちょうど一つの行に属していますか。ユースケース別 CDFD は複数グループを横断する順序と引き渡し条件だけを扱っていますか。
|
|
121
|
+
- 系統の関係を描く方式では、各系統の流れをユースケース別 CDFD でプロセス領域の単位に詳細化していますか。プロセスグループ別 CDFD の表は省略するか、移行期・非推奨の記録として扱っていますか。
|
|
122
122
|
- 「未作成」などの作成状況を本文に書いていませんか。
|
|
123
123
|
|
|
124
|
-
作成状況は登録簿で追跡し、本文には ID
|
|
124
|
+
作成状況は登録簿で追跡し、本文には ID だけを書きます。今の方式で単一グループに閉じる業務はグループ別 CDFD で扱い、ユースケース別 CDFD は横断業務が必要になった時点で追加します。
|
|
125
125
|
|
|
126
126
|
### 4.7. 凡例(本プロダクト共通)(任意)
|
|
127
127
|
|
|
@@ -129,7 +129,7 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
129
129
|
|
|
130
130
|
- 本プロダクトに複数の詳細 CDFD があり、共通のノード形状・色・絵文字を使いますか。
|
|
131
131
|
- 全体概要と詳細 CDFD の各図が、この章の定義を再掲せず参照する形になっていますか。
|
|
132
|
-
-
|
|
132
|
+
- サンプル図には、採用する記法(Mermaid または D2)の rulebook が定義する全ノード種別が一つずつ含まれていますか。
|
|
133
133
|
|
|
134
134
|
詳細 CDFD が複数あり、色・絵文字の割り当てを毎回説明し直すと負担になる場合に設けます。単一の CDFD しかない場合は省略します。
|
|
135
135
|
|
|
@@ -146,53 +146,55 @@ Conceptual Data Flow Diagram Overview Writing Recipe
|
|
|
146
146
|
|
|
147
147
|
1. 各領域の目的から逆向きにたどり、その領域が応える利用者の判断または業務課題を確認します。
|
|
148
148
|
2. 各領域の起点イベントを見て、定義系の領域が実行の契機で書かれていないか、同じグループ内で同文になっていないかを確認します。
|
|
149
|
-
3.
|
|
149
|
+
3. 図の出力の線から順向きにたどり、他グループ・区分または外部主体が利用するか、データストアに残るかを確認します。
|
|
150
150
|
4. 同じデータストアを更新する複数グループを並べ、更新責務が重複していないか確認します。
|
|
151
|
-
5.
|
|
152
|
-
6.
|
|
151
|
+
5. 図の線を一本ずつたどり、領域表の業務目的とストアの主な内容に照らして、欠けた受け渡しや不要な線を修正します。
|
|
152
|
+
6. 「データストア」の各行がいずれかの図に登場し、再掲時も名称が一致するか確認します。保管先が重なる場合は論理境界と共有相手の注記を確認します。
|
|
153
153
|
7. コマンド名、画面名、ファイル名を隠しても目的と受け渡しを説明できるか確認し、説明できない行を概念粒度へ戻します。
|
|
154
154
|
8. 補助操作を除外したことで必要な検証入力が失われていないか確認し、独立領域ではなく支援先の入力として残します。
|
|
155
155
|
|
|
156
156
|
## 6. 良い例 / 悪い例
|
|
157
157
|
|
|
158
|
-
| 観点 | 良い例
|
|
159
|
-
| ------------ |
|
|
160
|
-
| 業務目的 | 現金販売を記録し、商品を顧客へ渡す
|
|
161
|
-
| 起点イベント | 定期実行定義は「定期的に確認・実行する事項が判明した」
|
|
162
|
-
| グループ粒度 | 店頭販売とつけ販売を「販売」グループにまとめ、値引きや取消の手順は詳細 CDFD へ委ねる
|
|
163
|
-
| 入出力 | 入力は購入依頼と支払、売価、つけ上限。出力は販売記録とつけ販売の記録
|
|
164
|
-
| データストア | 販売取引の正本である「販売記録」と、その生成物である「日次締め記録」を分ける
|
|
165
|
-
| 区分 | 定期実行定義(定義)はマスタ・構成、実行記録(活動の記録)はトランザクション
|
|
166
|
-
| 保管先 | 実装があるのでパスを書く。設計中は `_UNDECIDED_`。概念段階は列を省略
|
|
167
|
-
| 補助操作 | 商品検索は販売の入力確認として扱う
|
|
168
|
-
| 図の要素 | 顧客と仕入先を外部主体、店主を各領域の担当として内側に置く
|
|
169
|
-
| ノード数 | 代表ノード 6 とデータストア 15 の計 21
|
|
170
|
-
| 詳細化先 | 販売グループを `cdfd-sales` へ、つけ販売から精算までを `cdfd-uc-credit-sales` へ割り当てる
|
|
158
|
+
| 観点 | 良い例 | 悪い例 |
|
|
159
|
+
| ------------ | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
160
|
+
| 業務目的 | 現金販売を記録し、商品を顧客へ渡す | 販売登録画面を実行する |
|
|
161
|
+
| 起点イベント | 定期実行定義は「定期的に確認・実行する事項が判明した」 | 定期実行定義に「指定された時期が到来した」(実行の契機) |
|
|
162
|
+
| グループ粒度 | 店頭販売とつけ販売を「販売」グループにまとめ、値引きや取消の手順は詳細 CDFD へ委ねる | 全体概要に値引き、取消、再入力を別ノードで並べる |
|
|
163
|
+
| 入出力 | 入力は購入依頼と支払、売価、つけ上限。出力は販売記録とつけ販売の記録 | 入力はフォーム、出力は JSON |
|
|
164
|
+
| データストア | 販売取引の正本である「販売記録」と、その生成物である「日次締め記録」を分ける | `sales-table`。または販売記録と締め記録を一つにまとめる |
|
|
165
|
+
| 区分 | 定期実行定義(定義)はマスタ・構成、実行記録(活動の記録)はトランザクション | 定義と記録を同じ区分にする |
|
|
166
|
+
| 保管先 | 実装があるのでパスを書く。設計中は `_UNDECIDED_`。概念段階は列を省略 | 未定なのに推測でパスを書く |
|
|
167
|
+
| 補助操作 | 商品検索は販売の入力確認として扱う | 商品検索を独立したプロセス領域にする |
|
|
168
|
+
| 図の要素 | 顧客と仕入先を外部主体、店主を各領域の担当として内側に置く | 店主を外部主体として描く |
|
|
169
|
+
| ノード数 | 代表ノード 6 とデータストア 15 の計 21 なのでデータの種類で分け、調整役がいれば指示を別図にする | 21 ノードを 1 図に並べる |
|
|
170
|
+
| 詳細化先 | 販売グループを `cdfd-sales` へ、つけ販売から精算までを `cdfd-uc-credit-sales` へ割り当てる | 領域ごとに詳細 CDFD を作り、横断業務を各図に重複記載する |
|
|
171
171
|
|
|
172
172
|
## 7. レビュー観点
|
|
173
173
|
|
|
174
|
-
| 観点 | 確認内容
|
|
175
|
-
| ---------- |
|
|
176
|
-
| 業務価値 | 各領域の目的が、対象者の課題、判断、期待する業務成果のどれに応えるか説明できる
|
|
177
|
-
| 対象境界 | 領域、プロセスグループ、補助操作、領域内部、人間の最終判断、外部主体の境界を承認できる
|
|
178
|
-
| 詳細化入力 |
|
|
179
|
-
| 網羅性 |
|
|
180
|
-
| 用語整合 |
|
|
181
|
-
| 粒度 |
|
|
182
|
-
| 可読性 |
|
|
174
|
+
| 観点 | 確認内容 | 主な確認者 |
|
|
175
|
+
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
|
|
176
|
+
| 業務価値 | 各領域の目的が、対象者の課題、判断、期待する業務成果のどれに応えるか説明できる | BA |
|
|
177
|
+
| 対象境界 | 領域、プロセスグループ、補助操作、領域内部、人間の最終判断、外部主体の境界を承認できる | PO |
|
|
178
|
+
| 詳細化入力 | 各グループまたは区分の受け渡し、データストア、詳細化先を識別できる | ARC |
|
|
179
|
+
| 網羅性 | 各領域が一つのグループまたは区分に属し、選択した方式の詳細 CDFD へ対応し、受け渡しに欠落がない | QE |
|
|
180
|
+
| 用語整合 | 領域、グループ、データストアの名称が表、一覧、図、詳細 CDFD 一覧で一致する | BA、QE |
|
|
181
|
+
| 粒度 | 全体概要がグループまたは区分単位の受け渡しに留まり、領域単位の入出力、手順、状態、例外、実装詳細を詳細化先へ委譲する | BA、ARC |
|
|
182
|
+
| 可読性 | グループまたは区分が 8 以下で、16 ノードを超える場合は選択した方式で分割され、系統の関係を描く方式では区分の位置と指示の別図が適切である | BA、ARC |
|
|
183
183
|
|
|
184
184
|
## 8. 仕上げチェック
|
|
185
185
|
|
|
186
|
-
-
|
|
187
|
-
|
|
188
|
-
-
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
-
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
-
|
|
195
|
-
-
|
|
196
|
-
-
|
|
186
|
+
最終的な完成判定は [[specdojo:cdfd-overview-rulebook|作成ルール]] の完成判定を正本とし、ここでは作成中の整合を確かめます。
|
|
187
|
+
|
|
188
|
+
- 目的は全体像として何を示すかを 1〜2 文で書き、対象範囲、対象外、責任分担は適用範囲に書いた。
|
|
189
|
+
- 各領域に ID、業務目的、担当、起点イベントがあり、各グループまたは区分の節は領域表だけにした。PDCA 列は必要な場合だけ追加した。
|
|
190
|
+
- グループまたは区分が 8 以下である。
|
|
191
|
+
- データストアをマスタ・構成とトランザクションに分け、保管先列を確定度に合った扱いにした。
|
|
192
|
+
- 代表ノード、領域表、データストア、詳細 CDFD 一覧の名称と ID が対応し、`subgraph` を使っていない。
|
|
193
|
+
- 受け渡しの全線に名詞のラベルがあり、区分間の実行要求も内容を読み取れる。
|
|
194
|
+
- 16 ノードを超える場合は選択した方式で分割した。系統の関係を描く方式ではデータの図で区分の位置をそろえ、線のない区分を省き、各区分はいずれかの図に出した。
|
|
195
|
+
- 系統の関係を描く方式では、調整役はデータの図に置かず、必要な指示の図に置いた。直接読み書きするストアだけにつなぎ、CLI 経由の読み書きはデータの図の該当区分から描いた。
|
|
196
|
+
- 図の題は業務の言葉で、図の説明は読み取れることを 1 文で書き、作図の約束を凡例にまとめた。
|
|
197
|
+
- 対象範囲内の参加者を外部主体にせず、補助操作を独立領域にしていない。
|
|
198
|
+
- 詳細 CDFD 一覧は選択した方式に従い、作成状況を書いていない。領域内部の詳細と状態定義はそれぞれの正本へ委ねた。
|
|
199
|
+
- 未決事項は `_UNDECIDED_` で区別し、影響、決定者、決定時期、状態を記載した。未決事項がなければ章を設けていない。
|
|
197
200
|
- 作業メモを HTML コメントで本文に残していない。
|
|
198
|
-
- 「凡例(本プロダクト共通)」を設けた場合、各図の注記がその定義を再掲せず参照している。
|