specdojo 0.7.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -11,40 +11,29 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Stakeholder Register Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
ステークホルダー登録簿を、業務価値・利用者影響・合意対象が判断できる内容に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 次に、誰が判断し、誰が利用し、誰が協力し、誰が影響を受けるかを役割別に洗い出す。
|
|
20
|
-
- 各関係者について、期待、懸念、必要な合意、情報要求を同じ ID でつなげる。
|
|
21
|
-
- 最後に、影響度/関心度の根拠と、変更時に見直す条件を確認する。
|
|
22
|
-
- プロジェクトの目的と利用者影響(Why)、判断者・利用者・協力者・影響受容者と合意対象(What)、関与方針と情報要求(How)を整理し、ステークホルダー ID、評価根拠、証跡要件で追跡する(Trace)。詳細な配信計画は後続文書へ委譲する。
|
|
18
|
+
- 登録簿は、プロジェクト概要の目的と利用者影響(Why)から関係者と合意対象(What)を識別し、関与方針と情報要求(How)を決める。各関係者は同じ `STH-<KEY>` で関係者一覧から証跡要件までたどれるようにする(Trace)。
|
|
23
19
|
|
|
24
20
|
## 2. 作成前に集める情報
|
|
25
21
|
|
|
26
|
-
| 項目
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| 合意対象 | 着手、範囲、変更、公開、利用開始で確認が必要な事項 |
|
|
34
|
-
| 情報要求 | 誰が、何を、どの手段で確認・判断するか |
|
|
35
|
-
| 更新条件 | 目的、範囲、体制、利用者影響、公開方針が変わる出来事 |
|
|
36
|
-
| 実行主体の境界 | AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・確認の責任を持つ人の役割は誰か |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ---------------------- | --------------------------------------------------------- | -------------------------- |
|
|
24
|
+
| 目的と利用者 | 誰のどの課題を改善するか、直接・間接の利用者と利用場面 | プロジェクト概要 |
|
|
25
|
+
| 判断と合意の場面 | 着手・範囲・変更・公開・利用開始で、誰が何を決めるか | プロジェクト責任者への確認 |
|
|
26
|
+
| 実行・協力の体制 | 実行担当、運用担当、外部協力者と関わり方、採用済みの Role | 体制・メンバー定義 |
|
|
27
|
+
| 懸念 | 利用負荷、変更影響、継続性、公開適性、合意遅延の要因 | 各関係者への聞き取り |
|
|
28
|
+
| AI Agent・ツールの関与 | 入力・制約・生成結果の確認責任を持つ人の役割 | 実行担当への確認 |
|
|
37
29
|
|
|
38
30
|
## 3. 全体の作成手順
|
|
39
31
|
|
|
40
|
-
1.
|
|
41
|
-
2.
|
|
42
|
-
3.
|
|
43
|
-
4.
|
|
44
|
-
5.
|
|
45
|
-
6. 情報要求、希望チャネル、証跡要件を整理し、詳細な配信計画は後続のコミュニケーション計画へ委譲する。
|
|
46
|
-
7. 変更時と定期確認時の見直し条件、責任者、承認者を定める。
|
|
47
|
-
8. 個人情報、推測の Role code、設計詳細、会議運営の重複がないことを確認する。
|
|
32
|
+
1. 関係者一覧を先に書き、ID を決める。ID が決まらないと、ほかの表の行をつなげられない。
|
|
33
|
+
2. 影響度/関心度分析で、期待・懸念・必要な合意と評価根拠を書く。
|
|
34
|
+
3. エンゲージメント方針は High の関係者から書く。合意が要る相手の行動が決まると、残りは情報共有で足りるかを判断しやすい。
|
|
35
|
+
4. コミュニケーション要件で、関係者が判断に使う情報と残す証跡を書く。
|
|
36
|
+
5. 最後に見直し条件を書く。ほかの表がそろってから、どの変更でどの行が動くかを確かめる。
|
|
48
37
|
|
|
49
38
|
## 4. 各章の書き方
|
|
50
39
|
|
|
@@ -52,117 +41,92 @@ Stakeholder Register Writing Recipe
|
|
|
52
41
|
|
|
53
42
|
問い:
|
|
54
43
|
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
- 誰が実行、運用、協力を担い、どの責任を持つか。
|
|
58
|
-
- AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・生成結果の確認責任を持つ人の役割は誰か。
|
|
44
|
+
- 誰が目的・範囲・公開や利用の可否を判断し、誰が直接利用し、誰が間接的に影響を受けるか。
|
|
45
|
+
- AI Agent やツールが関与する場合、その確認責任を持つのはどの人の役割か。
|
|
59
46
|
|
|
60
|
-
|
|
47
|
+
コツ:
|
|
61
48
|
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
- AI Agent やツールなどの実行主体自体は単独のステークホルダーとして記載せず、入力・制約・確認の責任を持つ人の役割として記載する。
|
|
65
|
-
- 同じ関係者を全章で同じ ID にする。
|
|
49
|
+
- 「ユーザー」と書きたくなったら、利用場面ごとに集団を分けられないかを聞く。
|
|
50
|
+
- 個人名で挙がった人は、その人が担う役割名に置き換える。概要に書かれた利用者は写さず、概要への参照に置き換える。
|
|
66
51
|
|
|
67
52
|
### 4.2. 影響度/関心度分析
|
|
68
53
|
|
|
69
54
|
問い:
|
|
70
55
|
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
- 期待が満たされないと、誰にどのような利用・継続上の影響が出るか。
|
|
56
|
+
- 期待が満たされないと、誰の利用や継続にどのような影響が出るか。
|
|
57
|
+
- その関係者と、何を決めなければ先へ進めないか。
|
|
74
58
|
|
|
75
|
-
|
|
59
|
+
コツ:
|
|
76
60
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
- 評価は人の重要度ではなく、プロジェクトへの影響と関与必要性で行う。
|
|
61
|
+
- 「重要だから High」になりやすい。その人が左右する判断(方針・範囲・公開可否など)を聞き、それを根拠に書く。
|
|
62
|
+
- 懸念は「期待が満たされない場合の困りごと」として聞くと具体になる。
|
|
80
63
|
|
|
81
64
|
### 4.3. エンゲージメント方針
|
|
82
65
|
|
|
83
66
|
問い:
|
|
84
67
|
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
- 誰がいつまでに行い、どこに証跡を残すか。
|
|
68
|
+
- 今の関与状態と目標の関与状態の差を、どの行動で埋めるか。
|
|
69
|
+
- その行動は、必要な合意を取る時点に間に合うか。
|
|
88
70
|
|
|
89
|
-
|
|
71
|
+
コツ:
|
|
90
72
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
- 合意を求める相手と、情報共有だけでよい相手を区別する。
|
|
73
|
+
- 期限は「週次」のような会議の頻度ではなく、初期公開前などの判断の節目で書く。会議の日時や頻度はコミュニケーション計画へ渡す。
|
|
74
|
+
- 外部関係者がまだ関与していなければ、現在の事実と将来の仮定を混ぜず、_ASSUMPTION_ を付ける。
|
|
94
75
|
|
|
95
76
|
### 4.4. コミュニケーション要件
|
|
96
77
|
|
|
97
78
|
問い:
|
|
98
79
|
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
- 詳細計画で追加管理すべき事項は何か。
|
|
80
|
+
- 関係者は何を受け取れば、判断・利用・協力ができるか。
|
|
81
|
+
- どの手段なら内容を確認でき、証跡を残せるか。
|
|
102
82
|
|
|
103
|
-
|
|
83
|
+
コツ:
|
|
104
84
|
|
|
105
|
-
-
|
|
106
|
-
- 会議の日時や配信頻度の詳細を重複管理しない。
|
|
107
|
-
- 合意・報告の必要性と、証跡要件を同じ行に置く。
|
|
85
|
+
- 「進捗」と聞いたら、優先順位・変更理由・利用手順など、何の判断に使う情報かを聞き返す。
|
|
108
86
|
|
|
109
87
|
### 4.5. 見直し条件
|
|
110
88
|
|
|
111
89
|
問い:
|
|
112
90
|
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
- 定期確認では、どの未解決の合意や情報要求を確認するか。
|
|
91
|
+
- どの変更が、関係者・期待・影響度・合意対象を変えるか。
|
|
92
|
+
- 誰が見直し、誰が承認するか。
|
|
116
93
|
|
|
117
|
-
|
|
94
|
+
コツ:
|
|
118
95
|
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
- 変更した表だけでなく、同じ ID を使う全章への影響を確認する。
|
|
96
|
+
- 承認者を空欄や「-」にしない。見直し責任者が自分で承認してよい場合は、その役割名を承認者に書く。
|
|
97
|
+
- 周期が決まっていなければ、_TODO_ を付けて決める時期を残す。
|
|
122
98
|
|
|
123
99
|
## 5. 深掘り手順
|
|
124
100
|
|
|
125
|
-
|
|
101
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
126
102
|
|
|
127
|
-
1.
|
|
128
|
-
2.
|
|
129
|
-
3.
|
|
130
|
-
4.
|
|
131
|
-
5. High の関係者を先に選び、関与方針、責任者、期限、証跡を埋める。
|
|
132
|
-
6. 変更イベントごとに、見直す行と承認者を確認する。
|
|
103
|
+
1. 目的と期待効果から利益を得る集団・影響を受ける集団をたどり、一覧にない集団を足す。
|
|
104
|
+
2. High の関係者ごとに、必要な合意がエンゲージメント方針の行動と期限で取れるかを確かめる(リリース前に要る合意を、リリース後の行動で埋めていないか)。
|
|
105
|
+
3. 情報要求ごとに、どの判断に使うかを確かめ、使い道のない行を外す。
|
|
106
|
+
4. 変更の出来事ごとに、動く行と承認者がいるかを確かめる。
|
|
133
107
|
|
|
134
108
|
## 6. 良い例 / 悪い例
|
|
135
109
|
|
|
136
|
-
| 観点
|
|
137
|
-
|
|
|
138
|
-
| 関係者の識別
|
|
139
|
-
| 影響度の根拠
|
|
140
|
-
| 必要な合意
|
|
141
|
-
| 関与方針
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
| 実行主体の境界 | 「AI Agent活用担当」のように責任を持つ人の役割として記載する | 「AI Agent」を単独の関係者として記載する |
|
|
110
|
+
| 観点 | 良い例 | 悪い例 |
|
|
111
|
+
| ------------ | -------------------------------------------------------------- | ------------------------------------ |
|
|
112
|
+
| 関係者の識別 | 「将来の利用者」を利用場面と期待を添えて書く | 「ユーザー」とだけ書く |
|
|
113
|
+
| 影響度の根拠 | 「公開・利用可否を判断するため High」と書く | 「重要なので High」と書く |
|
|
114
|
+
| 必要な合意 | 「初期公開の範囲と公開情報」と具体化する | 「いろいろ相談する」と書く |
|
|
115
|
+
| 関与方針 | 「初期公開前に導入手順を公開し、Issue で不明点を集める」と書く | 「利用者と連携する」と書く |
|
|
116
|
+
| 見直し条件 | 「公開方針の変更時に将来利用者の要件を見直す」と書く | 「必要に応じて更新する」と書く |
|
|
117
|
+
| 実行主体 | 「AI Agent 活用担当」のように責任を持つ人の役割として書く | 「AI Agent」を単独の関係者として書く |
|
|
145
118
|
|
|
146
119
|
## 7. レビュー観点
|
|
147
120
|
|
|
148
|
-
| 観点
|
|
149
|
-
|
|
|
150
|
-
|
|
|
151
|
-
| 利用者影響
|
|
152
|
-
|
|
|
153
|
-
|
|
|
154
|
-
| 関与方針 | 現状、目標、行動、責任者、期限、証跡が対応しているか |
|
|
155
|
-
| コミュニケーション統制 | 詳細計画と重複せず、情報要求と証跡要件を入力として渡せるか |
|
|
156
|
-
| 公開適性 | 個人情報、非公開情報、未採用 Role code、根拠のない推測がないか |
|
|
157
|
-
| 実行主体の境界 | AI Agent やツールなどの実行主体が、責任を持つ人の役割に対応付けられているか |
|
|
121
|
+
| 観点 | 確認内容 |
|
|
122
|
+
| ---------- | ---------------------------------------------------------------- |
|
|
123
|
+
| 業務価値 | 目的・利用者・期待効果から関係者を識別できているか |
|
|
124
|
+
| 利用者影響 | 直接利用者・間接利用者・影響受容者の期待と懸念が分かるか |
|
|
125
|
+
| 合意の時点 | 必要な合意を取る時点と、関与方針の行動・期限が食い違っていないか |
|
|
126
|
+
| 公開適性 | 個人情報、非公開情報、根拠のない推測がないか |
|
|
158
127
|
|
|
159
128
|
## 8. 仕上げチェック
|
|
160
129
|
|
|
161
|
-
-
|
|
162
|
-
-
|
|
163
|
-
-
|
|
164
|
-
- 利用者・影響受容者の利用場面または影響が読み取れる。
|
|
165
|
-
- AI Agent やツールなどの実行主体を、責任を持つ人の役割に対応付けている(単独のステークホルダーとして扱っていない)。
|
|
166
|
-
- 詳細な会議運営、設計詳細、個人情報を本文に含めていない。
|
|
167
|
-
- 各必須表のカラムがすべて埋まっている。
|
|
168
|
-
- 各ステークホルダーを、目的または利用者影響、必要な合意、関与方針、証跡要件へ同じ ID で追跡できる。
|
|
130
|
+
- 各関係者を、関係者一覧から必要な合意・関与方針・証跡要件まで同じ ID でたどれる。
|
|
131
|
+
- High の関係者に、期待・懸念・必要な合意・関与方針がある。
|
|
132
|
+
- 見直し条件の各行に、承認する役割が書かれている。
|
|
@@ -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 を承認者にしていない。
|