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
|
@@ -14,22 +14,19 @@ specdojo:
|
|
|
14
14
|
|
|
15
15
|
Project Charter Documentation Rulebook
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
立ち上げ認可、権限委譲、後続判断条件を記録し、関係者が「誰が、何を、どの範囲まで承認したか」を確認できる憲章の記述基準を定める。
|
|
18
18
|
|
|
19
19
|
## 1. 全体方針
|
|
20
20
|
|
|
21
21
|
- 対象は、プロジェクトの存在を正式に認可し、詳細計画の策定と初期準備へ進む権限を委譲するプロジェクト憲章である。
|
|
22
|
-
-
|
|
22
|
+
- 目的は、プロジェクトの目的、認可対象、権限範囲、主要前提、予算枠を、承認責任者が判断できる形で明示することである。
|
|
23
23
|
- 憲章の承認は、本格実行開始、外部公開、主要投資、主要スコープ変更を自動的に承認するものではない。これらは後続の GO / Not GO 判断または変更判断で扱う。
|
|
24
24
|
- 背景、目的、期待効果はプロジェクト概要を根拠に要約し、詳細本文を二重管理しない。
|
|
25
|
-
-
|
|
25
|
+
- 関係者、期待、懸念、必要な合意はステークホルダー登録簿を根拠に要約する。
|
|
26
26
|
- 詳細なスコープ、成功基準、前提・制約、体制、スケジュール、リスク、コミュニケーションは後続文書へ委譲する。
|
|
27
|
+
- **共通の運用**: 役割の割り当て(スポンサーと PO の対応を含む)は適用先のメンバー定義に従い、本文では認可権限を持つ役割を「承認責任者」と呼ぶ。`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
|
|
27
28
|
|
|
28
|
-
## 2.
|
|
29
|
-
|
|
30
|
-
### 2.1. 位置づけ
|
|
31
|
-
|
|
32
|
-
プロジェクト憲章は、プロジェクト概要とステークホルダー登録簿を根拠として、立ち上げ認可と権限委譲を記録する文書である。後続のプロジェクト定義文書とプロジェクト管理文書は、本書の認可対象、権限範囲、未決事項を入力として詳細化する。
|
|
29
|
+
## 2. 位置づけ
|
|
33
30
|
|
|
34
31
|
```mermaid
|
|
35
32
|
flowchart LR
|
|
@@ -50,57 +47,32 @@ flowchart LR
|
|
|
50
47
|
class PCH target
|
|
51
48
|
```
|
|
52
49
|
|
|
53
|
-
### 2.2. 用語定義
|
|
54
|
-
|
|
55
|
-
| 用語 | 定義 |
|
|
56
|
-
| ---------------- | -------------------------------------------------------------------------------- |
|
|
57
|
-
| プロジェクト憲章 | プロジェクトの立ち上げを正式に認可し、詳細計画策定と初期準備の権限を委譲する文書 |
|
|
58
|
-
| 立ち上げ認可 | プロジェクトとして扱い、後続の定義・計画・準備へ進むことを認める判断 |
|
|
59
|
-
| 権限委譲 | PO またはスポンサーが、PM などの実行責任者に付与する意思決定・実行の範囲 |
|
|
60
|
-
| 本格実行開始 | 承認された計画に基づき、主要成果物作成や公開準備を本格的に進める段階 |
|
|
61
|
-
| GO / Not GO 判断 | 本格実行、公開、継続、再計画、中止のいずれへ進むかを判定する判断 |
|
|
62
|
-
| 予算枠 | プロジェクトに許容する費用、外部支出、運用負担、または追加支出を行わない制約 |
|
|
63
|
-
| 証跡 | 承認、判定、変更理由を追跡できる記録。議事録、Issue、Pull Request、決定記録など |
|
|
64
|
-
|
|
65
50
|
## 3. ファイル命名・ID規則
|
|
66
51
|
|
|
67
52
|
### 3.1. 配置(推奨)
|
|
68
53
|
|
|
69
54
|
- `docs/ja/projects/<project-id>/020-project-definition/prj-charter.md` に配置する。
|
|
70
|
-
- 承認議事録、決定記録、変更記録は、実際に管理する文書またはツールへ残し、本文から参照できる状態にする。
|
|
71
|
-
- 公開前提のリポジトリでは、個人名、連絡先、非公開組織情報、秘密情報を本文に含めない。
|
|
72
55
|
|
|
73
56
|
### 3.2. ドキュメントID(推奨)
|
|
74
57
|
|
|
75
58
|
- 推奨: `<project-id>:prj-charter`
|
|
76
59
|
- 例: `prj-0001:prj-charter`
|
|
77
|
-
- ID はプロジェクト内で一意にし、チケット ID と混同しない。
|
|
78
60
|
|
|
79
61
|
### 3.3. ファイル名(推奨)
|
|
80
62
|
|
|
81
63
|
- 推奨: `prj-charter.md`
|
|
82
|
-
- 日本語ファイル名を使う場合も、Frontmatter の `id` は推奨形式で一意にする。
|
|
83
64
|
|
|
84
65
|
## 4. 推奨 Frontmatter 項目
|
|
85
66
|
|
|
86
67
|
### 4.1. 設定内容
|
|
87
68
|
|
|
88
|
-
|
|
89
|
-
| ---------- | ------------------------------------------------------------ | ---- |
|
|
90
|
-
| id | `<project-id>:prj-charter` 形式の文書 ID | ○ |
|
|
91
|
-
| type | `project` | ○ |
|
|
92
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
93
|
-
| rulebook | `specdojo:prj-charter-rulebook` | ○ |
|
|
94
|
-
| based_on | 立ち上げ認可の直接根拠にした概要、ステークホルダー登録簿など | 任意 |
|
|
95
|
-
| supersedes | 置き換えた旧文書 ID | 任意 |
|
|
69
|
+
共通項目・値制約はドキュメントメタ情報標準を正とし、`type` は `project`、`rulebook` は `specdojo:prj-charter-rulebook` とする。
|
|
96
70
|
|
|
97
71
|
### 4.2. 推奨ルール
|
|
98
72
|
|
|
99
73
|
- `based_on` は、認可対象、目的、関係者、権限委譲を判断する直接根拠だけを列挙する。
|
|
100
74
|
- 初版では、原則として `prj-overview` と `prj-stakeholder-register` を中心にする。
|
|
101
75
|
- `pm-plan`、`pm-organization`、詳細スコープ、成功基準などは、憲章承認後に作成または詳細化する文書であり、初版憲章の直接根拠として扱う場合は理由を明記する。
|
|
102
|
-
- 改訂時は `supersedes` に旧文書 ID を設定し、差し替え関係を追跡可能にする。
|
|
103
|
-
- H1 にはプロジェクト名を含め、Frontmatter にはタイトルを重複管理しない。
|
|
104
76
|
|
|
105
77
|
## 5. 本文構成(標準テンプレ)
|
|
106
78
|
|
|
@@ -112,122 +84,76 @@ flowchart LR
|
|
|
112
84
|
| 2 | プロジェクトの目的 | ○ | プロジェクト概要に基づく目的と期待効果の要約、成功基準文書への委譲 |
|
|
113
85
|
| 3 | ハイレベルスコープ | ○ | 認可する対象範囲、対象外、未確定事項。成果物群は成果物カタログへ委譲 |
|
|
114
86
|
| 4 | 初期ステークホルダー | ○ | 初期関係者、関与区分、Role code、認可判断上の責任 |
|
|
115
|
-
| 5 | 権限委譲 | ○ |
|
|
87
|
+
| 5 | 権限委譲 | ○ | 委譲する権限、承認責任者に留保する判断、証跡 |
|
|
116
88
|
| 6 | 主要前提・制約 | ○ | 認可判断に直結する前提、制約、予算枠。全量は前提・制約・依存文書へ委譲 |
|
|
117
89
|
| 7 | 本格実行開始の GO / Not GO 判断 | ○ | 本格実行前に確認する観点と記録先 |
|
|
118
90
|
| 8 | 承認 | ○ | 承認日、承認者、承認対象、証跡リンク |
|
|
119
|
-
| 9 | 未決事項 | 任意 |
|
|
120
|
-
|
|
121
|
-
立ち上げ認可文書であること、委譲する範囲、本格実行開始を承認しないことは、専用の章を設けず H1 直下の冒頭文に書く。
|
|
91
|
+
| 9 | 未決事項 | 任意 | 意思決定が必要な論点、認可や後続判断への影響、当面の扱い |
|
|
122
92
|
|
|
123
93
|
## 6. 記述ガイド
|
|
124
94
|
|
|
125
95
|
### 6.1. 共通
|
|
126
96
|
|
|
127
|
-
- H1
|
|
97
|
+
- H1 にプロジェクト名を含める。直下の冒頭文には、立ち上げ認可の対象、誰にどの権限を委譲するか、承認責任者、本格実行開始・外部公開を承認しないことを 2〜3 文で書く。
|
|
128
98
|
- 立ち上げ認可と権限委譲に集中し、詳細計画や設計の本文を先取りしない。後続文書は根拠として先取りせず、詳細化先として参照する。
|
|
129
99
|
|
|
130
|
-
- 後続文書への参照(`詳細化先` 列や記録先)は、参照先が未作成の間は ID をバッククォートで仮置きし(例: `prj-scope`)、作成後に `[[<project-id>:prj-scope|プロジェクトスコープ]]` のような wikilink へ更新する。
|
|
131
|
-
- 事実、判断、未決事項を分ける。未確定は _TODO_:、_UNDECIDED_:、_ASSUMPTION_: を用いる。
|
|
132
|
-
- 認可しない範囲を明記し、憲章承認と本格実行開始を混同しない。
|
|
133
|
-
|
|
134
|
-
- 公開文書では、公開してよい情報だけを記載し、最終判断と説明責任を人間の PO が担う前提を崩さない。
|
|
135
|
-
|
|
136
100
|
### 6.2. 認可対象
|
|
137
101
|
|
|
138
102
|
- プロジェクト名、プロジェクト ID、認可対象、認可しない範囲、直接根拠、承認責任を表で示す。
|
|
139
103
|
- 認可対象は、原則として立ち上げ、詳細計画策定、初期準備に限定する。
|
|
140
104
|
- 本格実行や公開まで認可する場合は、計画、体制、予算枠、品質条件が確認済みであることを明記する。
|
|
141
|
-
-
|
|
142
|
-
|
|
143
|
-
推奨表:
|
|
144
|
-
|
|
145
|
-
| 項目 | 内容 |
|
|
146
|
-
| --------------- | ---- |
|
|
147
|
-
| プロジェクト名 | |
|
|
148
|
-
| プロジェクト ID | |
|
|
149
|
-
| 認可対象 | |
|
|
150
|
-
| 認可しない範囲 | |
|
|
151
|
-
| 直接根拠 | |
|
|
152
|
-
| 承認責任 | |
|
|
105
|
+
- 表は `項目`・`内容` の 2 列とし、承認に条件が付く場合のみ `認可条件` 行を追加する。承認の記録要件は「承認と未決事項」に従う。
|
|
153
106
|
|
|
154
107
|
### 6.3. プロジェクトの目的
|
|
155
108
|
|
|
156
109
|
- 冒頭は 1〜2 文の要約に留め、背景、必要性、目的の詳細はプロジェクト概要を正として参照する。
|
|
157
|
-
-
|
|
110
|
+
- 期待効果は、承認責任者が承認または保留を判断できる観点に分解する。表は `観点`・`認可判断で確認する期待効果` の 2 列とする。
|
|
158
111
|
- 数値目標、測定方法、中長期指標はプロジェクト概要の期待効果を正とし、憲章では再掲しない。
|
|
159
112
|
- 成功判定の観点と受入条件は成功基準文書を正とし、専用の章を設けず本章から参照する。
|
|
160
113
|
|
|
161
|
-
推奨表:
|
|
162
|
-
|
|
163
|
-
| 観点 | 認可判断で確認する期待効果 |
|
|
164
|
-
| ---- | -------------------------- |
|
|
165
|
-
|
|
166
114
|
### 6.4. ハイレベルスコープ
|
|
167
115
|
|
|
168
116
|
- 立ち上げ時点で認可する大まかな対象範囲だけを示す。
|
|
169
|
-
-
|
|
170
|
-
|
|
171
|
-
- AI Agent の支援範囲、人間の判断責任、公開情報の範囲など、責任境界に関わる事項を含める。
|
|
117
|
+
- `区分`・`内容`・`詳細化先` の 3 列で、`対象`・`対象外`・`未確定` を分ける。対象と対象外はスコープ文書、未確定は未決事項へつなげる。
|
|
118
|
+
- AI Agent を利用するプロジェクトでは、支援対象の活動と委譲範囲を記載する。利用しない場合は記載を要しない。
|
|
172
119
|
- 成果物群の一覧・配置・派生関係と、憲章承認後に作成する文書の一覧は成果物カタログを正とし、専用の章を設けず本章から参照する。
|
|
173
120
|
|
|
174
|
-
推奨表:
|
|
175
|
-
|
|
176
|
-
| 区分 | 内容 | 詳細化先 |
|
|
177
|
-
| ------ | ---- | ----------- |
|
|
178
|
-
| 対象 | | `prj-scope` |
|
|
179
|
-
| 対象外 | | `prj-scope` |
|
|
180
|
-
| 未確定 | | 未決事項 |
|
|
181
|
-
|
|
182
121
|
### 6.5. 初期ステークホルダー
|
|
183
122
|
|
|
184
123
|
- ステークホルダー登録簿のうち、認可判断と権限委譲に関係する主要関係者だけを要約する。
|
|
185
|
-
-
|
|
186
|
-
- AI Agent は支援者として扱い、承認者または説明責任者として扱わない。
|
|
124
|
+
- 関係者 ID、関係者名、関与区分、対応 Role code、認可判断における主な責任を示す。役割の定義や割り当ては再掲しない。
|
|
187
125
|
|
|
188
126
|
### 6.6. 権限委譲
|
|
189
127
|
|
|
190
|
-
-
|
|
191
|
-
-
|
|
192
|
-
- 予算枠、公開可否、ライセンス、主要スコープ変更、GO / Not GO 判断は、PO 承認事項として明示する。
|
|
193
|
-
|
|
194
|
-
推奨表:
|
|
195
|
-
|
|
196
|
-
| 項目 | 決裁者 | 実行責任者 | 協議先 | 証跡 |
|
|
197
|
-
| ------------ | ------ | ---------- | ------ | ---- |
|
|
198
|
-
| 立ち上げ認可 | | | | |
|
|
199
|
-
| 詳細計画策定 | | | | |
|
|
200
|
-
| 本格実行開始 | | | | |
|
|
128
|
+
- `項目`・`決裁者`・`実行責任者`・`協議先`・`証跡` の 5 列で、立ち上げ認可、詳細計画策定、本格実行開始の判断権限を示す。
|
|
129
|
+
- 委譲する権限と、承認責任者に留保する判断を分ける。予算枠、公開可否、ライセンス、主要スコープ変更、GO / Not GO を境界として明示する。
|
|
201
130
|
|
|
202
131
|
### 6.7. 主要前提・制約
|
|
203
132
|
|
|
204
133
|
- 前提・制約の全量は前提・制約・依存関係文書を正とし、認可判断に直結する事項(予算枠、公開適性、人間の判断責任)だけを載せる。
|
|
134
|
+
- 予算枠は、費用・外部支出・運用負担の上限、または追加支出を認めない制約として具体化する。
|
|
205
135
|
- 予算枠が未確定の場合は、未確定であること、追加支出を認めるかどうか、確定タイミングを明記する。
|
|
206
|
-
- 公開文書では秘密情報を含めない制約を明示する。
|
|
207
136
|
|
|
208
137
|
### 6.8. 本格実行開始の GO / Not GO 判断
|
|
209
138
|
|
|
210
|
-
-
|
|
139
|
+
- 本格実行開始、外部公開、主要投資へ進むか、継続・再計画・中止とするかを判断できる観点を定義する。
|
|
211
140
|
- 判断観点には、目的整合、公開適性、予算枠、体制、品質を含める。
|
|
212
|
-
-
|
|
141
|
+
- 観点ごとに確認内容、合格条件、判断結果の記録先を示す。目的整合は概要、体制は組織定義、品質は品質管理計画と照合し、予算枠と公開範囲の条件も確認する。未達条件が残れば開始判断を保留する。
|
|
213
142
|
|
|
214
143
|
### 6.9. 承認と未決事項
|
|
215
144
|
|
|
216
|
-
-
|
|
145
|
+
- 承認履歴は `承認日`・`承認者`・`承認対象`・`証跡リンク` の 4 列を必須とする。版番号は設けない。
|
|
217
146
|
- 証跡リンクには、承認の意思表示と承認対象の文書状態の両方を特定できる記録(決定記録、Pull Request、Issue、議事録など)を記載する。
|
|
218
|
-
-
|
|
219
|
-
-
|
|
220
|
-
- 未決事項には、論点、期限、担当、対応方針を記載し、GO / Not GO 判断までに解消が必要なものを識別できるようにする。
|
|
147
|
+
- Frontmatter の `status` は文書の成熟度、承認履歴はプロジェクトの認可状態を表す独立した軸である。`ready` だけを根拠に正式認可済みとしない。認可状態は承認者・承認日・証跡と認可条件の充足で確認する。
|
|
148
|
+
- 未決事項は論点、認可や GO / Not GO への影響、当面の扱いを記載し、後続判断までに解消が必要な条件を識別する。
|
|
221
149
|
|
|
222
150
|
## 7. 禁止事項
|
|
223
151
|
|
|
224
152
|
| 項目 | 理由 |
|
|
225
153
|
| ---------------------------------------------------- | -------------------------------------------- |
|
|
226
154
|
| 憲章承認を本格実行開始や外部公開の承認と混同する | 立ち上げ認可と後続判断の責任境界が崩れるため |
|
|
227
|
-
| 認可対象または認可しない範囲を記載しない |
|
|
155
|
+
| 認可対象または認可しない範囲を記載しない | 承認責任者が認可範囲を判断できないため |
|
|
228
156
|
| 予算枠または追加支出の扱いを記載しない | 承認判断に必要なコスト境界が不明になるため |
|
|
229
157
|
| 承認者、承認日、証跡が未確定なのに正式認可済みと書く | 説明責任と監査可能性が失われるため |
|
|
230
158
|
| 詳細スコープ、受入条件、設計詳細を憲章に過剰記載する | 後続文書との二重管理を招くため |
|
|
231
|
-
| AI Agent を最終判断者または承認者として扱う | 人間の説明責任と公開判断の前提に反するため |
|
|
232
|
-
| 個人情報、秘密情報、非公開組織情報を記載する | 公開時の情報管理リスクを高めるため |
|
|
233
159
|
| 曖昧語だけで成功基準や GO / Not GO 条件を書く | 判断可能性と再現性が下がるため |
|
|
@@ -17,31 +17,16 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Comparison of Alternatives Documentation Rulebook
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
意思決定の再現性と説明責任を担保します。
|
|
20
|
+
複数案を同じ条件で比較し、採否の根拠と見直し条件を残す基準を定めます。
|
|
22
21
|
|
|
23
22
|
## 1. 全体方針
|
|
24
23
|
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
- 比較レイヤーは対象プロジェクトの課題から定めます。業務運用、解決方式、購入 / 構築、製品、アーキテクチャ、運営・開発戦略など、必要な判断だけを扱います。
|
|
32
|
-
- プロジェクトの業務課題や利用者課題を解く案の比較を優先し、開発戦略や作業管理は、それ自体が明示的な決定対象である場合だけ扱います。
|
|
33
|
-
- 抽象度が異なる判断を一つの文書で扱う場合は、決定 ID を分けて順序を明示します。
|
|
34
|
-
- 標準・方法論と製品・ツールを区別し、製品を標準または唯一の代表とみなす場合は客観的根拠を示します。
|
|
35
|
-
- 外部ツールを扱う場合は、正本、導入時期、試行条件、移行・撤退可能性を比較します。
|
|
36
|
-
- PMBOK 観点では、意思決定記録、リスク比較、制約下でのトレードオフ評価を含めます。
|
|
37
|
-
- 評価軸は固定し、案ごとに評価基準を変えません。
|
|
38
|
-
- 採択案の最終判断は人間の `PO` が行うことを明記する。AI Agent は比較分析の支援を担ってよい。
|
|
39
|
-
- 技術的・方針的な代替案では、実現可能性、外部依存、後続成果物への影響を比較結果に含めます。
|
|
40
|
-
- 公開リポジトリに配置する場合は、個人名、個人連絡先、非公開の組織情報を記載しない。
|
|
41
|
-
|
|
42
|
-
## 2. 位置づけと用語定義
|
|
43
|
-
|
|
44
|
-
### 2.1. 位置づけ(他ドキュメントとの関係)
|
|
24
|
+
- 対象は、業務・利用者の課題を解く技術的・方針的な代替案の比較です。
|
|
25
|
+
- 比較レイヤー(同じ抽象度で比較する判断の単位)ごとに、単独で同じ目的を達成できる一式の案を最低 2 案比較します。
|
|
26
|
+
- 前段文書から課題・制約・必要能力・評価条件を引き継ぎ、外部調査で候補を広げ、検証できる根拠を残します。
|
|
27
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入条件に含めません。
|
|
28
|
+
|
|
29
|
+
## 2. 位置づけ
|
|
45
30
|
|
|
46
31
|
```mermaid
|
|
47
32
|
flowchart LR
|
|
@@ -59,162 +44,88 @@ flowchart LR
|
|
|
59
44
|
class COA target
|
|
60
45
|
```
|
|
61
46
|
|
|
62
|
-
### 2.2. 用語定義(本ルール内)
|
|
63
|
-
|
|
64
|
-
| 用語 | 定義 |
|
|
65
|
-
| ------------ | ----------------------------------------------------------------------------------- |
|
|
66
|
-
| 代替案 | 同一の意思決定を代替でき、単独でも目的達成への道筋を説明できる一式の候補案 |
|
|
67
|
-
| 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など、同じ抽象度で比較する判断の単位 |
|
|
68
|
-
| 候補カテゴリ | 同種の責務・統合範囲を持つ方式をまとめ、具体候補を探索する単位 |
|
|
69
|
-
| 支援方式 | 採択した案を実行するための製品、ツール、台帳、タスク・状態管理など |
|
|
70
|
-
| 正本 | 現在の状態または判断根拠について、最終的に正しいものとして参照する情報源 |
|
|
71
|
-
| 比較試行 | 正式採用前に、入力、評価軸、完了条件を固定して適合性と可逆性を確認する活動 |
|
|
72
|
-
| 評価軸 | 比較に使用する観点(効果、コスト、期間、リスク等) |
|
|
73
|
-
| 評価基準 | 評価軸ごとの判定ルールや配点規則 |
|
|
74
|
-
| 採択案 | 評価結果に基づいて選択した案 |
|
|
75
|
-
| トレードオフ | 採択に伴って受容する不利条件 |
|
|
76
|
-
|
|
77
47
|
## 3. ファイル命名・ID規則
|
|
78
48
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
- 評価根拠となる見積、リスク分析、検証結果を参照リンクで接続します。
|
|
83
|
-
|
|
84
|
-
### 3.2. ドキュメントID(推奨)
|
|
85
|
-
|
|
86
|
-
- 推奨: `<project-id>:prj-comparison-of-alternatives`
|
|
87
|
-
- 例: `prj-0001:prj-comparison-of-alternatives`
|
|
88
|
-
|
|
89
|
-
### 3.3. ファイル名(推奨)
|
|
90
|
-
|
|
91
|
-
- 推奨: `prj-comparison-of-alternatives.md`
|
|
92
|
-
- 日本語ファイル名の場合: `代替案比較.md`
|
|
49
|
+
- 共通の配置・命名は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
50
|
+
- 配置は `docs/ja/projects/<project-id>/020-project-definition/`、ファイル名は `prj-comparison-of-alternatives.md` を推奨します。日本語名は `代替案比較.md` とし、プロジェクト内で統一します。
|
|
51
|
+
- ID は `<project-id>:prj-comparison-of-alternatives` を推奨します。
|
|
93
52
|
|
|
94
53
|
## 4. 推奨 Frontmatter 項目
|
|
95
54
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
-
|
|
99
|
-
- メタ情報標準: [document-metadata-standard.md](../standards/document-metadata-standard.md)
|
|
100
|
-
|
|
101
|
-
| 項目 | 説明 | 必須 |
|
|
102
|
-
| ---------- | ----------------------------------------------------------------------------- | ---- |
|
|
103
|
-
| id | `<project-id>:prj-comparison-of-alternatives` | ○ |
|
|
104
|
-
| type | `project` 固定 | ○ |
|
|
105
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
106
|
-
| rulebook | `specdojo:prj-comparison-of-alternatives-rulebook` | ○ |
|
|
107
|
-
| based_on | 比較判断に直接使用するスコープ、課題と解決アプローチ、前提・制約などの文書 ID | 任意 |
|
|
108
|
-
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
109
|
-
|
|
110
|
-
### 4.2. 推奨ルール
|
|
111
|
-
|
|
112
|
-
- `based_on` は、比較判断に直接使う根拠文書だけを列挙します。
|
|
113
|
-
- 評価軸は固定し、案ごとに評価基準を変えません。
|
|
114
|
-
- 配点や重みを使う場合は、判定への使い方を明示します。
|
|
55
|
+
- 値・構文・必須性は [成果物 Frontmatter スキーマ](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とします。
|
|
56
|
+
- `type` は本書の `deliverable_type` に合わせ、`rulebook` には本書の ID を指定します。
|
|
57
|
+
- `based_on` には、スコープ、課題と解決アプローチ、前提・制約など、比較判断に直接使った文書を指定します。
|
|
115
58
|
|
|
116
|
-
## 5.
|
|
59
|
+
## 5. 本文要件
|
|
117
60
|
|
|
118
|
-
|
|
61
|
+
見出し順・表・記入欄は Frontmatter の template を正本とし、内容の充足条件を以下に定めます。
|
|
119
62
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
| 3 | 評価軸と評価基準 | ○ | レイヤー別の観点、配点、判定基準 |
|
|
125
|
-
| 4 | 比較結果と採択理由 | ○ | 採択、試行、保留、非採択とその理由 |
|
|
126
|
-
| 5 | リスクとトレードオフ | ○ | 採択による不利益、軽減策 |
|
|
127
|
-
| 6 | 決定と見直し | 任意 | 現時点の採択方針、再評価条件 |
|
|
63
|
+
- **比較目的と前提条件・比較対象案(必須)**: 決めること・対象外、候補カテゴリの選定根拠、各案の課題解決への道筋を示します。複数レイヤーでは決定 ID と判断順序も必要です。
|
|
64
|
+
- **評価軸と評価基準・比較結果と採択理由(必須)**: 課題・制約に結び付く判定条件、同一条件での評価と採否の根拠、技術的実現性・外部依存・後続への影響を示します。
|
|
65
|
+
- **リスクとトレードオフ(必須)**: 案ごとの不確実性と受容する不利益を区別し、軽減策と後続作業の対象・完了条件を示します。
|
|
66
|
+
- **決定と見直し(独立章は任意)**: 最終判断者、再評価トリガー、記録先は必須です。独立章がなければ「比較結果と採択理由」へ統合します。
|
|
128
67
|
|
|
129
68
|
## 6. 記述ガイド
|
|
130
69
|
|
|
131
70
|
### 6.1. 共通
|
|
132
71
|
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
- 評価結果には定量情報と定性理由の両方を含めます。
|
|
136
|
-
- 根拠資料は、前段のスコープ、課題と解決アプローチ、前提・制約など、比較判断に直接必要な文書に限定します。
|
|
137
|
-
- 根拠資料との整合は、候補案を前段文書の案に限定することを意味しません。前段文書から課題と評価条件を導き、候補案は外部調査を含めて展開します。
|
|
138
|
-
- 複数の判断を扱う場合は `D-01` などの決定 ID を付け、上位の解決方式から製品・実装方式などへ判断する順序と、各決定で扱わない範囲を示します。
|
|
139
|
-
- 同じ採択理由、非採択理由、見直し条件を複数の章や表に重複記載せず、評価結果に集約します。
|
|
140
|
-
|
|
141
|
-
### 6.2. 比較対象案
|
|
142
|
-
|
|
143
|
-
- 各案は、単独で課題解決への道筋、適用範囲、主要な構成を説明できる一式の解決案にします。
|
|
144
|
-
- 相互に組み合わせる要素を別案として並べず、業務運用を含む解決パッケージとして比較します。
|
|
145
|
-
- 現行案に有利な候補だけで閉じず、現行運用の改善、汎用ツール、既存製品・サービス、個別構築、外部委託など、課題に応じた有力案を含めます。
|
|
146
|
-
- 購入 / 構築を決める比較と、購入製品を選ぶ比較は分けます。上位判断で既存製品の採用可能性が残った場合に、具体製品を別レイヤーで比較します。
|
|
147
|
-
- 開発戦略やタスク管理方式は、業務・システム解決案と分離します。プロジェクト運営そのものが比較目的の場合だけ主レイヤーとして扱います。
|
|
148
|
-
- 具体候補を列挙する前に、非システム対応、汎用ツール、既存製品、個別構築など、比較目的に合う候補カテゴリと選定基準を定義します。
|
|
149
|
-
- 各カテゴリから、公式資料で責務、データ保管、対応環境、移行可能性を確認できる候補を選びます。市場占有率を調べていない場合は「市場を代表する」と断定しません。
|
|
150
|
-
- 現行・内製方式、専用ツールを採用しない案、外部の直接競合を必要に応じて含め、特定製品に有利な候補集合にしません。
|
|
151
|
-
|
|
152
|
-
推奨表(比較対象案):
|
|
153
|
-
|
|
154
|
-
| 案ID | 比較レイヤー | 案 | 目的達成への道筋 | 主な構成要素 | 対象範囲 |
|
|
155
|
-
| ---- | ------------ | --- | ---------------- | ------------ | -------- |
|
|
156
|
-
|
|
157
|
-
推奨表(候補カテゴリ):
|
|
158
|
-
|
|
159
|
-
| 決定ID | 候補カテゴリ | 候補に含める基準 |
|
|
160
|
-
| ------ | ------------ | ---------------- |
|
|
161
|
-
|
|
162
|
-
### 6.3. 評価軸と評価基準
|
|
163
|
-
|
|
164
|
-
- 評価軸は効果、コスト、期間、リスク、運用適合、技術実現性の 6 観点を最低ラインとします。
|
|
165
|
-
|
|
166
|
-
- 観点を省略する場合は省略理由を記載します。
|
|
167
|
-
- 技術実現性は、既存環境、データ移行、外部依存、運用継続、後続成果物への影響を見ます。
|
|
168
|
-
- 不確実性への適応、トレーサビリティ、人間の判断責任、AI Agent の長期作業と検証可能性が判断に影響する場合は、独立した評価軸として追加します。
|
|
169
|
-
- 抽象度が異なる比較レイヤーには同じ評価軸を強制せず、各レイヤー内では候補ごとに同じ軸を使用します。
|
|
170
|
-
- 製品・サービスには、業務適合、データ移行、ロックイン、可逆性、成熟度を必要に応じて追加します。
|
|
171
|
-
|
|
172
|
-
推奨表(評価基準):
|
|
173
|
-
|
|
174
|
-
| 評価軸 | 重み | 判定基準 | 備考 |
|
|
175
|
-
| ------ | ---- | -------- | ---- |
|
|
72
|
+
- 採否の理由と証拠は評価結果に集約し、決定の要約から参照します。見積・リスク分析・検証結果は判断箇所から辿れるようにします。
|
|
73
|
+
- 詳細設計・製品仕様・実装・schema は正本を参照し、比較には採否を左右する差異・制約・影響だけを残します。
|
|
176
74
|
|
|
177
|
-
### 6.
|
|
75
|
+
### 6.2. 比較目的と前提条件
|
|
178
76
|
|
|
179
|
-
-
|
|
180
|
-
-
|
|
181
|
-
-
|
|
182
|
-
-
|
|
183
|
-
- 比較試行は、同じ入力、評価軸、完了条件、記録先、採用・撤退判定を定義し、試行前に特定ツールを標準扱いしません。
|
|
184
|
-
- 外部ツールを採択する場合は、仕様や状態の正本、同期方向、利用停止時の移行方法を明記します。
|
|
77
|
+
- スコープと課題から決めること・対象外を定め、業務運用、解決方式、購入 / 構築、製品などのレイヤーに絞ります。開発戦略や作業管理は明示的な決定対象に限ります。
|
|
78
|
+
- 複数の判断には `D-01` などの決定 ID と判断順序を付けます。前段文書は課題・制約・評価条件の根拠として読みます。
|
|
79
|
+
- **良い例**: 「D-01 で販売記録を継続できる解決方式を選ぶ。製品選定は既存サービス案が残った場合に行い、EC は対象外とする」。
|
|
80
|
+
- **悪い例**: 「使う製品を先に決め、導入理由を比較表にする」。課題と比較範囲を判断できません。
|
|
185
81
|
|
|
186
|
-
|
|
82
|
+
### 6.3. 比較対象案
|
|
187
83
|
|
|
188
|
-
|
|
189
|
-
|
|
84
|
+
- 各案に目的達成への道筋、対象範囲、業務運用を含む主要構成を示します。相互に補完する部品は一式の案にまとめます。
|
|
85
|
+
- 同種の責務・統合範囲で候補カテゴリと選定基準を先に定め、現行運用改善、汎用ツール、既存製品、個別構築、外部委託から有力案を探します。専用ツールを使わない案や外部の直接競合も必要に応じて含めます。
|
|
86
|
+
- 標準・方法論と製品を区別し、公式資料で責務、データ保管、対応環境、移行可能性を確認します。市場代表と呼ぶ場合は客観的根拠を示します。
|
|
87
|
+
- **良い例**: 「紙帳票の統一、共有表計算、既存サービス、個別構築を同じ販売記録の課題で比較する」。
|
|
88
|
+
- **悪い例**: 「画面、データベース、開発ツールを別案にし、すべて採択する」。一つの意思決定を代替していません。
|
|
190
89
|
|
|
191
|
-
|
|
90
|
+
### 6.4. 評価軸と評価基準
|
|
192
91
|
|
|
193
|
-
|
|
194
|
-
|
|
92
|
+
- 最低ラインは **効果、コスト、期間、リスク、業務適合、技術実現性** の 6 観点です。業務適合は利用者の手順・体制への適合、必要に応じて分ける運用・保守性は継続運用の負荷を指します。
|
|
93
|
+
- レイヤーごとに軸を変えても、最低観点の省略には観点名と不要な理由、統合には対応先と判定条件が必要です。別章の説明だけで省略理由を代替できません。
|
|
94
|
+
- 同一レイヤーの全候補に同じ軸・判定境界・評価方向を使用します。
|
|
95
|
+
- 技術実現性は既存環境、移行、外部依存、運用継続、後続成果物への影響から判定します。製品比較ではロックイン・可逆性・成熟度、判断に影響する場合は適応性・追跡性・人間の統制・AI Agent の長期作業と検証可能性を追加します。
|
|
195
96
|
|
|
196
|
-
|
|
97
|
+
評価基準表には次の情報を示します。情報を失わなければ列を統合できます。
|
|
197
98
|
|
|
198
|
-
|
|
|
199
|
-
|
|
|
99
|
+
| 情報 | 記述・判定の基準 |
|
|
100
|
+
| -------------- | -------------------------------------------------------------------- |
|
|
101
|
+
| 評価軸と根拠 | 観点の意味と、対応する課題 ID・制約を示す |
|
|
102
|
+
| 判定基準 | 測定値または観察可能な状態で評価の境界と有利な方向を定める |
|
|
103
|
+
| 重み・集約方法 | 使用時は理由、優先順位か加重計算か、総合評価・採否への反映方法を示す |
|
|
200
104
|
|
|
201
|
-
|
|
105
|
+
- **良い例**: 「期間は 2 週以内の試行開始を High、2 週超 4 週以内を Middle、それ超を Low とする。リスクは継続運用軸へ統合し、通信断時の記録保持で判定する」。
|
|
106
|
+
- **悪い例**: 「不要な軸を削除する」「リスクは別章に書いたので評価しない」。削除の妥当性と全候補への適用を確認できません。
|
|
202
107
|
|
|
203
|
-
|
|
108
|
+
### 6.5. 比較結果と採択理由
|
|
204
109
|
|
|
205
|
-
-
|
|
206
|
-
-
|
|
110
|
+
- 各候補に採択・一部採択・比較試行・保留・非採択などの判定と再評価条件を付けます。結果表は評価軸に対応させ、測定値・定性理由・根拠資料への参照で評価と採否を追跡可能にします。
|
|
111
|
+
- 実現性と影響は決定・案ごとの表で示します。外部ツールは仕様・状態の正本、導入時期、同期方向、停止時の移行・取り出し方法を明示します。
|
|
112
|
+
- 比較試行は正式採用や標準と区別し、同じ入力・範囲・評価軸で行います。測定項目、完了条件、採用・撤退の閾値、記録先を事前に定めます。未確認を確認済みの高評価にせず、仮定と確認作業を分けます。
|
|
113
|
+
- **良い例**: 「ALT-02 は操作検証で 10 件中 2 件の記録漏れがあり、漏れ 0 件の基準を満たさず非採択。入力手順改善後に再試行する」。
|
|
114
|
+
- **悪い例**: 「新しい製品なので High、採択する」。評価条件と証拠がなく再現できません。
|
|
207
115
|
|
|
208
|
-
|
|
116
|
+
### 6.6. リスクとトレードオフ
|
|
209
117
|
|
|
210
|
-
|
|
211
|
-
|
|
118
|
+
- リスクには起きうる事象と軽減策、トレードオフには先送りする範囲・受容する負荷・後続への影響を記し、決定 ID・案 ID または全候補共通で対象を特定します。
|
|
119
|
+
- 後続作業となる軽減策には担当、依存作業・成果物、完了条件を示します。計画書・台帳名は実在を確認し、詳細設計は後続成果物へ委譲します。
|
|
120
|
+
- **良い例**: 「ALT-04 の残高移行漏れを抑えるため、移行後に `QE` が元ノートとの全件照合を行い、差分 0 件を受入条件とする」。
|
|
121
|
+
- **悪い例**: 「移行には注意する」。対象、実施者、完了条件がなく計画へ渡せません。
|
|
212
122
|
|
|
213
|
-
### 6.
|
|
123
|
+
### 6.7. 決定と見直し
|
|
214
124
|
|
|
215
|
-
-
|
|
216
|
-
-
|
|
217
|
-
-
|
|
125
|
+
- 採択・試行・保留は決定 ID ごとに要約し、最終判断者を示します。再評価トリガーは期間・測定値・制約や依存の変化で定め、特定製品の自動採用条件にしません。
|
|
126
|
+
- 方針変更の理由、評価結果、影響範囲、移行・撤退方法を記録先から辿れるようにします。未決の比較条件には論点と採否・後続作業への影響を示します。
|
|
127
|
+
- **良い例**: 「ALT-04 を採択。2 週間の試行で記録継続が営業日の 90% 未満なら再比較し、判断理由を決定記録へ残す」。
|
|
128
|
+
- **悪い例**: 「必要に応じて採用ツールを変更する」。再評価条件を判断できません。
|
|
218
129
|
|
|
219
130
|
## 7. 禁止事項
|
|
220
131
|
|
|
@@ -231,6 +142,3 @@ flowchart LR
|
|
|
231
142
|
| 前段文書の候補案を名称変更して再掲するだけで外部案を調査しない | 結論の追認となり、有力な代替手段を見落とすため |
|
|
232
143
|
| 評価軸なしの採択結論 | 判断根拠が不透明になるため |
|
|
233
144
|
| 非採択理由の未記載 | 将来再評価時に経緯追跡できないため |
|
|
234
|
-
| 根拠資料リンクなし | 説明責任を果たせないため |
|
|
235
|
-
| Agent に採択案の最終判断を委ねる | 人間の判断責任を代替してしまうため |
|
|
236
|
-
| 公開リポジトリに個人名・個人連絡先・非公開の組織情報を記載する | 公開範囲とプライバシーに反するため |
|