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
|
@@ -17,22 +17,18 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Project Issues and Approach Documentation Rules
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
関係者が「何が課題で、どれを、どう解く方針か(なぜその方針か)」を短時間で合意できる粒度に整えます。
|
|
20
|
+
関係者が「何が課題で、どれを、どう解く方針か(なぜその方針か)」を短時間で合意できるよう、プロジェクト課題と解決アプローチの記述基準を定めます。
|
|
22
21
|
|
|
23
22
|
## 1. 全体方針
|
|
24
23
|
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
- 解決策は 2 件以上の方針を挙げ、相互に代替する案か、異なる課題・原因を扱う補完策かを区別して採用理由を明記します(単一案の押し付けは禁止)。
|
|
24
|
+
- **目的と適用範囲**: 課題の整理と採用アプローチの合意により、意思決定の前提を揃えます。詳細な設計・実装・テスト設計は対象外とします。
|
|
25
|
+
- **事実と仮説の区別**: 事実・観察と推測・仮説を混ぜず、混ざる場合はラベルで区別します。
|
|
26
|
+
- **複数の方針**: 解決策は 2 件以上挙げ、相互に代替する案か、異なる課題・原因を扱う補完策かを区別して採用理由を明記します。
|
|
27
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直しません。文書の整形・lint はリポジトリの検証で扱います。
|
|
30
28
|
|
|
31
|
-
## 2.
|
|
29
|
+
## 2. 位置づけ
|
|
32
30
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
プロジェクト課題と解決アプローチと他ドキュメントの関係を示します。
|
|
31
|
+
プロジェクト概要の背景・必要性、スコープの対象範囲、前提・制約・依存関係の成立条件を受けて、課題と解決アプローチを定めます。
|
|
36
32
|
|
|
37
33
|
```mermaid
|
|
38
34
|
flowchart LR
|
|
@@ -51,64 +47,18 @@ flowchart LR
|
|
|
51
47
|
class PIA target
|
|
52
48
|
```
|
|
53
49
|
|
|
54
|
-
### 2.2. 用語定義(本ルール内)
|
|
55
|
-
|
|
56
|
-
| 用語 | 定義 |
|
|
57
|
-
| ------------------------ | --------------------------------------------------------------------------------- |
|
|
58
|
-
| **課題** | 困っている現象(観察できる問題)。解決策の先取り(例:「自動発注がない」)にしない |
|
|
59
|
-
| **影響** | 課題が放置された場合に起きる損失/リスク(業務・顧客・コスト・期日など) |
|
|
60
|
-
| **原因** | 課題の発生要因(事実と仮説を区別する) |
|
|
61
|
-
| **解決策候補** | 課題を解決するための方針。相互に代替する案と、異なる課題・原因を扱う補完策を含む |
|
|
62
|
-
| **案の関係** | 候補同士が同じ判断を置き換える「代替」か、役割を分けて併用する「補完」かの区分 |
|
|
63
|
-
| **判断軸** | 採否判断に使う観点(効果/コスト/期間/リスク/現場適合など) |
|
|
64
|
-
| **採用アプローチ** | 採用する案と、その実行方針(なぜそれを選ぶかを含む) |
|
|
65
|
-
| **トレードオフ** | 採用の代償として失うもの/我慢するもの |
|
|
66
|
-
| **リスク** | 失敗/遅延/品質低下などの可能性と、その軽減策 |
|
|
67
|
-
| **次の検討事項(ToDo)** | 未確定事項、追加調査、意思決定が必要な事項 |
|
|
68
|
-
|
|
69
50
|
## 3. ファイル命名・ID規則
|
|
70
51
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
-
|
|
74
|
-
- プロジェクト配下の章構成は [docs-structure-guide.md](../guides/docs-structure-guide.md) に従います。
|
|
75
|
-
- 課題と方針の根拠となる関連資料を別ファイルにする場合は、本文から参照リンクで紐付けます。
|
|
76
|
-
|
|
77
|
-
### 3.2. ドキュメントID(推奨)
|
|
78
|
-
|
|
79
|
-
メタ情報(Frontmatter)を付ける場合、ID は一意である必要があります。
|
|
80
|
-
|
|
81
|
-
- 推奨: `<project-id>:prj-issues-and-approach`
|
|
82
|
-
- 例: `prj-0001:prj-issues-and-approach`
|
|
83
|
-
|
|
84
|
-
### 3.3. ファイル名(推奨)
|
|
85
|
-
|
|
86
|
-
- 推奨: `prj-issues-and-approach.md`
|
|
87
|
-
- 日本語ファイル名を使う場合も、Frontmatter の `id` は 3.2 の形式で一意にします。
|
|
52
|
+
- **配置**: `docs/ja/projects/<project-id>/020-project-definition/prj-issues-and-approach.md` とし、構成は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
53
|
+
- **ファイル名**: `prj-issues-and-approach.md` とします。
|
|
54
|
+
- **文書 ID**: `<project-id>:prj-issues-and-approach`(例: `prj-0001:prj-issues-and-approach`)とします。
|
|
88
55
|
|
|
89
56
|
## 4. 推奨 Frontmatter 項目
|
|
90
57
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
- プロジェクト課題と解決アプローチでも、機械可読性が必要な場合は YAML Frontmatter を付与します。
|
|
94
|
-
- 参照スキーマ: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
|
|
95
|
-
- メタ情報標準: [document-metadata-standard.md](../standards/document-metadata-standard.md)
|
|
96
|
-
|
|
97
|
-
| 項目 | 説明 | 必須 |
|
|
98
|
-
| ---------- | ------------------------------------------------------------ | ---- |
|
|
99
|
-
| id | `<project-id>:prj-issues-and-approach` | ○ |
|
|
100
|
-
| type | `project` 固定 | ○ |
|
|
101
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
102
|
-
| rulebook | `specdojo:prj-issues-and-approach-rulebook` | ○ |
|
|
103
|
-
| based_on | 概要、スコープ、前提・制約・依存関係など、直接根拠にした文書 | 任意 |
|
|
104
|
-
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
105
|
-
|
|
106
|
-
### 4.2. 推奨ルール
|
|
58
|
+
許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
|
|
107
59
|
|
|
108
|
-
- `
|
|
109
|
-
-
|
|
110
|
-
|
|
111
|
-
### 4.3. 推奨例
|
|
60
|
+
- `specdojo.type` は `project`、`specdojo.rulebook` は `specdojo:prj-issues-and-approach-rulebook` とします。
|
|
61
|
+
- `specdojo.based_on` には、直接の根拠とした概要・スコープ・前提・制約・依存関係の ID を記載します(なければ `[]`)。
|
|
112
62
|
|
|
113
63
|
```yaml
|
|
114
64
|
---
|
|
@@ -127,36 +77,32 @@ specdojo:
|
|
|
127
77
|
|
|
128
78
|
## 5. 本文構成(標準テンプレ)
|
|
129
79
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
### 5.1. プロジェクト課題と解決アプローチ(Project Issues and Approach)
|
|
133
|
-
|
|
134
|
-
| 番号 | 見出し | 必須 | 内容(要点) |
|
|
135
|
-
| ---- | ------ | ---- | ------------ |
|
|
80
|
+
見出しの骨組みは Frontmatter の `template` を正本とし、次の順序で配置します。
|
|
136
81
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
82
|
+
| 章 | 必須 | 内容・受入条件 |
|
|
83
|
+
| -------------------- | ---- | ---------------------------------------------------------------------------------------------- |
|
|
84
|
+
| 導入部(H1 直下) | ○ | 本書の目的、承認者と利用ロールごとの利用目的、合意対象と合意対象外 |
|
|
85
|
+
| 課題一覧 | ○ | 各課題に課題・影響・優先度を記載する |
|
|
86
|
+
| 原因(仮説でも可) | ○ | 課題ごとの原因を、事実と仮説を分けて根拠とともに示す |
|
|
87
|
+
| 解決策候補 | ○ | 2 件以上の方針と、案の関係(代替・補完)、対応する課題・原因 |
|
|
88
|
+
| 採用アプローチと理由 | ○ | 採用方針、判断軸による理由、補完策を組み合わせる理由、非採用案と理由 |
|
|
89
|
+
| トレードオフ/リスク | 任意 | 代償、リスクと軽減策、前提が崩れた場合の対応 |
|
|
90
|
+
| 次の検討事項(ToDo) | 任意 | 次の意思決定に必要な追加調査・確認・承認 |
|
|
91
|
+
| 見直しと変更管理 | 任意 | 本書の合意を見直す契機、確認する観点、対応方針。見直しの記録は共通の運用に従い、ここで定めない |
|
|
144
92
|
|
|
145
93
|
## 6. 記述ガイド
|
|
146
94
|
|
|
147
|
-
|
|
95
|
+
完成例は Frontmatter の `sample` で宣言された sample を参照してください。見出し配下は箇条書きと必要最小限の表を基本とし、未確定は `_TODO_` または `_UNDECIDED_` で明示します。
|
|
148
96
|
|
|
149
|
-
|
|
150
|
-
- “事実/観察” と “推測/仮説” を混ぜないでください(混ざる場合はラベルで区別)。
|
|
151
|
-
- 読み手が「次に何を決めればよいか」が分かるように、未確定は未確定として明示します。
|
|
97
|
+
### 6.1. 導入部
|
|
152
98
|
|
|
153
|
-
|
|
99
|
+
- 本書の目的を 1 文で示し、誰が承認し、どの利用ロールが何の判断に使うかを書きます。
|
|
100
|
+
- 合意対象(優先課題、採用アプローチ、先送り事項など)と合意対象外(設計詳細、特定技術の採否など)を分けて書きます。
|
|
154
101
|
|
|
155
|
-
|
|
156
|
-
- 各課題には、最低限「影響」と「優先度」を添えます。
|
|
157
|
-
- 推奨: 課題IDを振って、議論や DEC 参照に使えるようにします。
|
|
102
|
+
### 6.2. 課題一覧
|
|
158
103
|
|
|
159
|
-
|
|
104
|
+
- 課題は「困っている現象」を書き、解決策の先取り(例:「自動発注がない」)にしません。
|
|
105
|
+
- 課題 ID を振り、原因・解決策候補・決定記録から参照できるようにします。
|
|
160
106
|
|
|
161
107
|
| 課題ID | 課題 | 影響 | 優先度 | 備考 |
|
|
162
108
|
| ------ | ---- | ---- | ------ | ---- |
|
|
@@ -165,68 +111,49 @@ specdojo:
|
|
|
165
111
|
### 6.3. 原因(仮説でも可)
|
|
166
112
|
|
|
167
113
|
- 原因は分解して書きます(例: 情報不足、判断基準の不在、手順のばらつき、システム制約)。
|
|
168
|
-
-
|
|
169
|
-
- 原因には、根拠文書、観察事実、補足説明を添えます。
|
|
170
|
-
|
|
171
|
-
推奨(原因表):
|
|
114
|
+
- 原因区分で事実と仮説を分け、根拠文書・観察事実または確認方法を添えます。
|
|
172
115
|
|
|
173
116
|
| 課題ID | 原因区分 | 内容 | 根拠 / 補足 |
|
|
174
117
|
| ------ | -------- | ---- | ----------- |
|
|
175
118
|
|
|
176
119
|
### 6.4. 解決策候補
|
|
177
120
|
|
|
178
|
-
-
|
|
179
|
-
-
|
|
180
|
-
-
|
|
181
|
-
- 案 ID を振り、採用アプローチ、代替案比較、決定記録から参照できるようにします。
|
|
182
|
-
- 同じ意思決定を置き換える一式の案を評価軸で詳細比較する場合は `prj-comparison-of-alternatives` へ委譲し、本書では課題との対応と比較が必要な論点までを示します。
|
|
183
|
-
|
|
184
|
-
推奨(解決策候補表):
|
|
121
|
+
- 各案を `代替` または `補完` に区分し、概要と期待できる効果を 1〜3 行で書きます。
|
|
122
|
+
- 案 ID と対応課題を示します。補完策は、ほかの案と役割が重複しないことを確かめます。
|
|
123
|
+
- 同じ判断を置き換える一式の案を評価軸で詳細比較する場合は `prj-comparison-of-alternatives` へ委譲し、本書では比較が必要な論点までを示します。
|
|
185
124
|
|
|
186
125
|
| 案ID | 案 | 関係 | 概要 | 期待できる効果 | 対応課題 |
|
|
187
126
|
| ---- | --- | ---- | ---- | -------------- | -------- |
|
|
188
127
|
|
|
189
128
|
### 6.5. 採用アプローチと理由
|
|
190
129
|
|
|
191
|
-
-
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
- 補完策を組み合わせる場合は、各案が担う課題・原因と、単独では不足する理由を説明します。中核・補助または実行順序がある場合だけ、その関係も示します。
|
|
195
|
-
|
|
196
|
-
推奨(採用判定表):
|
|
130
|
+
- 採用案を明記し、判断軸(効果・コスト・期間・リスク・現場適合など)で理由を説明し、重視する順序を示します。
|
|
131
|
+
- 採用しない代替案は、その理由を 1 行で添えます。
|
|
132
|
+
- 補完策を組み合わせる場合は、各案が担う課題・原因と、単独では不足する理由を書きます。中核・補助または実行順序がある場合だけ、その関係も示します。
|
|
197
133
|
|
|
198
134
|
| 採用対象 | 判定 | 理由 |
|
|
199
135
|
| -------- | ---- | ---- |
|
|
200
136
|
|
|
201
137
|
### 6.6. トレードオフ/リスク(任意)
|
|
202
138
|
|
|
203
|
-
-
|
|
204
|
-
-
|
|
205
|
-
- 区分は `トレードオフ` / `リスク` などで揃え、課題ログやリスク登録簿へ転記しやすい粒度にします。
|
|
206
|
-
|
|
207
|
-
推奨(トレードオフ/リスク表):
|
|
139
|
+
- トレードオフは「何を捨てる・先送りする・我慢するか」を書きます。
|
|
140
|
+
- リスクは「起きうること」と「軽減策」をセットで書き、区分は `トレードオフ` / `リスク` で揃えます。
|
|
208
141
|
|
|
209
142
|
| 区分 | 内容 | 軽減策 |
|
|
210
143
|
| ---- | ---- | ------ |
|
|
211
144
|
|
|
212
145
|
### 6.7. 次の検討事項(ToDo)(任意)
|
|
213
146
|
|
|
214
|
-
-
|
|
215
|
-
-
|
|
216
|
-
|
|
217
|
-
推奨(ToDo 表):
|
|
147
|
+
- 次の意思決定に必要な追加調査・確認・承認事項と、その目的を列挙します。
|
|
148
|
+
- 責任ロールは、プロジェクトの体制定義で採用済みのロールで書きます。
|
|
218
149
|
|
|
219
150
|
| ToDo | 目的 | 責任ロール |
|
|
220
151
|
| ---- | ---- | ---------- |
|
|
221
152
|
|
|
222
153
|
### 6.8. 見直しと変更管理(任意)
|
|
223
154
|
|
|
224
|
-
-
|
|
155
|
+
- 見直す契機(仮説の反証、スコープ・前提制約の変更、採用アプローチに影響する決定、リスクの顕在化など)を挙げます。
|
|
225
156
|
- 契機ごとに、確認する観点と対応方針をセットで書きます。
|
|
226
|
-
- 見直し結果と判断根拠の記録先(プロジェクト登録簿、決定記録など)を示します。
|
|
227
|
-
- 責任は、各項目の所有者が監視し、全体の取りまとめと最終判断を行うロールを明記します。
|
|
228
|
-
|
|
229
|
-
推奨(見直しと変更管理表):
|
|
230
157
|
|
|
231
158
|
| 見直しの契機 | 確認する観点 | 対応方針 |
|
|
232
159
|
| ------------ | ------------ | -------- |
|
|
@@ -14,21 +14,17 @@ specdojo:
|
|
|
14
14
|
|
|
15
15
|
Project Scope Documentation Rulebook
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
関係者が「今回やること、やらないこと、境界変更時の判断方法」を短時間で合意できる粒度に整えます。
|
|
17
|
+
関係者が「今回やること、やらないこと、境界変更時の判断方法」を合意できるプロジェクトスコープの記述基準を定めます。
|
|
19
18
|
|
|
20
19
|
## 1. 全体方針
|
|
21
20
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
- スコープは “やること” だけでなく “やらないこと” を明示します。スコープ外の未記載は禁止します。
|
|
21
|
+
- 対象は **プロジェクトスコープ**(対象範囲、対象外、境界判断、変更方針)です。
|
|
22
|
+
- 目的は、利用者が対象範囲と除外範囲を確認でき、後続の成功基準、前提・制約、課題整理、計画作成の前提を揃えることです。
|
|
25
23
|
- スコープは設計詳細ではなく、業務価値、利用者影響、合意対象、責務境界を確認するための境界定義です。
|
|
26
24
|
- 詳細な成功判定や受入条件は `prj-success-criteria-and-acceptance-criteria`、前提・制約・依存は `prj-assumptions-constraints-dependencies`、課題と解決方針は `prj-issues-and-approach` へ委譲します。
|
|
27
|
-
-
|
|
25
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
|
|
28
26
|
|
|
29
|
-
## 2.
|
|
30
|
-
|
|
31
|
-
### 2.1. 位置づけ
|
|
27
|
+
## 2. 位置づけ
|
|
32
28
|
|
|
33
29
|
プロジェクトスコープは、プロジェクト概要で示した背景・必要性・期待効果を受け、対象範囲と対象外を定義する文書です。後続文書は、本書の境界を前提に詳細化します。
|
|
34
30
|
|
|
@@ -49,18 +45,6 @@ flowchart LR
|
|
|
49
45
|
class PSC target
|
|
50
46
|
```
|
|
51
47
|
|
|
52
|
-
### 2.2. 用語定義
|
|
53
|
-
|
|
54
|
-
| 用語 | 定義 |
|
|
55
|
-
| ---------------- | ------------------------------------------------------------------------ |
|
|
56
|
-
| スコープ内 | 今回やること、成果物に含めること、または対象にする活動領域 |
|
|
57
|
-
| 対象業務 | 対象とする業務、活動、プロセス、利用場面 |
|
|
58
|
-
| 対象システム | 対象とするシステム、成果物、文書体系、基盤、補助ツール、外部連携 |
|
|
59
|
-
| 対象期間 | 本スコープを適用する期間。日付が未確定の場合はイベント基準で定義してよい |
|
|
60
|
-
| スコープ外 | 意図的にやらないこと。理由、補足、後続で扱う条件を添える |
|
|
61
|
-
| 境界の判断基準 | 含める・含めないで迷ったときの判断順序、優先原則、SSOT |
|
|
62
|
-
| スコープ変更方針 | スコープを追加・削除・変更するときの入口、確認観点、承認者、記録方法 |
|
|
63
|
-
|
|
64
48
|
## 3. ファイル命名・ID規則
|
|
65
49
|
|
|
66
50
|
### 3.1. 配置(推奨)
|
|
@@ -73,44 +57,31 @@ flowchart LR
|
|
|
73
57
|
|
|
74
58
|
- 推奨: `<project-id>:prj-scope`
|
|
75
59
|
- 例: `prj-0001:prj-scope`
|
|
76
|
-
- YAML Frontmatter では、必要に応じてコロンを含む ID をクォートします。
|
|
77
60
|
|
|
78
61
|
### 3.3. ファイル名(推奨)
|
|
79
62
|
|
|
80
63
|
- 推奨: `prj-scope.md`
|
|
81
|
-
- 日本語ファイル名を使う場合も、Frontmatter の `id` は推奨形式で一意にします。
|
|
82
64
|
|
|
83
65
|
## 4. 推奨 Frontmatter 項目
|
|
84
66
|
|
|
85
67
|
### 4.1. 設定内容
|
|
86
68
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- 参照スキーマ: [deliverable-frontmatter.schema.yaml](/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
|
|
90
|
-
- メタ情報標準: [[specdojo:document-metadata-standard]]
|
|
69
|
+
許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
|
|
91
70
|
|
|
92
|
-
|
|
93
|
-
| ---------- | ---------------------------------- | ---- |
|
|
94
|
-
| id | `<project-id>:prj-scope` | ○ |
|
|
95
|
-
| type | `project` 固定 | ○ |
|
|
96
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
97
|
-
| rulebook | `specdojo:prj-scope-rulebook` | ○ |
|
|
98
|
-
| based_on | `prj-overview`、上位方針、憲章など | 任意 |
|
|
99
|
-
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
71
|
+
- `id` は `<project-id>:prj-scope`、`type` は `project`、`rulebook` は `specdojo:prj-scope-rulebook` とします。
|
|
100
72
|
|
|
101
73
|
### 4.2. 推奨ルール
|
|
102
74
|
|
|
103
|
-
- `based_on`
|
|
104
|
-
-
|
|
105
|
-
- ドキュメント名は Frontmatter ではなく本文 H1 に記述します(例: `# プロジェクトスコープ: <プロジェクト名>`)。
|
|
75
|
+
- `based_on` には直接の根拠を記載し、`prj-overview` が存在する場合は含めて背景・必要性・期待効果とスコープを対応させます。成果物カタログに `depends_on` がある場合はその推移閉包内に限定します。
|
|
76
|
+
- H1 は `# プロジェクトスコープ: <プロジェクト名>` とします。
|
|
106
77
|
|
|
107
78
|
## 5. 本文構成(標準テンプレ)
|
|
108
79
|
|
|
109
|
-
|
|
80
|
+
各章は次の内容を満たすものとし、見出し順と記入欄は宣言済みの template を正本とします。
|
|
110
81
|
|
|
111
82
|
### 5.1. プロジェクトスコープ(Project Scope)
|
|
112
83
|
|
|
113
|
-
| 番号 |
|
|
84
|
+
| 番号 | 章 | 必須 | 内容・受入条件 |
|
|
114
85
|
| ---- | ---------------- | ---- | -------------------------------------------------------- |
|
|
115
86
|
| 1 | 対象業務 | ○ | 対象とする業務、活動領域、利用場面、利用者影響 |
|
|
116
87
|
| 2 | 対象システム | ○ | 対象となるシステム、成果物、文書体系、基盤、外部連携範囲 |
|
|
@@ -123,26 +94,22 @@ Frontmatter は共通スキーマに従います。
|
|
|
123
94
|
|
|
124
95
|
### 6.1. 共通
|
|
125
96
|
|
|
126
|
-
- 見出し配下は「箇条書き + 必要最小限の表」を基本とします。
|
|
127
97
|
- 対象範囲、対象外、利用者影響、合意対象が読み取れる粒度で記述します。
|
|
128
|
-
- “事実/決定済み” と “推測/仮説/未決” を混ぜないでください。未確定の内容は _UNDECIDED_: を優先し、作業待ちの項目だけ _TODO_:、仮置きの前提は _ASSUMPTION_: で明示します。
|
|
129
98
|
- UI、API、DB、テストケース、運用手順などの詳細は、対象となる後続文書へ委譲します。
|
|
130
99
|
|
|
131
100
|
### 6.2. 対象業務
|
|
132
101
|
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
- 対象業務には、何を作るかだけでなく、何を運用・管理できる状態にするかを含めます。
|
|
102
|
+
- 機能名ではなく、現場の作業・判断・活動領域の単位で書き、対象者、利用場面、利用者影響を添えることを推奨します。
|
|
103
|
+
- 文書体系、ルール整備、公開準備が目的の場合は「対象とする活動領域」として記述してよいです。
|
|
104
|
+
- 作るものと、運用・管理できるようにするものを含めます。
|
|
137
105
|
|
|
138
106
|
### 6.3. 対象システム
|
|
139
107
|
|
|
140
108
|
- 対象機能、対象成果物、対象基盤は粒度を揃えます。
|
|
141
|
-
-
|
|
109
|
+
- 業務アプリケーション以外では、文書体系、管理台帳、サンプル、補助ツール、公開基盤などを表で示してよいです。
|
|
142
110
|
- 実行可能なツールや CLI、正本となる管理データ、正本から生成する成果物は、プロジェクトが整備・変更・運用するなら対象システムに含めます。所有者、編集方法、責務が異なる場合は別の行に分けます。
|
|
143
111
|
- 生成物を含める場合は、生成元となる正本と、直接編集の可否を境界に記述します。
|
|
144
112
|
- 外部連携、公開基盤、補助ツールを含める場合は、プロジェクトが担う設定・接続・利用と、外部サービスや外部ツール本体の責務を分けて記述します。
|
|
145
|
-
- UI/画面遷移、API一覧、DB 定義、個別テンプレートの詳細は、本ドキュメントでは書きません。
|
|
146
113
|
|
|
147
114
|
推奨表:
|
|
148
115
|
|
|
@@ -158,7 +125,7 @@ Frontmatter は共通スキーマに従います。
|
|
|
158
125
|
|
|
159
126
|
### 6.5. スコープ外
|
|
160
127
|
|
|
161
|
-
-
|
|
128
|
+
- 今回含めない対象を明示します。
|
|
162
129
|
- 推奨: スコープ外にした理由(コスト、効果、責務境界、公開適性、後続フェーズ等)を添えます。
|
|
163
130
|
- 利用者影響が大きい対象外項目は、後続で扱う条件や再検討タイミングも示します。
|
|
164
131
|
|
|
@@ -195,8 +162,6 @@ Frontmatter は共通スキーマに従います。
|
|
|
195
162
|
| 項目 | 理由 |
|
|
196
163
|
| ----------------------------------- | ----------------------------------------- |
|
|
197
164
|
| 設計詳細(DB設計、API設計等) | プロダクト仕様/設計ドキュメントへ委譲する |
|
|
198
|
-
| “だいたい/適切に” 等の曖昧表現 | 合意・検証ができない |
|
|
199
165
|
| スコープ外の未記載 | 境界が曖昧になり手戻りの原因になる |
|
|
200
166
|
| 対象業務と対象システムの粒度不一致 | 見積、優先度、責務境界の認識が崩れる |
|
|
201
167
|
| 受入条件や GO / Not GO 判定の詳細化 | 成功基準と受入条件との責務重複を防ぐ |
|
|
202
|
-
| 個人名・連絡先等の公開不適切情報 | 公開リポジトリでの利用を想定するため |
|
|
@@ -14,33 +14,20 @@ specdojo:
|
|
|
14
14
|
|
|
15
15
|
Stakeholder Register Documentation Rulebook
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
プロジェクトの関係者を業務価値と利用者影響から整理し、合意対象、関与方針、後続のコミュニケーション計画への入力を定める規約です。
|
|
18
18
|
|
|
19
19
|
## 1. 全体方針
|
|
20
20
|
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
21
|
+
- 対象は、意思決定、実行、利用、運用、評価、影響受容に関わる個人・組織・集団である。
|
|
22
|
+
- 目的は、関係者の関心と影響を可視化し、合意漏れと利用者影響の見落としを防ぐことである。
|
|
23
|
+
- 会議体、配信頻度、議事録の運用はコミュニケーション計画へ委譲し、入力となる要求だけを扱う。
|
|
24
|
+
- ステークホルダーは人・組織との関係を示し、タスクの担当責務である Role と区別する。対応する Role がある場合だけ Role code を併記する。
|
|
25
|
+
- AI Agent・ツール自体は登録せず、入力・制約・確認責任を持つ人・組織を記載する。
|
|
26
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認には含めない。
|
|
27
27
|
|
|
28
|
-
## 2.
|
|
28
|
+
## 2. 位置づけ
|
|
29
29
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
ステークホルダー登録簿は、プロジェクト概要で示した目的、利用者、期待効果を受けて、合意対象と関与方針を具体化する文書である。後続のコミュニケーション計画は、本書の情報要求、合意・報告の必要性、証跡要件を入力として詳細化する。
|
|
33
|
-
|
|
34
|
-
### 2.2. 用語定義
|
|
35
|
-
|
|
36
|
-
| 用語 | 定義 |
|
|
37
|
-
| -------------------- | ------------------------------------------------------------------------------------ |
|
|
38
|
-
| ステークホルダー | プロジェクトの成果に影響を与える、または成果・進め方から影響を受ける個人、組織、集団 |
|
|
39
|
-
| 関与区分 | 意思決定者、利用者、実行担当者、外部協力者、影響受容者など、関係者の立場を表す分類 |
|
|
40
|
-
| 影響度 | 方針、範囲、優先順位、利用、運用、合意形成に与えられる影響の強さ |
|
|
41
|
-
| 関心度 | 成果、進捗、利用条件、変更に対して継続的に関与する必要性または意向の強さ |
|
|
42
|
-
| エンゲージメント方針 | 現状から目標とする関与状態へ近づけるための情報提供、相談、合意、巻き込みの進め方 |
|
|
43
|
-
| 必要な合意 | 着手、変更、公開、利用、運用のために当該関係者と確認または承認する事項 |
|
|
30
|
+
概要の目的・利用者・期待効果を合意対象と関与方針へ具体化する。情報要求、合意・報告の必要性、証跡要件を後続のコミュニケーション計画へ渡す。
|
|
44
31
|
|
|
45
32
|
## 3. ファイル命名・ID規則
|
|
46
33
|
|
|
@@ -48,69 +35,52 @@ Stakeholder Register Documentation Rulebook
|
|
|
48
35
|
|
|
49
36
|
- `docs/ja/projects/<project-id>/020-project-definition/prj-stakeholder-register.md` に配置する。
|
|
50
37
|
- 個人連絡先、非公開の利害情報、詳細な連絡網は、アクセス制限された管理資料へ分離する。
|
|
51
|
-
- 関与方針の証跡は、議事録、決定記録、Issue、Pull Request など、実際に管理する文書またはツールへ残す。
|
|
52
38
|
|
|
53
39
|
### 3.2. ドキュメントID(推奨)
|
|
54
40
|
|
|
55
41
|
- 推奨: `<project-id>:prj-stakeholder-register`
|
|
56
42
|
- 例: `prj-0001:prj-stakeholder-register`
|
|
57
|
-
- ID
|
|
43
|
+
- 文書 ID と関係者 ID は区別する。
|
|
58
44
|
|
|
59
45
|
### 3.3. ファイル名(推奨)
|
|
60
46
|
|
|
61
47
|
- 推奨: `prj-stakeholder-register.md`
|
|
62
48
|
- 関係者 ID は `STH-<KEY>` 形式とし、同じ関係者を全ての表で同じ ID で参照する。
|
|
63
|
-
-
|
|
49
|
+
- 個人名より役割名・組織名・集団名を優先する。
|
|
64
50
|
|
|
65
51
|
## 4. 推奨 Frontmatter 項目
|
|
66
52
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
| 項目 | 説明 | 必須 |
|
|
70
|
-
| ---------- | ----------------------------------------------------- | ---- |
|
|
71
|
-
| id | `<project-id>:prj-stakeholder-register` 形式の文書 ID | ○ |
|
|
72
|
-
| type | `project` | ○ |
|
|
73
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
74
|
-
| rulebook | `specdojo:prj-stakeholder-register-rulebook` | ○ |
|
|
75
|
-
| based_on | 関係者の根拠にした概要、憲章など | 任意 |
|
|
76
|
-
| supersedes | 置き換えた旧文書 ID | 任意 |
|
|
53
|
+
許可キー・必須項目・型制約は「共通の運用」の参照先と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従う。
|
|
77
54
|
|
|
78
|
-
|
|
55
|
+
- `type` は `project` とする。
|
|
56
|
+
- `rulebook` は `specdojo:prj-stakeholder-register-rulebook` とする。
|
|
57
|
+
- 任意の `based_on` には、関係者、期待、合意対象を判断した概要や憲章などの直接根拠を記載する。
|
|
79
58
|
|
|
80
|
-
|
|
81
|
-
- 個人名、メールアドレス、電話番号、住所、非公開の組織情報、機密性の高い利害関係は記載しない。
|
|
82
|
-
- 対応 Role code は、プロジェクトで採用済みであることを確認できる場合だけ記載する。該当しない外部集団には割り当てない。
|
|
83
|
-
- 変更時は、関係者の追加・削除・関与変更のいずれかと、見直しの証跡を残す。
|
|
59
|
+
## 5. 本文要件
|
|
84
60
|
|
|
85
|
-
|
|
61
|
+
骨組み(見出し順・表・記入欄)は `template` を正とし、各章の必須性・受入条件は次に定める。
|
|
86
62
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
| 4 | コミュニケーション要件 | ○ | 情報要求、希望チャネル、合意・報告の必要性、証跡要件、計画への反映 |
|
|
95
|
-
| 5 | 見直し条件 | ○ | 更新トリガー、見直し内容、見直し責任者、承認者、証跡 |
|
|
63
|
+
| 章 | 必須 | 目的・受入条件 |
|
|
64
|
+
| ---------------------- | ---- | ------------------------------------------------------------------------------------------------------- |
|
|
65
|
+
| 関係者一覧 | ○ | 調整先を識別する。ID、関係者名、関与区分、所属/組織、対応 Role code、主な責任、利用場面または備考を示す |
|
|
66
|
+
| 影響度/関心度分析 | ○ | 関与の優先度を判断する。影響度、関心度、期待、懸念、必要な合意、評価根拠を対応付ける |
|
|
67
|
+
| エンゲージメント方針 | ○ | 関与の差分を埋める。現状、目標、対応方針、責任者、期限、証跡を対応付ける |
|
|
68
|
+
| コミュニケーション要件 | ○ | 詳細計画への入力を示す。情報要求、希望チャネル、合意・報告の必要性、証跡要件、計画への反映を記載する |
|
|
69
|
+
| 見直し条件 | ○ | 関係者への影響を再評価する契機を示す。更新トリガー、見直し内容、見直し責任者、承認者、証跡を記載する |
|
|
96
70
|
|
|
97
71
|
## 6. 記述ガイド
|
|
98
72
|
|
|
99
73
|
### 6.1. 関係者一覧
|
|
100
74
|
|
|
101
|
-
-
|
|
102
|
-
- 1
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
推奨表:
|
|
106
|
-
|
|
107
|
-
| ID | 関係者 | 関与区分 | 所属/組織 | 対応 Role code | 主な責任 | 備考 |
|
|
108
|
-
| --- | ------ | -------- | --------- | -------------- | -------- | ---- |
|
|
75
|
+
- 関与区分は意思決定、実行、利用、運用、外部協力、影響受容で識別する。
|
|
76
|
+
- 1 行で主な責任とプロジェクトへの関わり方を示す。
|
|
77
|
+
- 同じ対象を別名で重複登録しない。
|
|
78
|
+
- 対応 Role code は採用済みのものだけを使い、該当しない外部集団には割り当てない。
|
|
109
79
|
|
|
110
80
|
### 6.2. 影響度/関心度分析
|
|
111
81
|
|
|
112
|
-
-
|
|
113
|
-
-
|
|
82
|
+
- 影響度・関心度は High / Medium / Low で評価し、方針・範囲・利用・合意形成への影響を根拠にする。
|
|
83
|
+
- 期待・懸念と、着手・変更・公開・利用・運用のために確認・承認する「必要な合意」を対応付ける。
|
|
114
84
|
- High の関係者は、必要な合意または関与方針を空欄にしない。
|
|
115
85
|
|
|
116
86
|
| 評価 | 影響度の基準 | 関心度の基準 |
|
|
@@ -121,46 +91,31 @@ Stakeholder Register Documentation Rulebook
|
|
|
121
91
|
|
|
122
92
|
### 6.3. エンゲージメント方針
|
|
123
93
|
|
|
124
|
-
-
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
|
|
128
|
-
推奨表:
|
|
129
|
-
|
|
130
|
-
| ID | 関係者 | 現状 | 目標 | 対応方針 | 責任者 | 期限 | 証跡 |
|
|
131
|
-
| --- | ------ | ---- | ---- | -------- | ------ | ---- | ---- |
|
|
94
|
+
- 現状と目標を対比し、差分を埋める対応方針を書く。
|
|
95
|
+
- 情報提供、相談、合意形成、承認依頼、巻き込み、リスク低減の目的が分かる行動にする。
|
|
96
|
+
- 証跡は議事録、決定記録、Issue、Pull Request などで辿れるようにする。未確定の関与方針・期限は、論点と利用者影響を明示する。
|
|
132
97
|
|
|
133
98
|
### 6.4. コミュニケーション要件
|
|
134
99
|
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
138
|
-
|
|
139
|
-
推奨表:
|
|
140
|
-
|
|
141
|
-
| ID | 関係者 | 情報要求 | 希望チャネル | 合意・報告の必要性 | 証跡要件 | コミュニケーション計画への反映 |
|
|
142
|
-
| --- | ------ | -------- | ------------ | ------------------ | -------- | ------------------------------ |
|
|
100
|
+
- 情報要求は、受け取る情報と、それによる判断・確認を示す。
|
|
101
|
+
- 希望チャネルは対面、Issue、文書、公開ページなどの手段を示す。
|
|
102
|
+
- 詳細計画を作る場合は、情報要求と証跡要件を入力として渡し、同じ配信計画を二重管理しない。
|
|
143
103
|
|
|
144
104
|
### 6.5. 見直し条件
|
|
145
105
|
|
|
146
106
|
- 概要、範囲、体制、公開方針、主要な利用者影響が変わるときは見直す。
|
|
147
107
|
- 定期見直しを行う場合は、周期だけでなく、確認する内容と承認者を明記する。
|
|
148
|
-
-
|
|
149
|
-
|
|
150
|
-
推奨表:
|
|
151
|
-
|
|
152
|
-
| 更新トリガー | 見直し内容 | 見直し責任者 | 承認者 | 証跡 |
|
|
153
|
-
| ------------ | ---------- | ------------ | ------ | ---- |
|
|
108
|
+
- 関係者の追加・削除・関与変更と、同じ ID を使う各章・コミュニケーション計画への影響を、変更差分や決定記録で辿れるようにする。
|
|
154
109
|
|
|
155
110
|
## 7. 禁止事項
|
|
156
111
|
|
|
157
|
-
| 項目
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
| ステークホルダー ID をタスクの owner
|
|
163
|
-
| 未採用の Role code
|
|
164
|
-
|
|
|
165
|
-
|
|
|
166
|
-
| AI Agent
|
|
112
|
+
| 項目 | 理由 |
|
|
113
|
+
| ------------------------------------------------ | ------------------------------------------ |
|
|
114
|
+
| 役割・責任・関与区分の欠落 | 調整先と利用者影響を判断できないため |
|
|
115
|
+
| 根拠のない影響度・関心度の評価 | 対応優先度を説明できないため |
|
|
116
|
+
| 必要な合意の空欄 | 意思決定者と合意対象を識別できないため |
|
|
117
|
+
| ステークホルダー ID をタスクの owner に使う | 関係者と責務 Role を混同するため |
|
|
118
|
+
| 未採用の Role code の推測 | 組織・責務定義と不整合になるため |
|
|
119
|
+
| 個人連絡先・非公開情報・機密の利害関係の記載 | 公開時の情報管理リスクがあるため |
|
|
120
|
+
| 詳細な会議運営・配信計画の重複管理 | コミュニケーション計画と二重管理になるため |
|
|
121
|
+
| AI Agent・ツール自体をステークホルダーとして登録 | 責任を持つ人・組織との関係が不明になるため |
|