specdojo 0.8.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +4 -1
- package/CHANGELOG.md +77 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/orchestrator.js +5 -77
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/shared.js +2 -2
- package/dist/dashboard/timeline.js +14 -14
- package/dist/deliverable/trash.js +2 -1
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/opencode-permissions.js +117 -0
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +82 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/repo-trace.js +2 -1
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +5 -2
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +2 -2
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-repos.js +19 -4
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +12 -2
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/register/renumber.js +1 -3
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +17 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +258 -118
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -17,21 +17,17 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Assumptions, Constraints and Dependencies Documentation Rulebook
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
プロジェクトの成立条件、守るべき限界、外部・先行成果物への依存を整理し、変化時の影響と対応の判断基準を定める。
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
- 各項目は、条件だけで終わらせず、影響、確認方法、変化または逸脱のトリガー、所有者、対応方針を一組で記載する。
|
|
24
|
+
- 各項目には影響・確認方法・トリガー・所有者・対応方針を記載する。
|
|
26
25
|
- 前提は「成立するものとして置く条件」、制約は「守るべき限界」、依存関係は「他者・外部サービス・先行成果物などから受ける条件」として分離する。
|
|
27
|
-
-
|
|
28
|
-
- 上位文書がすでに継続的な監視・記録先を持つ事項(判断ゲートの記録先が明示された章など)は、内容を要約して再登録せず参照にとどめる。上位文書が結論だけを示し継続監視の仕組みを持たない場合は、監視方法・トリガー・所有者・対応方針を付与して運用可能な形に展開してよいが、その場合は展開元の上位文書と章を明示する。
|
|
26
|
+
- 上位文書で確定済みの対象外・境界・責務や、継続監視・記録先を持つ事項は再登録せず、該当章の冒頭で正本へ委譲する。結論だけで監視の仕組みがない条件は、展開元の文書・章を示し、確認方法・トリガー・所有者・対応方針を補って登録できる。委譲先に条件が実在することを確認する。
|
|
29
27
|
- 文書は計画・設計・実装の詳細やリスク登録簿を代替しない。必要な詳細はそれぞれの成果物に委譲する。
|
|
30
|
-
-
|
|
28
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
|
|
31
29
|
|
|
32
|
-
## 2.
|
|
33
|
-
|
|
34
|
-
### 2.1. 位置づけ
|
|
30
|
+
## 2. 位置づけ
|
|
35
31
|
|
|
36
32
|
```mermaid
|
|
37
33
|
flowchart LR
|
|
@@ -46,26 +42,19 @@ flowchart LR
|
|
|
46
42
|
class ACD target
|
|
47
43
|
```
|
|
48
44
|
|
|
49
|
-
### 2.2. 用語定義
|
|
50
|
-
|
|
51
|
-
| 用語 | 定義 |
|
|
52
|
-
| -------- | -------------------------------------------------------------------------- |
|
|
53
|
-
| トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
|
|
54
|
-
| 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
|
|
55
|
-
|
|
56
45
|
## 3. ファイル命名・ID規則
|
|
57
46
|
|
|
58
47
|
### 3.1. 成果物の配置と文書 ID
|
|
59
48
|
|
|
60
49
|
- 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
|
|
61
50
|
- 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
|
|
62
|
-
- 文書 ID
|
|
51
|
+
- 文書 ID と項目 ID は区別し、別文書からの行参照には両者を使う。
|
|
63
52
|
|
|
64
53
|
### 3.2. 項目 ID
|
|
65
54
|
|
|
66
|
-
-
|
|
55
|
+
- 項目 ID は前提条件 `ACD-A01`、制約事項 `ACD-C01`、依存関係 `ACD-D01` から種別ごとに既採番の最大値に続ける。整数部は 2 桁未満をゼロ埋めし、100 件目以降は桁を増やす。
|
|
67
56
|
- 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
|
|
68
|
-
-
|
|
57
|
+
- 種別変更は旧項目を廃止して新規採番し、変更記録に新旧 ID と理由を残す。
|
|
69
58
|
|
|
70
59
|
## 4. 推奨 Frontmatter 項目
|
|
71
60
|
|
|
@@ -89,10 +78,8 @@ flowchart LR
|
|
|
89
78
|
|
|
90
79
|
### 6.1. 前提条件
|
|
91
80
|
|
|
92
|
-
- 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
|
|
93
81
|
- 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
|
|
94
|
-
-
|
|
95
|
-
- スコープで定義済みの境界に該当する前提は、章冒頭でスコープの該当章へ委譲する。委譲先に条件が実在することを確認し、参照だけで未定義の条件を補ったことにしない。
|
|
82
|
+
- 仮置きの前提には `_ASSUMPTION_`、根拠の確認待ちには `_TODO_` を付け、確認先を残す。
|
|
96
83
|
- リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
|
|
97
84
|
|
|
98
85
|
良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
|
|
@@ -104,10 +91,8 @@ flowchart LR
|
|
|
104
91
|
|
|
105
92
|
### 6.2. 制約事項
|
|
106
93
|
|
|
107
|
-
- 制約には、適用範囲と、逸脱したと判断する条件を記載する。
|
|
108
94
|
- 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
|
|
109
95
|
- 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
|
|
110
|
-
- スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、追加の運用制約、または「全体方針」に従って監視・対応を補う制約を扱う。
|
|
111
96
|
|
|
112
97
|
良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
|
|
113
98
|
|
|
@@ -121,8 +106,7 @@ flowchart LR
|
|
|
121
106
|
- 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
|
|
122
107
|
- 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
|
|
123
108
|
- 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
|
|
124
|
-
-
|
|
125
|
-
- 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
|
|
109
|
+
- 意思決定待ちの依存には `_UNDECIDED_` を付け、論点、不成立時の影響、当面の扱いを示す。
|
|
126
110
|
- 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
|
|
127
111
|
|
|
128
112
|
良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
|
|
@@ -138,9 +122,9 @@ flowchart LR
|
|
|
138
122
|
|
|
139
123
|
- 影響は、スコープ、期日、費用、品質、公開適性、運用責任など、該当する領域を具体的に示す。
|
|
140
124
|
- 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
|
|
141
|
-
-
|
|
125
|
+
- 所有者は状態確認と一次対応を担う者とし、最終判断者と判断を求める範囲を区別する。
|
|
142
126
|
|
|
143
|
-
良い例:
|
|
127
|
+
良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、順序・期日の変更案を判断者へ提示して開始可否を確認する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
|
|
144
128
|
|
|
145
129
|
推奨表:
|
|
146
130
|
|
|
@@ -150,12 +134,10 @@ flowchart LR
|
|
|
150
134
|
### 6.5. 監視・変更管理
|
|
151
135
|
|
|
152
136
|
- 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
|
|
153
|
-
- 変更記録には、項目 ID
|
|
154
|
-
-
|
|
155
|
-
- 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
|
|
156
|
-
- 改訂・廃止時の共通手順は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。本系統では PM が計画・Schedule・PJR の追従作業を管理し、ARC が参照と技術制約、QE が受入条件・検証への影響を確認する。
|
|
137
|
+
- 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。
|
|
138
|
+
- 条件の変化が影響するスコープ・計画・Schedule・受入条件を特定し、変更記録と追従作業を項目 ID で結ぶ。
|
|
157
139
|
|
|
158
|
-
良い例:
|
|
140
|
+
良い例: 「端末の利用不能を検知したら、対象 ID と影響作業、代替策、再確認時期を変更記録に残す。復旧確認を Schedule の試用開始の先行作業にする」と書く。悪い例: 「必要に応じて更新する」とだけ書き、追従対象を示さない。
|
|
159
141
|
|
|
160
142
|
## 7. 禁止事項
|
|
161
143
|
|
|
@@ -164,7 +146,4 @@ flowchart LR
|
|
|
164
146
|
| スコープ等の上位文書の決定事項を行として再掲する | 正本との二重管理になり、更新漏れと矛盾を招く。 |
|
|
165
147
|
| 前提・制約・依存を種別なしに混在させる | 条件の性質と対応方法を区別できない。 |
|
|
166
148
|
| 影響、トリガー、所有者、対応方針のない登録 | 変化時に判断・対応へ使えない。 |
|
|
167
|
-
|
|
|
168
|
-
| Agent に最終判断、承認、公開可否を委ねる | 人間の判断責任を代替してしまう。 |
|
|
169
|
-
| API、DB、契約書全文などの詳細を記載する | 本書の責務を越え、詳細成果物と重複する。 |
|
|
170
|
-
| 個人情報、非公開情報、機密情報を記載する | 公開・再利用の前提を損なう。 |
|
|
149
|
+
| 部分決定だけで依存全体を成立済みとする | 未成立の条件に依存する作業を開始してしまう。 |
|
|
@@ -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,18 +17,16 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Comparison of Alternatives Documentation Rulebook
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
複数案を同じ条件で比較し、採否の根拠と見直し条件を残す基準を定めます。
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
24
|
+
- 対象は、業務・利用者の課題を解く技術的・方針的な代替案の比較です。
|
|
25
|
+
- 比較レイヤー(同じ抽象度で比較する判断の単位)ごとに、単独で同じ目的を達成できる一式の案を最低 2 案比較します。
|
|
26
|
+
- 前段文書から課題・制約・必要能力・評価条件を引き継ぎ、外部調査で候補を広げ、検証できる根拠を残します。
|
|
27
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入条件に含めません。
|
|
28
28
|
|
|
29
|
-
## 2.
|
|
30
|
-
|
|
31
|
-
### 2.1. 位置づけ(他ドキュメントとの関係)
|
|
29
|
+
## 2. 位置づけ
|
|
32
30
|
|
|
33
31
|
```mermaid
|
|
34
32
|
flowchart LR
|
|
@@ -46,101 +44,88 @@ flowchart LR
|
|
|
46
44
|
class COA target
|
|
47
45
|
```
|
|
48
46
|
|
|
49
|
-
### 2.2. 用語定義(本ルール内)
|
|
50
|
-
|
|
51
|
-
| 用語 | 定義 |
|
|
52
|
-
| ------------ | ----------------------------------------------------------------------------------- |
|
|
53
|
-
| 代替案 | 同一の意思決定を代替でき、単独でも目的達成への道筋を説明できる一式の候補案 |
|
|
54
|
-
| 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など、同じ抽象度で比較する判断の単位 |
|
|
55
|
-
| 候補カテゴリ | 同種の責務・統合範囲を持つ方式をまとめ、具体候補を探索する単位 |
|
|
56
|
-
| 正本 | 現在の状態または判断根拠について、最終的に正しいものとして参照する情報源 |
|
|
57
|
-
| 比較試行 | 正式採用前に、入力、評価軸、完了条件を固定して適合性と可逆性を確認する活動 |
|
|
58
|
-
| トレードオフ | 採択に伴って受容する不利条件 |
|
|
59
|
-
|
|
60
47
|
## 3. ファイル命名・ID規則
|
|
61
48
|
|
|
62
49
|
- 共通の配置・命名は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
63
|
-
- 配置は `docs/ja/projects/<project-id>/020-project-definition/`、ファイル名は `prj-comparison-of-alternatives.md`
|
|
64
|
-
- ID は `<project-id>:prj-comparison-of-alternatives`
|
|
50
|
+
- 配置は `docs/ja/projects/<project-id>/020-project-definition/`、ファイル名は `prj-comparison-of-alternatives.md` を推奨します。日本語名は `代替案比較.md` とし、プロジェクト内で統一します。
|
|
51
|
+
- ID は `<project-id>:prj-comparison-of-alternatives` を推奨します。
|
|
65
52
|
|
|
66
53
|
## 4. 推奨 Frontmatter 項目
|
|
67
54
|
|
|
68
|
-
-
|
|
55
|
+
- 値・構文・必須性は [成果物 Frontmatter スキーマ](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とします。
|
|
69
56
|
- `type` は本書の `deliverable_type` に合わせ、`rulebook` には本書の ID を指定します。
|
|
70
|
-
- `based_on`
|
|
57
|
+
- `based_on` には、スコープ、課題と解決アプローチ、前提・制約など、比較判断に直接使った文書を指定します。
|
|
71
58
|
|
|
72
59
|
## 5. 本文要件
|
|
73
60
|
|
|
74
|
-
|
|
61
|
+
見出し順・表・記入欄は Frontmatter の template を正本とし、内容の充足条件を以下に定めます。
|
|
75
62
|
|
|
76
|
-
- **比較目的と前提条件・比較対象案(必須)**:
|
|
77
|
-
- **評価軸と評価基準・比較結果と採択理由(必須)**:
|
|
78
|
-
- **リスクとトレードオフ(必須)**:
|
|
79
|
-
- **決定と見直し(独立章は任意)**:
|
|
63
|
+
- **比較目的と前提条件・比較対象案(必須)**: 決めること・対象外、候補カテゴリの選定根拠、各案の課題解決への道筋を示します。複数レイヤーでは決定 ID と判断順序も必要です。
|
|
64
|
+
- **評価軸と評価基準・比較結果と採択理由(必須)**: 課題・制約に結び付く判定条件、同一条件での評価と採否の根拠、技術的実現性・外部依存・後続への影響を示します。
|
|
65
|
+
- **リスクとトレードオフ(必須)**: 案ごとの不確実性と受容する不利益を区別し、軽減策と後続作業の対象・完了条件を示します。
|
|
66
|
+
- **決定と見直し(独立章は任意)**: 最終判断者、再評価トリガー、記録先は必須です。独立章がなければ「比較結果と採択理由」へ統合します。
|
|
80
67
|
|
|
81
68
|
## 6. 記述ガイド
|
|
82
69
|
|
|
83
70
|
### 6.1. 共通
|
|
84
71
|
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
- 実装、schema、リファレンスが定める値・構文・データ構造は正本への参照で示し、比較には採否を左右する差異・制約・影響だけを残します。
|
|
72
|
+
- 採否の理由と証拠は評価結果に集約し、決定の要約から参照します。見積・リスク分析・検証結果は判断箇所から辿れるようにします。
|
|
73
|
+
- 詳細設計・製品仕様・実装・schema は正本を参照し、比較には採否を左右する差異・制約・影響だけを残します。
|
|
88
74
|
|
|
89
75
|
### 6.2. 比較目的と前提条件
|
|
90
76
|
|
|
91
|
-
-
|
|
92
|
-
- 複数の判断には `D-01` などの決定 ID
|
|
77
|
+
- スコープと課題から決めること・対象外を定め、業務運用、解決方式、購入 / 構築、製品などのレイヤーに絞ります。開発戦略や作業管理は明示的な決定対象に限ります。
|
|
78
|
+
- 複数の判断には `D-01` などの決定 ID と判断順序を付けます。前段文書は課題・制約・評価条件の根拠として読みます。
|
|
93
79
|
- **良い例**: 「D-01 で販売記録を継続できる解決方式を選ぶ。製品選定は既存サービス案が残った場合に行い、EC は対象外とする」。
|
|
94
80
|
- **悪い例**: 「使う製品を先に決め、導入理由を比較表にする」。課題と比較範囲を判断できません。
|
|
95
81
|
|
|
96
82
|
### 6.3. 比較対象案
|
|
97
83
|
|
|
98
|
-
-
|
|
99
|
-
-
|
|
84
|
+
- 各案に目的達成への道筋、対象範囲、業務運用を含む主要構成を示します。相互に補完する部品は一式の案にまとめます。
|
|
85
|
+
- 同種の責務・統合範囲で候補カテゴリと選定基準を先に定め、現行運用改善、汎用ツール、既存製品、個別構築、外部委託から有力案を探します。専用ツールを使わない案や外部の直接競合も必要に応じて含めます。
|
|
100
86
|
- 標準・方法論と製品を区別し、公式資料で責務、データ保管、対応環境、移行可能性を確認します。市場代表と呼ぶ場合は客観的根拠を示します。
|
|
101
87
|
- **良い例**: 「紙帳票の統一、共有表計算、既存サービス、個別構築を同じ販売記録の課題で比較する」。
|
|
102
88
|
- **悪い例**: 「画面、データベース、開発ツールを別案にし、すべて採択する」。一つの意思決定を代替していません。
|
|
103
89
|
|
|
104
90
|
### 6.4. 評価軸と評価基準
|
|
105
91
|
|
|
106
|
-
- 最低ラインは **効果、コスト、期間、リスク、業務適合、技術実現性** の 6
|
|
107
|
-
-
|
|
108
|
-
-
|
|
92
|
+
- 最低ラインは **効果、コスト、期間、リスク、業務適合、技術実現性** の 6 観点です。業務適合は利用者の手順・体制への適合、必要に応じて分ける運用・保守性は継続運用の負荷を指します。
|
|
93
|
+
- レイヤーごとに軸を変えても、最低観点の省略には観点名と不要な理由、統合には対応先と判定条件が必要です。別章の説明だけで省略理由を代替できません。
|
|
94
|
+
- 同一レイヤーの全候補に同じ軸・判定境界・評価方向を使用します。
|
|
109
95
|
- 技術実現性は既存環境、移行、外部依存、運用継続、後続成果物への影響から判定します。製品比較ではロックイン・可逆性・成熟度、判断に影響する場合は適応性・追跡性・人間の統制・AI Agent の長期作業と検証可能性を追加します。
|
|
110
96
|
|
|
111
|
-
|
|
97
|
+
評価基準表には次の情報を示します。情報を失わなければ列を統合できます。
|
|
112
98
|
|
|
113
|
-
| 情報 | 記述・判定の基準
|
|
114
|
-
| -------------- |
|
|
115
|
-
| 評価軸と根拠 | 観点の意味と、対応する課題 ID・制約を示す
|
|
116
|
-
| 判定基準 | 測定値または観察可能な状態で評価の境界と有利な方向を定める
|
|
117
|
-
| 重み・集約方法 |
|
|
99
|
+
| 情報 | 記述・判定の基準 |
|
|
100
|
+
| -------------- | -------------------------------------------------------------------- |
|
|
101
|
+
| 評価軸と根拠 | 観点の意味と、対応する課題 ID・制約を示す |
|
|
102
|
+
| 判定基準 | 測定値または観察可能な状態で評価の境界と有利な方向を定める |
|
|
103
|
+
| 重み・集約方法 | 使用時は理由、優先順位か加重計算か、総合評価・採否への反映方法を示す |
|
|
118
104
|
|
|
119
105
|
- **良い例**: 「期間は 2 週以内の試行開始を High、2 週超 4 週以内を Middle、それ超を Low とする。リスクは継続運用軸へ統合し、通信断時の記録保持で判定する」。
|
|
120
106
|
- **悪い例**: 「不要な軸を削除する」「リスクは別章に書いたので評価しない」。削除の妥当性と全候補への適用を確認できません。
|
|
121
107
|
|
|
122
108
|
### 6.5. 比較結果と採択理由
|
|
123
109
|
|
|
124
|
-
-
|
|
125
|
-
-
|
|
126
|
-
-
|
|
110
|
+
- 各候補に採択・一部採択・比較試行・保留・非採択などの判定と再評価条件を付けます。結果表は評価軸に対応させ、測定値・定性理由・根拠資料への参照で評価と採否を追跡可能にします。
|
|
111
|
+
- 実現性と影響は決定・案ごとの表で示します。外部ツールは仕様・状態の正本、導入時期、同期方向、停止時の移行・取り出し方法を明示します。
|
|
112
|
+
- 比較試行は正式採用や標準と区別し、同じ入力・範囲・評価軸で行います。測定項目、完了条件、採用・撤退の閾値、記録先を事前に定めます。未確認を確認済みの高評価にせず、仮定と確認作業を分けます。
|
|
127
113
|
- **良い例**: 「ALT-02 は操作検証で 10 件中 2 件の記録漏れがあり、漏れ 0 件の基準を満たさず非採択。入力手順改善後に再試行する」。
|
|
128
114
|
- **悪い例**: 「新しい製品なので High、採択する」。評価条件と証拠がなく再現できません。
|
|
129
115
|
|
|
130
116
|
### 6.6. リスクとトレードオフ
|
|
131
117
|
|
|
132
|
-
-
|
|
133
|
-
-
|
|
118
|
+
- リスクには起きうる事象と軽減策、トレードオフには先送りする範囲・受容する負荷・後続への影響を記し、決定 ID・案 ID または全候補共通で対象を特定します。
|
|
119
|
+
- 後続作業となる軽減策には担当、依存作業・成果物、完了条件を示します。計画書・台帳名は実在を確認し、詳細設計は後続成果物へ委譲します。
|
|
134
120
|
- **良い例**: 「ALT-04 の残高移行漏れを抑えるため、移行後に `QE` が元ノートとの全件照合を行い、差分 0 件を受入条件とする」。
|
|
135
121
|
- **悪い例**: 「移行には注意する」。対象、実施者、完了条件がなく計画へ渡せません。
|
|
136
122
|
|
|
137
123
|
### 6.7. 決定と見直し
|
|
138
124
|
|
|
139
|
-
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
143
|
-
- **悪い例**: 「Agent が必要に応じて採用ツールを変更する」。再評価条件と人間の判断責任が不明です。
|
|
125
|
+
- 採択・試行・保留は決定 ID ごとに要約し、最終判断者を示します。再評価トリガーは期間・測定値・制約や依存の変化で定め、特定製品の自動採用条件にしません。
|
|
126
|
+
- 方針変更の理由、評価結果、影響範囲、移行・撤退方法を記録先から辿れるようにします。未決の比較条件には論点と採否・後続作業への影響を示します。
|
|
127
|
+
- **良い例**: 「ALT-04 を採択。2 週間の試行で記録継続が営業日の 90% 未満なら再比較し、判断理由を決定記録へ残す」。
|
|
128
|
+
- **悪い例**: 「必要に応じて採用ツールを変更する」。再評価条件を判断できません。
|
|
144
129
|
|
|
145
130
|
## 7. 禁止事項
|
|
146
131
|
|
|
@@ -157,6 +142,3 @@ flowchart LR
|
|
|
157
142
|
| 前段文書の候補案を名称変更して再掲するだけで外部案を調査しない | 結論の追認となり、有力な代替手段を見落とすため |
|
|
158
143
|
| 評価軸なしの採択結論 | 判断根拠が不透明になるため |
|
|
159
144
|
| 非採択理由の未記載 | 将来再評価時に経緯追跡できないため |
|
|
160
|
-
| 根拠資料リンクなし | 説明責任を果たせないため |
|
|
161
|
-
| Agent に採択案の最終判断を委ねる | 人間の判断責任を代替してしまうため |
|
|
162
|
-
| 公開リポジトリに個人名・個人連絡先・非公開の組織情報を記載する | 公開範囲とプライバシーに反するため |
|