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
|
@@ -11,52 +11,37 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Conceptual Data Flow Diagram Process Group Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
全体概要から一つのプロセスグループを引き継ぎ、領域内と領域間のプロセス、主要例外、グループ外への委譲を、関係者が再現できる形で具体化するための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- 最後に、全領域と全プロセスの網羅性、データストア名称・区分・読み書き、同一グループ内の領域間フロー、STSD への参照、他グループとの責任境界を突き合わせます。
|
|
22
|
-
|
|
23
|
-
この成果物は、上位の業務目的を Why、グループ内で成立させる出力と境界を What、プロセス・例外対応・委譲を How、領域 ID・プロセス ID・例外 ID・参照先の対応を Trace として整理します。上位目的、状態定義、状態遷移は複製しません。
|
|
18
|
+
- この CDFD は、全体概要のグループの目的(Why)を参照で引き継ぎ、グループ内でそろえる出力と境界(What)を定め、プロセス・例外対応・委譲(How)を決める。領域 ID・プロセス ID・例外 ID・データストア名でたどれるようにする(Trace)。
|
|
19
|
+
- 上位の目的、状態の定義と遷移は写さず参照に置き換える。全体概要が正の領域・データストアの名称も言い換えない。
|
|
20
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
|
|
24
21
|
|
|
25
22
|
## 2. 作成前に集める情報
|
|
26
23
|
|
|
27
|
-
| 項目 | 集める情報
|
|
28
|
-
| ------------------ |
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
| データストア | 全体概要の「データストア」にある名称と区分、および各領域・プロセスでの参照・更新の別 |
|
|
37
|
-
| 状態定義・状態遷移 | 状態を変えるプロセスが参照する STSD の文書 ID |
|
|
38
|
-
| 主要例外 | 入力不足、業務条件不成立、更新失敗など、結果または後続起動を変える分岐 |
|
|
39
|
-
| グループ外委譲 | 他グループまたは横断ユースケースへ渡す責務、情報、戻す条件 |
|
|
40
|
-
| 責任分担 | 人間と AI Agent の責任分担を定める対応文書 |
|
|
41
|
-
| 未決事項 | 境界、起動条件、正本、判断者が未確定な論点と、影響・決定時期 |
|
|
24
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
25
|
+
| ------------------ | -------------------------------------------------------------- | ---------------------------- |
|
|
26
|
+
| 対象グループと領域 | グループ名、`cdfd-<group>` のスラッグ、属する全領域の ID・名称 | 全体概要 |
|
|
27
|
+
| グループの入出力 | グループ単位の主要入力・主要出力・データストアと区分 | 全体概要 |
|
|
28
|
+
| プロセス候補 | 業務目的・担当・更新する正本・完了条件が異なる処理 | 領域の担当者への聞き取り |
|
|
29
|
+
| 起動条件と非起動 | 起動のきっかけと、起動しないときに正常に終わる経路 | 領域の担当者への聞き取り |
|
|
30
|
+
| 状態を変える処理 | 状態を変えるプロセスと、その状態を扱う STSD の文書 ID | 状態を管理する担当者・文書群 |
|
|
31
|
+
| 主要例外 | 結果または後続の起動を変える分岐と、再開の位置 | 品質確認担当・過去の障害記録 |
|
|
32
|
+
| 他グループとの境界 | 他グループや横断ユースケースへ渡す責務、情報、戻す条件 | 他グループの担当者 |
|
|
42
33
|
|
|
43
34
|
## 3. 全体の作成手順
|
|
44
35
|
|
|
45
|
-
1.
|
|
46
|
-
2.
|
|
47
|
-
3.
|
|
48
|
-
4.
|
|
49
|
-
5.
|
|
50
|
-
6.
|
|
51
|
-
7.
|
|
52
|
-
8.
|
|
53
|
-
9.
|
|
54
|
-
10. 領域ごとの表の各行を一つずつプロセスノードへ置き、イベント、外部主体、データストアとラベル付きエッジでつなぎます。
|
|
55
|
-
11. 条件付き・選択プロセスの非起動経路を確認し、どの出力がそろえば各領域とグループが完了するかを図で示します。
|
|
56
|
-
12. 状態を変えるプロセスを抽出し、状態一覧と状態遷移図を統合した STSD を参照表へ記入します。状態一覧や遷移表は CDFD に書きません。
|
|
57
|
-
13. 業務結果または後続起動を変える主要例外を選び、検出条件、扱い、継続・再開条件を表にします。
|
|
58
|
-
14. 他グループの内部処理を委譲表へ移し、委譲先 `cdfd-<group>` または `cdfd-uc-<topic>`、引き渡す情報、戻す条件を記述します。
|
|
59
|
-
15. 領域 ID、プロセス ID、例外 ID、データストア名、参照先 ID を使って、表と図の重複・欠落・名称ゆれを解消します。
|
|
36
|
+
1. 対象グループの全領域を書き出し、グループの入出力をどの領域が受け取り、どの領域が生み出すかを割り当てる。この割り当てがプロセスを切り出す手がかりになる。
|
|
37
|
+
2. 領域ごとに、最初の入力から最終出力までをたどり、業務目的または完了条件が変わる箇所でプロセスを分ける。
|
|
38
|
+
3. 一覧・検索・状態参照・検証など、独自の業務成果がない候補を支援先のプロセスへ戻す。
|
|
39
|
+
4. 本グループが読み書きするデータストアを全体概要から切り出す。
|
|
40
|
+
5. 領域間の受け渡しを特定してから図の分割単位を決め、概念データフローを描く。プロセスが固まる前に描くと、図と表の名称がずれる。
|
|
41
|
+
6. 各プロセスの主要入出力を整理する。
|
|
42
|
+
7. 状態を変えるプロセスを抽出し、STSD への参照を書く。
|
|
43
|
+
8. 主要例外とグループ外への委譲を書く。正常の流れが固まってから書くと、停止範囲と再開位置を特定しやすい。
|
|
44
|
+
9. 最後に目的と適用範囲を書く。境界が決まってから書くと、本文の言い直しにならない。
|
|
60
45
|
|
|
61
46
|
## 4. 各章の書き方
|
|
62
47
|
|
|
@@ -64,155 +49,109 @@ Conceptual Data Flow Diagram Process Group Writing Recipe
|
|
|
64
49
|
|
|
65
50
|
問い:
|
|
66
51
|
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
|
|
52
|
+
- 誰が、グループ内のフロー・受け渡し・例外・委譲を合意または設計に使うか。
|
|
53
|
+
- このグループの図から、どの判断ができるようになるか。
|
|
54
|
+
|
|
55
|
+
コツ:
|
|
70
56
|
|
|
71
|
-
|
|
57
|
+
- 「仕入を詳しくする」で止まったら、「承認する人」と「設計へ使う人」を一人ずつ聞くと、対象者と利用結果が結び付く。
|
|
58
|
+
- 上位の業務目的を書きたくなったら、全体概要への参照に置き換える。
|
|
72
59
|
|
|
73
60
|
### 4.2. 適用範囲
|
|
74
61
|
|
|
75
62
|
問い:
|
|
76
63
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
- 人間と AI Agent の責任分担を本文で再定義せず、対応文書を参照していますか。
|
|
64
|
+
- どのイベントから、どの出力がそろうまでを扱うか。
|
|
65
|
+
- 他グループの責務・横断の順序・実装詳細のどこから先を外すか。
|
|
66
|
+
|
|
67
|
+
コツ:
|
|
82
68
|
|
|
83
|
-
|
|
69
|
+
- 「この出力がそろったら、次は誰の仕事か」と聞くと、終了と対象外が一度に決まる。
|
|
70
|
+
- プロジェクトの実行フェーズ名や一時的な仮称が紛れやすい。対象プロダクトの業務語に置き換える。
|
|
84
71
|
|
|
85
72
|
### 4.3. プロセス領域
|
|
86
73
|
|
|
87
74
|
問い:
|
|
88
75
|
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
- 各領域の箇条書きを合わせると、全体概要のグループ単位の箇条書きを説明できますか。
|
|
92
|
-
- 領域 ID と名称は上位と一致し、業務目的・担当・起点イベントを書き写していませんか。
|
|
93
|
-
- プロセス ID は所属領域を示す `P-<nn>-<nn>` 形式ですか。
|
|
94
|
-
- 各領域に一つ以上の内部プロセスがあり、表の一行が一つの業務目的と完了条件を持ちますか。
|
|
95
|
-
- 起動条件はイベント、前段完了、承認、条件値のいずれかで判定できますか。
|
|
96
|
-
- 条件付きまたは選択のプロセスを起動しない場合、正常に領域完了へ進めますか。
|
|
76
|
+
- 各プロセスは、一つの業務目的と、yes / no で判定できる完了条件を持つか。
|
|
77
|
+
- 条件付き・選択のプロセスを起動しない場合も、領域を正常に終えられるか。
|
|
97
78
|
|
|
98
|
-
|
|
79
|
+
コツ:
|
|
99
80
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
81
|
+
- 処理を分けるか迷ったら、業務目的・主担当・更新する正本・完了条件を並べて比べる。どれも同じなら一つにまとめる。
|
|
82
|
+
- 「必要に応じて」と答えが返ってきたら、「何が起きたら始めるか」を聞き直す。
|
|
83
|
+
- 領域の入出力を領域の節に書きたくなるが、入出力は「個別プロセス主要入出力」にまとめる。手順 1 の割り当てはメモに残す。
|
|
103
84
|
|
|
104
|
-
|
|
105
|
-
- 各行に参照・更新の別と、本グループでの利用内容がありますか。
|
|
106
|
-
- プロセス領域の箇条書きと個別プロセス主要入出力にあるデータストアを過不足なく含んでいますか。
|
|
107
|
-
- 各行が概念データフローの同名ノードに対応していますか。
|
|
108
|
-
|
|
109
|
-
全体概要の「データストア」から必要な行を切り出し、マスタ・構成データとトランザクションデータの区分を保ちます。新しい名称や区分が必要なら、先に全体概要を見直します。図を分割して同じノードを再掲する場合も、表の行とノードラベルの名称は変えません。
|
|
110
|
-
|
|
111
|
-
### 4.5. 概念データフロー
|
|
85
|
+
### 4.4. データストアと個別プロセス主要入出力
|
|
112
86
|
|
|
113
87
|
問い:
|
|
114
88
|
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
- 図を領域ごと、または業務の性質が近い単位へ分けていますか。一図が 15 プロセスを超えていませんか。
|
|
118
|
-
- 条件付き・選択プロセスの起動条件と、非起動時の正常経路を区別できますか。
|
|
119
|
-
- データストアの名称、区分、色クラスは全体概要と一致していますか。
|
|
120
|
-
- 図直後の注記に、全体概要の凡例への参照、使用線種、省略した入出力と理由、別図と共有するノードを示していますか。
|
|
121
|
-
- 状態をノードとして並べたり、状態間の遷移を描いたりしていませんか。
|
|
89
|
+
- 各プロセスの入出力は、隣のプロセス・外部主体・データストアとの受け渡しとして説明できるか。
|
|
90
|
+
- 図の同名ノードと、データストアの行が一対一に対応するか。
|
|
122
91
|
|
|
123
|
-
|
|
92
|
+
コツ:
|
|
124
93
|
|
|
125
|
-
|
|
94
|
+
- 新しい名称や区分が要ると気づいたら、この文書で作らず、先に全体概要の見直しを依頼する。
|
|
95
|
+
- 主要出力の概念名と、保存先のデータストア名を混同しやすい。「何ができたか」と「どこに残すか」を分けて聞く。
|
|
126
96
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
- 図を領域単位で分けた場合、同じ領域単位で節と表を設けていますか。
|
|
130
|
-
- 各プロセスの主要入力・主要出力は、隣接プロセス、外部主体、データストアとの受け渡しとして説明できますか。
|
|
131
|
-
- データストアの名称と区分は「プロセス領域」「データストア」および全体概要と一致していますか。
|
|
132
|
-
- 業務目的、担当、起動条件、必須性を「プロセス領域」の表から重複させていませんか。
|
|
133
|
-
|
|
134
|
-
全プロセスをちょうど一度、所属領域または図の分割単位に対応する表へ記載します。主要出力という概念名と、保存先であるデータストア名を別の列に保ちます。
|
|
135
|
-
|
|
136
|
-
### 4.7. 状態遷移の参照
|
|
97
|
+
### 4.5. 概念データフロー
|
|
137
98
|
|
|
138
99
|
問い:
|
|
139
100
|
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
- 参照先が未作成の場合、文書 ID をバッククォートで仮置きし、状態内容を CDFD へ代替記載していませんか。
|
|
101
|
+
- 起点イベントからグループの完了まで、領域間の受け渡しを順方向にたどれるか。
|
|
102
|
+
- 他グループのノードを隠しても、本グループの完了を説明できるか。
|
|
143
103
|
|
|
144
|
-
|
|
104
|
+
コツ:
|
|
145
105
|
|
|
146
|
-
|
|
106
|
+
- 状態の変化を描きたくなったら、プロセスと起動条件だけを残し、状態名と遷移は STSD へ委ねる。
|
|
107
|
+
- 図を説明する注記は長くなりやすい。省略した入出力と別図と共有するノードだけを書く。
|
|
147
108
|
|
|
148
|
-
|
|
109
|
+
### 4.6. 状態遷移の参照、主要例外とグループ外への委譲
|
|
149
110
|
|
|
150
|
-
|
|
151
|
-
- その例外は、成果の採否、正本の確定、後続起動、人間の判断のいずれかを変えますか。
|
|
152
|
-
- どの条件で検出し、どのプロセスまで停止し、どこから再開しますか。
|
|
153
|
-
- 同一グループ内の領域間受け渡しを委譲扱いにしていませんか。
|
|
154
|
-
- 委譲先は他の `cdfd-<group>` または横断順序を扱う `cdfd-uc-<topic>` で、内部処理を書き写していませんか。
|
|
111
|
+
問い:
|
|
155
112
|
|
|
156
|
-
|
|
113
|
+
- その例外は、成果の採否・正本の確定・後続の起動・人間の判断のどれを変えるか。
|
|
114
|
+
- 委譲先の担当者は、引き渡す情報だけで次の行動を始められるか。
|
|
157
115
|
|
|
158
|
-
|
|
116
|
+
コツ:
|
|
159
117
|
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
-
|
|
118
|
+
- 例外の件数を増やすより、正常に終われない理由と再開の位置を一つに決める。
|
|
119
|
+
- 同じグループ内の領域間の受け渡しを委譲として書きやすい。委譲は他グループと横断ユースケースへ渡すものだけにする。
|
|
120
|
+
- STSD や委譲先がまだなくても、安定した文書 ID をバッククォートで示す。状態の内容や他グループの処理を代わりに書かない。
|
|
163
121
|
|
|
164
122
|
## 5. 深掘り手順
|
|
165
123
|
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
7. 各主要例外について、検出前に確定した正本、停止する後続、再開位置を順にたどります。
|
|
173
|
-
8. 他グループのノードを隠しても本グループの完了条件を説明でき、委譲表から次の責任者が行動できるか確認します。
|
|
174
|
-
9. データストア名を全体概要、プロセス領域、データストア、図、個別プロセス主要入出力で機械的に照合します。
|
|
124
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
125
|
+
|
|
126
|
+
1. グループの最終出力から逆向きにたどり、どの出力にもつながらないプロセスを外す。
|
|
127
|
+
2. 条件付き・選択のプロセスを一つずつ止め、必須の出力が欠けるなら必須性か起動条件を見直す。
|
|
128
|
+
3. 各主要例外について、検出の前に確定した正本と、止める後続をたどり、再開の位置が一つに決まるか確かめる。
|
|
129
|
+
4. 状態を表す名詞や遷移の条件を本文から探し、CDFD で定義している箇所を STSD への参照に戻す。
|
|
175
130
|
|
|
176
131
|
## 6. 良い例 / 悪い例
|
|
177
132
|
|
|
178
|
-
| 観点 | 良い例
|
|
179
|
-
| ------------ |
|
|
180
|
-
| グループ境界 | 仕入グループの仕入計画と入荷検品を一文書で扱う
|
|
181
|
-
|
|
|
182
|
-
|
|
|
183
|
-
|
|
|
184
|
-
|
|
|
185
|
-
|
|
|
186
|
-
| 状態遷移 | 検品を状態変更プロセスとして示し、商品状態の定義と遷移は STSD を参照する | 未入荷→検品中→販売可能の遷移表を CDFD に複製する |
|
|
187
|
-
| 主要例外 | 発注記録を特定できない場合は入荷記録を確定せず、照合後に受入から再開する | エラーなら適切に対応する |
|
|
188
|
-
| 委譲 | 補充判断を `cdfd-inventory`、グループ横断順序を `cdfd-uc-replenishment` へ委譲する | 在庫グループの補充判定手順を仕入 CDFD 内に描く |
|
|
133
|
+
| 観点 | 良い例 | 悪い例 |
|
|
134
|
+
| ------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------ |
|
|
135
|
+
| グループ境界 | 仕入グループの仕入計画と入荷検品を一文書で扱う | 仕入計画だけを一つの CDFD に分割する |
|
|
136
|
+
| 起動条件 | 仕入先から商品が納品され、対応する発注記録を特定できた | 必要に応じて検品する |
|
|
137
|
+
| データストア | 「仕入記録」を全体概要と同じ名称・区分で使う | 図だけ「発注 DB」と改名する |
|
|
138
|
+
| 状態遷移 | 検品を状態を変えるプロセスとして示し、商品状態の定義と遷移は STSD を参照する | 未入荷→検品中→販売可能の遷移表を CDFD に写す |
|
|
139
|
+
| 主要例外 | 発注記録を特定できない場合は入荷記録を確定せず、照合後に受入から再開する | エラーなら適切に対応する |
|
|
140
|
+
| 委譲 | 補充判断を `cdfd-inventory`、グループ横断の順序を `cdfd-uc-replenishment` へ委譲する | 在庫グループの補充判定の手順を仕入 CDFD 内に描く |
|
|
189
141
|
|
|
190
142
|
## 7. レビュー観点
|
|
191
143
|
|
|
192
|
-
| 観点
|
|
193
|
-
|
|
|
194
|
-
| 業務価値
|
|
195
|
-
|
|
|
196
|
-
|
|
|
197
|
-
|
|
|
198
|
-
| 状態責務 | CDFD が状態を定義せず、状態変更プロセスから STSD をたどれる | 技術メンター、品質確認担当 |
|
|
199
|
-
| 例外 | 主要例外の検出条件、停止範囲、再開条件が判定できる | 品質確認担当 |
|
|
200
|
-
| 用語整合 | 領域、プロセス、イベント、入出力、データストアの名称が上位・表・図で一致する | 業務分析担当、品質確認担当 |
|
|
201
|
-
| グループ境界 | 同一グループ内の領域間フローを描き、他グループの内部処理を作り込んでいない | 業務分析担当、アーキテクト |
|
|
202
|
-
|
|
203
|
-
「業務分析担当」「品質確認担当」「技術メンター」「アーキテクト」は、対象プロジェクトのロール定義または対応する責任分担文書で正式な担当へ対応付けます。
|
|
144
|
+
| 観点 | 確認内容 |
|
|
145
|
+
| ---------- | -------------------------------------------------------------------------------- |
|
|
146
|
+
| 業務価値 | グループ内の各出力が、上位の目的と対象者の利用場面のどちらを支えるか説明できるか |
|
|
147
|
+
| 必須性境界 | 店主代表が、条件付き・選択のプロセスを起動しない扱いを承認できるか |
|
|
148
|
+
| 設計入力 | 開発担当が、各プロセスの起動条件・入出力・委譲先を設計へ使えるか |
|
|
149
|
+
| 例外 | 品質確認担当が、例外ごとに止める範囲と再開の位置を判定できるか |
|
|
204
150
|
|
|
205
151
|
## 8. 仕上げチェック
|
|
206
152
|
|
|
207
|
-
-
|
|
208
|
-
-
|
|
209
|
-
-
|
|
210
|
-
-
|
|
211
|
-
-
|
|
212
|
-
- 図を領域または業務の性質ごとに分け、図直後に凡例の参照、線種、省略事項、共有ノードを記載した。
|
|
213
|
-
- 条件付き・選択プロセスの起動条件と非起動時の正常な扱いを説明できる。
|
|
214
|
-
- 状態を変えるプロセスから STSD を参照し、状態定義・遷移表・状態遷移図を CDFD に複製していない。
|
|
215
|
-
- 主要例外に検出条件、扱い、継続・再開条件がある。
|
|
216
|
-
- グループ外委譲の委譲先、引き渡す情報、戻す条件があり、同一グループ内の領域間受け渡しを委譲扱いにしていない。
|
|
217
|
-
- 未決事項は共通ラベルで確定情報と区別し、ない場合は章を設けていない。
|
|
218
|
-
- 個人情報、秘密情報、非公開の組織情報など、公開範囲に不適切な内容を含めていない。
|
|
153
|
+
- 各プロセスが、グループの最終出力のどれかにつながる。
|
|
154
|
+
- 条件付き・選択のプロセスを起動しなくても、領域を正常に終えられる。
|
|
155
|
+
- 状態の定義と遷移を CDFD で書かず、状態を変えるプロセスから STSD をたどれる。
|
|
156
|
+
- 他グループの内部処理を描かず、委譲先が引き渡す情報で次の行動を始められる。
|
|
157
|
+
- 個人名、秘密情報、非公開の組織情報を含めていない。
|
|
@@ -11,162 +11,155 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Conceptual Data Flow Diagram Use Case Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
全体概要で選んだ一つのユースケースまたは系統について、開始から終了までの流れと受け渡す情報・物を、読み手が図から追える内容に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 目的、適用範囲、役割表、データストアの部分集合を作り、上から下へ進む図で受け渡しを示します。
|
|
20
|
-
- 最後に表と図の名称・順序、全体概要との境界、有効な参照先を確認します。業務上重要な戻りだけ、任意の図を追加します。
|
|
21
|
-
|
|
22
|
-
ケース ID、参加単位の名称・領域 ID、データストア名を軸に、範囲・表・図を対応させます。引き渡し ID を追加せず、情報・物の名前を線のラベルにします。
|
|
18
|
+
- 全体概要のケース ID と業務目的(Why)を引き継ぎ、開始・終了と参加単位の範囲(What)を決め、参加単位の責務と受け渡しの線(How)で流れを示す。ケース ID・領域 ID・データストア名を表と図で同じにして、流れを全体概要までたどれるようにする(Trace)。
|
|
23
19
|
|
|
24
20
|
## 2. 作成前に集める情報
|
|
25
21
|
|
|
26
|
-
| 項目
|
|
27
|
-
|
|
|
28
|
-
| 対象ケース
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
| 受け渡し
|
|
33
|
-
| データストア |
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
| 重要な戻り | 補完・再判断を担う参加単位、返す不足情報や差異。業務上重要な場合だけ集める |
|
|
37
|
-
| 未決事項 | 境界、名称、責務、判断者が未確定な論点、影響、決定者、決定時期 |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ---------------- | -------------------------------------------------------------------- | -------------------------------- |
|
|
24
|
+
| 対象ケース | ケース ID、業務名、業務目的、採用された描き方(横断・系統) | 全体概要の「詳細 CDFD 一覧」 |
|
|
25
|
+
| 開始と終了 | 開始する出来事の原文と、最後に利用できるようになる成果 | 全体概要の「プロセス領域」 |
|
|
26
|
+
| 参加単位と順序 | グループ・区分、領域 ID、正常系の通過順、条件付きでだけ通る領域 | 全体概要、各領域の担当者への確認 |
|
|
27
|
+
| 共用する領域 | 複数の系統が通る領域と、その内部を描く文書 | 全体概要、領域の詳細文書 |
|
|
28
|
+
| 受け渡し | 隣り合う参加単位・データストアの間で渡す情報・物の名前 | 各領域の担当者への確認 |
|
|
29
|
+
| データストア | このケースで参照・更新するものと、その名称・区分 | 全体概要の「データストア」 |
|
|
30
|
+
| 例外時の戻り | 不足や差異を返す先、返す情報、補完後に再提示する情報 | 各領域の担当者への確認、過去事例 |
|
|
31
|
+
| 状態・調整の正本 | 状態を定める STSD、Orchestrator の指示の図、凡例(絵文字の割り当て) | 全体概要、STSD |
|
|
38
32
|
|
|
39
33
|
## 3. 全体の作成手順
|
|
40
34
|
|
|
41
|
-
1.
|
|
42
|
-
2.
|
|
43
|
-
3.
|
|
44
|
-
4.
|
|
45
|
-
5.
|
|
46
|
-
6.
|
|
47
|
-
7. データストアを同名ノードで加え、表の各行と図を対応させます。イベントは一ノード一出来事の短い文とし、長ければ原文を保って改行します。
|
|
48
|
-
8. 図に業務の言葉で題を付け、読み取れることを 1 文で説明します。凡例は全体概要への短い参照にします。
|
|
49
|
-
9. 業務上重要な戻りがある場合だけ、「概念データフロー」に「例外時の戻り」の図を追加し、返す情報を線にします。戻りの線は上側のノードを左辺にした `a <- b` で書きます。
|
|
50
|
-
10. ケース ID、名称、領域 ID で範囲・表・図を突き合わせ、内部処理や状態定義・遷移の重複を除きます。
|
|
35
|
+
1. 概念データフローの正常系の図を最初に描く。順序の正本は図なので、表から書くと順序欄と図がずれる。
|
|
36
|
+
2. 図の参加単位を 1 行ずつプロセス領域の役割表へ移し、順序欄を図から転記する。
|
|
37
|
+
3. 図に出たデータストアだけをデータストアの表へ移す。
|
|
38
|
+
4. 例外時の戻りを集め、戻りの図を描く。
|
|
39
|
+
5. 目的と適用範囲を書く。図が決まってからだと、開始と終了を図と同じ言葉で書ける。
|
|
40
|
+
6. 未決事項があれば最後の章にまとめ、最後に H1 直下の導入文を書く。
|
|
51
41
|
|
|
52
42
|
## 4. 各章の書き方
|
|
53
43
|
|
|
54
|
-
### 4.1.
|
|
44
|
+
### 4.1. 導入文と目的
|
|
55
45
|
|
|
56
46
|
問い:
|
|
57
47
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
48
|
+
- どのケース ID と業務名の流れを示す文書か。
|
|
49
|
+
- その業務がないと、誰が何に困るのか。
|
|
50
|
+
|
|
51
|
+
コツ:
|
|
60
52
|
|
|
61
|
-
|
|
53
|
+
- 導入文はケース ID と業務名を全体概要から写し、言い換えない。ケースを特定しない導入文は、どの選定を詳細化したか分からなくなる。
|
|
54
|
+
- 目的に「BA が承認する」「QE が検証に使う」などの読み手の作業を書きそうになったら、業務が成り立たせる成果に言い直す。
|
|
62
55
|
|
|
63
56
|
### 4.2. 適用範囲
|
|
64
57
|
|
|
65
58
|
問い:
|
|
66
59
|
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
- 共通原則と調整役の指示を全体概要に委ねていますか。
|
|
70
|
-
- 本文と `based_on` に `deprecated` の文書が残っていませんか。
|
|
60
|
+
- 開始の出来事と、終了時に使えるようになる成果は何か。
|
|
61
|
+
- 内部の手順や状態遷移のうち、どれを別の文書へ委ねるか。
|
|
71
62
|
|
|
72
|
-
|
|
63
|
+
コツ:
|
|
64
|
+
|
|
65
|
+
- 全体概要の選定と食い違ったら、本書で範囲を変えず、先に全体概要を直す。
|
|
66
|
+
- 共通の責任分担や状態の定義は写さず、正本への参照に置き換える。
|
|
73
67
|
|
|
74
68
|
### 4.3. プロセス領域
|
|
75
69
|
|
|
76
70
|
問い:
|
|
77
71
|
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
|
|
81
|
-
|
|
72
|
+
- 各参加単位はこのケースで何を引き受けるか。
|
|
73
|
+
- 常に通る領域と、計画連携や補完のときだけ通る領域はどれか。
|
|
74
|
+
|
|
75
|
+
コツ:
|
|
82
76
|
|
|
83
|
-
|
|
77
|
+
- 条件付きで通る領域は、順序欄を「計画連携時」「補完時」などの参加場面にすると、主経路と混ざらない。
|
|
78
|
+
- 共用する領域の内部を描きたくなったら、内部を描く文書を参照先に書き、本書では 1 行に留める。
|
|
79
|
+
- PDCA の段階を区分の代わりに書きやすい。区分は全体概要の名前を使う。
|
|
84
80
|
|
|
85
81
|
### 4.4. データストア
|
|
86
82
|
|
|
87
83
|
問い:
|
|
88
84
|
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
- 関連する参加単位を名称・領域 ID で示し、利用内容を説明していますか。
|
|
92
|
-
- 表の各行と図の同名ノードが対応していますか。
|
|
85
|
+
- このケースで参照・更新するのはどれか。
|
|
86
|
+
- 各データストアを、どの参加単位が何のために使うか。
|
|
93
87
|
|
|
94
|
-
|
|
88
|
+
コツ:
|
|
89
|
+
|
|
90
|
+
- 全体概要の一覧を丸ごと写しやすい。図に線が引かれないものは外す。
|
|
91
|
+
- 保存先やカラムを書き始めたら、用途の 1 文に戻す。
|
|
95
92
|
|
|
96
93
|
### 4.5. 概念データフロー
|
|
97
94
|
|
|
98
95
|
問い:
|
|
99
96
|
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
- 図の題は業務の言葉ですか。説明は読み取れることの 1 文ですか。
|
|
97
|
+
- 前段の成果は、どの情報・物として次段へ渡るか。
|
|
98
|
+
- 図の題と説明 1 文で、何を読み取ってほしいか。
|
|
99
|
+
|
|
100
|
+
コツ:
|
|
105
101
|
|
|
106
|
-
|
|
102
|
+
- 線のラベルを担当者に聞くときは「次の人は何を受け取れば始められるか」と聞く。名詞で答えが返り、条件のイベントを置かずに済む。
|
|
103
|
+
- 承認が要る受け渡しは「承認済みの補充依頼」のように、渡す物の性質で表す。
|
|
104
|
+
- 線が込み入ったら、線を削らず業務の段ごとに図を分け、共有ノードで接続を示す。
|
|
107
105
|
|
|
108
|
-
### 4.6.
|
|
106
|
+
### 4.6. 例外時の戻りの図
|
|
109
107
|
|
|
110
108
|
問い:
|
|
111
109
|
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
|
|
110
|
+
- どの不足や差異を、どの参加単位へ返すか。
|
|
111
|
+
- 補完した後に、何を再提示するか。
|
|
112
|
+
|
|
113
|
+
コツ:
|
|
115
114
|
|
|
116
|
-
|
|
115
|
+
- 担当者は重要な戻りだけを挙げやすい。「差し戻した事例をすべて」と聞いて集める。
|
|
116
|
+
- 共用する領域の内部の戻りは内部を描く文書に任せ、外へ返す情報だけを描く。
|
|
117
117
|
|
|
118
118
|
### 4.7. 未決事項(任意)
|
|
119
119
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
-
|
|
120
|
+
問い:
|
|
121
|
+
|
|
122
|
+
- 境界、名称、責務、判断者のうち決まっていないものはどれか。
|
|
123
|
+
- その論点はどのケース・参加単位に影響するか。
|
|
124
|
+
|
|
125
|
+
コツ:
|
|
126
|
+
|
|
127
|
+
- 本文の `_UNDECIDED_` と 1 対 1 で対応させる。決着した論点は本文へ反映して消す。
|
|
123
128
|
|
|
124
129
|
## 5. 深掘り手順
|
|
125
130
|
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
131
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
132
|
+
|
|
133
|
+
1. 終了の成果から逆にたどり、業務目的に寄与しない参加単位や線を外す。
|
|
134
|
+
2. 役割表の各行が図のどのノードに当たるかを確かめ、図にない行を外す。
|
|
135
|
+
3. データストアごとに、読み書きする線があるかを確かめる。
|
|
136
|
+
4. 状態の定義・遷移や内部の処理が残っていれば、正本の参照に置き換える。
|
|
137
|
+
5. 集めた戻りごとに、返す先の参加単位と再提示の線があるかを確かめる。
|
|
133
138
|
|
|
134
139
|
## 6. 良い例 / 悪い例
|
|
135
140
|
|
|
136
|
-
| 観点
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
| 状態責務 | 商品状態は STSD を参照する | 未発注から販売可能への状態遷移を本書で定義する |
|
|
141
|
+
| 観点 | 良い例 | 悪い例 |
|
|
142
|
+
| ---------- | ----------------------------------------------------- | --------------------------------------------- |
|
|
143
|
+
| 導入文 | 「ケース `C-02`『欠品から補充まで』の流れを示す」 | 「補充業務の流れを示す」とだけ書く |
|
|
144
|
+
| 区分 | 区分は全体概要の「調達」とし、PDCA は別の列で Do | 区分の欄に Do と書く |
|
|
145
|
+
| 共用領域 | 内部を描く文書を一つ決め、ほかでは 1 ノードで受け渡す | 系統ごとに同じ領域の内部を描き直す |
|
|
146
|
+
| 渡す情報 | 在庫から仕入へ「承認済みの補充依頼」を直接つなぐ | 途中に「H-01 受理できる」というイベントを置く |
|
|
147
|
+
| イベント | 「在庫が補充基準を下回った」を必要なら改行する | 複数の出来事を一つのノードに詰める |
|
|
148
|
+
| 戻り | すべての戻りを描き、多ければ戻り先ごとに図を分ける | 重要な戻りだけを残し、ほかを削る |
|
|
149
|
+
| 状態の責務 | 商品の状態は STSD を参照する | 未発注から販売可能までの遷移を本書で定める |
|
|
146
150
|
|
|
147
151
|
## 7. レビュー観点
|
|
148
152
|
|
|
149
|
-
| 観点
|
|
150
|
-
|
|
|
151
|
-
| 業務価値
|
|
152
|
-
|
|
|
153
|
-
|
|
|
154
|
-
|
|
|
155
|
-
|
|
|
156
|
-
| 正本の境界 | 調整・状態遷移・内部処理を重複させず、有効な文書を参照する | アーキテクト |
|
|
157
|
-
|
|
158
|
-
確認者の呼称は、対象プロジェクトのロール定義または責任分担文書で正式な担当へ対応付けます。
|
|
153
|
+
| 観点 | 確認内容 |
|
|
154
|
+
| -------------- | ---------------------------------------------------------------- |
|
|
155
|
+
| 業務価値 | 終了時の成果が目的に応え、目的に寄与しない参加単位や線がないか |
|
|
156
|
+
| 表と図の対応 | 役割表の順序と名称が図と一致し、条件付きの領域が主経路と分かるか |
|
|
157
|
+
| 受け渡しの具体 | 各線のラベルから、次の参加単位が受け取る情報・物を特定できるか |
|
|
158
|
+
| 戻りの網羅 | 集めた戻りがすべて、返す先と再提示の線とともに描かれているか |
|
|
159
|
+
| 正本の境界 | 共用領域の内部・状態遷移・Orchestrator の調整を写していないか |
|
|
159
160
|
|
|
160
161
|
## 8. 仕上げチェック
|
|
161
162
|
|
|
162
|
-
-
|
|
163
|
-
-
|
|
164
|
-
-
|
|
165
|
-
- 表と図の参加単位、データストアが対応し、開始から終了まで縦に追える。
|
|
166
|
-
- イベントは一ノード一出来事で短く、入口の原文を保っている。
|
|
167
|
-
- 受け渡しは線のラベルにあり、引き渡し ID・条件イベント・旧来の引き渡し/戻り先の章がない。
|
|
168
|
-
- Orchestrator を詳細の図に置かず、全体概要の指示の図へ委ねた。
|
|
169
|
-
- 図の題は業務の言葉、説明は読み取れることの 1 文で、凡例は全体概要を参照している。
|
|
170
|
-
- 戻りの図は業務上重要な場合だけ追加し、条件表や内部の再試行手順を置いていない。
|
|
171
|
-
- `based_on` と本文に `deprecated` の参照先がなく、状態定義・遷移を複製していない。
|
|
172
|
-
- 未決事項がない場合は章を省略し、公開範囲に不適切な情報を含めていない。
|
|
163
|
+
- ケース ID、領域 ID、データストア名が、導入文・表・図・全体概要で同じ表記になっている。
|
|
164
|
+
- 図を分けた場合も、共有ノードをたどって開始から終了まで追える。
|
|
165
|
+
- 絵文字の有無と割り当てが、文書内の全図とほかの系統でそろっている。
|