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
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cnd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: draft
|
|
6
|
+
rulebook: specdojo:cnd-rulebook
|
|
7
|
+
sample: specdojo:cnd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# C4コンテナ図 作成レシピ
|
|
11
|
+
|
|
12
|
+
C4 Container Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
利用者が必要とする結果から、実行単位・ストア・連携経路を選ぶ作り方を示す。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- コンテナ図は、上位のコンテキスト図の利用目的と外部への委譲を引き継ぎ(Why)、それを担う実行単位・ストア・関係を定め(What)、配置の前提と結合で観測する結果までを扱う(How)。要素名と関係 ID で、図・定義・検証観点・仮定をたどれるようにする(Trace)。
|
|
19
|
+
|
|
20
|
+
## 2. 作成前に集める情報
|
|
21
|
+
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| -------------- | ------------------------------------------------------------ | ------------------------------------ |
|
|
24
|
+
| 利用目的と境界 | 誰が何を達成するか、対象に含める責務と外へ委ねる処理 | 上位のコンテキスト図 |
|
|
25
|
+
| 実行単位の候補 | 別に起動・配備するアプリと、別にする理由 | 開発者への確認、起動・配備の手順 |
|
|
26
|
+
| 記録と生成物 | 正本、更新する主体、読む主体と時点 | 開発者への確認、リポジトリの構成 |
|
|
27
|
+
| 外部依存 | 常時必要か特定の操作時だけか、同じ端末にある別ツール | 上位のコンテキスト図、開発者への確認 |
|
|
28
|
+
| 配置の前提 | ローカル・リモート、構築時・閲覧時の区別と、根拠のない配置案 | 運用担当への確認 |
|
|
29
|
+
| 詳細の正本 | 連携契約、データ構造、内部構成、インフラを扱う文書 | 文書の一覧 |
|
|
30
|
+
|
|
31
|
+
## 3. 全体の作成手順
|
|
32
|
+
|
|
33
|
+
1. 概要に、分解する対象と分割の目的を先に書く。目的がないと、分割を止める所が決まらない。
|
|
34
|
+
2. 要素と境界の定義で、実行単位の候補ごとに別に起動・配備する理由を付ける。理由が機能名だけなら元のアプリへ戻す。
|
|
35
|
+
3. ストアを正本と生成物に分け、更新する主体と読む主体を書く。
|
|
36
|
+
4. 利用者の操作から保存・外部への依頼・結果の確認までをたどって関係を書き、上位図の利用目的・外部依存ごとに担当するコンテナか描かない理由を決める。
|
|
37
|
+
5. 定義と関係が決まってから C4コンテナ図を描く。図から書くと、根拠のない線が残りやすい。
|
|
38
|
+
6. 技術前提・制約と検証観点では、経路ごとの正常な結果を先に決め、その後で読取不能・外部停止・応答欠落で区別する状態を書く。
|
|
39
|
+
7. 根拠の足りない配置・経路をメモ / 将来課題へ移す。
|
|
40
|
+
|
|
41
|
+
## 4. 各章の書き方
|
|
42
|
+
|
|
43
|
+
### 4.1. 概要
|
|
44
|
+
|
|
45
|
+
問い:
|
|
46
|
+
|
|
47
|
+
- 上位図のどのシステムを分解し、分割によって誰が配置や接続の何を判断できるか。
|
|
48
|
+
- サイトなどの派生した提供経路を含める場合、上位図との範囲の違いは何か。
|
|
49
|
+
|
|
50
|
+
コツ:
|
|
51
|
+
|
|
52
|
+
- 上位図の目的や利用者の説明は写さず、上位図への参照に置き換える。
|
|
53
|
+
- 目的を判断したいことに絞ると、分割を止める基準になる。
|
|
54
|
+
|
|
55
|
+
### 4.2. C4コンテナ図(Mermaid)
|
|
56
|
+
|
|
57
|
+
問い:
|
|
58
|
+
|
|
59
|
+
- 読み手は線から、依頼・参照の向きと、その線が成立する時点を説明できるか。
|
|
60
|
+
- 上位図の各利用目的・外部依存から経路をたどれるか。
|
|
61
|
+
|
|
62
|
+
コツ:
|
|
63
|
+
|
|
64
|
+
- ラベルを縮めると「構築時」「印刷時だけ」などの条件が落ちやすい。
|
|
65
|
+
- 方式が分からない接続は線で補わず、メモ / 将来課題へ移す。
|
|
66
|
+
|
|
67
|
+
### 4.3. 要素と境界の定義
|
|
68
|
+
|
|
69
|
+
問い:
|
|
70
|
+
|
|
71
|
+
- 各コンテナの責務は、誰のどの結果につながるか。
|
|
72
|
+
- ストアは正本か生成物か。直接更新するのは誰か。
|
|
73
|
+
|
|
74
|
+
コツ:
|
|
75
|
+
|
|
76
|
+
- 同じ端末にある外部ツールは、同じアプリにまとめやすい。管理する主体と、止まったときの影響を聞いて分ける。
|
|
77
|
+
- ファイルの保存場所、版管理の仕組み、共有サービスを聞き分け、更新する主体が複数なら排他制御の有無を開発者に聞く。
|
|
78
|
+
|
|
79
|
+
### 4.4. 技術前提・制約と検証観点
|
|
80
|
+
|
|
81
|
+
問い:
|
|
82
|
+
|
|
83
|
+
- 経路が正常に成立したとき、入力に対してどの保存内容・生成物・返却結果を照合できるか。
|
|
84
|
+
- 接続を止めたとき、失われる結果と残る記録は何か。
|
|
85
|
+
|
|
86
|
+
コツ:
|
|
87
|
+
|
|
88
|
+
- 書込先・外部の実行環境・閲覧先は、配置を設計する人に「何が未定だと困るか」を聞いて集める。
|
|
89
|
+
- 実行の成功と人の承認を同じ結果として書きやすい。分けて観測する対象を決める。
|
|
90
|
+
|
|
91
|
+
### 4.5. メモ / 将来課題
|
|
92
|
+
|
|
93
|
+
問い:
|
|
94
|
+
|
|
95
|
+
- 未確認の技術名・接続方式・配備先はどれで、そのために配置や結合確認の何が決められないか。
|
|
96
|
+
- 誰が何を確認すれば、仮定を更新できるか。
|
|
97
|
+
|
|
98
|
+
コツ:
|
|
99
|
+
|
|
100
|
+
- 解消条件は「配信先が公開範囲を満たすかを運用担当が確かめる」のように、誰が何を確かめるかの形で聞く。
|
|
101
|
+
|
|
102
|
+
## 5. 深掘り手順
|
|
103
|
+
|
|
104
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
105
|
+
|
|
106
|
+
1. 一つの利用結果から逆にたどり、対応する結果のないコンテナ候補を外す。
|
|
107
|
+
2. 各関係を「いつ」「誰が起動し」「何を渡すか」で読み直し、上位図から取り残した経路を探す。
|
|
108
|
+
3. 正本の更新から閲覧・共有までをたどり、正常な結果を照合する記録と、障害の影響が止まる境界を確かめる。根拠へ戻れない期待結果はメモ / 将来課題へ移す。
|
|
109
|
+
|
|
110
|
+
## 6. 良い例 / 悪い例
|
|
111
|
+
|
|
112
|
+
| 観点 | 良い例 | 悪い例 |
|
|
113
|
+
| ------------ | -------------------------------------------------------------- | ---------------------------------------------- |
|
|
114
|
+
| 分割の目的 | 「販売の入力、記録、印字の配備単位を示す」 | 「業務に必要なすべての構成」 |
|
|
115
|
+
| 分割の理由 | 画面はブラウザで動き、処理サービスはサーバーで動く | 登録・検索・削除をそれぞれコンテナにする |
|
|
116
|
+
| ストア | 文書の正本はファイル群、閲覧用 HTML は生成物とする | すべてを「DB」とし、更新元と派生物を区別しない |
|
|
117
|
+
| 関係のラベル | 「公開文書の参照(構築時)」 | 「データ連携」 |
|
|
118
|
+
| 外部依存 | 印刷時だけ印刷基盤へ依頼する | 印刷基盤の停止で全参照も止まると断定する |
|
|
119
|
+
| 検証観点 | 控えと紙面の一致と、印字失敗時に残る販売の記録を分けて確かめる | 「結合テストをする」 |
|
|
120
|
+
| 未確定の配置 | ローカル構築を仮定し、配信先の確認を運用担当へ渡す | 候補のホストを既存構成のように描く |
|
|
121
|
+
|
|
122
|
+
## 7. レビュー観点
|
|
123
|
+
|
|
124
|
+
| 観点 | 確認内容 |
|
|
125
|
+
| ------------ | -------------------------------------------------------- |
|
|
126
|
+
| 価値と範囲 | 利用者が得る結果が、分割後も上位図の境界からはみ出ないか |
|
|
127
|
+
| 配置への入力 | 実行単位、保持単位、必要な接続と仮定を分けて読み取れるか |
|
|
128
|
+
| 結合への入力 | 主要な経路と外部の失敗で観測する対象を関係 ID で追えるか |
|
|
129
|
+
| 詳細との分担 | 構文・データ構造・物理配置を書かず、更新先が分かるか |
|
|
130
|
+
|
|
131
|
+
## 8. 仕上げチェック
|
|
132
|
+
|
|
133
|
+
- 各コンテナが一つ以上の利用結果につながっている。
|
|
134
|
+
- 正本、構築時の入力、閲覧用の生成物が区別され、関係が成立する時点が図と定義で食い違っていない。
|
|
135
|
+
- 仮定と確定事項が分かれ、各仮定に誰が何を確かめるかがある。
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cpd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cpd-rulebook
|
|
7
|
+
sample: specdojo:cpd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# C4コンポーネント図 作成レシピ
|
|
11
|
+
|
|
12
|
+
C4 Component Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
上位コンテナの責務を内部のまとまりへ分け、機能名を並べただけの図から、実装と結合設計の判断に使える構成へ具体化する作り方を示す。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- CPD は、上位図と上位の要求から分割の理由(Why)を引き継ぎ、コンポーネントの責務と境界で受け渡す情報(What)を定め、依存方向と失敗時の観測点(How)を示す。これらをコンポーネント名と関係 ID でたどれるようにする(Trace)。
|
|
19
|
+
|
|
20
|
+
## 2. 作成前に集める情報
|
|
21
|
+
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元・聞く相手 |
|
|
23
|
+
| ---------- | ---------------------------------------------------------------------- | ----------------------- |
|
|
24
|
+
| 上位の境界 | 展開するコンテナ、外部のまま残す利用者・ストア・他システム | 上位のコンテナ図 |
|
|
25
|
+
| 必要な成果 | 利用者が確認して次へ進む結果、期待価値・成功基準の記述箇所 | 上位の要求・目的、BA |
|
|
26
|
+
| 代表の依頼 | 入力から結果の確認までの流れと、結果を作る側・記録する側 | 業務の流れ、BA・DEV |
|
|
27
|
+
| 責務の候補 | 入力の解釈・判断・記録・外部依頼のうち、別々に変更・確認したいもの | 実装担当(DEV)への確認 |
|
|
28
|
+
| 確定度 | 設計上の決定と実装で確かめた構成の区別、未確認の配置 | 実装担当(DEV)への確認 |
|
|
29
|
+
| 結合の論点 | 相手の不在・拒否・応答欠落で不明になる結果、依存する共通機構の保証範囲 | 外部 IF の仕様、ARC・QE |
|
|
30
|
+
|
|
31
|
+
## 3. 全体の作成手順
|
|
32
|
+
|
|
33
|
+
1. 代表の依頼を一つ選び、入力から結果の確認までをたどってメモする。分割の候補は、この流れで結果を作る側と記録する側から見つける。
|
|
34
|
+
2. 「要素と境界の定義」を先に書く。責務と入出力が決まらないと、図の矢印の意味が決まらない。
|
|
35
|
+
3. 「C4コンポーネント図(Mermaid)」に、主要な依頼と依存を関係 ID 付きで描く。
|
|
36
|
+
4. 「技術前提・制約と検証観点」で、関係ごとの成功と失敗の観測点を書く。
|
|
37
|
+
5. 確かめられなかった配置や保証を「メモ / 将来課題」へ移す。
|
|
38
|
+
6. 最後に「概要」を書く。分割と未確認の範囲が決まってから書くと、対象外と確定度を言い切れる。
|
|
39
|
+
|
|
40
|
+
## 4. 各章の書き方
|
|
41
|
+
|
|
42
|
+
### 4.1. 概要
|
|
43
|
+
|
|
44
|
+
問い:
|
|
45
|
+
|
|
46
|
+
- この分割で、後続の設計・実装は何を判断できるようになるか。今回扱わない範囲は何か。
|
|
47
|
+
- 期待価値・成功基準は、どの上位記述から引き継ぐか。
|
|
48
|
+
|
|
49
|
+
コツ:
|
|
50
|
+
|
|
51
|
+
- 上位の目的や成功基準は写さず、参照に置き換える。上位に見つからなければ BA に聞き、答えが出るまで論点に残す。
|
|
52
|
+
- 構成案と確かめた構成を混ぜやすい。DEV に「どこまでコードで確かめたか」を聞き、残りは _ASSUMPTION_: にする。
|
|
53
|
+
|
|
54
|
+
### 4.2. C4コンポーネント図(Mermaid)
|
|
55
|
+
|
|
56
|
+
問い:
|
|
57
|
+
|
|
58
|
+
- 矢印は利用する側から利用される側へ向いているか。応答を逆向きの依存として足していないか。
|
|
59
|
+
- 主要経路を省くと、どの判断が変わるか。
|
|
60
|
+
|
|
61
|
+
コツ:
|
|
62
|
+
|
|
63
|
+
- 正常な依頼と外部応答が欠ける依頼の二本をたどると、描く経路と省く経路を選べる。
|
|
64
|
+
- 同じ端末で動くという理由で、上位図の外側の要素を内側へ移しやすい。
|
|
65
|
+
|
|
66
|
+
### 4.3. 要素と境界の定義
|
|
67
|
+
|
|
68
|
+
問い:
|
|
69
|
+
|
|
70
|
+
- その責務を削ると、誰が結果を作れなくなるか。
|
|
71
|
+
- 二つの要素が同じ記録の更新判断を持っていないか。
|
|
72
|
+
|
|
73
|
+
コツ:
|
|
74
|
+
|
|
75
|
+
- 入出力は「確認済み販売明細」「保存結果」のように意味で書くと、判断する側と記録する側の分界が見える。
|
|
76
|
+
- 共通化の候補には「分けたままだと、どの判断が重複するか」を聞く。同名の関数があるだけでは共通化の理由にならない。
|
|
77
|
+
- 値・構文・構造は写さず、管理する文書への参照に置き換える。未作成なら仮の参照と確認先を残す。
|
|
78
|
+
|
|
79
|
+
### 4.4. 技術前提・制約と検証観点
|
|
80
|
+
|
|
81
|
+
技術前提の問い:
|
|
82
|
+
|
|
83
|
+
- どの共通機構・外部依存に頼るか。排他・原子性・再試行の保証は確かめたか。
|
|
84
|
+
|
|
85
|
+
検証観点の問い:
|
|
86
|
+
|
|
87
|
+
- 各境界で、どの条件を与えると何を観測すれば成功・失敗を区別できるか。
|
|
88
|
+
|
|
89
|
+
コツ:
|
|
90
|
+
|
|
91
|
+
- 応答欠落を、成功・未実施のどちらかに即断しやすい。結果不明として別に観測する。
|
|
92
|
+
- 確かめられない期待値は、詳細の契約へ引き継ぐ。
|
|
93
|
+
|
|
94
|
+
### 4.5. メモ / 将来課題
|
|
95
|
+
|
|
96
|
+
問い:
|
|
97
|
+
|
|
98
|
+
- 未確認事項を確定するには、どの根拠が要るか。
|
|
99
|
+
- 確定しないまま進むと、どの要素・関係と後続の作業が止まるか。
|
|
100
|
+
|
|
101
|
+
コツ:
|
|
102
|
+
|
|
103
|
+
- 未確認の主張を仮定・判断待ち・確認作業に分けると、当面の扱いと解消条件を書ける。
|
|
104
|
+
- 対象の要素名・関係 ID を必ず添える。添えないと影響先をたどれない。
|
|
105
|
+
|
|
106
|
+
## 5. 深掘り手順
|
|
107
|
+
|
|
108
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
109
|
+
|
|
110
|
+
1. 各出力が、どの利用場面と上位の成功基準に応えるかを確かめ、使われない出力のためだけの分割を外す。
|
|
111
|
+
2. 外部依頼の直前と直後で止まった場合を比べ、残る記録と結果不明を区別できない関係を探す。
|
|
112
|
+
3. 共通機構を外したとき、複数の責務へ同じ判断が散らばるかを確かめる。散らばらない共通化は外す。
|
|
113
|
+
4. 一つの変更(境界・責務・外部契約)を仮定し、関係 ID から上位図・詳細契約・観測点・作業順への影響をたどる。たどれない関係は定義を補う。
|
|
114
|
+
|
|
115
|
+
## 6. 良い例 / 悪い例
|
|
116
|
+
|
|
117
|
+
| 観点 | 良い例 | 悪い例 |
|
|
118
|
+
| ---------- | ------------------------------------------------------------------------ | -------------------------------------- |
|
|
119
|
+
| 分割の用途 | 「交代時の未印字引き継ぎに応え、保存と印字の責任境界を結合設計へ渡す」 | 「販売を管理する」 |
|
|
120
|
+
| 分割の理由 | 印字失敗と販売確定を分けて確かめるため、印字連携を独立させる | コマンドの数だけ部品を作る |
|
|
121
|
+
| 依存の意味 | 会計処理が保存済み控えの印字を依頼し、発行結果を受ける | 会計と印字が相互に処理する |
|
|
122
|
+
| 共通化 | 商品参照と販売記録の保存接点を共通化し、販売可否の判断は会計側に残す | 共通処理がすべて判断する |
|
|
123
|
+
| 確定度 | 同一プロセス内の論理配置案とし、実装対応は DEV が確かめる | 未調査のソースパスを実装済みとして書く |
|
|
124
|
+
| 観測点 | `REL-08` の応答欠落で、保存済み販売と印字の結果不明を別々に観測する | 「異常系を確認する」 |
|
|
125
|
+
| 未確認事項 | 印字応答欠落の回復条件が定まるまで自動再送を認めず、印字経路の受入を保留 | 「保存を検討」 |
|
|
126
|
+
|
|
127
|
+
## 7. レビュー観点
|
|
128
|
+
|
|
129
|
+
| 観点 | 確認内容 |
|
|
130
|
+
| ---------- | ------------------------------------------------------------------ |
|
|
131
|
+
| 目的と分割 | 各責務の必要性を、上位コンテナが返す結果へ結び付けられるか |
|
|
132
|
+
| 更新責任 | 同じ結果を二つの要素が別々に確定していないか |
|
|
133
|
+
| 境界の観測 | 外部の不在・拒否・応答欠落で、起点が確かめる結果を区別できるか |
|
|
134
|
+
| 委譲の境界 | 値・構文・構造を写さず、変更が詳細の文書だけで済む形になっているか |
|
|
135
|
+
|
|
136
|
+
## 8. 仕上げチェック
|
|
137
|
+
|
|
138
|
+
- 図で省いた経路ごとに、省いても判断が変わらない理由を書いている。
|
|
139
|
+
- 実装で確かめていない配置や外部の保証を、確定事項として書いていない。
|
|
140
|
+
- 未確認事項ごとに、影響する要素・関係 ID と当面の扱いが分かる。
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cxd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cxd-rulebook
|
|
7
|
+
sample: specdojo:cxd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# C4コンテキスト図 作成レシピ
|
|
11
|
+
|
|
12
|
+
C4 Context Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
利用目的から対象システムの責務を選び、人・外部システムとの境界を説明する図と定義の作り方を示す。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- CXD は、利用者の課題と期待する成果(Why)を引き継ぎ、対象システムが引き受ける責務と境界外へ委ねる責務(What)を定め、人・外部システムとの関係と、関係が崩れたときの確かめ方(How)を示す。図の要素と定義表を要素名・関係 ID で対応付け、境界の判断から根拠と論点をたどれるようにする(Trace)。
|
|
19
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
|
|
20
|
+
|
|
21
|
+
## 2. 作成前に集める情報
|
|
22
|
+
|
|
23
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
24
|
+
| ------------ | ---------------------------------------------------------------- | ------------------------------------------ |
|
|
25
|
+
| 利用目的 | 誰の何の課題を解き、どの成果を対象システムが支えるか | 上位の概要・要求の文書 |
|
|
26
|
+
| 対象範囲 | 一つのシステムとして引き受けることと、人・別システムへ委ねること | 製品の責任者への確認 |
|
|
27
|
+
| 利用者 | 直接操作する人と、判断・確認だけに関わる人 | 利用場面の聞き取り |
|
|
28
|
+
| 外部依存 | 外部へ依頼する情報・処理と、常に要るか特定の機能でだけ要るか | 既存の連携仕様、実装の呼び出し箇所、設計者 |
|
|
29
|
+
| 未確定の論点 | 根拠が見つからない接続経路や保持範囲と、その影響 | 確認の過程のメモ |
|
|
30
|
+
|
|
31
|
+
## 3. 全体の作成手順
|
|
32
|
+
|
|
33
|
+
1. 対象システムの責務と委譲先を最初に対にする。ここが決まらないと、図に置く人・外部システムを選べない。
|
|
34
|
+
2. 概要に、利用目的と本図の対象外を書く。
|
|
35
|
+
3. 直接の利用者と外部システムを選び、関係ごとに、誰が何のために何を渡すかを書き出す。
|
|
36
|
+
4. 書き出した関係を短いラベルにして図を描く。表を先に作ると、図と表の名前がずれにくい。
|
|
37
|
+
5. 技術前提・制約と検証観点では、境界が成り立つ条件を先に挙げ、各条件が崩れたときに確かめることを後から作る。
|
|
38
|
+
6. 最後に、残った論点をメモ / 将来課題へ移す。
|
|
39
|
+
|
|
40
|
+
## 4. 各章の書き方
|
|
41
|
+
|
|
42
|
+
### 4.1. 概要
|
|
43
|
+
|
|
44
|
+
問い:
|
|
45
|
+
|
|
46
|
+
- 誰がどの結果を得るためのシステムか。
|
|
47
|
+
- 関心を持つだけの人と、直接操作する人をどう分けるか。
|
|
48
|
+
|
|
49
|
+
コツ:
|
|
50
|
+
|
|
51
|
+
- 目的が「便利にする」で止まったら、誰が何を記録・確認するのかまで聞く。
|
|
52
|
+
- 上位の文書にある目的や背景は写さず、参照に置き換える。
|
|
53
|
+
|
|
54
|
+
### 4.2. C4コンテキスト図(Mermaid)
|
|
55
|
+
|
|
56
|
+
問い:
|
|
57
|
+
|
|
58
|
+
- 各矢印の向きを、利用・依頼・送信のどれとして説明できるか。
|
|
59
|
+
- 人・外部システムの候補がない場合、利用・運用の接点を見落としていないか。
|
|
60
|
+
|
|
61
|
+
コツ:
|
|
62
|
+
|
|
63
|
+
- 関係を書き出してから描くと、ラベルが「連携」のような目的のない語になりにくい。
|
|
64
|
+
- 呼び出しを確かめられない関係は、線を引く前に論点へ分ける。線があると既知の関係に見える。
|
|
65
|
+
|
|
66
|
+
### 4.3. 要素と境界の定義
|
|
67
|
+
|
|
68
|
+
#### 4.3.1. 対象システムとシステム境界
|
|
69
|
+
|
|
70
|
+
問い:
|
|
71
|
+
|
|
72
|
+
- 利用者が期待する結果のうち、対象システムが直接管理するものは何か。
|
|
73
|
+
- 引き受けない責務は、人と別システムのどちらへ委ねるか。
|
|
74
|
+
|
|
75
|
+
コツ:
|
|
76
|
+
|
|
77
|
+
- 実装モジュール名を伏せても責務を説明できるかを試す。説明できなければ内部の分割を書いている。
|
|
78
|
+
|
|
79
|
+
#### 4.3.2. Person(人・ロール)
|
|
80
|
+
|
|
81
|
+
問い:
|
|
82
|
+
|
|
83
|
+
- 各候補は、操作・運用・管理のどの接点で直接利用するか。
|
|
84
|
+
- その接点で何を入力し、どの結果を確認して次の判断へ進むか。
|
|
85
|
+
|
|
86
|
+
コツ:
|
|
87
|
+
|
|
88
|
+
- 役職の一覧から始めず、利用場面ごとに誰が画面・コマンドに触れるかを聞く。
|
|
89
|
+
|
|
90
|
+
#### 4.3.3. External Software System(外部システム)
|
|
91
|
+
|
|
92
|
+
問い:
|
|
93
|
+
|
|
94
|
+
- 外部へ依頼する処理と、その結果を対象システムが管理する範囲はどこで分かれるか。
|
|
95
|
+
- 未導入・障害・応答欠落のとき、影響を受ける結果は何か。
|
|
96
|
+
|
|
97
|
+
コツ:
|
|
98
|
+
|
|
99
|
+
- 「保持される」「再送される」と聞いたら、確かめた連携仕様や実装を聞く。根拠がなければ仮定として残す。
|
|
100
|
+
|
|
101
|
+
#### 4.3.4. Relationship(関係・連携契約)
|
|
102
|
+
|
|
103
|
+
問い:
|
|
104
|
+
|
|
105
|
+
- 各関係は、どの利用目的を支えるか。
|
|
106
|
+
- ローカル実行か外部通信かを、何で確かめたか。
|
|
107
|
+
|
|
108
|
+
コツ:
|
|
109
|
+
|
|
110
|
+
- 引数や電文を書き始めたら、目的と渡す情報の要点だけを残し、詳細は写さず参照に置き換える。
|
|
111
|
+
|
|
112
|
+
### 4.4. 技術前提・制約と検証観点
|
|
113
|
+
|
|
114
|
+
問い:
|
|
115
|
+
|
|
116
|
+
- ローカル実行・外部通信・人の承認のうち、どの条件が境界を成り立たせているか。
|
|
117
|
+
- 外部依存が失敗したとき、誰が何を見れば「結果不明」と「失敗確定」を分けられるか。
|
|
118
|
+
|
|
119
|
+
コツ:
|
|
120
|
+
|
|
121
|
+
- これから確かめる検証対象と、契約・実装で確認済みの保証を混ぜやすい。確認済みかどうかを条件ごとに聞く。
|
|
122
|
+
|
|
123
|
+
### 4.5. メモ / 将来課題
|
|
124
|
+
|
|
125
|
+
問い:
|
|
126
|
+
|
|
127
|
+
- 論点は、本文のどの境界・関係に影響するか。
|
|
128
|
+
- どの情報が得られれば解消するか。
|
|
129
|
+
|
|
130
|
+
## 5. 深掘り手順
|
|
131
|
+
|
|
132
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
133
|
+
|
|
134
|
+
1. 関係を 1 本選び、利用者が得たい結果へ逆向きにたどる。目的につながらない関係は、本図に要るかを見直す。
|
|
135
|
+
2. 外部システムごとに、対象システムのどの責務を支えるかを確かめ、対応のない要素を外す。
|
|
136
|
+
3. 検証観点の各行が、どの関係または境界に対応するかを確かめる。
|
|
137
|
+
|
|
138
|
+
## 6. 良い例 / 悪い例
|
|
139
|
+
|
|
140
|
+
| 観点 | 良い例 | 悪い例 |
|
|
141
|
+
| ------------ | ---------------------------------------------------------------------------- | ---------------------------------------- |
|
|
142
|
+
| 概要の目的 | 「店番担当が現金販売を記録する CLI と、商品・売上管理、印刷の境界を示す」 | 「販売を便利にする全体像」 |
|
|
143
|
+
| 関係のラベル | 「CLI → 印刷基盤: 印字依頼・結果取得」 | 「CLI → 印刷基盤: 連携」 |
|
|
144
|
+
| 責務の分担 | 「CLI はレシート控えを保持し、印刷基盤が物理印字を担う」 | 「両方で印刷を管理する」 |
|
|
145
|
+
| 依存の粒度 | ローカル版管理とリモート共有の利用条件を分け、通信失敗の影響を共有に限る | リモート障害で全操作が停止すると断定する |
|
|
146
|
+
| 検証観点 | 「印字が時間切れになったとき、会計結果と控えを確認する」 | 「障害でも問題なく動く」 |
|
|
147
|
+
| 論点 | 「売上応答欠落時の照合は契約未整備。受付照会の契約で期待結果を確かめて解消」 | 「後で検討する」 |
|
|
148
|
+
|
|
149
|
+
## 7. レビュー観点
|
|
150
|
+
|
|
151
|
+
| 観点 | 確認内容 |
|
|
152
|
+
| ------------ | ---------------------------------------------------------------------- |
|
|
153
|
+
| 価値と利用者 | 各利用関係が、概要の課題のどの結果に応えるかを説明できるか |
|
|
154
|
+
| 境界と判断 | 対象システムが引き受ける範囲と、人が判断する範囲を読み手が合意できるか |
|
|
155
|
+
| 外部依存 | 依頼と結果の管理主体、未確定の条件が分かるか |
|
|
156
|
+
| 検証入力 | 不在・失敗・結果不明のときに確かめる情報を特定できるか |
|
|
157
|
+
|
|
158
|
+
## 8. 仕上げチェック
|
|
159
|
+
|
|
160
|
+
- 外部依存が使えないときに保持されると書いた情報に、確かめた根拠がある。
|
|
161
|
+
- 確認済みの保証と、これから確かめる検証対象を分けて書いている。
|
|
162
|
+
- 同じ端末で動く外部ツールを、対象システムの内部に置いていない。
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:ifd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:ifd-mermaid-rulebook
|
|
7
|
+
sample: specdojo:ifd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# インフラ構成図 作成レシピ
|
|
11
|
+
|
|
12
|
+
Infrastructure Flow Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
上位の責務を実行場所と通信境界へ移し、境界設計と障害の切り分けに使える構成図を作るための作り方を示す。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 構成図は、上位構成図とプロジェクト文脈から継続したい利用と守る情報を引き継ぎ(Why)、実行場所・境界・経路を定め(What)、技術前提と検証観点で境界の成り立ちを示す(How)。経路 ID で情報・利用条件・検証対象・未決事項を結ぶ(Trace)。
|
|
19
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。製品名や枠の数から始めない。
|
|
20
|
+
|
|
21
|
+
## 2. 作成前に集める情報
|
|
22
|
+
|
|
23
|
+
秘密値は集めず、管理主体と確認先だけを控える。
|
|
24
|
+
|
|
25
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
26
|
+
| ------------ | ---------------------------------------------------------------------- | ---------------------------- |
|
|
27
|
+
| 利用目的 | 誰が何の記録・処理を続け、どの障害を切り分けたいか | 上位構成図、プロジェクト文脈 |
|
|
28
|
+
| 上位の要素 | 処理・データ・外部依存の責務 | 上位構成図 |
|
|
29
|
+
| 実行場所 | ホスト、実行用コンテナ、別端末、外部基盤のどこで動くか、代替配置の有無 | 環境の管理者への確認 |
|
|
30
|
+
| 正本とコピー | 何をどこに保持し、閲覧物・共有物・復元用コピーをどう分けるか | 環境の管理者への確認 |
|
|
31
|
+
| 接続条件 | 誰が起動し、いつ外部接続が要り、何を送るか | 連携の担当への確認 |
|
|
32
|
+
| 確認の根拠 | 配置・接続条件の確認元と、未検証の仮定 | 設定の確認記録、検証の記録 |
|
|
33
|
+
|
|
34
|
+
## 3. 全体の作成手順
|
|
35
|
+
|
|
36
|
+
1. 上位の処理・データを実行場所へ仮置きする。同じホストにあることと、同じ管理主体であることを分けて考える。
|
|
37
|
+
2. 「配置と境界の定義」を書く。配置が決まらないと、経路の起点・終点が決まらない。配置が不明なものは仮定として残す。
|
|
38
|
+
3. 「通信経路と情報の境界」で経路 ID を振る。ローカル操作と外部への持ち出しを分ける。
|
|
39
|
+
4. 「インフラ構成図」を、決めた配置と経路 ID から描く。図から先に描くと、表が図の言い直しになる。
|
|
40
|
+
5. 「技術前提・制約と検証観点」で、境界が成り立つ条件と、依存が使えないときの影響を書く。
|
|
41
|
+
6. 「メモ / 将来課題」に、仮定と不足情報がどの経路に効くかを集める。なければ章を省く。
|
|
42
|
+
7. 最後に「概要」を書く。判断範囲は配置と経路が決まってから絞ると、本文の言い直しにならない。
|
|
43
|
+
|
|
44
|
+
## 4. 各章の書き方
|
|
45
|
+
|
|
46
|
+
### 4.1. 概要
|
|
47
|
+
|
|
48
|
+
問い:
|
|
49
|
+
|
|
50
|
+
- この図を使う人は、配置、接続、障害影響のどれを判断するか。
|
|
51
|
+
- 上位の責務のうち、今回配置しないものは何か。
|
|
52
|
+
|
|
53
|
+
コツ:
|
|
54
|
+
|
|
55
|
+
- 上位構成図の背景を写したくなったら、上位構成図への参照に置き換える。
|
|
56
|
+
- 費用や担当負荷を変える前提が、採用済みの事実として紛れ込みやすい。決まっていなければ仮定にする。
|
|
57
|
+
|
|
58
|
+
### 4.2. インフラ構成図
|
|
59
|
+
|
|
60
|
+
問い:
|
|
61
|
+
|
|
62
|
+
- 各枠を越えると、実行場所・到達条件・管理主体の何が変わるか。
|
|
63
|
+
- 一本の矢印を、依頼・参照・転送のどれと説明できるか。
|
|
64
|
+
|
|
65
|
+
コツ:
|
|
66
|
+
|
|
67
|
+
- 中継を省いた線は、許可していない直接接続に見えやすい。省いたら、到達条件が変わる点を本文に残す。
|
|
68
|
+
|
|
69
|
+
### 4.3. 配置と境界の定義
|
|
70
|
+
|
|
71
|
+
問い:
|
|
72
|
+
|
|
73
|
+
- 正本、閲覧物、共有先、復元用コピーを区別できるか。
|
|
74
|
+
- 代替配置へ切り替えると、保持範囲・書込範囲・到達性のどれを確かめ直すか。
|
|
75
|
+
|
|
76
|
+
コツ:
|
|
77
|
+
|
|
78
|
+
- 同じ枠の二要素について、管理者・保持情報・到達許可が同じかを管理者に聞く。違えば別の枠か注記にする。
|
|
79
|
+
- 表には図にない管理責務と到達条件だけを足し、図の枠を読み上げない。
|
|
80
|
+
|
|
81
|
+
### 4.4. 通信経路と情報の境界
|
|
82
|
+
|
|
83
|
+
問い:
|
|
84
|
+
|
|
85
|
+
- 外部へ出る情報と、選んだ機能でだけ要る経路はどれか。
|
|
86
|
+
- 送り先を変えたら、持ち出す情報と承認条件も変わるか。
|
|
87
|
+
|
|
88
|
+
コツ:
|
|
89
|
+
|
|
90
|
+
- 連携の担当に「その情報を送らなくても利用目的を満たせるか」を聞くと、不要な持ち出しが見つかる。
|
|
91
|
+
- 接続方式は確認した根拠を聞く。製品名から認証方式を推測しやすい。
|
|
92
|
+
|
|
93
|
+
### 4.5. 技術前提・制約と検証観点
|
|
94
|
+
|
|
95
|
+
問い:
|
|
96
|
+
|
|
97
|
+
- 外部サービス・通信・保存先を一つずつ使えなくすると、どの利用結果に影響するか。
|
|
98
|
+
- これから確かめる条件と、既に確かめた証跡を区別できるか。
|
|
99
|
+
|
|
100
|
+
コツ:
|
|
101
|
+
|
|
102
|
+
- 到達、認証、処理結果、保存結果を別々に聞く。「接続できたので保存もできた」とまとめやすい。
|
|
103
|
+
- 確かめられない保証は書かず、「メモ / 将来課題」へ戻す。
|
|
104
|
+
|
|
105
|
+
### 4.6. メモ / 将来課題
|
|
106
|
+
|
|
107
|
+
問い:
|
|
108
|
+
|
|
109
|
+
- 仮定・不足情報が、どの経路の判断や検証を止めるか。
|
|
110
|
+
- 未作成の文書を、実在する仕様として扱っていないか。
|
|
111
|
+
|
|
112
|
+
コツ:
|
|
113
|
+
|
|
114
|
+
- 「後日確認」で済ませず、決まったら直す枠と経路を書く。
|
|
115
|
+
|
|
116
|
+
## 5. 深掘り手順
|
|
117
|
+
|
|
118
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
119
|
+
|
|
120
|
+
1. 外部へ出る経路ごとに、どの利用目的に応えるかを確かめ、対応のない持ち出しを外す。
|
|
121
|
+
2. 配置表の要素ごとに、どの上位要素の責務かを確かめ、対応のない要素を外す。
|
|
122
|
+
3. 依存を止めた場面ごとに、ローカルの結果、相手側の受付、利用者が確かめられる結果を分ける。結果不明を未実行と推測しない。
|
|
123
|
+
|
|
124
|
+
## 6. 良い例 / 悪い例
|
|
125
|
+
|
|
126
|
+
| 観点 | 良い例 | 悪い例 |
|
|
127
|
+
| ------ | ---------------------------------------- | -------------------------------------------- |
|
|
128
|
+
| 境界 | 同じホストでも別管理のサービスを区別する | 同じネットワークにあるので同じ信頼範囲とする |
|
|
129
|
+
| 情報 | 共有時の変更履歴と推論時の文脈を分ける | 外部接続をすべて同期と呼ぶ |
|
|
130
|
+
| 継続性 | サービス停止で失う結果と残る記録を分ける | 外部障害時も問題なく動くと断定する |
|
|
131
|
+
|
|
132
|
+
## 7. レビュー観点
|
|
133
|
+
|
|
134
|
+
| 観点 | 確認内容 |
|
|
135
|
+
| -------- | ------------------------------------------------------------ |
|
|
136
|
+
| 利用目的 | 配置案が守る利用結果と、通信・費用・負荷の条件を説明できるか |
|
|
137
|
+
| 配置境界 | 上位要素と実行場所、正本、管理主体が対応するか |
|
|
138
|
+
| 持ち出し | 送る情報、送り先、利用条件、人間が判断する範囲が分かるか |
|
|
139
|
+
| 検証入力 | 経路ごとの失敗・結果不明と、観測する情報を分けられるか |
|
|
140
|
+
|
|
141
|
+
## 8. 仕上げチェック
|
|
142
|
+
|
|
143
|
+
- 図の要素から、実行場所・管理主体・保持情報へたどれる。
|
|
144
|
+
- 経路 ID から、利用目的・情報・利用条件・検証対象へたどれる。
|
|
145
|
+
- 未確認の隔離や復旧を保証していない。
|