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
|
@@ -10,109 +10,101 @@ specdojo:
|
|
|
10
10
|
template: specdojo:pm-quality-management-plan-template
|
|
11
11
|
based_on:
|
|
12
12
|
- specdojo:people-and-organization-definition-standard
|
|
13
|
+
- specdojo:document-metadata-standard
|
|
13
14
|
---
|
|
14
15
|
|
|
15
16
|
# 品質管理計画 作成ルール
|
|
16
17
|
|
|
17
18
|
Quality Management Plan Documentation Rulebook
|
|
18
19
|
|
|
19
|
-
|
|
20
|
+
利用者価値と成果物品質を、少数の品質ゲート、証跡、是正方法で管理するためのルールです。
|
|
20
21
|
|
|
21
22
|
## 1. 全体方針
|
|
22
23
|
|
|
23
24
|
- 品質は、利用者価値の成立と、それを支える成果物・技術条件の両方で判定します。
|
|
24
|
-
- 成功基準の条件 ID、成果物rulebook、検証コマンドを正本とし、本書には判定の接続方法だけを書きます。
|
|
25
|
-
- 品質目標、メトリクス、検査基準を重複させず、品質ゲートへ統合します。
|
|
26
25
|
- 小規模プロジェクトでは、代表試行、主要レビュー、公開前確認など必要なゲートだけを置きます。
|
|
27
|
-
-
|
|
26
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint・見出し・wikilink の検査はリポジトリの検証で扱い、業務の受入条件に含めません。
|
|
28
27
|
|
|
29
|
-
|
|
28
|
+
## 2. 位置づけ
|
|
30
29
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
| 用語 | 定義 |
|
|
34
|
-
| ---------- | -------------------------------------------------------------- |
|
|
35
|
-
| 品質ゲート | 所定の時点で、条件・証跡・判断者をそろえて合否を確認する仕組み |
|
|
36
|
-
| 価値品質 | 利用者・業務・社会に期待する変化が成立したかを示す品質 |
|
|
37
|
-
| 成果物品質 | 構造、整合、検証、公開適性など価値提供を支える品質 |
|
|
38
|
-
| 不適合 | 品質ゲートの合格条件を満たさない状態 |
|
|
30
|
+
本計画は、管理計画の品質方針を判定時点・責任・証跡・是正へ具体化し、レビューと後続作業の計画に用います。
|
|
39
31
|
|
|
40
32
|
## 3. ファイル命名・ID規則
|
|
41
33
|
|
|
42
34
|
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-quality-management-plan.md` を推奨します。
|
|
43
35
|
- ID は `<project-id>:pm-quality-management-plan`、ファイル名は `pm-quality-management-plan.md` とします。
|
|
44
|
-
-
|
|
36
|
+
- 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従い、判定条件は成功基準 ID、受入条件 ID、成果物 ID など安定した識別子で参照します。
|
|
45
37
|
|
|
46
38
|
## 4. 推奨 Frontmatter 項目
|
|
47
39
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
| id | `<project-id>:pm-quality-management-plan` | ○ |
|
|
51
|
-
| type | `project` | ○ |
|
|
52
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
53
|
-
| rulebook | `specdojo:pm-quality-management-plan-rulebook` | ○ |
|
|
54
|
-
| based_on | 管理計画、成功基準など直接根拠となる ID | 任意 |
|
|
55
|
-
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
40
|
+
- 共通項目・型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
|
|
41
|
+
- `based_on` には、管理計画など作成時に直接根拠とした先行成果物を記載します。カタログを利用する場合は `depends_on` の推移閉包内に限り、閉包外の根拠が必要なら依存関係の整備を先行させます。
|
|
56
42
|
|
|
57
|
-
## 5.
|
|
43
|
+
## 5. 本文要件
|
|
58
44
|
|
|
59
|
-
|
|
60
|
-
| ---- | ------ | ---- | ---- |
|
|
45
|
+
見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とし、本書では各章が満たす意味要件を定めます。
|
|
61
46
|
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
|
47
|
+
| 要件 | 必須条件 | 記載する判断・根拠 |
|
|
48
|
+
| ------------------------------ | ------------------------ | -------------------------------------------------------------------- |
|
|
49
|
+
| 品質方針と適用範囲 | 必須 | 価値品質と成果物品質、対象範囲、適用開始・終了 |
|
|
50
|
+
| 品質ゲート | 必須 | ゲートごとの品質観点、条件 ID、確認方法と証跡、時期、確認・承認責任 |
|
|
51
|
+
| レビューと証跡 | 必須 | 対象、主要観点、実施責任、合否を判定できる出口条件、証跡、記録先 |
|
|
52
|
+
| 不適合と是正 | 必須 | 区分ごとの対応、再判定条件、再判定責任、記録先、重大不適合の通過制限 |
|
|
53
|
+
| 見直し条件と未決事項(見直し) | 必須 | 見直し契機、影響する正本・後続作業 |
|
|
54
|
+
| 見直し条件と未決事項(未決) | 未決事項がある場合に必須 | 未決論点と影響、未決中に保留する判定。なければ「なし」と明記できる |
|
|
67
55
|
|
|
68
56
|
## 6. 記述ガイド
|
|
69
57
|
|
|
58
|
+
品質計画固有の判断基準と部分例を示します。
|
|
59
|
+
|
|
70
60
|
### 6.1. 品質方針と適用範囲
|
|
71
61
|
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
62
|
+
- 判断基準は、利用者価値とそれを支える成果物品質、対象範囲・期間を識別できることです。成功基準を根拠とし、技術検証だけで価値を判定しません。
|
|
63
|
+
- 適用開始・終了は日付または識別可能なイベントで示します。公開後の観測を含む場合は終了までの関係を示し、未確定の終了日は終了条件と見直し契機で代替できます。
|
|
64
|
+
- 良い例: 「代表試行開始から公開後価値ゲートの判定完了まで適用する。利用継続と負担を価値品質、再現性を成果物品質として確認する」。
|
|
65
|
+
- 悪い例: 「開発中の品質を高める」。価値品質と期間の境界を確認できません。
|
|
75
66
|
|
|
76
67
|
### 6.2. 品質ゲート
|
|
77
68
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
69
|
+
- 判断基準は、各ゲートから条件の正本、確認方法、証跡、時期、確認者と承認者を辿り、合否または保留を決められることです。初期受入と公開後の継続判断は適用時点を分けます。
|
|
70
|
+
- 合格条件は文書 ID と条件 ID で参照し、算出方法・閾値・計測頻度を正本から確認できるようにします。条件を満たさなければ未達、証跡不足・条件未定義なら保留とし、いずれも通過させません。
|
|
71
|
+
- 「確認者 / 承認者」は証跡に基づく品質確認と当該ゲートの判断を区別して示します。
|
|
72
|
+
- 費用・負荷を扱う場合は、現金支出、作業時間、継続運用負荷を別の基準・記録で確認します。
|
|
73
|
+
- 良い例: 「初期受入は SC-01・AC-01 に基づき試行終了時に判定する。確認者が試行記録を条件別に照合し、全条件の合格で通過する」。
|
|
74
|
+
- 悪い例: 「lint が通れば受入とし、利用者の評価は後で確認する」。価値の合否を判定できません。
|
|
84
75
|
|
|
85
76
|
### 6.3. レビューと証跡
|
|
86
77
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
- 生成物は正本から再生成し、直接編集を品質是正に使いません。
|
|
78
|
+
- 判断基準は、対象版について誰が何を確認し、どの状態なら通過でき、どこに結果が残るかを再現できることです。レビュー種別は対象と対応が異なるものに絞ります。
|
|
79
|
+
- 列名は「対象」「実施責任」に統一します。「出口条件」は合否を分ける状態、「証跡」は判定を裏付ける記録、「記録先」はその記録へ到達する文書 ID またはパスです。三者を独立した列で必須とし、証跡名だけで出口条件を代替しません。
|
|
80
|
+
- 証跡には対象版、実施日、結果、未達条件・指摘と是正・再判定結果を追跡できる情報を残します。生成物の是正は生成元の正本を修正し、再生成して確認します。
|
|
81
|
+
- 良い例: 「試行結果を確認者が照合する。出口条件は AC-01 の合格、証跡は対象版と条件別結果を持つ試行記録、記録先は `execution/reviews/trial-1/result.md` とする」。パスは例示であり、実際の保存先を指定します。
|
|
82
|
+
- 悪い例: 「実施者: 関係者、出口条件・証跡: レビュー結果」。責任、通過条件、記録先を特定できません。
|
|
93
83
|
|
|
94
84
|
### 6.4. 不適合と是正
|
|
95
85
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
86
|
+
- 判断基準は、不適合から是正、再判定、結果記録までを追跡できることです。軽微、価値、構造・検証、公開など対応差がある区分だけを置きます。
|
|
87
|
+
- 「再判定条件」と「再判定責任」を独立した列に分けます。前者は是正後に再確認する条件 ID・ゲートと確認を再開する契機、後者は再確認を担う Role code です。
|
|
88
|
+
- 必須の価値・受入条件、検証の成立、公開安全性への影響から重大性の判定境界を示します。重大な不適合は是正完了、または管理計画が認める期限付き例外の成立まで該当ゲートを通過させません。例外には対象条件、理由、期限、再判定条件を残します。
|
|
89
|
+
- 記録先はレビュー記録・検証結果・登録簿の文書 ID またはパスで特定し、条件変更を伴う是正は変更要求・決定記録へ接続します。
|
|
90
|
+
- 良い例: 「技術不適合は生成元を修正する。再判定条件は再生成後に未達の AC-02 と影響範囲の検証が成功すること、再判定責任は `QE` とし、対象版・結果を課題個票から辿れる検証記録に残す」。
|
|
91
|
+
- 悪い例: 「対応: 修正、再判定: `QE`、記録先: 課題」。条件・確認契機と到達先が不明です。
|
|
102
92
|
|
|
103
93
|
### 6.5. 見直し条件と未決事項
|
|
104
94
|
|
|
105
|
-
-
|
|
106
|
-
-
|
|
107
|
-
-
|
|
95
|
+
- 判断基準は、見直しの契機と判定条件への影響を追えることです。成功基準、公開範囲、成果物構造、検証方法、体制、重大不適合の傾向の変化を確認します。
|
|
96
|
+
- 追従対象は管理計画・RACI・Schedule・証跡参照とし、影響する条件 ID・証跡・再確認範囲を特定します。
|
|
97
|
+
- 未決事項は「論点」「影響・未決中に保留する判定」を示し、決定時に直す条件・証跡を特定します。
|
|
98
|
+
- 良い例: 「`_UNDECIDED_:` 試行記録の形式。未決の間は代表試行ゲートを保留する。決定後は証跡参照を更新し、確認工数が変われば Schedule に反映する」。
|
|
99
|
+
- 悪い例: 「手順は後で決め、変更時は見直す」。ゲートと後続作業への影響を確認できません。
|
|
108
100
|
|
|
109
101
|
## 7. 禁止事項
|
|
110
102
|
|
|
111
|
-
| 禁止事項
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
| 品質目標、メトリクス、検査基準へ同じ条件を重複記載する
|
|
115
|
-
| 技術検証だけで利用者価値の品質を代替する
|
|
116
|
-
| 現金支出だけを確認し、人の負荷を除外する
|
|
117
|
-
| 生成物を直接修正して不適合を解消する
|
|
118
|
-
|
|
|
103
|
+
| 禁止事項 | 理由 |
|
|
104
|
+
| ------------------------------------------------------- | ---------------------------------- |
|
|
105
|
+
| 成功基準の閾値・算出方法を品質ゲートで再定義する | 判定条件の正本が分散するため |
|
|
106
|
+
| 品質目標、メトリクス、検査基準へ同じ条件を重複記載する | 更新量と不整合が増えるため |
|
|
107
|
+
| 技術検証だけで利用者価値の品質を代替する | プロジェクト成功を判定できないため |
|
|
108
|
+
| 現金支出だけを確認し、人の負荷を除外する | 負荷転嫁を見逃すため |
|
|
109
|
+
| 生成物を直接修正して不適合を解消する | 再生成時に修正が失われるため |
|
|
110
|
+
| 証跡名や Role code だけで出口条件・再判定条件を代替する | 合否と責任を別々に確認できないため |
|
|
@@ -16,102 +16,83 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
RACI Documentation Rulebook
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
成果物・判断の責任境界を示し、責任衝突・判断停滞を防ぐ基準です。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
- Role code はロール定義、実行主体・兼務はメンバー定義、Schedule owner はScheduleを正本とします。
|
|
28
|
-
- Agent は `R` または `C` を支援できますが、`A` は担いません。
|
|
23
|
+
- 標準運用以上の責任境界を扱います。最小運用での省略条件は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「ファイル別の責務」に従います。
|
|
24
|
+
- 全成果物を列挙せず、主要成果物、価値、変更、品質例外、公開など責任衝突があり得る対象を選びます。
|
|
25
|
+
- 業務・技術・品質の作業責任、最終判断、必要な相談先を確認できることを網羅条件とします。該当しない観点は省略理由を示し、確認のためだけに行や未採用 Role を増やしません。
|
|
26
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入条件に含めません。
|
|
29
27
|
|
|
30
28
|
## 2. 位置づけと用語定義
|
|
31
29
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
| A | Accountable | 最終責任を持ち、承認または判断する |
|
|
36
|
-
| C | Consulted | 作業前・判断前に相談または確認する |
|
|
37
|
-
| I | Informed | 結果または変更の共有を受ける |
|
|
30
|
+
記号・用語は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
|
|
31
|
+
|
|
32
|
+
採用 Role は組織定義、Role code と責務はロール定義を正本とします。RACI は責任配置、Schedule は個別タスクの `owner` を管理します。
|
|
38
33
|
|
|
39
34
|
## 3. ファイル命名・ID規則
|
|
40
35
|
|
|
41
36
|
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-raci.md` を推奨します。
|
|
42
37
|
- ID は `<project-id>:pm-raci`、ファイル名は `pm-raci.md` とします。
|
|
43
|
-
-
|
|
38
|
+
- 行は成果物 ID または判断・プロセス名で特定し、統合した行も各成果物から一意に照合できるようにします。
|
|
44
39
|
|
|
45
40
|
## 4. 推奨 Frontmatter 項目
|
|
46
41
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
| 番号 | 見出し | 必須 | 内容 |
|
|
59
|
-
| ---- | -------------------------- | ---- | -------------------------------------------- |
|
|
60
|
-
| 1 | 適用方針 | ○ | 対象範囲、記号、Role code、兼務・Agentの扱い |
|
|
61
|
-
| 2 | 成果物別 RACI | ○ | 主要成果物の責任マトリクス |
|
|
62
|
-
| 3 | 判断・プロセス別 RACI | ○ | 価値判断、変更、品質、公開等の責任マトリクス |
|
|
63
|
-
| 4 | Schedule・実行主体との対応 | ○ | `R`、Schedule owner、member割り当ての関係 |
|
|
64
|
-
| 5 | 見直し条件 | ○ | 更新トリガーと確認内容 |
|
|
42
|
+
共通項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と成果物 Frontmatter schema に従います。`rulebook` は本書の ID、`based_on` を使う場合は依存関係に含まれる組織定義など実際の根拠を指定します。
|
|
43
|
+
|
|
44
|
+
## 5. 本文要件
|
|
45
|
+
|
|
46
|
+
骨組みは宣言した template、完成例は sample を正本とし、次を必須とします。
|
|
47
|
+
|
|
48
|
+
- 責任の確認範囲: 対象範囲、省略範囲と理由、採用 Role の参照、兼務・Agent 支援の扱い。
|
|
49
|
+
- 責任配置: 成果物別と判断・プロセス別の二表。各行は一つの `A` と一つ以上の `R` を持ち、`A/R` の兼任は可、`C` / `I` は必要時に記載します。
|
|
50
|
+
- 担当照合: 主担当の識別、Schedule と割り当て先の正本への参照、不一致時の更新先。
|
|
51
|
+
- 責任の継続: 見直しのトリガーと確認対象。
|
|
65
52
|
|
|
66
53
|
## 6. 記述ガイド
|
|
67
54
|
|
|
68
55
|
### 6.1. 適用方針
|
|
69
56
|
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
57
|
+
- 判断基準: 初期スコープと組織定義から、業務の合意、技術の実現・変更、品質の検証・判定を扱う行を確認します。列は必要な採用 Role code とし、省く列は理由を示します。
|
|
58
|
+
- 雛形の `_ROLE_CODE_` は採用 Role に置換して増減する例であり、固定の必須列ではありません。
|
|
59
|
+
- 良い例: 「初期公開を対象とし、業務合意・実装・品質判定を扱う。次期拡張は対象外」と限定し、組織定義を参照する。
|
|
60
|
+
- 悪い例: 「全作業を対象」とだけ書き、未採用 Role を含む列をそのまま使う。
|
|
73
61
|
|
|
74
62
|
### 6.2. 成果物別 RACI
|
|
75
63
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
-
|
|
80
|
-
- 生成ビューは正本と責任が同じ場合に独立行を作りません。
|
|
81
|
-
|
|
82
|
-
- 各行に一つの `A` と一つ以上の `R` があることを確認します。
|
|
64
|
+
- 判断基準: 主要成果物、管理計画、公開対象を責任が同じ単位でまとめます。主担当や `A` が異なる成果物は分け、正本と同じ責任の生成ビューは独立行にしません。
|
|
65
|
+
- 相談・共有の関与がないセルは空欄または `—` とし、表内で統一します。
|
|
66
|
+
- 良い例: 同じ責任配置の管理文書を対象 ID でまとめ、技術担当が主導する設計文書は別行にする。
|
|
67
|
+
- 悪い例: カタログ全体を転記する、または担当の異なる戦略文書まで一括して管理担当の `R` に含める。
|
|
83
68
|
|
|
84
69
|
### 6.3. 判断・プロセス別 RACI
|
|
85
70
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- 当事者価値、費用・負荷、変更、品質例外、公開など最終判断者が異なる対象を分けます。
|
|
90
|
-
- 成果物作成と成果物内容の最終判断を混同しません。
|
|
91
|
-
- 通常の作業手順を網羅せず、責任境界が必要なプロセスだけを置きます。
|
|
71
|
+
- 判断基準: 当事者価値、費用・負荷、変更、品質例外、公開など最終判断者が異なる対象を分けます。成果物行と重なる場合は各 `A` の判断範囲を明記し、業務・技術・品質の確認者・相談先を採用 Role から追跡可能にします。
|
|
72
|
+
- 良い例: 「作成フローの運営」の `A` は順序・進捗を判断し、内容の承認は各成果物行の `A` が行うと区別する。
|
|
73
|
+
- 悪い例: 「成果物作成」の `A` が各成果物の内容も承認すると読める、または品質例外と公開判断を担当の確認なしにまとめる。
|
|
92
74
|
|
|
93
75
|
### 6.4. Schedule・実行主体との対応
|
|
94
76
|
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
-
|
|
77
|
+
- 主担当は対象作業を主導する一つの `R`(`A/R` を含む)です。複数 `R` の行には、作業ごとの主担当 Role code と担当範囲を注記します。
|
|
78
|
+
- 主担当はタスクの action に最も近い `R` とし、一意に決まらなければ責任境界を確認してタスクを分割します。
|
|
79
|
+
- 担当照合は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「Schedule への担当展開」に従います。WBS の明示 `owner` を先に確認し、作成作業と、`A` / `C` を許容する承認・レビュー・外部待ちの別 Task / Milestone を区別します。
|
|
80
|
+
- WBS・Schedule の正本(生成する場合は戦略・設定)と割り当て先を文書 ID で参照します。不一致の原因から、RACI の責任配置かタスク定義の正本か、修正先を明記します。
|
|
81
|
+
- 良い例: 複数 `R` の行に「要件整理は業務担当、構成設計は技術担当」と採用 Role code で注記し、承認タスクは対応する `A` と照合する。
|
|
82
|
+
- 悪い例: 複数 `R` の主担当を注記せず、Schedule に現在入っている `owner` を理由に後付けで選ぶ。
|
|
98
83
|
|
|
99
84
|
### 6.5. 見直し条件
|
|
100
85
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
- スコープ、採用Role code、主要成果物、判断ゲート、Schedule ownerが変わった場合に見直します。
|
|
105
|
-
- 兼務で作業・判断が滞留した場合は、まず責任分担とエスカレーションを見直します。
|
|
106
|
-
- RACIの行追加は、責任衝突を防ぐ必要がある場合だけ行います。
|
|
86
|
+
- 判断基準: スコープ、採用 Role、主要成果物の統合・分割・廃止、判断ゲート、Schedule の担当、兼務の継続可能性の変化から、影響する行・参照・担当を特定します。組織・ロール・メンバー定義、WBS・Schedule、コミュニケーション計画との整合を確認します。
|
|
87
|
+
- 良い例: 品質判定の滞留時に、判断待ちの責任境界と影響タスク、当面の扱いを示し、相談先とエスカレーションを見直す。
|
|
88
|
+
- 悪い例: 「必要時に見直す」とだけ書く、または判断履歴や課題の状態を RACI の行へ蓄積する。
|
|
107
89
|
|
|
108
90
|
## 7. 禁止事項
|
|
109
91
|
|
|
110
|
-
| 禁止事項
|
|
111
|
-
|
|
|
112
|
-
| 成果物カタログ全体や生成ビューを機械的に列挙する
|
|
113
|
-
|
|
|
114
|
-
| `
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
| 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
|
|
92
|
+
| 禁止事項 | 理由 |
|
|
93
|
+
| ----------------------------------------------------- | -------------------------------------- |
|
|
94
|
+
| 成果物カタログ全体や生成ビューを機械的に列挙する | 保守量が増え、主要責任が埋もれる |
|
|
95
|
+
| `A` の欠落・複数配置、`R` の欠落を許す | 最終責任または作業責任が不明になるため |
|
|
96
|
+
| 複数 `R` の担当範囲と主担当を識別不能なままにする | 個別タスクの担当を照合できないため |
|
|
97
|
+
| WBS の優先順やタスク種別を無視して `owner` を変更する | 上位標準と責任配置の対応が失われるため |
|
|
98
|
+
| 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
|
|
@@ -12,34 +12,27 @@ specdojo:
|
|
|
12
12
|
|
|
13
13
|
Risk Register Documentation Rules
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
顕在化前のリスクを評価・対応・監視し、納期や品質への影響を事前に抑えるためのリスク登録簿の記述基準を定める。
|
|
16
16
|
|
|
17
17
|
## 1. 全体方針
|
|
18
18
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- 曖昧表現を避け、対応着手判断が可能な記述にする。
|
|
19
|
+
- リスクごとに、発生確率・影響度から優先度を再現でき、対応に着手するかを判断できる形で残す。
|
|
20
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
22
21
|
|
|
23
|
-
## 2.
|
|
22
|
+
## 2. 位置づけ
|
|
24
23
|
|
|
25
|
-
- `pm-
|
|
26
|
-
-
|
|
27
|
-
- `pm-issue-log
|
|
24
|
+
- プロジェクト登録簿を使うプロジェクトでは、リスク 1 件を `item_type: risk` の個票に書き、`controls/generated/pm-risk-register.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
|
|
25
|
+
- 本書の判断基準は、個票と、登録簿を使わない単独のリスク登録簿の両方に適用する。
|
|
26
|
+
- リスクが顕在化したら `pm-issue-log` 側の課題として、スコープや計画の変更が要るなら `pm-change-request-log` 側の変更要求として起票し、関連ドキュメントで結ぶ。
|
|
28
27
|
|
|
29
28
|
## 3. ファイル命名・ID規則
|
|
30
29
|
|
|
31
|
-
- `id` は `pm-risk-register`
|
|
32
|
-
-
|
|
30
|
+
- `id` は `<project-id>:pm-risk-register`、ファイル名は `pm-risk-register.md` とする。
|
|
31
|
+
- リスク ID は登録簿では `PJR-XXXX`、単独の登録簿では `RK-NNN` とし、再利用しない。
|
|
33
32
|
|
|
34
33
|
## 4. 推奨 Frontmatter 項目
|
|
35
34
|
|
|
36
|
-
|
|
37
|
-
| ---------- | -------------------------------- | ---- |
|
|
38
|
-
| id | `pm-risk-register` | ○ |
|
|
39
|
-
| type | `project` 固定 | ○ |
|
|
40
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
41
|
-
| based_on | 根拠仕様ID(配列) | 任意 |
|
|
42
|
-
| supersedes | 置換関係ID(配列) | 任意 |
|
|
35
|
+
- 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
|
|
43
36
|
|
|
44
37
|
## 5. 本文構成(標準テンプレ)
|
|
45
38
|
|
|
@@ -56,39 +49,39 @@ Risk Register Documentation Rules
|
|
|
56
49
|
|
|
57
50
|
### 6.1. 概要
|
|
58
51
|
|
|
59
|
-
-
|
|
52
|
+
- 管理対象、見直し頻度、記録単位を 1〜3 行で示す。
|
|
60
53
|
|
|
61
54
|
### 6.2. リスク登録簿一覧
|
|
62
55
|
|
|
63
|
-
- リスクID
|
|
64
|
-
|
|
65
|
-
推奨フォーマット(表):
|
|
66
|
-
|
|
67
|
-
| リスクID | 内容 | 発生確率 | 影響度 | 優先度 | 対応策 | 担当 | ステータス |
|
|
68
|
-
| -------- | ---- | -------- | ------ | ------ | ------ | ---- | ---------- |
|
|
56
|
+
- リスクID、内容、発生確率、影響度、優先度、対応策、担当、ステータスを一覧にする。
|
|
57
|
+
- 優先度とステータスは登録簿の `priority`・`item_status` の値を使い、言い換えない。
|
|
69
58
|
|
|
70
59
|
### 6.3. 評価基準
|
|
71
60
|
|
|
72
|
-
-
|
|
61
|
+
- 発生確率と影響度の段階ごとの判定条件と、その組み合わせから優先度を決める対応表を書く。
|
|
62
|
+
- 再評価の条件と、評価を変える判断をする者を書く。
|
|
73
63
|
|
|
74
64
|
### 6.4. 対応計画
|
|
75
65
|
|
|
76
|
-
-
|
|
66
|
+
- 回避・低減・受容・移転のどれを採るかと、具体の対応、期限、完了条件を書く。完了条件は確認の手段と合格の基準で書く。
|
|
67
|
+
- 受容する場合は、受容を判断した者と、許容する残存影響を書く。
|
|
77
68
|
|
|
78
69
|
### 6.5. モニタリング
|
|
79
70
|
|
|
80
|
-
-
|
|
71
|
+
- 監視周期、顕在化を判定するトリガー、状態を更新する契機を書く。
|
|
72
|
+
- 見直しが行われなかったときの連絡先を書く。
|
|
81
73
|
|
|
82
74
|
### 6.6. 関連ドキュメント
|
|
83
75
|
|
|
84
|
-
-
|
|
85
|
-
- 関連がない場合でも `(本書のみ)` を明記する。
|
|
76
|
+
- 根拠、影響を受ける成果物、リスクから起票した課題・変更要求を文書 ID で示す。なければ `(本書のみ)` と書く。
|
|
86
77
|
|
|
87
78
|
## 7. 禁止事項
|
|
88
79
|
|
|
89
|
-
| 禁止事項
|
|
90
|
-
|
|
|
91
|
-
| リスクIDなしで記録する
|
|
92
|
-
| 評価基準なしで優先度を決める
|
|
93
|
-
| 対応責任者を未記載にする
|
|
94
|
-
| モニタリング周期を未定義にする
|
|
80
|
+
| 禁止事項 | 理由 |
|
|
81
|
+
| -------------------------------------------- | -------------------------------- |
|
|
82
|
+
| リスクIDなしで記録する | 追跡不能になるため |
|
|
83
|
+
| 評価基準なしで優先度を決める | 判断が恣意的になるため |
|
|
84
|
+
| 対応責任者を未記載にする | 対応遅延が発生するため |
|
|
85
|
+
| モニタリング周期を未定義にする | 兆候を見落とすため |
|
|
86
|
+
| 顕在化したリスクを課題として起票せず放置する | 対応が課題ログで追跡されないため |
|
|
87
|
+
| 生成された `pm-risk-register.md` を直す | 再生成で修正が失われるため |
|