specdojo 0.1.0 → 0.2.1
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/LICENSE +22 -0
- package/README.md +142 -35
- package/dist/agent-response.js +27 -0
- package/dist/agent.js +124 -0
- package/dist/build-command.js +149 -0
- package/dist/build-if-stale.js +35 -0
- package/dist/catalog-build.js +1079 -0
- package/dist/catalog-generate.js +226 -0
- package/dist/catalog-paths.js +31 -0
- package/dist/catalog-plan-generate.js +301 -0
- package/dist/catalog-plan-prompt.js +73 -0
- package/dist/catalog-plan.js +471 -0
- package/dist/catalog-scaffold.js +255 -0
- package/dist/catalog-types.js +4 -0
- package/dist/catalog.js +606 -0
- package/dist/dashboard.js +990 -0
- package/dist/deliverable-trash.js +148 -0
- package/dist/deliverable.js +97 -0
- package/dist/dist-freshness.js +150 -0
- package/dist/doc-index.js +424 -0
- package/dist/exec-agent-config.js +172 -0
- package/dist/exec-agent-git-state.js +136 -0
- package/dist/exec-agent-protected-config.js +276 -0
- package/dist/exec-events.js +250 -112
- package/dist/exec-evidence.js +317 -0
- package/dist/exec-format.js +54 -0
- package/dist/exec-limit.js +202 -0
- package/dist/exec-parent-validation.js +169 -0
- package/dist/exec-pipeline-state.js +160 -0
- package/dist/exec-plans.js +1016 -0
- package/dist/exec-project.js +25 -11
- package/dist/exec-protection-handoff.js +169 -0
- package/dist/exec-provider-scaffold.js +99 -0
- package/dist/exec-register-resume.js +196 -0
- package/dist/exec-register.js +281 -0
- package/dist/exec-reporter.js +329 -0
- package/dist/exec-results.js +510 -0
- package/dist/exec-run-lock.js +149 -0
- package/dist/exec-run.js +4953 -0
- package/dist/exec-schedule-calendar.js +86 -9
- package/dist/exec-schedule-cpm.js +30 -12
- package/dist/exec-schedule-gantt-chart-render.js +428 -0
- package/dist/exec-schedule-gantt-chart-scope.js +111 -0
- package/dist/exec-schedule-gantt-chart.js +2 -0
- package/dist/exec-schedule-hash.js +34 -25
- package/dist/exec-schedule-index.js +200 -67
- package/dist/exec-schedule-initial.js +100 -0
- package/dist/exec-schedule-progress.js +51 -26
- package/dist/exec-schedule-ready.js +71 -27
- package/dist/exec-schedule.js +171 -93
- package/dist/exec-shared.js +146 -25
- package/dist/exec-strategy.js +547 -0
- package/dist/exec-task-view.js +64 -0
- package/dist/exec-trial.js +895 -0
- package/dist/exec-worktree-command.js +426 -0
- package/dist/exec-worktree-ops.js +847 -0
- package/dist/exec-worktree.js +359 -0
- package/dist/exec.js +744 -192
- package/dist/frontmatter-namespace.js +48 -0
- package/dist/git-environment.js +23 -0
- package/dist/grade-result.js +137 -0
- package/dist/grade.js +2456 -0
- package/dist/index-command.js +103 -0
- package/dist/job.js +1081 -0
- package/dist/kata-command.js +303 -0
- package/dist/kata.js +187 -0
- package/dist/package-paths.js +33 -0
- package/dist/practice-id.js +24 -0
- package/dist/register-date.js +122 -0
- package/dist/register-events.js +363 -0
- package/dist/register-history.js +323 -0
- package/dist/register-item.js +455 -0
- package/dist/register-migrate-timestamps.js +176 -0
- package/dist/register.js +2199 -0
- package/dist/review-plan.js +199 -0
- package/dist/review-types.js +1 -0
- package/dist/role-types.js +1 -0
- package/dist/routine.js +814 -0
- package/dist/schedule-approach.js +252 -0
- package/dist/schedule-build.js +552 -0
- package/dist/schedule-phase-sets.js +73 -0
- package/dist/schedule-strategy-generate.js +812 -0
- package/dist/schedule-strategy-profiles.js +276 -0
- package/dist/schedule.js +420 -0
- package/dist/spawn-self.js +28 -0
- package/dist/specdojo-config.js +133 -39
- package/dist/specdojo.js +56 -7
- package/dist/template-frontmatter.js +89 -0
- package/dist/template-resolution.js +92 -0
- package/dist/timeline-build.js +334 -0
- package/dist/timeline.js +107 -0
- package/dist/watch.js +313 -0
- package/dist/yaml-pages-command.js +28 -0
- package/dist/yaml-pages.js +180 -0
- package/dist/yaml-schema-modeline.js +49 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
- package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
- package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
- package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
- package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
- package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
- package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
- package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
- package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
- package/docs/ja/specdojo/guides/kata-guide.md +89 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
- package/docs/ja/specdojo/guides/review-guide.md +428 -0
- package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
- package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
- package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
- package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
- package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
- package/docs/ja/specdojo/guides/waza-guide.md +224 -0
- package/docs/ja/specdojo/index.md +33 -0
- package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
- package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
- package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
- package/docs/ja/specdojo/references/command-reference.md +718 -0
- package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
- package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
- package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/atc-sample.md +41 -0
- package/docs/ja/specdojo/samples/bac-sample.md +38 -0
- package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
- package/docs/ja/specdojo/samples/bds-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-sample.md +38 -0
- package/docs/ja/specdojo/samples/bps-sample.md +38 -0
- package/docs/ja/specdojo/samples/br-sample.md +40 -0
- package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
- package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cld-sample.md +38 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-sample.md +38 -0
- package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
- package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
- package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
- package/docs/ja/specdojo/samples/dec-sample.md +39 -0
- package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
- package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
- package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/etc-sample.md +38 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
- package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
- package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
- package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
- package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/itc-sample.md +38 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/mm-sample.md +35 -0
- package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
- package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
- package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
- package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
- package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
- package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
- package/docs/ja/specdojo/samples/opd-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
- package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
- package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
- package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
- package/docs/ja/specdojo/samples/otp-sample.md +68 -0
- package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
- package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
- package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
- package/docs/ja/specdojo/samples/pr-sample.md +39 -0
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
- package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
- package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
- package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
- package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
- package/docs/ja/specdojo/samples/sac-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-sample.md +38 -0
- package/docs/ja/specdojo/samples/sld-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-sample.md +38 -0
- package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
- package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
- package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/uis-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-sample.md +38 -0
- package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
- package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
- package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
- package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
- package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
- package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
- package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
- package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
- package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
- package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
- package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
- package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
- package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
- package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
- package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
- package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
- package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
- package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
- package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
- package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
- package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
- package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
- package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
- package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
- package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
- package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
- package/docs/ja/specdojo/templates/opr-template.md +85 -0
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
- package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
- package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
- package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
- package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
- package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
- package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
- package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
- package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
- package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
- package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
- package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
- package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
- package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
- package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
- package/docs/ja/specdojo/templates/stsd-template.md +57 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
- package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
- package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
- package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
- package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
- package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
- package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
- package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
- package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
- package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
- package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
- package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
- package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
- package/package.json +121 -24
- package/templates/antigravity/README.md +35 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
- package/templates/antigravity/orchestrator.md +146 -0
- package/templates/antigravity/pm-members-snippet.yaml +55 -0
- package/templates/claude/README.md +46 -0
- package/templates/claude/agents/claude-expert-review-executor.md +14 -0
- package/templates/claude/agents/claude-review-executor.md +14 -0
- package/templates/claude/agents/specdojo-orchestrator.md +153 -0
- package/templates/claude/settings.edit.json +6 -0
- package/templates/claude/settings.report.json +6 -0
- package/templates/claude/settings.review.json +7 -0
- package/templates/codex/README.md +61 -0
- package/templates/codex/agents/codex-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
- package/templates/codex/agents/codex-review-executor.toml +10 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
- package/templates/codex/orchestrator.md +146 -0
- package/templates/copilot/README.md +41 -0
- package/templates/copilot/exec-defaults-snippet.yaml +28 -0
- package/templates/copilot/pm-members-snippet.yaml +44 -0
- package/templates/opencode/README.md +41 -0
- package/templates/opencode/agents/opencode-executor.md +59 -0
- package/templates/opencode/agents/opencode-reporter.md +26 -0
- package/templates/opencode/agents/opencode-review-executor.md +48 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cdfd-overview-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cdfd-overview-rulebook
|
|
7
|
+
sample: specdojo:cdfd-overview-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 概念データフロー図(全体概要)作成レシピ
|
|
11
|
+
|
|
12
|
+
Conceptual Data Flow Diagram Overview Writing Recipe
|
|
13
|
+
|
|
14
|
+
業務または運用の全体をプロセス領域とプロセスグループへ分け、データストアを一覧化し、グループとデータストアの間の受け渡しと詳細 CDFD への引き渡し境界を、関係者が再現可能な形で合意するための作成手順です。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 最初に、対象業務・運用の範囲と、プロセス領域・データストアの候補を粗く書き出します。
|
|
19
|
+
- 次に、各章の問いに答えながら、目的、適用範囲、プロセス領域(グループごとの入出力を含む)、データストア、概念データフロー(概要)、詳細 CDFD 一覧を具体化します。
|
|
20
|
+
- 最後に、レビュー観点で「グループの入出力と図のエッジが対応しているか」「領域単位の詳細を書きすぎていないか」を確認します。
|
|
21
|
+
|
|
22
|
+
この成果物は、プロセスグループとデータストアの名称を軸に、プロセス領域の表・データストア・図・詳細 CDFD 一覧の四点を対応させ、上位の業務目的を領域分割の理由として引き継ぎます。領域内の手順や実装方式は作り込まず、各要素の対応関係で判断を追跡できるようにします(Trace)。
|
|
23
|
+
|
|
24
|
+
## 2. 作成前に集める情報
|
|
25
|
+
|
|
26
|
+
| 項目 | 集める情報 |
|
|
27
|
+
| ---------------- | ---------------------------------------------------------------------------------------------- |
|
|
28
|
+
| 利用者と判断 | 誰が対象範囲と領域分割を承認し、誰が詳細化・設計・網羅性確認に使うか |
|
|
29
|
+
| 対象範囲 | 開始点、終了点、対象業務、組織、システム境界 |
|
|
30
|
+
| 対象外 | 補助操作、領域内の手順、実装詳細、別成果物が責任を持つ事項 |
|
|
31
|
+
| 領域候補 | 固有の業務目的、主な担当、起点イベントを持つ責務のまとまり |
|
|
32
|
+
| グループ候補 | 業務の性質が近い領域のまとまり(例: 計画、実行、評価、改善のような段階) |
|
|
33
|
+
| 主な担当 | 各領域を主に担うロール、複数ロールが担う場合の管理責任、人間の最終判断者 |
|
|
34
|
+
| 起点イベント | 各領域の開始を判定できる出来事 |
|
|
35
|
+
| データストア | 各グループが参照・更新する論理的な正本と、その内容。マスタ・構成かトランザクションかの区分 |
|
|
36
|
+
| 保管先 | データストアの物理的な所在。実装が先にある場合は確定値、設計中は候補、概念段階では扱わない |
|
|
37
|
+
| 主要な受け渡し | 各グループが受け取る入力、引き渡す出力として移動する情報・物 |
|
|
38
|
+
| 物理保管 | 現物(商品・現金など)を保管する場所(物の流れを図示する場合) |
|
|
39
|
+
| 外部主体 | 対象範囲外から入力を渡す人・組織・システムと、結果を受け取る主体。対象範囲内の参加者は含めない |
|
|
40
|
+
| 横断ユースケース | 複数のグループをまたぎ、順序と引き渡し条件を定める必要がある業務 |
|
|
41
|
+
| 未決事項 | 境界、名称、責務、判断者、保管先が未確定な論点と、影響、決定者、決定時期 |
|
|
42
|
+
|
|
43
|
+
## 3. 全体の作成手順
|
|
44
|
+
|
|
45
|
+
1. 対象者、利用場面、開始点、終了点、対象外を定義します。
|
|
46
|
+
2. 開始から結果利用までの業務成果を並べ、起点イベントと最終出力が異なるまとまりへ分け、各まとまりへ安定した領域 ID を付けます。
|
|
47
|
+
3. 一覧、検索、状態参照、検証、dry-run など、独立した業務成果を持たない候補を支援先の領域へ戻します。
|
|
48
|
+
4. 業務の性質が近い領域をプロセスグループへまとめ、グループ数を 8 以下にします。各グループの主要入力・主要出力・データストアを箇条書きにします。
|
|
49
|
+
5. 各グループが参照・更新するデータストアを集め、更新契機でマスタ・構成データとトランザクションデータに区分し、一覧にします。保管先は確定度に応じて列を置くか省略します。
|
|
50
|
+
6. グループを代表ノード、「データストア」の各行をデータストアのノードにし、グループの入出力から導いた受け渡しを名詞形のラベル付きエッジで描きます。ノード総数が 16 を超える場合はトランザクションデータの図とマスタ・構成データの図に分けます。
|
|
51
|
+
7. プロセスグループ別 CDFD の表を作り、複数グループを横断し順序と引き渡し条件を定める必要がある業務だけをユースケース別 CDFD の表に載せます。
|
|
52
|
+
8. 名称を使って表、箇条書き、データストア、図、詳細 CDFD 一覧を突き合わせ、重複、欠落、名称ゆれを解消します。
|
|
53
|
+
9. 確定できない論点は影響と決定時期を添えて未決事項へ分離します。
|
|
54
|
+
|
|
55
|
+
## 4. 各章の書き方
|
|
56
|
+
|
|
57
|
+
### 4.1. 目的
|
|
58
|
+
|
|
59
|
+
問い:
|
|
60
|
+
|
|
61
|
+
- この全体概要によって、誰がどの判断のために使いますか(承認、詳細化、設計入力、網羅性確認など)。
|
|
62
|
+
- 対象者ごとに、何を読み取れれば目的を達成したと言えますか。
|
|
63
|
+
|
|
64
|
+
対象者ごとに利用場面を一文で結び付けます。「全体を分かりやすくする」ではなく、「店主代表が対象範囲と領域分割を承認する」のように、利用結果を判定できる表現にします。後続の詳細 CDFD の位置付けを明確にすることを目的に含めます。
|
|
65
|
+
|
|
66
|
+
### 4.2. 適用範囲
|
|
67
|
+
|
|
68
|
+
問い:
|
|
69
|
+
|
|
70
|
+
- どの出来事から、どの成果または判断までを扱いますか。
|
|
71
|
+
- 領域内部としてプロセスグループ別 CDFD へ委ねるものと、業務成果を持たないため補助操作として除外するものは何ですか。
|
|
72
|
+
- 人間が責任を持つ判断と、AI Agent やシステムが支援できる処理の境界はどこですか。対応する責任分担文書はありますか。
|
|
73
|
+
- 特定プロジェクトの実行計画・スケジュール上のフェーズ名を、前提知識のない読者への説明なく持ち込んでいませんか。
|
|
74
|
+
|
|
75
|
+
対象業務、開始点、終了点、対象外、補助操作の扱いを明示します。責任分担は対応する文書があれば参照し、なければ原則を一文で書きます。
|
|
76
|
+
|
|
77
|
+
### 4.3. プロセス領域
|
|
78
|
+
|
|
79
|
+
問い:
|
|
80
|
+
|
|
81
|
+
- 各領域には、他の領域と区別できる固有の起点イベントと業務成果がありますか。定義系の領域の起点を実行の契機で書いていませんか。
|
|
82
|
+
- 各グループの説明文から、グループの役割と内部の領域の連携が読み取れますか。
|
|
83
|
+
- グループの主要入力・主要出力は、他グループ、外部主体、データストアとの受け渡しとして説明できますか。他グループからの要求を入力に含めていますか。
|
|
84
|
+
- データストアの名称は「データストア」と一致していますか。
|
|
85
|
+
- 主な担当を「全員」だけで終わらせず、管理責任のロールを示していますか。
|
|
86
|
+
|
|
87
|
+
グループごとに節を設け、説明文、主要入力・主要出力・データストアの箇条書き、領域の表の順に書きます。業務目的は手段名ではなく、対象者が利用する成果または維持したい状態で書きます。領域を分けるか迷う場合は、起点、最終出力、更新する正本の三点を比較します。領域単位の入出力は書かず、プロセスグループ別 CDFD へ委ねます。
|
|
88
|
+
|
|
89
|
+
### 4.4. データストア
|
|
90
|
+
|
|
91
|
+
問い:
|
|
92
|
+
|
|
93
|
+
- 各データストアは、何の正本かが分かる名称ですか。生成物の場合は生成元、退避先の場合は退避対象が主な内容に書かれていますか。
|
|
94
|
+
- 区分は更新契機で判定していますか。定義から生成される生成物を、生成元と同じ区分にしていませんか。
|
|
95
|
+
- 保管先の列を置く場合、確定度に合った書き方(確定値、`_UNDECIDED_`、列の省略)になっていますか。各保管先は一つのデータストアにだけ属していますか。
|
|
96
|
+
- リポジトリ基盤や開発環境の設定など、業務データでないものを除外していますか。
|
|
97
|
+
|
|
98
|
+
マスタ・構成データとトランザクションデータの 2 表に分けます。図に置くデータストアはこの一覧の行と一対一にするため、図で使いたい名称をここで確定します。
|
|
99
|
+
|
|
100
|
+
### 4.5. 概念データフロー(概要)
|
|
101
|
+
|
|
102
|
+
問い:
|
|
103
|
+
|
|
104
|
+
- 代表ノードはプロセスグループごとに一つで、ラベルにグループ名と含む領域 ID の範囲がありますか。`subgraph` で囲んでいませんか。
|
|
105
|
+
- データストアのノードは「データストア」の各行と一対一で、名称が一致していますか。
|
|
106
|
+
- 各エッジは「プロセス領域」の各グループの主要入力・主要出力のどれかに対応していますか。対応のないエッジ、エッジのない入出力はありませんか。
|
|
107
|
+
- エッジラベルだけを読んでも、何がどこからどこへ渡るか説明できますか。
|
|
108
|
+
- 対象範囲内の参加者を外部主体として描いていませんか。外部主体は対象範囲外の入力元・出力先だけですか。
|
|
109
|
+
- ノード総数が 16 を超える場合、トランザクションデータの図とマスタ・構成データの図に分け、両図で名称を統一し、グループ間の要求をトランザクションの図にだけ描いていますか。
|
|
110
|
+
- 各図の直後に、凡例の参照先、物の流れの有無、載せていない要素の参照先、外部主体の有無を注記していますか。
|
|
111
|
+
|
|
112
|
+
図はグループとデータストアの間の受け渡しに集中させます。グループ内の領域や手順を複数ノードへ展開したくなった場合は、その内容をプロセスグループ別 CDFD へ移します。物の受け渡しがある場合は、物理保管(売場棚、バックヤードなど)もデータストアと同様に図の要素として扱い、`==>` で描きます。
|
|
113
|
+
|
|
114
|
+
### 4.6. 詳細 CDFD 一覧
|
|
115
|
+
|
|
116
|
+
問い:
|
|
117
|
+
|
|
118
|
+
- 章の冒頭で、プロセスグループ別 CDFD とユースケース別 CDFD の役割分担を示していますか。
|
|
119
|
+
- 状態の定義と遷移は STSD を正本とし、詳細 CDFD は参照に留める役割分担を示していますか。
|
|
120
|
+
- プロセスグループ別 CDFD の表に全グループが 1 行ずつあり、各領域がちょうど一つの行に属していますか。
|
|
121
|
+
- ユースケース別 CDFD の表に載せた業務は、複数のグループを横断し、順序と引き渡し条件を定める必要がありますか。単一グループに閉じる業務を載せていませんか。
|
|
122
|
+
- 「未作成」などの作成状況を本文に書いていませんか。
|
|
123
|
+
|
|
124
|
+
作成状況は登録簿で追跡し、本文には ID だけを書きます。単一グループに閉じる業務は、必要になった時点でユースケース別 CDFD を追加する旨を本文に書きます。
|
|
125
|
+
|
|
126
|
+
### 4.7. 凡例(本プロダクト共通)(任意)
|
|
127
|
+
|
|
128
|
+
問い:
|
|
129
|
+
|
|
130
|
+
- 本プロダクトに複数の詳細 CDFD があり、共通のノード形状・色・絵文字を使いますか。
|
|
131
|
+
- 全体概要と詳細 CDFD の各図が、この章の定義を再掲せず参照する形になっていますか。
|
|
132
|
+
- サンプル図には、`specdojo:cdfd-mermaid-rulebook` が定義する全ノード種別が一つずつ含まれていますか。
|
|
133
|
+
|
|
134
|
+
詳細 CDFD が複数あり、色・絵文字の割り当てを毎回説明し直すと負担になる場合に設けます。単一の CDFD しかない場合は省略します。
|
|
135
|
+
|
|
136
|
+
### 4.8. 未決事項(条件付き)
|
|
137
|
+
|
|
138
|
+
問い:
|
|
139
|
+
|
|
140
|
+
- 境界、名称、責務、判断者、保管先のいずれかに未確定の論点がありますか。
|
|
141
|
+
- 本文中の `_UNDECIDED_` は、表の論点と対応していますか。
|
|
142
|
+
|
|
143
|
+
未決事項がある場合だけ最終章として設け、論点、影響、決定者、決定時期、状態の表にします。確定した論点は本文へ反映して表から削除します。
|
|
144
|
+
|
|
145
|
+
## 5. 深掘り手順
|
|
146
|
+
|
|
147
|
+
1. 各領域の目的から逆向きにたどり、その領域が応える利用者の判断または業務課題を確認します。
|
|
148
|
+
2. 各領域の起点イベントを見て、定義系の領域が実行の契機で書かれていないか、同じグループ内で同文になっていないかを確認します。
|
|
149
|
+
3. 各グループの主要出力から順向きにたどり、他グループまたは外部主体が利用するか、データストアに残るかを確認します。
|
|
150
|
+
4. 同じデータストアを更新する複数グループを並べ、更新責務が重複していないか確認します。
|
|
151
|
+
5. 図のエッジを一本ずつ、対応するグループの主要入力・主要出力に対応付け、対応のないものを追加または削除します。
|
|
152
|
+
6. 「データストア」の各行が図に一度ずつ登場し、保管先が他の行と重なっていないかを確認します。
|
|
153
|
+
7. コマンド名、画面名、ファイル名を隠しても目的と受け渡しを説明できるか確認し、説明できない行を概念粒度へ戻します。
|
|
154
|
+
8. 補助操作を除外したことで必要な検証入力が失われていないか確認し、独立領域ではなく支援先の入力として残します。
|
|
155
|
+
|
|
156
|
+
## 6. 良い例 / 悪い例
|
|
157
|
+
|
|
158
|
+
| 観点 | 良い例 | 悪い例 |
|
|
159
|
+
| ------------ | ------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
|
|
160
|
+
| 業務目的 | 現金販売を記録し、商品を顧客へ渡す | 販売登録画面を実行する |
|
|
161
|
+
| 起点イベント | 定期実行定義は「定期的に確認・実行する事項が判明した」 | 定期実行定義に「指定された時期が到来した」(実行の契機) |
|
|
162
|
+
| グループ粒度 | 店頭販売とつけ販売を「販売」グループにまとめ、値引きや取消の手順は詳細 CDFD へ委ねる | 全体概要に値引き、取消、再入力を別ノードで並べる |
|
|
163
|
+
| 入出力 | 入力は購入依頼と支払、売価、つけ上限。出力は販売記録とつけ販売の記録 | 入力はフォーム、出力は JSON |
|
|
164
|
+
| データストア | 販売取引の正本である「販売記録」と、その生成物である「日次締め記録」を分ける | `sales-table`。または販売記録と締め記録を一つにまとめる |
|
|
165
|
+
| 区分 | 定期実行定義(定義)はマスタ・構成、実行記録(活動の記録)はトランザクション | 定義と記録を同じ区分にする |
|
|
166
|
+
| 保管先 | 実装があるのでパスを書く。設計中は `_UNDECIDED_`。概念段階は列を省略 | 未定なのに推測でパスを書く |
|
|
167
|
+
| 補助操作 | 商品検索は販売の入力確認として扱う | 商品検索を独立したプロセス領域にする |
|
|
168
|
+
| 図の要素 | 顧客と仕入先を外部主体、店主を各領域の担当として内側に置く | 店主を外部主体として描く |
|
|
169
|
+
| ノード数 | 代表ノード 6 とデータストア 15 の計 21 なので 2 図に分ける | 21 ノードを 1 図に並べる |
|
|
170
|
+
| 詳細化先 | 販売グループを `cdfd-sales` へ、つけ販売から精算までを `cdfd-uc-credit-sales` へ割り当てる | 領域ごとに詳細 CDFD を作り、横断業務を各図に重複記載する |
|
|
171
|
+
|
|
172
|
+
## 7. レビュー観点
|
|
173
|
+
|
|
174
|
+
| 観点 | 確認内容 | 主な確認者 |
|
|
175
|
+
| ---------- | -------------------------------------------------------------------------------------------------------- | ---------- |
|
|
176
|
+
| 業務価値 | 各領域の目的が、対象者の課題、判断、期待する業務成果のどれに応えるか説明できる | BA |
|
|
177
|
+
| 対象境界 | 領域、プロセスグループ、補助操作、領域内部、人間の最終判断、外部主体の境界を承認できる | PO |
|
|
178
|
+
| 詳細化入力 | 各グループの入出力、データストア、詳細化先を識別できる | ARC |
|
|
179
|
+
| 網羅性 | 各領域がちょうど一つのグループとプロセスグループ別 CDFD に属し、図のエッジと入出力が相互に対応する | QE |
|
|
180
|
+
| 用語整合 | 領域、グループ、データストアの名称が表、箇条書き、一覧、図、詳細 CDFD 一覧で一致する | BA、QE |
|
|
181
|
+
| 粒度 | 全体概要がグループ単位の入出力に留まり、領域単位の入出力、手順、状態、例外、実装詳細を詳細化先へ委譲する | BA、ARC |
|
|
182
|
+
| 可読性 | グループ数が 8 以下で、ノード総数が 16 を超える場合は 2 図に分かれている | BA、ARC |
|
|
183
|
+
|
|
184
|
+
## 8. 仕上げチェック
|
|
185
|
+
|
|
186
|
+
- 対象者、利用場面、対象範囲、対象外、責任分担を明記した。
|
|
187
|
+
- 各領域に ID、目的、担当、起点イベントがあり、各グループに説明文と主要入力・主要出力・データストアの箇条書きがある。
|
|
188
|
+
- グループ数が 8 以下である。
|
|
189
|
+
- 「データストア」がマスタ・構成とトランザクションに分かれ、保管先列は確定度に合った扱いになっている。
|
|
190
|
+
- 図の代表ノードがグループごとに一つで、データストアが一覧の各行と一対一に対応し、`subgraph` を使っていない。
|
|
191
|
+
- 図の全エッジに名詞形のラベルがあり、グループの入出力と相互に対応する。
|
|
192
|
+
- ノード総数が 16 を超える場合は 2 図に分かれ、両図で名称が統一されている。
|
|
193
|
+
- 対象範囲内の参加者を外部主体として描いていない。
|
|
194
|
+
- プロセスグループ別 CDFD の表に全グループがあり、ユースケース別 CDFD の表には横断業務だけがある。「未作成」などの作成状況を書いていない。
|
|
195
|
+
- 補助操作を独立領域にせず、領域単位の入出力や実装方式を作り込んでいない。
|
|
196
|
+
- 未決事項は `_UNDECIDED_` で確定情報と区別し、影響、決定者、決定時期、状態を記載した。未決事項がなければ章を設けていない。
|
|
197
|
+
- 作業メモを HTML コメントで本文に残していない。
|
|
198
|
+
- 「凡例(本プロダクト共通)」を設けた場合、各図の注記がその定義を再掲せず参照している。
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cdfd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cdfd-rulebook
|
|
7
|
+
sample: specdojo:cdfd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 概念データフロー図(プロセスグループ別)作成レシピ
|
|
11
|
+
|
|
12
|
+
Conceptual Data Flow Diagram Process Group Writing Recipe
|
|
13
|
+
|
|
14
|
+
全体概要から一つのプロセスグループとそれに属する領域群を引き継ぎ、領域内部と領域間のプロセス、主要例外、グループ外への委譲を、関係者が再現可能な形で具体化するための作成手順です。状態を変えるプロセスは STSD へ接続し、状態定義と遷移の二重管理を防ぎます。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 最初に、全体概要から対象グループ、含む全領域、グループ単位の主要入力・主要出力・データストアを抜き出し、領域ごとの節へ配分します。
|
|
19
|
+
- 次に、各節を説明文、主要入力・主要出力・データストアの箇条書き、プロセス表の順で作り、全体概要の「データストア」から本グループが読み書きする部分集合を切り出します。
|
|
20
|
+
- その後、概念データフロー、個別プロセス主要入出力、状態遷移の参照、主要例外とグループ外への委譲を具体化します。
|
|
21
|
+
- 最後に、全領域と全プロセスの網羅性、データストア名称・区分・読み書き、同一グループ内の領域間フロー、STSD への参照、他グループとの責任境界を突き合わせます。
|
|
22
|
+
|
|
23
|
+
この成果物は、上位の業務目的を Why、グループ内で成立させる出力と境界を What、プロセス・例外対応・委譲を How、領域 ID・プロセス ID・例外 ID・参照先の対応を Trace として整理します。上位目的、状態定義、状態遷移は複製しません。
|
|
24
|
+
|
|
25
|
+
## 2. 作成前に集める情報
|
|
26
|
+
|
|
27
|
+
| 項目 | 集める情報 |
|
|
28
|
+
| ------------------ | ------------------------------------------------------------------------------------ |
|
|
29
|
+
| 対象グループ | 全体概要のプロセスグループ名と `cdfd-<group>` の英小文字スラッグ |
|
|
30
|
+
| 対象領域 | グループに属する全領域の ID・名称。業務目的、担当、起点イベントは参照用に控える |
|
|
31
|
+
| グループ入出力 | 全体概要にあるグループ単位の主要入力、主要出力、データストア |
|
|
32
|
+
| 領域別入出力 | グループ入出力を各領域へ配分した主要入力、主要出力、データストア |
|
|
33
|
+
| 利用者と判断 | 誰が内部フローを合意し、誰が境界を承認し、誰が設計・検証に使うか |
|
|
34
|
+
| プロセス候補 | 異なる業務目的、担当、正本更新、完了条件を持つ処理候補 |
|
|
35
|
+
| 起動条件と必須性 | 外部イベント、前段完了、承認、条件値、および非起動時の正常な扱い |
|
|
36
|
+
| データストア | 全体概要の「データストア」にある名称と区分、および各領域・プロセスでの参照・更新の別 |
|
|
37
|
+
| 状態定義・状態遷移 | 状態を変えるプロセスが参照する STSD の文書 ID |
|
|
38
|
+
| 主要例外 | 入力不足、業務条件不成立、更新失敗など、結果または後続起動を変える分岐 |
|
|
39
|
+
| グループ外委譲 | 他グループまたは横断ユースケースへ渡す責務、情報、戻す条件 |
|
|
40
|
+
| 責任分担 | 人間と AI Agent の責任分担を定める対応文書 |
|
|
41
|
+
| 未決事項 | 境界、起動条件、正本、判断者が未確定な論点と、影響・決定時期 |
|
|
42
|
+
|
|
43
|
+
## 3. 全体の作成手順
|
|
44
|
+
|
|
45
|
+
1. 全体概要から一つのプロセスグループと、そこに属する全領域の ID・名称を転記します。
|
|
46
|
+
2. 全体概要のグループ単位の主要入力・主要出力・データストアを、領域ごとの節へ配分します。
|
|
47
|
+
3. 各領域について、役割と内部プロセスの連携を説明し、主要入力・主要出力・データストアを箇条書きにします。
|
|
48
|
+
4. 領域ごとの開始と最終出力から必要な処理をたどり、業務目的または完了条件が変わる箇所でプロセスを分けます。
|
|
49
|
+
5. 各プロセスへ所属領域 ID の枝番を付け、目的、担当、起動条件、必須性を同じ領域の表へ一行ずつ記入します。
|
|
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 を使って、表と図の重複・欠落・名称ゆれを解消します。
|
|
60
|
+
|
|
61
|
+
## 4. 各章の書き方
|
|
62
|
+
|
|
63
|
+
### 4.1. 目的
|
|
64
|
+
|
|
65
|
+
問い:
|
|
66
|
+
|
|
67
|
+
- この CDFD は全体概要のどのプロセスグループを詳細化しますか。
|
|
68
|
+
- 誰が、グループ内部のフロー、領域間の受け渡し、主要例外、委譲境界を判断または利用しますか。
|
|
69
|
+
- 上位の業務目的を書き写さず、このグループで得る成果と利用結果を説明できますか。
|
|
70
|
+
|
|
71
|
+
「仕入を詳しくする」のような曖昧な表現ではなく、「店主代表が発注から売場補充までの責任境界を承認し、開発担当が領域間の入出力を設計へ使う」のように、対象者と利用結果を結び付けます。
|
|
72
|
+
|
|
73
|
+
### 4.2. 適用範囲
|
|
74
|
+
|
|
75
|
+
問い:
|
|
76
|
+
|
|
77
|
+
- 対象グループに属する全領域を含み、別グループの領域を混在させていませんか。
|
|
78
|
+
- どのイベントから、どの出力がそろうまでを対象にしますか。
|
|
79
|
+
- 対象となる期間、組織、システム境界を説明できますか。
|
|
80
|
+
- 補助操作、実装詳細、他グループの責務、横断順序のどこから先を対象外にしますか。
|
|
81
|
+
- 人間と AI Agent の責任分担を本文で再定義せず、対応文書を参照していますか。
|
|
82
|
+
|
|
83
|
+
他グループへの委譲内容は「主要例外とグループ外への委譲」に集約し、本章では指し先だけを示します。対象プロダクトの現在の正本として読める業務語を使い、プロジェクトの実行フェーズ名や一時的な仮称を持ち込みません。
|
|
84
|
+
|
|
85
|
+
### 4.3. プロセス領域
|
|
86
|
+
|
|
87
|
+
問い:
|
|
88
|
+
|
|
89
|
+
- 全体概要で対象グループに属する領域が、一つも欠けず、一節ずつ登場しますか。
|
|
90
|
+
- 各節が、説明文、主要入力・主要出力・データストアの箇条書き、プロセス表の順になっていますか。
|
|
91
|
+
- 各領域の箇条書きを合わせると、全体概要のグループ単位の箇条書きを説明できますか。
|
|
92
|
+
- 領域 ID と名称は上位と一致し、業務目的・担当・起点イベントを書き写していませんか。
|
|
93
|
+
- プロセス ID は所属領域を示す `P-<nn>-<nn>` 形式ですか。
|
|
94
|
+
- 各領域に一つ以上の内部プロセスがあり、表の一行が一つの業務目的と完了条件を持ちますか。
|
|
95
|
+
- 起動条件はイベント、前段完了、承認、条件値のいずれかで判定できますか。
|
|
96
|
+
- 条件付きまたは選択のプロセスを起動しない場合、正常に領域完了へ進めますか。
|
|
97
|
+
|
|
98
|
+
最初にグループ単位の入出力を付箋のように並べ、どの領域が受け取り、どの領域が生み出すかを一つずつ割り当てます。次に、領域の役割を 1〜3 文で要約し、箇条書きの後へプロセス表を置きます。処理を分けるか迷う場合は、業務目的、主担当、更新する正本、完了条件を比較します。
|
|
99
|
+
|
|
100
|
+
### 4.4. データストア
|
|
101
|
+
|
|
102
|
+
問い:
|
|
103
|
+
|
|
104
|
+
- 本グループが読み書きするデータストアだけを、全体概要と同じ名称・区分で掲載していますか。
|
|
105
|
+
- 各行に参照・更新の別と、本グループでの利用内容がありますか。
|
|
106
|
+
- プロセス領域の箇条書きと個別プロセス主要入出力にあるデータストアを過不足なく含んでいますか。
|
|
107
|
+
- 各行が概念データフローの同名ノードに対応していますか。
|
|
108
|
+
|
|
109
|
+
全体概要の「データストア」から必要な行を切り出し、マスタ・構成データとトランザクションデータの区分を保ちます。新しい名称や区分が必要なら、先に全体概要を見直します。図を分割して同じノードを再掲する場合も、表の行とノードラベルの名称は変えません。
|
|
110
|
+
|
|
111
|
+
### 4.5. 概念データフロー
|
|
112
|
+
|
|
113
|
+
問い:
|
|
114
|
+
|
|
115
|
+
- プロセス領域の各表の行が同じ ID と名称を持つ一つのプロセスノードとして登場しますか。
|
|
116
|
+
- 同一グループ内の領域間の受け渡しを、起点イベントからグループ完了まで順方向にたどれますか。
|
|
117
|
+
- 図を領域ごと、または業務の性質が近い単位へ分けていますか。一図が 15 プロセスを超えていませんか。
|
|
118
|
+
- 条件付き・選択プロセスの起動条件と、非起動時の正常経路を区別できますか。
|
|
119
|
+
- データストアの名称、区分、色クラスは全体概要と一致していますか。
|
|
120
|
+
- 図直後の注記に、全体概要の凡例への参照、使用線種、省略した入出力と理由、別図と共有するノードを示していますか。
|
|
121
|
+
- 状態をノードとして並べたり、状態間の遷移を描いたりしていませんか。
|
|
122
|
+
|
|
123
|
+
図は順序と分岐へ集中させます。他グループは委譲先の代表ノードまたは境界イベントだけを置き、内部処理を展開しません。状態変化が重要な箇所でも、CDFD にはプロセスと起動条件を残し、状態名と遷移条件は STSD へ委ねます。
|
|
124
|
+
|
|
125
|
+
### 4.6. 個別プロセス主要入出力
|
|
126
|
+
|
|
127
|
+
問い:
|
|
128
|
+
|
|
129
|
+
- 図を領域単位で分けた場合、同じ領域単位で節と表を設けていますか。
|
|
130
|
+
- 各プロセスの主要入力・主要出力は、隣接プロセス、外部主体、データストアとの受け渡しとして説明できますか。
|
|
131
|
+
- データストアの名称と区分は「プロセス領域」「データストア」および全体概要と一致していますか。
|
|
132
|
+
- 業務目的、担当、起動条件、必須性を「プロセス領域」の表から重複させていませんか。
|
|
133
|
+
|
|
134
|
+
全プロセスをちょうど一度、所属領域または図の分割単位に対応する表へ記載します。主要出力という概念名と、保存先であるデータストア名を別の列に保ちます。
|
|
135
|
+
|
|
136
|
+
### 4.7. 状態遷移の参照
|
|
137
|
+
|
|
138
|
+
問い:
|
|
139
|
+
|
|
140
|
+
- 状態を変える全プロセスについて、状態一覧と状態遷移図を統合した STSD を特定できますか。
|
|
141
|
+
- CDFD は状態を変えるプロセスと起動条件だけを示し、状態名、状態説明、遷移元・遷移先、遷移条件を再定義していませんか。
|
|
142
|
+
- 参照先が未作成の場合、文書 ID をバッククォートで仮置きし、状態内容を CDFD へ代替記載していませんか。
|
|
143
|
+
|
|
144
|
+
対象、状態を変えるプロセス、STSD の三点を一行で結びます。状態を変えるプロセスがない場合も章は残し、その事実と確認根拠を一文で記載して表だけを省略します。
|
|
145
|
+
|
|
146
|
+
### 4.8. 主要例外とグループ外への委譲
|
|
147
|
+
|
|
148
|
+
問い:
|
|
149
|
+
|
|
150
|
+
- 例外 ID は最初に検出する領域の番号を含む `E-<nn>-<nn>` 形式ですか。
|
|
151
|
+
- その例外は、成果の採否、正本の確定、後続起動、人間の判断のいずれかを変えますか。
|
|
152
|
+
- どの条件で検出し、どのプロセスまで停止し、どこから再開しますか。
|
|
153
|
+
- 同一グループ内の領域間受け渡しを委譲扱いにしていませんか。
|
|
154
|
+
- 委譲先は他の `cdfd-<group>` または横断順序を扱う `cdfd-uc-<topic>` で、内部処理を書き写していませんか。
|
|
155
|
+
|
|
156
|
+
主要例外は件数を増やすより、正常完了できない理由と再開条件を一意にすることを優先します。委譲先が未作成でも安定した文書 ID をバッククォートで示し、作成状況は成果物本文ではなく登録簿で追跡します。
|
|
157
|
+
|
|
158
|
+
### 4.9. 未決事項(任意)
|
|
159
|
+
|
|
160
|
+
- 調査で確定できる不足情報は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きする前提は _ASSUMPTION_: とします。
|
|
161
|
+
- 未決論点には、影響する領域・プロセス・例外・委譲、決定者、決定時期を添えます。
|
|
162
|
+
- 未決事項がない場合は章を省略し、空表や「なし」だけの章を残しません。
|
|
163
|
+
|
|
164
|
+
## 5. 深掘り手順
|
|
165
|
+
|
|
166
|
+
1. 全体概要のグループ入力から順方向にたどり、どの領域が受け取り、どの領域が次へ渡すかを確認します。
|
|
167
|
+
2. グループの最終出力から逆向きにたどり、各領域と各プロセスが必要な理由を確認します。
|
|
168
|
+
3. 各領域について、領域単位の主要入力・主要出力・データストアがグループ単位の箇条書きへ対応するか確認します。
|
|
169
|
+
4. 一覧にだけあるプロセスと図にだけあるノードを列挙し、追加、削除、名称統一のいずれかで解消します。
|
|
170
|
+
5. 条件付き・選択プロセスを一つずつ非起動にし、必須出力が欠ける場合は必須性または起動条件を見直します。
|
|
171
|
+
6. 状態を表す名詞や遷移条件を検索し、CDFD で定義している内容を STSD の参照へ置き換えます。
|
|
172
|
+
7. 各主要例外について、検出前に確定した正本、停止する後続、再開位置を順にたどります。
|
|
173
|
+
8. 他グループのノードを隠しても本グループの完了条件を説明でき、委譲表から次の責任者が行動できるか確認します。
|
|
174
|
+
9. データストア名を全体概要、プロセス領域、データストア、図、個別プロセス主要入出力で機械的に照合します。
|
|
175
|
+
|
|
176
|
+
## 6. 良い例 / 悪い例
|
|
177
|
+
|
|
178
|
+
| 観点 | 良い例 | 悪い例 |
|
|
179
|
+
| ------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------ |
|
|
180
|
+
| グループ境界 | 仕入グループの仕入計画と入荷検品を一文書で扱う | 仕入計画だけを一つの CDFD に分割する |
|
|
181
|
+
| 領域別入出力 | 補充依頼を仕入計画へ、納品と売場補充を入荷検品へ配分する | グループ単位の入出力を各領域へそのまま複製する |
|
|
182
|
+
| プロセス ID | 領域 `P-02` の検品へ `P-02-02` を付ける | 文書内の順番だけで `P-01` を付ける |
|
|
183
|
+
| 起動条件 | 仕入先から商品が納品され、対応する発注記録を特定できた | 必要に応じて検品する |
|
|
184
|
+
| データストア | 「仕入記録」を全体概要と同じ名称・トランザクション区分で使う | 図だけ「発注 DB」と改名する |
|
|
185
|
+
| 図の分割 | 仕入計画と入荷検品を領域単位の二図に分け、受け渡す発注内容を一致させる | 性質の異なる全プロセスを一図に詰め込む |
|
|
186
|
+
| 状態遷移 | 検品を状態変更プロセスとして示し、商品状態の定義と遷移は STSD を参照する | 未入荷→検品中→販売可能の遷移表を CDFD に複製する |
|
|
187
|
+
| 主要例外 | 発注記録を特定できない場合は入荷記録を確定せず、照合後に受入から再開する | エラーなら適切に対応する |
|
|
188
|
+
| 委譲 | 補充判断を `cdfd-inventory`、グループ横断順序を `cdfd-uc-replenishment` へ委譲する | 在庫グループの補充判定手順を仕入 CDFD 内に描く |
|
|
189
|
+
|
|
190
|
+
## 7. レビュー観点
|
|
191
|
+
|
|
192
|
+
| 観点 | 確認内容 | 主な確認者 |
|
|
193
|
+
| ------------ | ---------------------------------------------------------------------------- | -------------------------- |
|
|
194
|
+
| 業務価値 | グループ内の各出力が、上位目的と対象者の利用場面のどちらを支えるか説明できる | 業務分析担当 |
|
|
195
|
+
| 領域網羅 | 対象グループの全領域が一度ずつ登場し、各領域に内部プロセスがある | 業務分析担当、品質確認担当 |
|
|
196
|
+
| 必須性境界 | 必須・条件付き・選択プロセスの起動条件と非起動時の扱いを承認できる | 店主代表 |
|
|
197
|
+
| 設計入力 | 各プロセスの起動条件、入出力、データストア、委譲先を識別できる | 技術メンター |
|
|
198
|
+
| 状態責務 | CDFD が状態を定義せず、状態変更プロセスから STSD をたどれる | 技術メンター、品質確認担当 |
|
|
199
|
+
| 例外 | 主要例外の検出条件、停止範囲、再開条件が判定できる | 品質確認担当 |
|
|
200
|
+
| 用語整合 | 領域、プロセス、イベント、入出力、データストアの名称が上位・表・図で一致する | 業務分析担当、品質確認担当 |
|
|
201
|
+
| グループ境界 | 同一グループ内の領域間フローを描き、他グループの内部処理を作り込んでいない | 業務分析担当、アーキテクト |
|
|
202
|
+
|
|
203
|
+
「業務分析担当」「品質確認担当」「技術メンター」「アーキテクト」は、対象プロジェクトのロール定義または対応する責任分担文書で正式な担当へ対応付けます。
|
|
204
|
+
|
|
205
|
+
## 8. 仕上げチェック
|
|
206
|
+
|
|
207
|
+
- 対象者、利用場面、対象グループ、開始・終了、組織・システム境界、対象外を明記した。
|
|
208
|
+
- 全体概要の対象グループに属する全領域を一度ずつ掲載し、各領域に一つ以上のプロセスがある。
|
|
209
|
+
- 領域単位の主要入力・主要出力・データストアが、全体概要のグループ単位の箇条書きと矛盾しない。
|
|
210
|
+
- プロセス ID は所属領域 ID の枝番で、一覧・図・入出力表に同じ ID と名称を使用した。
|
|
211
|
+
- 「データストア」が全体概要の部分集合で、名称・区分・読み書きの別が各表と図に一致する。
|
|
212
|
+
- 図を領域または業務の性質ごとに分け、図直後に凡例の参照、線種、省略事項、共有ノードを記載した。
|
|
213
|
+
- 条件付き・選択プロセスの起動条件と非起動時の正常な扱いを説明できる。
|
|
214
|
+
- 状態を変えるプロセスから STSD を参照し、状態定義・遷移表・状態遷移図を CDFD に複製していない。
|
|
215
|
+
- 主要例外に検出条件、扱い、継続・再開条件がある。
|
|
216
|
+
- グループ外委譲の委譲先、引き渡す情報、戻す条件があり、同一グループ内の領域間受け渡しを委譲扱いにしていない。
|
|
217
|
+
- 未決事項は共通ラベルで確定情報と区別し、ない場合は章を設けていない。
|
|
218
|
+
- 個人情報、秘密情報、非公開の組織情報など、公開範囲に不適切な内容を含めていない。
|