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
|
@@ -16,58 +16,36 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
# 概念データフロー図(プロセスグループ別): _GROUP_NAME_
|
|
18
18
|
|
|
19
|
-
_TODO_:
|
|
19
|
+
_TODO_: 全体概要(`cdfd-overview`)のどのプロセスグループ(_AREA_ID_RANGE_)を詳細化した文書かを一文で示す。
|
|
20
20
|
|
|
21
21
|
## 1. 目的
|
|
22
22
|
|
|
23
|
-
_TODO_:
|
|
24
|
-
|
|
25
|
-
- _ROLE_ は、_TODO_: 対象グループの業務境界、起動条件、主要例外を承認する。
|
|
26
|
-
- _ROLE_ は、_TODO_: 領域間の受け渡しとプロセス入出力を後続成果物へ利用する。
|
|
27
|
-
- _ROLE_ は、_TODO_: 領域・プロセス・状態遷移参照・委譲の重複や欠落を確認する。
|
|
23
|
+
_TODO_: 誰が、対象グループの内部フロー、領域間の受け渡し、主要例外、グループ外への委譲を承認・後続設計・確認のどれに使うかを 1〜2 文で書く。
|
|
28
24
|
|
|
29
25
|
## 2. 適用範囲
|
|
30
26
|
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
- 対象業務: _TODO_: どのイベントから、どの出力がそろうまでを対象とするかを書く。
|
|
34
|
-
- 組織境界: _TODO_: グループ内部の担当と外部主体を書く。
|
|
35
|
-
- システム境界: _TODO_: 概念上の参照・記録範囲と、対象外の操作・保存方式を書く。
|
|
36
|
-
- 対象外: _TODO_: 補助操作、実装詳細、他グループの責務、ユースケース別 CDFD が扱う横断順序を、`cdfd-_OTHER_GROUP_` または `cdfd-uc-_TOPIC_` のような委譲先とともに書く。
|
|
37
|
-
- 状態遷移: _TODO_: 状態名・成立条件・遷移元・遷移先・イベント・条件を定める STSD の文書 ID を示し、本書は状態を変えるプロセスと起動条件だけを扱うことを書く。
|
|
38
|
-
- 責任分担: _TODO_: 人間と AI Agent の責任分担を本文で再定義せず、対応する文書への参照を書く。
|
|
27
|
+
- **対象**: _GROUP_NAME_ グループ(_AREA_ID_RANGE_)の _START_EVENT_ から _END_EVENT_ まで、_TODO_: 対象期間と組織・システム境界を 1 行で書く。
|
|
28
|
+
- **対象外**: _TODO_: 補助操作・実装詳細、他グループの責務(`cdfd-_OTHER_GROUP_`)、横断ユースケース(`cdfd-uc-_TOPIC_`)、状態定義・遷移を委ねる STSD を 1 行で示し、人間と AI Agent の責任分担などの共通原則は全体概要を参照する。
|
|
39
29
|
|
|
40
30
|
## 3. プロセス領域
|
|
41
31
|
|
|
42
|
-
_GROUP_NAME_ グループは全体概要の _AREA_COUNT_ 領域を引き継ぐ。領域 ID
|
|
32
|
+
_GROUP_NAME_ グループは全体概要の _AREA_COUNT_ 領域を引き継ぐ。領域 ID、名称、業務目的、主な担当、起点イベントは全体概要、受け渡しは概念データフローを正本とし、本章では領域ごとのプロセスを定める。
|
|
43
33
|
|
|
44
|
-
<!-- 対象グループに属する領域ごとに 3.n
|
|
34
|
+
<!-- 対象グループに属する領域ごとに 3.n の節を繰り返す。各節にはプロセスの表だけを置き、領域の要約文や主要入力・主要出力・データストアの箇条書きは置かない。 -->
|
|
45
35
|
|
|
46
36
|
### 3.1. _AREA_NAME_(_AREA_ID_)
|
|
47
37
|
|
|
48
|
-
_TODO_: 領域の役割と、領域内のプロセスがどう連携するかを 1〜3 文で要約する。
|
|
49
|
-
|
|
50
|
-
- **主要入力**: _TODO_: 外部主体、他領域、データストアから受け取る主要な情報・物を名詞で列挙する。
|
|
51
|
-
- **主要出力**: _TODO_: 外部主体、他領域、データストアへ渡す主要な情報・物を名詞で列挙する。
|
|
52
|
-
- **データストア**: _TODO_: 「データストア」と同じ名称で、参照・更新するデータストアを列挙する。
|
|
53
|
-
|
|
54
38
|
| プロセス ID | プロセス | 業務目的 | 主な担当 | 起動条件 | 完了条件 | 必須性 |
|
|
55
39
|
| -------------- | -------------- | ------------------ | ------------ | ----------------- | ---------------------- | ------------- |
|
|
56
40
|
| `_PROCESS_ID_` | _PROCESS_NAME_ | _BUSINESS_PURPOSE_ | _OWNER_ROLE_ | _START_CONDITION_ | _COMPLETION_CONDITION_ | _REQUIREMENT_ |
|
|
57
41
|
|
|
58
42
|
### 3.2. _AREA_NAME_(_AREA_ID_)
|
|
59
43
|
|
|
60
|
-
_TODO_
|
|
61
|
-
|
|
62
|
-
- **主要入力**: _TODO_
|
|
63
|
-
- **主要出力**: _TODO_
|
|
64
|
-
- **データストア**: _TODO_
|
|
65
|
-
|
|
66
44
|
| プロセス ID | プロセス | 業務目的 | 主な担当 | 起動条件 | 完了条件 | 必須性 |
|
|
67
45
|
| -------------- | -------------- | ------------------ | ------------ | ----------------- | ---------------------- | ------------- |
|
|
68
46
|
| `_PROCESS_ID_` | _PROCESS_NAME_ | _BUSINESS_PURPOSE_ | _OWNER_ROLE_ | _START_CONDITION_ | _COMPLETION_CONDITION_ | _REQUIREMENT_ |
|
|
69
47
|
|
|
70
|
-
<!-- プロセス ID は所属領域 ID に二桁の枝番を付けた P-01-01 形式にする。各領域に一つ以上のプロセスを置き、全プロセスを一行ずつ追加する。完了条件は主要出力または正本の確定から yes / no で判定できる事実を書く。必須性は必須/条件付き/選択から選び、条件付き・選択では非起動時の正常な扱いも同じセルに書く。単一領域グループでは 3.2
|
|
48
|
+
<!-- プロセス ID は所属領域 ID に二桁の枝番を付けた P-01-01 形式にする。各領域に一つ以上のプロセスを置き、全プロセスを一行ずつ追加する。完了条件は主要出力または正本の確定から yes / no で判定できる事実を書く。必須性は必須/条件付き/選択から選び、条件付き・選択では非起動時の正常な扱いも同じセルに書く。単一領域グループでは 3.2 の節を削除する。 -->
|
|
71
49
|
|
|
72
50
|
## 4. データストア
|
|
73
51
|
|
|
@@ -93,33 +71,82 @@ _TODO_: 「プロセス領域」の各表の行を一つのプロセスノード
|
|
|
93
71
|
|
|
94
72
|
### 5.1. _FLOW_SCOPE_NAME_(_AREA_ID_RANGE_)
|
|
95
73
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
74
|
+
<!-- 以下は D2 の例。記法は全体概要の「凡例(本プロダクト共通)」の宣言に従う。凡例が D2 を宣言した場合は specdojo:cdfd-d2-rulebook に従い、凡例が Mermaid を宣言した場合、記法を宣言しない場合、または凡例がない場合は、本図を specdojo:cdfd-mermaid-rulebook に従う Mermaid の flowchart へ置き換える。色・絵文字の割り当ては凡例があればそれに合わせる。対象グループで使わない雛形のノード・線・classes は削除し、物を渡す線には material_flow class、現物の保管先には physical_store class を使う。 -->
|
|
75
|
+
|
|
76
|
+
```d2
|
|
77
|
+
direction: down
|
|
78
|
+
|
|
79
|
+
classes: {
|
|
80
|
+
process: {
|
|
81
|
+
shape: rectangle
|
|
82
|
+
style: {
|
|
83
|
+
border-radius: 8
|
|
84
|
+
fill: "#e3f2fd"
|
|
85
|
+
stroke: "#1e88e5"
|
|
86
|
+
font-color: "#000000"
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
event: {
|
|
90
|
+
shape: hexagon
|
|
91
|
+
style: {
|
|
92
|
+
fill: "#fff3e0"
|
|
93
|
+
stroke: "#fb8c00"
|
|
94
|
+
font-color: "#000000"
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
store_master: {
|
|
98
|
+
shape: cylinder
|
|
99
|
+
style: {
|
|
100
|
+
fill: "#e8f5e9"
|
|
101
|
+
stroke: "#43a047"
|
|
102
|
+
font-color: "#000000"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
store_transaction: {
|
|
106
|
+
shape: cylinder
|
|
107
|
+
style: {
|
|
108
|
+
fill: "#c8e6c9"
|
|
109
|
+
stroke: "#2e7d32"
|
|
110
|
+
font-color: "#000000"
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
physical_store: {
|
|
114
|
+
shape: rectangle
|
|
115
|
+
style: {
|
|
116
|
+
border-radius: 20
|
|
117
|
+
fill: "#c8e6c9"
|
|
118
|
+
stroke: "#2e7d32"
|
|
119
|
+
font-color: "#000000"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
actor: {
|
|
123
|
+
shape: rectangle
|
|
124
|
+
style: {
|
|
125
|
+
fill: "#f5f7fa"
|
|
126
|
+
stroke: "#607d8b"
|
|
127
|
+
font-color: "#000000"
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
material_flow: {
|
|
131
|
+
style: {
|
|
132
|
+
stroke-width: 3
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
external: "_EXTERNAL_NAME_" { class: actor }
|
|
138
|
+
start_event: "_START_EVENT_" { class: event }
|
|
139
|
+
process: "_PROCESS_ID_ _PROCESS_NAME_" { class: process }
|
|
140
|
+
master_store: "_MASTER_STORE_NAME_" { class: store_master }
|
|
141
|
+
transaction_store: "_TRANSACTION_STORE_NAME_" { class: store_transaction }
|
|
142
|
+
|
|
143
|
+
external -> start_event: "_EVENT_INPUT_LABEL_"
|
|
144
|
+
start_event -> process: "起動条件"
|
|
145
|
+
master_store -> process: "_REFERENCE_LABEL_"
|
|
146
|
+
process -> transaction_store: "_OUTPUT_LABEL_"
|
|
120
147
|
```
|
|
121
148
|
|
|
122
|
-
_TODO_:
|
|
149
|
+
_TODO_: 凡例の適用元を書く。全体概要に「凡例(本プロダクト共通)」がある場合はその章を参照し、ない場合は「ノード形状・線種・色・絵文字は `specdojo:cdfd-mermaid-rulebook` の既定凡例に従う」と書く。続けて、使用した線種(D2 は `->`・`<-` と `material_flow` class、Mermaid は `-->` / `==>`)、省略した入出力と理由、別図と共有するノード、他グループの内部処理を省略したことを 1〜2 文で書く。状態名をノードとして並べず、状態間の遷移を描かない。
|
|
123
150
|
|
|
124
151
|
<!-- 図が一つで足りる場合は 5.1 の見出しを削除して図を直下へ置く。複数図に分ける場合は 5.2 以降として同じ「見出し+図+直後の注記」を繰り返す。 -->
|
|
125
152
|
|
|
@@ -35,6 +35,8 @@ _TODO_: ケース `_CASE_ID_` の正常系の順序を示す。名称・領域
|
|
|
35
35
|
|
|
36
36
|
<!-- rulebook の「描き方の選択」に従い、全体概要と同じグループ・区分ごとに節を置く。各節には役割表だけを置き、主要入力・主要出力の箇条書きは置かない。以下はグループ代表ノードの例。領域単位の場合は「含む領域」を「プロセス領域」にし、P-xx 領域名を書く。PDCA は必要な場合だけ独立した列で追加し、グループ・区分の列に入れない。 -->
|
|
37
37
|
|
|
38
|
+
<!-- 複数の系統が共通して通る領域の内部は、全体概要またはその領域の詳細文書の 1 か所だけで描く。ほかの詳細では 1 ノードと受け渡しの線だけにし、内部の正本を役割表の「参照先」に示す。領域のまとまりの場合も全体概要の名称と含む領域 ID を併記する。 -->
|
|
39
|
+
|
|
38
40
|
### 3.1. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
|
|
39
41
|
|
|
40
42
|
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
@@ -73,6 +75,8 @@ _TODO_: 図から読み取れる流れや関係を 1 文で書く。題は「起
|
|
|
73
75
|
|
|
74
76
|
<!-- 開始から終了まで上から下へ配置する。イベントは一ノード一出来事の短い文にし、長ければ原文を保って改行する。系統の入口は全体概要の表と同じ文言にし、複数の出来事は分ける。引き渡し条件のイベント・引き渡し ID・Orchestrator は置かない。以下は D2 の例。実際の記法・色は全体概要の凡例に合わせる。 -->
|
|
75
77
|
|
|
78
|
+
<!-- 以下の例は絵文字なし。ノードの絵文字の有無・割り当ては全体概要の凡例に合わせ、正常系・戻りの全図と系統間でそろえる。凡例で付ける方針なら両図の全対象ノードへ反映し、同じ対象には同じ絵文字を使う。 -->
|
|
79
|
+
|
|
76
80
|
```d2
|
|
77
81
|
direction: down
|
|
78
82
|
|
|
@@ -140,11 +144,11 @@ target -> transaction_store: "_RESULT_INFORMATION_"
|
|
|
140
144
|
target -> end: "_COMPLETION_INFORMATION_"
|
|
141
145
|
```
|
|
142
146
|
|
|
143
|
-
_TODO_:
|
|
147
|
+
_TODO_: 全体概要の「凡例(本プロダクト共通)」を参照する短い注記と、使用線種・別図や内部の正本へ委ねる範囲・図を分ける場合の共有ノードを書く。
|
|
144
148
|
|
|
145
|
-
<!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class
|
|
149
|
+
<!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class を使う。対象ケースで使わない雛形のノード・線・classes は削除する。rulebook の分割の目安(一図の線が 15 本超、または一ノードの入出力が合計 10 本以上)や読みにくさに応じて連続する業務の段ごとに分割し、必要な線を削らず、同じ名称・領域 ID の共有ノードで接続を追えるようにする。引き渡し ID は作らない。 -->
|
|
146
150
|
|
|
147
|
-
<!--
|
|
151
|
+
<!-- 対象範囲の例外時の戻りを重要度で絞らず、以下の節に漏れなく描く。戻りがない場合だけ節ごと削除する。共通して通る領域の内部は 1 か所の正本へ委ね、領域から外へ返す情報は描く。「引き渡し」「例外時の戻り先」の章や条件表は設けない。 -->
|
|
148
152
|
|
|
149
153
|
### 5.2. 例外時の戻り
|
|
150
154
|
|
|
@@ -172,9 +176,9 @@ source <- target: "_RETURN_INFORMATION_"
|
|
|
172
176
|
source -> target: "_CORRECTED_INFORMATION_"
|
|
173
177
|
```
|
|
174
178
|
|
|
175
|
-
_TODO_:
|
|
179
|
+
_TODO_: 全体概要の凡例を参照し、通常の図やほかの戻りの図と共有する参加単位、別図・内部の正本へ委ねる範囲を短く注記する。
|
|
176
180
|
|
|
177
|
-
<!--
|
|
181
|
+
<!-- 戻りは補完・再判断を担う参加単位へ向け、返す情報と再提示する情報を名詞の線のラベルにする。線が多い場合は rulebook の分割の目安に従い、戻り先や業務の段ごとに本節の図を分け、必要な戻りを削らない。各図に戻す対象が分かる題と説明 1 文を付け、共有ノードで接続を追えるようにする。条件イベントや内部の再試行手順は置かない。 -->
|
|
178
182
|
|
|
179
183
|
<!-- 未決事項がある場合だけ以下の章を使い、ない場合は章ごと削除する。 -->
|
|
180
184
|
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cdr-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
applyTo: _APPLY_TO_
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
rulebook: specdojo:cdr-rulebook
|
|
13
|
+
based_on: _BASED_ON_
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# _DELIVERABLE_NAME_
|
|
17
|
+
|
|
18
|
+
_DELIVERABLE_OVERVIEW_
|
|
19
|
+
|
|
20
|
+
## 1. 基本方針
|
|
21
|
+
|
|
22
|
+
- _TODO_
|
|
23
|
+
|
|
24
|
+
## 2. モジュールと import
|
|
25
|
+
|
|
26
|
+
- モジュール方式・import の書き方: _TODO_
|
|
27
|
+
- 依存の向きの制約と検査する仕組み: _TODO_
|
|
28
|
+
|
|
29
|
+
## 3. 型
|
|
30
|
+
|
|
31
|
+
<!-- 動的型の言語では型ヒントの方針に置き換えるか、章を削除して導入文に理由を書く。 -->
|
|
32
|
+
|
|
33
|
+
- 型の宣言: _TODO_
|
|
34
|
+
- 不明な外部入力の扱い: _TODO_
|
|
35
|
+
- 型の強制の制限: _TODO_
|
|
36
|
+
|
|
37
|
+
## 4. エラー処理
|
|
38
|
+
|
|
39
|
+
- 例外と戻り値の使い分け: _TODO_
|
|
40
|
+
- エラーメッセージに含める文脈: _TODO_
|
|
41
|
+
- 例外の握りつぶしの禁止: _TODO_
|
|
42
|
+
|
|
43
|
+
## 5. 命名
|
|
44
|
+
|
|
45
|
+
- 識別子の大文字小文字: _TODO_
|
|
46
|
+
- 略語・真偽値の名前: _TODO_
|
|
47
|
+
|
|
48
|
+
## 6. テストと検証
|
|
49
|
+
|
|
50
|
+
| コマンド | 対象 | 実行条件 | 失敗時 |
|
|
51
|
+
| --------- | ------ | -------- | ------ |
|
|
52
|
+
| _COMMAND_ | _TODO_ | _TODO_ | _TODO_ |
|
|
53
|
+
|
|
54
|
+
## 7. 禁止事項
|
|
55
|
+
|
|
56
|
+
| 禁止事項 | 理由 |
|
|
57
|
+
| -------- | ------ |
|
|
58
|
+
| _TODO_ | _TODO_ |
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cnd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
rulebook: specdojo:cnd-rulebook
|
|
7
|
+
frontmatter_template:
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
rulebook: specdojo:cnd-rulebook
|
|
13
|
+
part_of: []
|
|
14
|
+
based_on: _BASED_ON_
|
|
15
|
+
supersedes: []
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# _DELIVERABLE_NAME_
|
|
19
|
+
|
|
20
|
+
## 1. 概要
|
|
21
|
+
|
|
22
|
+
_TODO_: 対象システム、上位コンテキスト図との対応、分割の目的、対象外を記入する。派生した提供経路を加える場合は範囲の違いを説明する。
|
|
23
|
+
|
|
24
|
+
_TODO_: 実行・配備の前提を示す。仮定は _ASSUMPTION_: とし、影響・確認先を「メモ / 将来課題」へ記入する。
|
|
25
|
+
|
|
26
|
+
_TODO_: 承認対象とする範囲・利用場面、作成担当・確認者・最終判断者の Role code を記入する。
|
|
27
|
+
|
|
28
|
+
## 2. C4コンテナ図(Mermaid)
|
|
29
|
+
|
|
30
|
+
<!-- 要素・関係は対象に応じて増減する。Person・外部システム・ストアが該当しない場合は理由を定義欄へ書く。骨組みの接続自体を確定構成として扱わない。 -->
|
|
31
|
+
|
|
32
|
+
```mermaid
|
|
33
|
+
flowchart LR
|
|
34
|
+
person["👤 _PERSON_NAME_"]
|
|
35
|
+
subgraph boundary["_SYSTEM_NAME_"]
|
|
36
|
+
app1("_CONTAINER_ONE_")
|
|
37
|
+
app2("_CONTAINER_TWO_")
|
|
38
|
+
store[("_STORE_NAME_")]
|
|
39
|
+
end
|
|
40
|
+
external["_EXTERNAL_NAME_"]
|
|
41
|
+
|
|
42
|
+
person -->|"_USE_LABEL_"| app1
|
|
43
|
+
app1 -->|"_INTERNAL_LABEL_"| app2
|
|
44
|
+
app2 -->|"_STORE_LABEL_"| store
|
|
45
|
+
app2 -->|"_EXTERNAL_LABEL_"| external
|
|
46
|
+
|
|
47
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
48
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
49
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
50
|
+
class person person;
|
|
51
|
+
class app1,app2,store system;
|
|
52
|
+
class external external;
|
|
53
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
_TODO_: 矢印の意味、応答の省略、構築時だけ成立する関係、任意依存を説明する。
|
|
57
|
+
|
|
58
|
+
_TODO_: 上位図の利用目的・外部依存について、担当コンテナと経路、描かない経路の対象外理由を記入する。
|
|
59
|
+
|
|
60
|
+
## 3. 要素と境界の定義
|
|
61
|
+
|
|
62
|
+
### 3.1. 対象システムとシステム境界
|
|
63
|
+
|
|
64
|
+
_TODO_: 境界内に含める責務と、境界外へ委ねる処理を対にして記入する。物理配置と責務の境界を区別する。
|
|
65
|
+
|
|
66
|
+
### 3.2. Person(人・ロール)
|
|
67
|
+
|
|
68
|
+
| Person(図中ラベル) | 利用目的・接点 | 判断・確認の責務 |
|
|
69
|
+
| -------------------- | --------------- | ----------------------- |
|
|
70
|
+
| `_PERSON_NAME_` | `_USE_PURPOSE_` | `_USER_RESPONSIBILITY_` |
|
|
71
|
+
|
|
72
|
+
### 3.3. Container(コンテナ)
|
|
73
|
+
|
|
74
|
+
| コンテナ(図中ラベル) | 責務 | 技術区分・実行配備の前提 |
|
|
75
|
+
| ---------------------- | ---------------------- | ------------------------ |
|
|
76
|
+
| `_CONTAINER_ONE_` | `_RESPONSIBILITY_ONE_` | `_EXECUTION_ONE_` |
|
|
77
|
+
| `_CONTAINER_TWO_` | `_RESPONSIBILITY_TWO_` | `_EXECUTION_TWO_` |
|
|
78
|
+
|
|
79
|
+
### 3.4. Data Store(データストア)
|
|
80
|
+
|
|
81
|
+
| ストア(図中ラベル) | 保持する情報・正本 | アクセスと生成物の境界 |
|
|
82
|
+
| -------------------- | ------------------------- | ----------------------------------- |
|
|
83
|
+
| `_STORE_NAME_` | `_PERSISTED_INFORMATION_` | `_READERS_WRITERS_AND_DERIVATIVES_` |
|
|
84
|
+
|
|
85
|
+
### 3.5. External Software System(外部システム)
|
|
86
|
+
|
|
87
|
+
| 外部システム(図中ラベル) | 利用条件・責任分界 | 不在・障害時の影響 |
|
|
88
|
+
| -------------------------- | ------------------------------------------- | ------------------ |
|
|
89
|
+
| `_EXTERNAL_NAME_` | `_DEPENDENCY_CONDITION_AND_RESPONSIBILITY_` | `_FAILURE_IMPACT_` |
|
|
90
|
+
|
|
91
|
+
### 3.6. Relationship(関係・連携契約)
|
|
92
|
+
|
|
93
|
+
<!-- 図の全関係に対応させ、端点・ラベルを一致させる。詳細の正本は実在する文書なら wikilink、未作成なら ID またはファイル名をインラインコードで記入する。構文・値・データ構造は参照先へ委ねる。 -->
|
|
94
|
+
|
|
95
|
+
| 関係 ID | 起点 → 終点 | 図中ラベル | 方式・条件と情報の要点 | 詳細の正本 |
|
|
96
|
+
| -------- | ------------------------------------- | ------------------ | ---------------------------------- | --------------------------- |
|
|
97
|
+
| `REL-01` | `_PERSON_NAME_` → `_CONTAINER_ONE_` | `_USE_LABEL_` | `_USER_CHANNEL_AND_INFORMATION_` | `_USER_SPEC_REFERENCE_` |
|
|
98
|
+
| `REL-02` | `_CONTAINER_ONE_` → `_CONTAINER_TWO_` | `_INTERNAL_LABEL_` | `_INTERNAL_CHANNEL_AND_TIMING_` | `_INTERNAL_SPEC_REFERENCE_` |
|
|
99
|
+
| `REL-03` | `_CONTAINER_TWO_` → `_STORE_NAME_` | `_STORE_LABEL_` | `_STORE_ACCESS_AND_TIMING_` | `_DATA_SPEC_REFERENCE_` |
|
|
100
|
+
| `REL-04` | `_CONTAINER_TWO_` → `_EXTERNAL_NAME_` | `_EXTERNAL_LABEL_` | `_EXTERNAL_CHANNEL_AND_CONDITION_` | `_EXTERNAL_SPEC_REFERENCE_` |
|
|
101
|
+
|
|
102
|
+
## 4. 技術前提・制約と検証観点
|
|
103
|
+
|
|
104
|
+
### 4.1. 技術前提・制約
|
|
105
|
+
|
|
106
|
+
- `_EXECUTION_AND_DEPLOYMENT_PRECONDITION_`
|
|
107
|
+
- `_BUILD_TIME_AND_RUNTIME_BOUNDARY_`
|
|
108
|
+
- `_LOCAL_REMOTE_AND_READ_WRITE_BOUNDARIES_`
|
|
109
|
+
- `_TRUST_AND_APPROVAL_CONSTRAINT_`
|
|
110
|
+
|
|
111
|
+
### 4.2. コンテナ間・外部依存の検証対象
|
|
112
|
+
|
|
113
|
+
<!-- 正常時は下流の結合検証へ渡す全経路に対応させる。保存先・外部依存では不在・失敗・結果不明時の状態も区別する。行は対象ごとに増減し、未確定の期待結果は「メモ / 将来課題」へ引き継ぐ。 -->
|
|
114
|
+
|
|
115
|
+
| 確認区分 | 対象関係・境界 | 観測する結果 | 主確認ロール |
|
|
116
|
+
| ------------ | ---------------------------------- | --------------------------------------- | --------------- |
|
|
117
|
+
| 正常時 | `_RELATIONSHIP_OR_BOUNDARY_` | `_NORMAL_RESULT_` | `_REVIEW_ROLE_` |
|
|
118
|
+
| 不在・失敗時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNAVAILABLE_OR_FAILED_RESULT_` | `_REVIEW_ROLE_` |
|
|
119
|
+
| 結果不明時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNKNOWN_RESULT_AND_RETAINED_RECORDS_` | `_REVIEW_ROLE_` |
|
|
120
|
+
|
|
121
|
+
### 4.3. 検証・承認前の確認
|
|
122
|
+
|
|
123
|
+
<!-- 確認内容・合格条件は rulebook の「検証・承認前の確認」に従う。 -->
|
|
124
|
+
|
|
125
|
+
- 文書検査・描画確認・内容レビューの記録: `_REVIEW_EVIDENCE_REFERENCE_`
|
|
126
|
+
- 未解決指摘と後続作業の制限: `_OPEN_FINDINGS_AND_RESTRICTIONS_`
|
|
127
|
+
- PO の承認・保留・差し戻しの記録: `_APPROVAL_RECORD_REFERENCE_`
|
|
128
|
+
- OPS による承認対象と公開対象の照合記録: `_PUBLICATION_SCOPE_CHECK_REFERENCE_`
|
|
129
|
+
- 改訂・廃止時の窓口と追従先・担当ロール: `_CHANGE_CONTACT_IMPACT_AND_ROLES_`
|
|
130
|
+
|
|
131
|
+
## 5. メモ / 将来課題
|
|
132
|
+
|
|
133
|
+
<!-- 仮定・未確定事項がない場合だけ章ごと削除する。最終列には解消条件、PJR 等の転送先レコード、判断者の Role code と判断期限または判断時点を記入する。 -->
|
|
134
|
+
|
|
135
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
136
|
+
| -------------- | ---------- | -------------- | ---------------------------------------- |
|
|
137
|
+
| `_OPEN_TOPIC_` | `_IMPACT_` | `_OWNER_ROLE_` | `_RESOLUTION_RECORD_DECIDER_AND_TIMING_` |
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cpd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cpd-rulebook
|
|
7
|
+
frontmatter_template:
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
owner: ARC
|
|
13
|
+
rulebook: specdojo:cpd-rulebook
|
|
14
|
+
part_of: []
|
|
15
|
+
based_on: _BASED_ON_
|
|
16
|
+
supersedes: []
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# _DELIVERABLE_NAME_
|
|
20
|
+
|
|
21
|
+
## 1. 概要
|
|
22
|
+
|
|
23
|
+
_TODO_: 上位コンテナ図の参照、対象コンテナ、分割の目的と設計入力としての用途、対象外を記入する。対象者の業務課題・放置時の影響・期待価値・成功基準は、上位の要求・目的の該当箇所を参照する。
|
|
24
|
+
|
|
25
|
+
_TODO_: 設計案と確認済みの実装構成を区別する。未確認の分割は _ASSUMPTION_: とし、影響と確認先を「メモ / 将来課題」に記入する。
|
|
26
|
+
|
|
27
|
+
_TODO_: 作成者、アーキテクチャ・実装・結合・業務の確認者と確認時点、最終合意者となる人間の PO を記入し、役割割当て・合意記録を参照する。公開する相手・媒体・範囲と、OPS の公開前確認の記録・PO の公開判断の参照先を記入する。
|
|
28
|
+
|
|
29
|
+
## 2. C4コンポーネント図(Mermaid)
|
|
30
|
+
|
|
31
|
+
<!-- 要素・関係は対象に合わせて増減する。下図の接続を確定設計として流用しない。ストアや外部システムの内外は上位図の境界に合わせる。 -->
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
flowchart LR
|
|
35
|
+
person["👤 _PERSON_ROLE_"]
|
|
36
|
+
subgraph boundary["_CONTAINER_NAME_"]
|
|
37
|
+
entry("_ENTRY_COMPONENT_")
|
|
38
|
+
domain("_DOMAIN_COMPONENT_")
|
|
39
|
+
adapter("_ADAPTER_COMPONENT_")
|
|
40
|
+
end
|
|
41
|
+
store[("_STORE_NAME_")]
|
|
42
|
+
external["_EXTERNAL_NAME_"]
|
|
43
|
+
|
|
44
|
+
person -->|"REL-01 _USE_LABEL_"| entry
|
|
45
|
+
entry -->|"REL-02 _REQUEST_LABEL_"| domain
|
|
46
|
+
domain -->|"REL-03 _DEPENDENCY_LABEL_"| adapter
|
|
47
|
+
domain -->|"REL-04 _STORE_LABEL_"| store
|
|
48
|
+
adapter -->|"REL-05 _EXTERNAL_LABEL_"| external
|
|
49
|
+
|
|
50
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
51
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
52
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
53
|
+
class person person;
|
|
54
|
+
class entry,domain,adapter system;
|
|
55
|
+
class store,external external;
|
|
56
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
_TODO_: 矢印の意味、応答の扱い、主要経路の選定理由と省略範囲を記入する。
|
|
60
|
+
|
|
61
|
+
## 3. 要素と境界の定義
|
|
62
|
+
|
|
63
|
+
### 3.1. 対象コンテナ境界と利用者
|
|
64
|
+
|
|
65
|
+
_TODO_: 境界に含む責務、境界外に残す別コンテナ・ストア・外部システム、上位図との対応を記入する。
|
|
66
|
+
|
|
67
|
+
| 上位図の Person | 本図の接点と確認する結果 |
|
|
68
|
+
| --------------- | ------------------------ |
|
|
69
|
+
| _PERSON_ROLE_ | _CONTACT_AND_RESULT_ |
|
|
70
|
+
|
|
71
|
+
<!-- Person が非該当なら表を削除し、その理由を書く。 -->
|
|
72
|
+
|
|
73
|
+
### 3.2. コンポーネントと論理配置
|
|
74
|
+
|
|
75
|
+
| コンポーネント | 固有の責務 | 主な入力 → 出力 | 論理配置・境界 |
|
|
76
|
+
| ---------------- | ---------------- | ------------------ | ------------------- |
|
|
77
|
+
| _COMPONENT_NAME_ | _RESPONSIBILITY_ | _INPUT_ → _OUTPUT_ | _LOGICAL_PLACEMENT_ |
|
|
78
|
+
|
|
79
|
+
_TODO_: 主要な分割・共通化・依存の採用理由を、上位の業務目的または技術制約に対応付けて記入する。実装配置への対応を示す場合は確認根拠を記入し、未確認の対応は「メモ / 将来課題」へ残す。
|
|
80
|
+
|
|
81
|
+
### 3.3. ストアと外部依存
|
|
82
|
+
|
|
83
|
+
| 要素・区分 | 保持内容または委ねる責務 | 利用条件・失敗の影響 |
|
|
84
|
+
| ----------------------- | ---------------------------- | ------------------------------ |
|
|
85
|
+
| _ELEMENT_NAME_AND_KIND_ | _CONTENTS_OR_RESPONSIBILITY_ | _CONDITION_AND_FAILURE_IMPACT_ |
|
|
86
|
+
|
|
87
|
+
<!-- ストア・外部依存のいずれかが非該当なら、その理由を書く。 -->
|
|
88
|
+
|
|
89
|
+
### 3.4. 関係と詳細の正本
|
|
90
|
+
|
|
91
|
+
| 関係 ID | 起点 → 終点 | 授受情報・条件 | 詳細の正本 |
|
|
92
|
+
| -------- | ---------------------------------------- | -------------------------------------- | ------------------------ |
|
|
93
|
+
| `REL-01` | _PERSON_ROLE_ → _ENTRY_COMPONENT_ | _USE_INFORMATION_AND_CONDITION_ | _USE_DETAIL_SOURCE_ |
|
|
94
|
+
| `REL-02` | _ENTRY_COMPONENT_ → _DOMAIN_COMPONENT_ | _REQUEST_INFORMATION_AND_CONDITION_ | _REQUEST_DETAIL_SOURCE_ |
|
|
95
|
+
| `REL-03` | _DOMAIN_COMPONENT_ → _ADAPTER_COMPONENT_ | _DEPENDENCY_INFORMATION_AND_CONDITION_ | _ADAPTER_DETAIL_SOURCE_ |
|
|
96
|
+
| `REL-04` | _DOMAIN_COMPONENT_ → _STORE_NAME_ | _STORE_INFORMATION_AND_CONDITION_ | _STORE_DETAIL_SOURCE_ |
|
|
97
|
+
| `REL-05` | _ADAPTER_COMPONENT_ → _EXTERNAL_NAME_ | _EXTERNAL_INFORMATION_AND_CONDITION_ | _EXTERNAL_DETAIL_SOURCE_ |
|
|
98
|
+
|
|
99
|
+
<!-- 図に合わせて行を増減し、全関係の ID・端点を対応付ける。値・構文・構造は詳細の正本へ委ね、既存なら文書 ID のリンク、未作成ならバッククォートの仮参照とする。 -->
|
|
100
|
+
|
|
101
|
+
## 4. 技術前提・制約と検証観点
|
|
102
|
+
|
|
103
|
+
### 4.1. 技術前提・制約
|
|
104
|
+
|
|
105
|
+
- _DEPENDENCY_CONSTRAINT_
|
|
106
|
+
- _PERSISTENCE_AND_DERIVED_DATA_BOUNDARY_
|
|
107
|
+
- _EXTERNAL_CALL_CONSTRAINT_
|
|
108
|
+
|
|
109
|
+
_TODO_: 保守・問い合わせ窓口と、変更時の影響確認記録を参照する。変更記録には影響する要素・関係 ID、後続成果物・実装・検証・Schedule の更新要否と理由・担当を残す。
|
|
110
|
+
|
|
111
|
+
### 4.2. コンポーネント間の検証対象
|
|
112
|
+
|
|
113
|
+
<!-- 通常時と失敗・応答欠落時の条件、合否を判断できる観測結果を関係 ID に対応付ける。実施結果は実行記録へ残す。 -->
|
|
114
|
+
|
|
115
|
+
| 対象関係 | 条件 | 観測する結果 |
|
|
116
|
+
| --------------- | ---------------------------- | ------------------- |
|
|
117
|
+
| `_RELATION_ID_` | _INPUT_OR_FAILURE_CONDITION_ | _OBSERVABLE_RESULT_ |
|
|
118
|
+
|
|
119
|
+
_TODO_: 文書検査・描画確認の証跡を参照する。
|
|
120
|
+
|
|
121
|
+
## 5. メモ / 将来課題
|
|
122
|
+
|
|
123
|
+
<!-- 仮定・未確認事項がない場合は章を省略する。論点は共通ラベルで確定事項と区別し、図・関係・制約の該当箇所と対応付ける。 -->
|
|
124
|
+
|
|
125
|
+
| 対象・区分 | 影響と後続成果物 | 担当 Role code・判断者 | 期限または判断タイミング | 次アクション・解消条件 | 承認への影響・引き継ぎ先 |
|
|
126
|
+
| -------------------- | ---------------------------- | ------------------------------- | ------------------------ | ---------------------------- | --------------------------------- |
|
|
127
|
+
| _TOPIC_AND_CATEGORY_ | _IMPACT_AND_DOWNSTREAM_DOCS_ | _OWNER_ROLE_AND_DECISION_MAKER_ | _DECISION_TIMING_ | _NEXT_ACTION_AND_RESOLUTION_ | _APPROVAL_IMPACT_AND_DESTINATION_ |
|
|
128
|
+
|
|
129
|
+
_TODO_: ARC から PM・人間の PO への報告先、継続追跡する論点の PJR 参照を記入する。未起票なら登録候補の理由・起票担当・判断時点を残し、後続作業の着手可否と Schedule の順序・期限への影響を対応付ける。
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cxd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: architecture
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:cxd-rulebook
|
|
12
|
+
part_of: []
|
|
13
|
+
based_on: _BASED_ON_
|
|
14
|
+
supersedes: []
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# _DELIVERABLE_NAME_
|
|
18
|
+
|
|
19
|
+
## 1. 概要
|
|
20
|
+
|
|
21
|
+
_TODO_: 対象システムの目的、提供価値、図の対象範囲を 1〜3 文で記入する。
|
|
22
|
+
|
|
23
|
+
| 対象者 | 課題・関心事 | 本図で確認する内容 |
|
|
24
|
+
| ------------- | ------------ | ------------------ |
|
|
25
|
+
| _STAKEHOLDER_ | _CONCERN_ | _CONFIRMATION_ |
|
|
26
|
+
|
|
27
|
+
_TODO_: 本図の対象外と、内部構成・操作・連携の詳細を委ねる先を示す。
|
|
28
|
+
|
|
29
|
+
## 2. C4コンテキスト図(Mermaid)
|
|
30
|
+
|
|
31
|
+
<!-- Person・外部システムと関係は対象に応じて増減し、表と対応させる。該当する主体がない場合は理由を本文に記入する。 -->
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
flowchart LR
|
|
35
|
+
person["👤 _PERSON_NAME_"]
|
|
36
|
+
subgraph boundary["対象システム"]
|
|
37
|
+
target("_SYSTEM_NAME_")
|
|
38
|
+
end
|
|
39
|
+
external["_EXTERNAL_SYSTEM_NAME_"]
|
|
40
|
+
|
|
41
|
+
person -->|"_USE_LABEL_"| target
|
|
42
|
+
target -->|"_DEPENDENCY_LABEL_"| external
|
|
43
|
+
|
|
44
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
45
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
46
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
47
|
+
class person person;
|
|
48
|
+
class target system;
|
|
49
|
+
class external external;
|
|
50
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
_TODO_: 矢印の向き、応答の省略など読み取りに必要な注記を 1〜3 文で記入する。
|
|
54
|
+
|
|
55
|
+
## 3. 要素と境界の定義
|
|
56
|
+
|
|
57
|
+
### 3.1. 対象システムとシステム境界
|
|
58
|
+
|
|
59
|
+
| 項目 | 内容 |
|
|
60
|
+
| ------------------------------------ | --------------------------- |
|
|
61
|
+
| システム名 | _SYSTEM_NAME_ |
|
|
62
|
+
| 提供する中核責務 | _CORE_RESPONSIBILITY_ |
|
|
63
|
+
| 境界内に含める範囲 | _IN_SCOPE_ |
|
|
64
|
+
| 境界外へ委ねる範囲(対象外と委譲先) | _OUT_OF_SCOPE_AND_DELEGATE_ |
|
|
65
|
+
|
|
66
|
+
### 3.2. Person(人・ロール)
|
|
67
|
+
|
|
68
|
+
| Person(図中ラベル) | 対応ロール | 利用目的・主な関わり | 境界上の接点・確認責務 |
|
|
69
|
+
| -------------------- | -------------------- | -------------------- | ---------------------- |
|
|
70
|
+
| _PERSON_NAME_ | _ROLE_OR_USER_GROUP_ | _USE_PURPOSE_ | _USER_RESPONSIBILITY_ |
|
|
71
|
+
|
|
72
|
+
### 3.3. External Software System(外部システム)
|
|
73
|
+
|
|
74
|
+
| 外部システム(図中ラベル) | 区分・位置づけ | 対象システムとの責任分界 | 不在・障害時の影響と扱い |
|
|
75
|
+
| -------------------------- | ---------------------- | ------------------------- | ------------------------ |
|
|
76
|
+
| _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_CONDITION_ | _RESPONSIBILITY_BOUNDARY_ | _FAILURE_IMPACT_ |
|
|
77
|
+
|
|
78
|
+
### 3.4. Relationship(関係・連携契約)
|
|
79
|
+
|
|
80
|
+
| 関係ID | 起点 → 終点 | 図中ラベル | やり取りする情報・制御の要点 | 連携方式・境界 | 正本・関連仕様 |
|
|
81
|
+
| -------- | -------------------------------------- | ------------------ | ---------------------------- | --------------------- | -------------------------- |
|
|
82
|
+
| `REL-01` | _PERSON_NAME_ → _SYSTEM_NAME_ | _USE_LABEL_ | _USER_INPUT_OUTPUT_ | _USER_CHANNEL_ | _USER_SPEC_REFERENCE_ |
|
|
83
|
+
| `REL-02` | _SYSTEM_NAME_ → _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_LABEL_ | _EXTERNAL_INPUT_OUTPUT_ | _INTEGRATION_CHANNEL_ | _INTERFACE_SPEC_REFERENCE_ |
|
|
84
|
+
|
|
85
|
+
## 4. 技術前提・制約と検証観点
|
|
86
|
+
|
|
87
|
+
### 4.1. 技術前提・制約
|
|
88
|
+
|
|
89
|
+
- _EXECUTION_OR_COMMUNICATION_CONSTRAINT_
|
|
90
|
+
- _TRUST_OR_APPROVAL_CONSTRAINT_
|
|
91
|
+
- _EXTERNAL_DEPENDENCY_PRECONDITION_
|
|
92
|
+
|
|
93
|
+
### 4.2. システム境界・外部依存の検証観点
|
|
94
|
+
|
|
95
|
+
| 確認区分 | 対象関係・境界 | 検証観点 | 主確認ロール |
|
|
96
|
+
| ---------------- | -------------------------- | ------------------ | ------------- |
|
|
97
|
+
| _CHECK_CATEGORY_ | _RELATIONSHIP_OR_BOUNDARY_ | _OBSERVABLE_CHECK_ | _REVIEW_ROLE_ |
|
|
98
|
+
|
|
99
|
+
## 5. メモ / 将来課題
|
|
100
|
+
|
|
101
|
+
<!-- 未作成の参照先・未確定の境界・将来課題がなければ、この章を削除する。 -->
|
|
102
|
+
|
|
103
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
104
|
+
| ------------ | -------- | ------------ | ---------------------------- |
|
|
105
|
+
| _OPEN_TOPIC_ | _IMPACT_ | _OWNER_ROLE_ | _RESOLUTION_AND_DESTINATION_ |
|