specdojo 0.8.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 +4 -1
- package/CHANGELOG.md +64 -0
- package/dist/catalog/catalog.js +16 -14
- 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 +4 -2
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- 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 +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- 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/repo-integration-sync.js +17 -5
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- 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 +4 -1
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -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 +13 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +9 -1
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +9 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- 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 +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- 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 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- 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 +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- 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 +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- 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 +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- 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 +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -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 +59 -81
- 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 +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- 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 +11 -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 +91 -106
- 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 +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- 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 +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- 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 +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- 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 +41 -108
- 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/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- 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-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -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/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- 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 +5 -2
|
@@ -11,40 +11,31 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Success Criteria and Acceptance Criteria Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
業務価値を起点に、プロジェクトの成功と初期受入の可否を、承認者が証跡で判断できる条件に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 次に、利用者にとって実現したい状態を業務価値として短く定義します。
|
|
20
|
-
- 業務価値ごとに、初期公開・初期リリース、短期、中長期の成功基準を置きます。
|
|
21
|
-
- 初期受入の対象について、価値提供を開始できる状態を受入条件と証跡で定義します。
|
|
22
|
-
- 最後に、確認者、承認者、否決時の再判定方法を明確にします。
|
|
23
|
-
- 利用者と期待効果(Why)、業務価値・成功基準・受入条件(What)、測定・確認・承認・再判定(How)を整理し、各 ID と証跡で追跡します(Trace)。詳細な実装・個別テスト手順は後続成果物へ委譲します。
|
|
18
|
+
- 概要とスコープから対象利用者と期待効果(Why)を引き継ぎ、業務価値ごとの成功基準と受入条件(What)を定め、測定・確認・承認・再判定の進め方(How)を決める。各条件は業務価値 ID と証跡でたどれるようにする(Trace)。
|
|
24
19
|
|
|
25
20
|
## 2. 作成前に集める情報
|
|
26
21
|
|
|
27
|
-
| 項目
|
|
28
|
-
|
|
|
29
|
-
| 対象と対象外
|
|
30
|
-
|
|
|
31
|
-
| 成功の状態
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
| 判断体制 | 確認者、承認者、否決時に是正を担う役割 |
|
|
36
|
-
| 未確定事項 | 閾値、期限、前提のうち、意思決定が未了のもの |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ---------------- | ------------------------------------------------------------ | ---------------------------- |
|
|
24
|
+
| 対象と対象外 | 今回判定する成果物・状態と、判定しない範囲 | プロジェクトスコープ |
|
|
25
|
+
| 利用者と期待効果 | 対象利用者、利用場面、期待する変化 | プロジェクト概要 |
|
|
26
|
+
| 成功の状態 | 初期公開、短期、中長期のそれぞれで、どうなれば成功と言えるか | 承認者・代表利用者への確認 |
|
|
27
|
+
| 費用と負荷の上限 | 追加の現金支出、人の作業時間、運用負荷の上限と、その承認者 | 承認者・実行責任者への確認 |
|
|
28
|
+
| 測定と証跡 | 観察、件数集計、費用・作業記録などの確認方法と、残せる記録 | 実行責任者・品質担当への確認 |
|
|
29
|
+
| 決めきれない値 | 閾値、期限、前提のうち、決定が済んでいないもの | 確認の過程のメモ |
|
|
37
30
|
|
|
38
31
|
## 3. 全体の作成手順
|
|
39
32
|
|
|
40
|
-
1.
|
|
41
|
-
2.
|
|
42
|
-
3.
|
|
43
|
-
4.
|
|
44
|
-
5.
|
|
45
|
-
6.
|
|
46
|
-
7. 判定の実施順、否決時の是正、再判定の記録方法を定義する。
|
|
47
|
-
8. 未確定の閾値・期限には _UNDECIDED_: を付け、決定時期と担当を記載する。依存文書(スコープ等)が別ラベル(例: _TODO_:)で未決を示している場合も、本書では _UNDECIDED_: に書き換える。
|
|
33
|
+
1. 業務価値を最初に定め、ID を付ける。成功基準も受入条件も業務価値に対応付けるため、ここが決まらないと条件の要否を判断できない。
|
|
34
|
+
2. 判定対象と適用範囲で、初期受入に必須とする条件と、公開後に判定する成功基準の境目を決める。
|
|
35
|
+
3. 成功基準を、公開後の段階まで含めて書く。
|
|
36
|
+
4. 受入条件を、価値提供を始められる最小の状態に絞って書く。
|
|
37
|
+
5. 判定手順と証跡で、確認の順と否決時の再判定を書く。
|
|
38
|
+
6. 最後に例外条件と未解決事項を書く。条件を書く途中で出た決めきれない値を集めると、漏れが減る。
|
|
48
39
|
|
|
49
40
|
## 4. 各章の書き方
|
|
50
41
|
|
|
@@ -52,128 +43,93 @@ Success Criteria and Acceptance Criteria Writing Recipe
|
|
|
52
43
|
|
|
53
44
|
問い:
|
|
54
45
|
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
- 誰がこの判定結果を使うのか。
|
|
58
|
-
- 当該プロジェクトだけでは因果を判定できない成果や、他文書へ委譲する詳細は何か。
|
|
46
|
+
- 初期公開の GO / Not GO を、どの条件のすべてで判断するのか。
|
|
47
|
+
- 当該プロジェクトだけでは因果を判定できない成果はどれか。
|
|
59
48
|
|
|
60
|
-
|
|
49
|
+
コツ:
|
|
61
50
|
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
- 業務価値は、利用者、利用場面、期待する状態を含む短文にする。
|
|
65
|
-
- 「品質を上げる」のような抽象的な価値ではなく、「利用者が同じ根拠で判断できる」のように状態を書く。
|
|
51
|
+
- スコープの対象・対象外を写したくなったら、スコープへの参照に置き換え、受入判断に要る境目だけを書く。
|
|
52
|
+
- 「品質を上げる」のような抽象語が出たら、「利用者が同じ根拠で判断できる」のように、利用者に生じる状態へ言い換える。
|
|
66
53
|
|
|
67
54
|
### 4.2. 成功基準
|
|
68
55
|
|
|
69
56
|
問い:
|
|
70
57
|
|
|
71
58
|
- どの業務価値が実現すれば、プロジェクトが成功したと言えるか。
|
|
72
|
-
-
|
|
73
|
-
- 公開後にしか測定できない成果について、判定時期と測定責任を決めているか。
|
|
74
|
-
- 閾値がある場合、対象・単位・母数・比較対象を説明できるか。
|
|
75
|
-
- 低コストや費用負担の軽減を価値に置く場合、現金支出、作業時間、継続運用負荷を分けているか。
|
|
76
|
-
- 既存資産、寄付、無償枠をどう扱い、人の無償労働への負荷転嫁をどう防ぐか。
|
|
59
|
+
- 公開後にしか測れない成果を、いつ誰が確かめるか。
|
|
77
60
|
|
|
78
|
-
|
|
61
|
+
コツ:
|
|
79
62
|
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
- 成果物完成、機能数、lint 合格だけで成功を表さず、利用者、業務、事業または社会に生じる変化を書く。
|
|
84
|
-
- 外部要因を受ける成果は単独の因果と断定せず、利用前後の変化と寄与を確認する。
|
|
85
|
-
- 低コストを条件にする場合は、現金支出だけでなく人の作業時間と継続運用負荷も判定し、既存資産、寄付、無償枠の扱いを明記する。
|
|
63
|
+
- 承認者に「公開から半年後、何が起きていれば続ける価値があったと言えるか」を聞くと、短期と中長期の成功の状態が出てくる。
|
|
64
|
+
- 「低コスト」を聞いたら、現金支出だけで答えが終わらないよう、作業時間と運用負荷、既存資産や寄付の扱いも続けて聞く。無償の作業を前提にした成功に気付ける。
|
|
65
|
+
- 閾値が出たら、何を数えるか、母数と比較対象は何かを、その場で聞き返す。
|
|
86
66
|
|
|
87
67
|
### 4.3. 受入条件
|
|
88
68
|
|
|
89
69
|
問い:
|
|
90
70
|
|
|
91
71
|
- 利用者は何を行い、どの結果なら受け入れられるか。
|
|
92
|
-
-
|
|
93
|
-
- 技術的確認は、どの業務価値を支えるために必要か。
|
|
94
|
-
- 合格の証拠を第三者が後から確認できるか。
|
|
72
|
+
- 技術的な確認は、どの業務価値を支えるために要るのか。
|
|
95
73
|
|
|
96
|
-
|
|
74
|
+
コツ:
|
|
97
75
|
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
- 技術的受入は種別を明記し、利用者の受入条件と混在させない。
|
|
101
|
-
- 承認者には最終判断を担う人間の役割を置く。AI Agent を承認者にしない。
|
|
76
|
+
- 公開後の利用件数を受入条件に入れたくなったら、成功基準へ移す。
|
|
77
|
+
- 確認者と承認者を一人の役割にまとめがちなので、「誰が証跡を見るか」と「誰が受け入れを決めるか」を分けて聞く。
|
|
102
78
|
|
|
103
79
|
### 4.4. 判定手順と証跡
|
|
104
80
|
|
|
105
81
|
問い:
|
|
106
82
|
|
|
107
83
|
- どの条件を、誰が、どの順で確認するか。
|
|
108
|
-
-
|
|
109
|
-
- 判定結果と未決事項をどこに残すか。
|
|
84
|
+
- 否決したとき、何を直し、どの条件を確かめ直すか。
|
|
110
85
|
|
|
111
|
-
|
|
86
|
+
コツ:
|
|
112
87
|
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
- 再判定時は、対象の受入条件 ID と予定を記録する。
|
|
88
|
+
- 費用と作業時間の上限は、試行の後では決めにくい。試行の前に承認する手順として置く。
|
|
89
|
+
- 証跡を「確認結果」とだけ書きそうになったら、確認日、確認者、条件 ID、母数など、記録に残す中身を聞く。
|
|
116
90
|
|
|
117
91
|
### 4.5. 例外条件と未解決事項
|
|
118
92
|
|
|
119
93
|
問い:
|
|
120
94
|
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
- 決定しない場合に誰が影響を受けるか。
|
|
95
|
+
- 決めきれない値があっても、初期受入を進められるか。
|
|
96
|
+
- 保留したとき、どの条件の判定に効くか。
|
|
124
97
|
|
|
125
|
-
|
|
98
|
+
コツ:
|
|
126
99
|
|
|
127
|
-
-
|
|
128
|
-
- スコープなど依存文書の未決事項を転記する場合、元のラベル(例: _TODO_:)をそのまま残さず、本ルールブックの _UNDECIDED_: に統一する。
|
|
129
|
-
- 例外は「受け入れる」だけで終わらせず、再判定する条件を記載する。
|
|
100
|
+
- スコープなどの上位成果物の未決事項は写さず、本書の判定に効く分だけを _UNDECIDED_: で書く。上位成果物が _TODO_: と書いていても、本書では _UNDECIDED_: にそろえる。
|
|
130
101
|
|
|
131
102
|
## 5. 深掘り手順
|
|
132
103
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
7. 後続時期の成功基準を初回受入の合否から分離し、測定時期と責任者を残す。
|
|
104
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
105
|
+
|
|
106
|
+
1. 成功基準と受入条件の各行が、どの業務価値に応えるかを確かめ、対応のない行を外すか技術的受入へ移す。
|
|
107
|
+
2. 業務価値ごとに、初期公開・短期・中長期のどこで成功を確かめるかを確かめ、抜けている段階を足す。
|
|
108
|
+
3. 各条件の測定方法と証跡で、第三者が後から同じ判定を再現できるかを確かめる。
|
|
109
|
+
4. 受入条件に混じった公開後の成果や実装詳細を、成功基準や後続成果物へ戻す。
|
|
140
110
|
|
|
141
111
|
## 6. 良い例 / 悪い例
|
|
142
112
|
|
|
143
|
-
| 観点
|
|
144
|
-
|
|
|
145
|
-
| 業務価値
|
|
146
|
-
| 初期成功基準
|
|
147
|
-
|
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
| 証跡 | 確認日、確認者、条件 ID を含む受入確認記録 | 確認したことを記録する |
|
|
151
|
-
| 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主代表が決定する | オフライン時は後で決める |
|
|
152
|
-
| 未解決事項のラベル | スコープの _TODO_: 初回公開日を _UNDECIDED_: に書き換え、決定時期と担当を添える | スコープの _TODO_: をそのまま転記する |
|
|
113
|
+
| 観点 | 良い例 | 悪い例 |
|
|
114
|
+
| -------------- | ----------------------------------------------------------------- | --------------------------- |
|
|
115
|
+
| 業務価値 | 店主と家族が同じ手順で在庫を確認できる | システムを便利にする |
|
|
116
|
+
| 初期成功基準 | 店主と家族が販売・在庫・つけ確認の必須タスクをすべて完了できる | 必要な機能が90%完成している |
|
|
117
|
+
| 中長期成功基準 | 人気商品の欠品回数が運用前1か月比で50%減少する | 店舗運営が改善する |
|
|
118
|
+
| 受入条件 | 商品、数量、支払方法を入力して確定すると販売記録が1件作成される | 販売機能が正しく動く |
|
|
119
|
+
| 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主が決める | オフライン時は後で決める |
|
|
153
120
|
|
|
154
121
|
## 7. レビュー観点
|
|
155
122
|
|
|
156
|
-
| 観点 | 確認内容
|
|
157
|
-
| ---------------- |
|
|
158
|
-
| 業務価値との対応 |
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
| 検証可能性 | 測定方法、合格基準、証跡が具体的である |
|
|
163
|
-
| 費用と負荷 | 低コストを価値に置く場合、現金支出、作業時間、継続運用負荷を分けている |
|
|
164
|
-
| 責任の明確性 | 確認者と人間の承認者が明記されている |
|
|
165
|
-
| 技術的受入 | 技術的条件が種別で分離され、業務価値との関係がある |
|
|
166
|
-
| 対象範囲 | スコープ内・対象外と矛盾しない |
|
|
167
|
-
| 公開適性 | 個人情報、非公開情報、機密情報がない |
|
|
168
|
-
| ラベル整合性 | 未確定事項が _UNDECIDED_: に統一され、依存文書の _TODO_: 等を転記したままにしていない |
|
|
123
|
+
| 観点 | 確認内容 |
|
|
124
|
+
| ---------------- | -------------------------------------------------------------------- |
|
|
125
|
+
| 業務価値との対応 | 各条件が対象利用者のどの期待効果に応えるかを説明できるか |
|
|
126
|
+
| 初期受入との分離 | 公開後の利用実績や中長期の成果が、初期受入の合否に混じっていないか |
|
|
127
|
+
| 費用と負荷 | 低コストを価値に置く場合、人の作業時間と運用負荷を見落としていないか |
|
|
128
|
+
| 対象範囲 | スコープの対象・対象外と食い違っていないか |
|
|
169
129
|
|
|
170
130
|
## 8. 仕上げチェック
|
|
171
131
|
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
- 対象外、未決事項、否決時の再判定方法を明示した。
|
|
177
|
-
- 未確定事項のラベルが _UNDECIDED_: に統一され、依存文書(スコープ等)の _TODO_: などをそのまま転記していない。
|
|
178
|
-
- 実装詳細、個別テスト手順、AI Agent による最終判断を書いていない。
|
|
179
|
-
- 各業務価値を、利用者・期待効果、段階別成功基準、受入条件、測定方法、証跡、判断者へ ID で追跡できる。
|
|
132
|
+
- 各業務価値から、成功基準・受入条件・証跡・判断する役割までたどれる。
|
|
133
|
+
- 閾値に、測定対象・単位・母数または比較対象がある。
|
|
134
|
+
- 未確定の値が _UNDECIDED_: にそろい、上位成果物の _TODO_: を写したままにしていない。
|
|
135
|
+
- AI Agent を承認者にしていない。
|
|
@@ -11,166 +11,136 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Status Definition Authoring Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
一つの業務対象について、状態で判断をそろえたい理由から、状態と遷移を説明できる内容に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 状態一覧を先に仮置きし、遷移図を描いた後で到達不能・出口なし・重複状態を見つけて一覧へ戻します。
|
|
20
|
-
- 各図と直下の遷移表を遷移 ID で一行ずつ照合し、最後に関連フローや用語との名称一致を確認します。
|
|
21
|
-
- 実装値は状態の安定識別に必要な範囲だけ扱い、実装条件式や操作手順は後続設計へ委ねます。
|
|
18
|
+
- STSD は、状態で判断をそろえたい業務課題(Why)を「目的」で引き継ぎ、一つの対象の状態と遷移(What)を「状態一覧」と「状態遷移」で定め、現在状態の決め方と遷移の条件・判断者(How)を「状態の判定」と遷移表で示す。状態値と遷移 ID で、図・遷移表・関連文書・レビュー指摘から同じ状態と遷移をたどれるようにする(Trace)。実装条件式や操作手順は後続設計へ委ねる。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
|
|
|
26
|
-
| ---------------- |
|
|
27
|
-
| 対象と業務境界 |
|
|
28
|
-
|
|
|
29
|
-
| 状態候補 |
|
|
30
|
-
| 状態変更イベント |
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| 判定規則と互換 | 正本と派生記録の区別、現在状態を一意に決める規則、旧状態値・旧イベント・未設定や欠損記録の扱い |
|
|
34
|
-
| 関連文書 | 用語集、業務データ辞書、状態を変えるプロセスを示す CDFD |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ---------------- | -------------------------------------------------------------- | ------------------------ |
|
|
24
|
+
| 対象と業務境界 | 状態を持つ一つの対象、状態変更が始まる業務と対象外の業務 | 関連 CDFD、業務分析担当 |
|
|
25
|
+
| 状態で行う判断 | 誰がその状態を見て、次に何をするかを決めるか | 現場の担当者への聞き取り |
|
|
26
|
+
| 状態候補 | 現場で「いま何の状態か」と答える名称・通称と、そう判断する事実 | 現場の担当者への聞き取り |
|
|
27
|
+
| 状態変更イベント | 誰が何をした、または何が起きたときに状態が変わるか | 関連 CDFD、現場の担当者 |
|
|
28
|
+
| 管理場所と正本 | 現在状態を確かめる記録と、派生して作る一覧・集計 | 帳簿・台帳・記録の現物 |
|
|
29
|
+
| 旧記録の扱い | 旧状態値・旧イベント・未設定の記録があるか | 既存の記録、移行の担当者 |
|
|
35
30
|
|
|
36
31
|
## 3. 全体の作成手順
|
|
37
32
|
|
|
38
|
-
1.
|
|
39
|
-
2.
|
|
40
|
-
3.
|
|
41
|
-
4.
|
|
42
|
-
5.
|
|
43
|
-
6.
|
|
44
|
-
7.
|
|
45
|
-
8. 関連文書と状態名・イベント名・管理場所を照合し、未決事項だけを今後の検討メモへ残します。
|
|
46
|
-
|
|
47
|
-
成果物は頭書きに続けて「目的」「適用範囲」「状態の判定」「状態一覧」「状態遷移」の順に章を設け、未決事項がある場合だけ「今後の検討メモ」を加えます。スコープは現行を既定として省略し、同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を明記して文書を分けます。
|
|
33
|
+
1. 対象を一つに決め、「目的」と「適用範囲」を書く。対象が決まらないと、状態候補の粒度と終了点の要否が決まらない。
|
|
34
|
+
2. 状態候補と状態変更イベントを同時に聞き取り、意味か成立条件が同じ候補を統合して「状態一覧」を仮置きする。名称とイベントを別々に集めると、つながらない状態が残る。
|
|
35
|
+
3. 「状態の判定」に正本の記録と現在状態を一つに決める規則を書く。成立条件だけでは判定が分かれる箇所が、ここで見つかる。
|
|
36
|
+
4. 「状態遷移」で正常系の図と直下の遷移表を作り、その後に例外分岐と戻りを加える。正常系を先に描くと、例外がどの状態から外れるかが見える。
|
|
37
|
+
5. 図から到達できない状態、出口のない状態、区別できない状態を探し、「状態一覧」へ戻して直す。
|
|
38
|
+
6. 関連文書と状態名・イベント名を突き合わせ、残った未決事項だけを「今後の検討メモ」へ置く。
|
|
39
|
+
7. 最後に H1 直下の頭書きを書く。対象と到達点が決まってから書くと、本文の言い直しにならない。
|
|
48
40
|
|
|
49
41
|
## 4. 各章の書き方
|
|
50
42
|
|
|
51
|
-
### 4.1.
|
|
43
|
+
### 4.1. 頭書きと目的
|
|
52
44
|
|
|
53
45
|
問い:
|
|
54
46
|
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
|
|
47
|
+
- 状態は対象の何を管理するのか(進み具合、利用可否など)。
|
|
48
|
+
- 誰がその状態を見て、どの業務の要否を判断するのか。
|
|
49
|
+
|
|
50
|
+
コツ:
|
|
58
51
|
|
|
59
|
-
|
|
52
|
+
- 「状態を区別しないと、どの判断がそろわないか」と聞くと、管理する内容と判断が一度に出る。
|
|
53
|
+
- 上位の概要や CDFD に書かれた背景は写さず、参照に置き換える。
|
|
60
54
|
|
|
61
|
-
### 4.2.
|
|
55
|
+
### 4.2. 適用範囲
|
|
62
56
|
|
|
63
57
|
問い:
|
|
64
58
|
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
|
|
59
|
+
- どの開始イベントから、どこまでの業務で状態変更を扱うのか。
|
|
60
|
+
- 完了・中止の後も、差し戻しや記録更新のために状態を管理し続けるのか。
|
|
61
|
+
|
|
62
|
+
コツ:
|
|
68
63
|
|
|
69
|
-
|
|
64
|
+
- 「完了した後に戻すことはあるか」を聞くと、終了点を置くかどうかが決まる。記録を保存するだけなら継続の理由にならない。
|
|
70
65
|
|
|
71
|
-
### 4.3.
|
|
66
|
+
### 4.3. 状態の判定
|
|
72
67
|
|
|
73
68
|
問い:
|
|
74
69
|
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
- 業務上の完了・中止後も、差し戻し、状態確認、記録更新のために状態管理を続けますか。
|
|
78
|
-
- 終了点を置かない場合、業務上の到達点と管理を続ける状態・理由を説明できますか。
|
|
70
|
+
- 現在状態を確かめる正本はどの記録で、どれが派生した一覧か。
|
|
71
|
+
- 旧状態値や未設定の記録を、どう読み取るのか。
|
|
79
72
|
|
|
80
|
-
|
|
73
|
+
コツ:
|
|
81
74
|
|
|
82
|
-
|
|
75
|
+
- 同じ対象の記録を二人が別々に判定し、同じ状態になるか確かめる。分かれた箇所へ順序や優先関係を補う。
|
|
76
|
+
- 根拠のない読み替えや初期値は仮定せず、未決事項へ回す。
|
|
77
|
+
|
|
78
|
+
### 4.4. 状態一覧
|
|
83
79
|
|
|
84
80
|
問い:
|
|
85
81
|
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
- 旧状態値・旧イベント、未設定・欠損記録をどう読み取りますか。過去の記録の読み替えと、現在発行する遷移を混同していませんか。
|
|
82
|
+
- その状態になると、誰の判断や管理責任が変わるのか。
|
|
83
|
+
- 隣の状態と、どの事実で区別できるのか。
|
|
89
84
|
|
|
90
|
-
|
|
85
|
+
コツ:
|
|
91
86
|
|
|
92
|
-
|
|
87
|
+
- 単なる処理待ちを状態にしたくなったら、判断や責任が変わるかを確かめ、変わらなければ前の状態に含める。
|
|
88
|
+
- 二つの候補が同時に成り立つなら、統合するか「状態の判定」に優先関係を書く。
|
|
93
89
|
|
|
94
|
-
|
|
90
|
+
### 4.5. 状態遷移
|
|
95
91
|
|
|
96
|
-
|
|
97
|
-
- 成立条件と「状態の判定」の規則から第三者が現在状態を一つに判定できますか。
|
|
98
|
-
- 通称が正式名称と違う場合、その対応を一行で確認できますか。
|
|
99
|
-
- 管理場所から現在状態の根拠を確認できますか。
|
|
92
|
+
問い:
|
|
100
93
|
|
|
101
|
-
|
|
94
|
+
- 例外の経路は、復帰・終了・人間の判断のどこへ進むのか。
|
|
95
|
+
- 分岐の条件は、記録や判断から yes / no で決められるのか。
|
|
102
96
|
|
|
103
|
-
|
|
97
|
+
コツ:
|
|
104
98
|
|
|
105
|
-
|
|
99
|
+
- 補足には、判断者・証跡・例外時の扱いなど、図から読めない根拠だけを書く。
|
|
100
|
+
- 承認者や共通条件など、運用ガイドなどの上位成果物を正とする内容は写さず、参照に置き換える。
|
|
106
101
|
|
|
107
|
-
|
|
108
|
-
- 状態一覧の全状態が図にあり、図の業務状態が一覧にありますか。
|
|
109
|
-
- 各矢印のラベルが `T-<nn> イベント / 条件` となり、同じ分岐元の条件を区別できますか。
|
|
110
|
-
- 例外経路から復帰、終了、または人間の判断へ進めますか。
|
|
111
|
-
- 各図のすぐ下の遷移表と、図の全矢印が遷移 ID・遷移元・遷移先・イベント・条件で一対一に対応していますか。
|
|
112
|
-
- 初回の確定前か、一度確定した後かを確認し、遷移 ID の採番方法を選んでいますか。
|
|
113
|
-
- 遷移 ID を振り直した場合、作業の記録から旧 ID のレビュー指摘と対応する遷移を追えますか。
|
|
114
|
-
- 業務状態の遷移元・遷移先は状態一覧と同じ名称ですか。初期点は「開始」、終了点は「終了」とし、状態一覧へ追加していませんか。
|
|
115
|
-
- 条件は記録や業務判断から yes / no で判定できますか。
|
|
116
|
-
- 図だけでは分からない判断者、証跡、例外時の扱いを補足していますか。
|
|
102
|
+
### 4.6. 今後の検討メモ
|
|
117
103
|
|
|
118
|
-
|
|
104
|
+
問い:
|
|
119
105
|
|
|
120
|
-
|
|
106
|
+
- 決まっていない例外状態・条件・用語・責任境界はどれか。
|
|
107
|
+
- 決まるまで、どの遷移をどう扱うのか。
|
|
121
108
|
|
|
122
|
-
|
|
109
|
+
コツ:
|
|
123
110
|
|
|
124
|
-
-
|
|
125
|
-
- 影響する状態名または遷移 ID、決定者、決定時期を添えます。
|
|
126
|
-
- 調査・追記・修正が必要な事項は `_TODO_:`、意思決定待ちは `_UNDECIDED_:`、仮置き前提は `_ASSUMPTION_:` を付けて区別します。
|
|
111
|
+
- 「今後検討」だけで終えず、影響する状態または遷移 ID と、決まるまでの扱いを聞いて書く。
|
|
127
112
|
|
|
128
113
|
## 5. 深掘り手順
|
|
129
114
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
115
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
116
|
+
|
|
117
|
+
1. 各状態について「その直前は何か」「何が起きてこの状態になるか」を逆向きにたどり、入口のない状態を探す。
|
|
118
|
+
2. 各状態について「次に何へ進むか」「進めないときはどうなるか」を順向きにたどり、出口の理由を説明できない状態を探す。
|
|
119
|
+
3. 同じイベントから分かれる矢印で条件を一つずつ反転し、重なりと漏れを探す。
|
|
120
|
+
4. 各状態が「目的」のどの判断に使われるかを確かめ、使われない状態を統合する。
|
|
121
|
+
5. 関連 CDFD の状態変更プロセスを一つずつたどり、対応する遷移のないプロセスを探す。
|
|
136
122
|
|
|
137
123
|
## 6. 良い例 / 悪い例
|
|
138
124
|
|
|
139
|
-
| 観点 | 良い例
|
|
140
|
-
| -------- |
|
|
141
|
-
| 対象 | 商品の入荷から販売・返品までを一文書で扱う
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
| 判定 | 正本の記録を業務の発生順にたどり、最後に成立した遷移先で判定する | 見た目で判断する |
|
|
146
|
-
| 遷移 | `T-02 検品完了 / 数量・品質が合格` | 次へ進む |
|
|
147
|
-
| 分岐 | 合格と、数量違いまたは品質不良を別条件にする | 成功 / それ以外 |
|
|
148
|
-
| 管理場所 | 仕入記録で受入、在庫記録で販売可能を確認する | システムで管理する |
|
|
149
|
-
| 図の分割 | 「状態遷移」で通常系の図と直下の表、例外系の図と直下の表を順に置く | 図を先に並べ、全遷移の表を別章へ置く |
|
|
125
|
+
| 観点 | 良い例 | 悪い例 |
|
|
126
|
+
| -------- | -------------------------------------------------------------- | -------------------------------------- |
|
|
127
|
+
| 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
|
|
128
|
+
| 分岐 | 合格と、数量違いまたは品質不良を別の条件にする | 成功 / それ以外 |
|
|
129
|
+
| 処理待ち | 検品待ちは、検品者が受入可否の判断を負うため独立した状態にする | 画面の処理中表示をそのまま状態にする |
|
|
130
|
+
| 補足 | 返品の判断者を店主代表とし、仕入記録に返品理由を残す | 図と同じ経路を文章で順に説明する |
|
|
150
131
|
|
|
151
132
|
## 7. レビュー観点
|
|
152
133
|
|
|
153
|
-
| 観点 | 確認内容
|
|
154
|
-
| ------------ |
|
|
155
|
-
|
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
| 設計入力 | 状態値、イベント、条件、管理場所を後続設計へ引き渡せる | 技術メンター |
|
|
160
|
-
| テスト可能性 | 初期、正常、例外、終了の経路と分岐条件から状態遷移テストを設計できる | 品質確認担当 |
|
|
161
|
-
| 用語整合 | 状態名・通称・イベント名が関連文書と一致する | 業務分析担当 |
|
|
134
|
+
| 観点 | 確認内容 |
|
|
135
|
+
| ------------ | -------------------------------------------------------------------- |
|
|
136
|
+
| 目的との対応 | 各状態と遷移が、「目的」に書いた誰のどの判断に使われるか |
|
|
137
|
+
| 業務妥当性 | 現場の判断と例外を表し、対象の開始から到達点までを説明できるか |
|
|
138
|
+
| テスト可能性 | 初期・正常・例外・到達点の経路と分岐条件から状態遷移テストを組めるか |
|
|
139
|
+
| 委譲の境界 | 実装条件式・画面操作・詳細 API を後続設計へ委ね、書きすぎていないか |
|
|
162
140
|
|
|
163
141
|
## 8. 仕上げチェック
|
|
164
142
|
|
|
165
|
-
-
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
- 「状態遷移」で各図のすぐ下にその図の遷移表があり、図と表の間に説明文や別の図を挟んでいない。全遷移のラベルが `T-<nn> イベント / 条件` で、直下の表と一対一に一致し、分割時も文書全体で重複や欠落がない。
|
|
170
|
-
- 開始から正常系・例外系の終了状態または継続状態までをたどれ、終了点を置かない理由と継続管理する状態を「適用範囲」で説明できる。
|
|
171
|
-
- 条件分岐が相互に区別でき、判定不能な「適切」「問題なし」を使っていない。
|
|
172
|
-
- 状態名、通称、イベント名、管理場所が用語集・業務データ辞書・関連 CDFD と矛盾しない。
|
|
173
|
-
- 実装条件式、SQL、詳細 API、画面操作を状態定義として記載していない。
|
|
174
|
-
- 今後の検討メモの `_TODO_:` を解消し、残る `_UNDECIDED_:`・`_ASSUMPTION_:` には影響する状態または遷移 ID、決定者、決定時期がある。
|
|
175
|
-
- 公開対象の本文・図表に個人情報・非公開情報を含めていないことを確認し、公開可否の最終判断と説明責任を人間の PO が担うことを確認している。
|
|
176
|
-
- 公開対象と人間の承認者を特定し、`ready` への昇格条件として内容確認、未解決指摘の扱いの合意、公開前確認をそろえている。作成中は `draft` を保ち、昇格は人間の承認後に人間が行う。
|
|
143
|
+
- 各状態が、「目的」に書いた判断のどれかに使われている。
|
|
144
|
+
- 例外の経路ごとに、復帰・終了・人間の判断のどこへ進むかを説明できる。
|
|
145
|
+
- 分岐の条件に「適切」「問題なし」など、判定できない語を使っていない。
|
|
146
|
+
- 未決事項ごとに、影響する状態または遷移 ID と決まるまでの扱いがある。
|