specdojo 0.7.0 → 0.8.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 +3 -2
- package/CHANGELOG.md +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- 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 +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -25
- 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/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- 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 +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- 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 +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- 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 +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +43 -9
- 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 +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- 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 +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- 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.js +142 -15
- package/dist/shared/grade-result.js +17 -1
- 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 +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -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 +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- 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 +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- 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 +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- 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/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +79 -64
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- 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 +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -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/cdsd-sample.md +89 -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 +132 -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/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-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/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -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 +164 -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/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/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 +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -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/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -16,102 +16,87 @@ 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
|
+
- 共通の用語・担当展開規則は上位標準を正本とし、本書では RACI 固有の判断基準を定めます。実装・schema・リファレンスが定める値・構文・構造は再掲しません。
|
|
29
27
|
|
|
30
28
|
## 2. 位置づけと用語定義
|
|
31
29
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
| A | Accountable | 最終責任を持ち、承認または判断する |
|
|
36
|
-
| C | Consulted | 作業前・判断前に相談または確認する |
|
|
37
|
-
| I | Informed | 結果または変更の共有を受ける |
|
|
30
|
+
`R` / `A` / `C` / `I`、Role、Member、Task owner の意味は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。主担当とは、対象作業を主導する一つの `R` の Role code です。行に複数の `R` がある場合の識別方法は「Schedule・実行主体との対応」で定めます。
|
|
31
|
+
|
|
32
|
+
採用 Role は組織定義、Role code と責務はロール定義、実行主体・兼務はメンバー定義を正本とします。RACI は責任配置、Schedule は個別タスクの `owner` を管理し、人物・Agent の一覧や成果物カタログを複製しません。
|
|
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
|
+
見出し順・表・記入欄の骨組みは Frontmatter で宣言した 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 に置換して必要数に増減します。固定の 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` が一つならその Role を主担当とし、`A/R` も `R` として扱います。
|
|
78
|
+
- 複数 `R` の行は、行に付随する注記で対象作業ごとに一つの主担当 Role code と担当範囲を明記します。
|
|
79
|
+
- 主担当は Schedule タスクの action フィールドが表す作業に最も近い `R` とし、一意に決められない場合は責任境界を確認してタスクを分割します。
|
|
80
|
+
- Schedule の `owner` の優先順と例外は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「Schedule への担当展開」に従います。照合時は WBS の明示 `owner` を先に確認し、作成作業の主担当と、承認・レビュー・外部待ちの別 Task / Milestone を区別します。後者では対象に応じた `A` / `C` を許容し、全タスクを `R` へ一律に合わせません。
|
|
81
|
+
- 対応する WBS・Schedule または生成元の戦略・設定と、実行主体を割り当てる正本を文書 ID で参照します。不一致は上位標準と対象作業から原因を判断し、RACI の責任配置かタスク定義の正本か、修正先を明記します。生成ビューは直接更新しません。
|
|
82
|
+
- 良い例: 複数 `R` の行に「要件整理は業務担当、構成設計は技術担当」と採用 Role code で注記し、承認タスクは対応する `A` と照合する。
|
|
83
|
+
- 悪い例: 複数 `R` の主担当を注記せず、Schedule に現在入っている `owner` を理由に後付けで選ぶ。
|
|
98
84
|
|
|
99
85
|
### 6.5. 見直し条件
|
|
100
86
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
-
|
|
105
|
-
- 兼務で作業・判断が滞留した場合は、まず責任分担とエスカレーションを見直します。
|
|
106
|
-
- RACIの行追加は、責任衝突を防ぐ必要がある場合だけ行います。
|
|
87
|
+
- 判断基準: スコープ、採用 Role、主要成果物の統合・分割・廃止、判断ゲート、Schedule の担当、兼務の継続可能性の変化をトリガーとし、影響する行・参照・担当を特定します。
|
|
88
|
+
- 改訂・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM 責務を担う採用 Role は、RACI と組織・ロール・メンバー定義、WBS・Schedule、コミュニケーション計画への波及を確認し、更新タスクと担当を管理します。
|
|
89
|
+
- 良い例: 品質判定の滞留を契機に、相談先とエスカレーションを見直し、課題・リスク・変更要求・決定は種別に応じたプロジェクト登録簿(PJR)等の管理記録へ担当 Role と参照を付けて引き継ぐ。
|
|
90
|
+
- 悪い例: 「必要時に見直す」とだけ書く、または判断履歴や課題の状態を RACI の行へ蓄積する。
|
|
107
91
|
|
|
108
92
|
## 7. 禁止事項
|
|
109
93
|
|
|
110
|
-
| 禁止事項
|
|
111
|
-
|
|
|
112
|
-
| 成果物カタログ全体や生成ビューを機械的に列挙する
|
|
113
|
-
| 未採用Role
|
|
114
|
-
| `A
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
94
|
+
| 禁止事項 | 理由 |
|
|
95
|
+
| ----------------------------------------------------- | -------------------------------------- |
|
|
96
|
+
| 成果物カタログ全体や生成ビューを機械的に列挙する | 保守量が増え、主要責任が埋もれる |
|
|
97
|
+
| 未採用 Role、Member、人名、Agent 名を列に使う | 正本と責任語彙が一致しないため |
|
|
98
|
+
| `A` の欠落・複数配置、`R` の欠落を許す | 最終責任または作業責任が不明になるため |
|
|
99
|
+
| 複数 `R` の担当範囲と主担当を識別不能なままにする | 個別タスクの担当を照合できないため |
|
|
100
|
+
| Agent に `A` を割り当てる | 人間の説明責任を代替するため |
|
|
101
|
+
| WBS の優先順やタスク種別を無視して `owner` を変更する | 上位標準と責任配置の対応が失われるため |
|
|
102
|
+
| 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
|
|
@@ -28,14 +28,14 @@ Risk Register Documentation Rules
|
|
|
28
28
|
|
|
29
29
|
## 3. ファイル命名・ID規則
|
|
30
30
|
|
|
31
|
-
- `id` は
|
|
31
|
+
- `id` は `<project-id>:pm-risk-register` を使用する。
|
|
32
32
|
- ファイル名は `pm-risk-register-リスク登録簿.md` など一意にする。
|
|
33
33
|
|
|
34
34
|
## 4. 推奨 Frontmatter 項目
|
|
35
35
|
|
|
36
36
|
| 項目 | 説明 | 必須 |
|
|
37
37
|
| ---------- | -------------------------------- | ---- |
|
|
38
|
-
| id |
|
|
38
|
+
| id | `<project-id>:pm-risk-register` | ○ |
|
|
39
39
|
| type | `project` 固定 | ○ |
|
|
40
40
|
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
41
41
|
| based_on | 根拠仕様ID(配列) | 任意 |
|
|
@@ -12,137 +12,110 @@ specdojo:
|
|
|
12
12
|
- specdojo:people-and-organization-definition-standard
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
#
|
|
15
|
+
# ロール定義 作成ルール
|
|
16
16
|
|
|
17
17
|
Project Role Definition Documentation Rulebook
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
`pm-roles.yaml` に、組織定義で採用した Role code を機械可読な一覧として記録するためのルールです。Schedule、RACI、メンバー定義が同じ責務語彙を参照でき、PO がプロジェクト固有の扱いを承認できる内容にします。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- 専任者の配置と Role code の採用を分けます。専任 Member がいなくても、責務語彙として使うロールは一覧に残します。
|
|
24
|
+
- 共通の責務や規模別の採用パターンは上位標準を参照し、プロジェクト固有の扱いだけを短く補足します。
|
|
24
25
|
|
|
25
|
-
|
|
26
|
-
- Role code の共通定義・責務・規模別パターンは上位標準を参照し、本ファイルに再掲しない。
|
|
27
|
-
- 兼務の割り当て、member nickname、agent 名、個人名は `pm-members.yaml` と `.specdojo/agent-members.yaml` で管理し、本ファイルに記載しない。
|
|
28
|
-
- ロール採用の方針・根拠、最終判断の集約先、見直し条件は `pm-organization.md` を参照し、本ファイルに重複して記載しない。
|
|
29
|
-
- `pm-roles.yaml` の `roles[].code` は、Schedule の `owner` および `pm-members.yaml` の `members[].roles` で使用できる Role code の語彙一覧として機能する。
|
|
30
|
-
- PO が全 Role code とプロジェクト固有メモを承認できるよう、各 `project_note` は公開可能な内容だけで簡潔に記載する。
|
|
31
|
-
- AI Agent が作成・検証を支援する場合でも、最終判断、公開可否、説明責任は人間の PO に残す前提で記載する。
|
|
26
|
+
## 2. 位置づけ
|
|
32
27
|
|
|
33
|
-
|
|
28
|
+
共通用語と標準ロールの定義は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。情報の更新先は次のように分けます。
|
|
34
29
|
|
|
35
|
-
|
|
30
|
+
| 管理先 | 担う情報・接続 |
|
|
31
|
+
| -------------------------------------------------- | --------------------------------------------------------------------------------------- |
|
|
32
|
+
| `pm-organization.md` | 採用・未採用 Role code、使用可能な `owner`、採用理由、見直し条件の正本 |
|
|
33
|
+
| `pm-roles.yaml` | 採用結果の機械可読な転記先。Role code、正式名称、プロジェクト固有メモを保持する |
|
|
34
|
+
| `pm-members.yaml` / `.specdojo/agent-members.yaml` | 人間 / agent の実行主体と対応ロール・兼務の割り当て |
|
|
35
|
+
| Schedule / `pm-raci.md` | 組織定義の方針に従い、ロール定義のコードをタスクの `owner` / 責任分担の列として参照する |
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
| -------------------- | ---------------------------------------------- | -------------------------------------- |
|
|
39
|
-
| `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
|
|
37
|
+
## 3. ファイル命名・ID規則
|
|
40
38
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
| `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
|
|
39
|
+
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml` を推奨します。
|
|
40
|
+
- ファイル名は `pm-roles.yaml`、ID は `<project-id>:pm-roles` とし、`project_id` を配置先プロジェクトに合わせます。
|
|
41
|
+
- 組織定義・人間のメンバー定義と同じ管理ディレクトリに置きます。共通の命名・配置規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
45
42
|
|
|
46
|
-
|
|
43
|
+
## 4. 推奨メタ項目
|
|
47
44
|
|
|
48
|
-
|
|
49
|
-
| ------------ | ------------------------------------------------------ | ---------------------------------------- |
|
|
50
|
-
| Role code | 責務・判断権限・専門性を表す短い識別子 | `roles[].code` に列挙する |
|
|
51
|
-
| Role name | Role code の正式名称 | `roles[].name` に記載する |
|
|
52
|
-
| Project note | 当該プロジェクトでの扱い、専任化条件、公開判断上の注意 | `roles[].project_note` に 1 行で記載する |
|
|
45
|
+
独立 YAML のため、メタ項目は先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml`、メタ情報の意味は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
|
|
53
46
|
|
|
54
|
-
|
|
47
|
+
| 項目 | この成果物で確認する内容 |
|
|
48
|
+
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
49
|
+
| `id` / `project_id` / `title` | 必須。対象プロジェクトと一覧の名称を識別できること |
|
|
50
|
+
| `type` / `status` / `version` | 必須。成果物種別は `project`。状態は `draft` / `ready` / `deprecated` を使い分け、データの版を示すこと |
|
|
51
|
+
| `rulebook` | 必須。準拠先として `specdojo:pm-roles-rulebook` を指定すること |
|
|
52
|
+
| `based_on` / `supersedes` | 任意。採用判断の根拠となる先行成果物 / 置き換え対象を示すこと。適用範囲とライフサイクル管理はメタ情報標準に従う |
|
|
55
53
|
|
|
56
|
-
|
|
57
|
-
- 配置先は `pm-organization.md`、`pm-members.yaml`、`pm-raci.md` と同じ組織定義ディレクトリに置く。
|
|
58
|
-
- 推奨パス: `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml`
|
|
59
|
-
- `project_id` は配置先プロジェクト ID と一致させる。例: `prj-0001`
|
|
60
|
-
- `id` は `<project-id>:pm-roles` 形式を推奨する。例: `prj-0001:pm-roles`
|
|
61
|
-
- `roles[].code` は標準 Role code の表記に合わせ、大文字の短いコードにする。例: `PO`, `PM`, `BA`
|
|
54
|
+
## 5. 本文要件
|
|
62
55
|
|
|
63
|
-
|
|
56
|
+
メタ項目以外の本文キーは次の役割を担います。YAML の骨組みは Frontmatter で宣言した template、構造・型の詳細は対応 schema を正本とします。
|
|
64
57
|
|
|
65
|
-
|
|
66
|
-
|
|
58
|
+
| キー | 必須・任意 | 目的・内容要件 |
|
|
59
|
+
| ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------ |
|
|
60
|
+
| `roles` | 必須 | 採用した全 Role code の配列。`PO` を必ず含め、各コードを一意にする。組織定義で採用した集合と一致させる |
|
|
61
|
+
| `roles[].code` | 必須 | 下流の `owner`、RACI、メンバー定義を接続する識別子 |
|
|
62
|
+
| `roles[].name` | 必須 | 上位標準の正式名称により、コードが表す責務を識別する |
|
|
63
|
+
| `roles[].project_note` | 任意 | PO の判断に必要なプロジェクト固有の扱いを短く示す。補足がなければ省略する |
|
|
67
64
|
|
|
68
|
-
|
|
69
|
-
| -------- | ---------------------------------------- | ---- |
|
|
70
|
-
| `id` | `<project-id>:pm-roles` 形式の成果物 ID | ○ |
|
|
71
|
-
| `type` | `project` 固定 | ○ |
|
|
72
|
-
| `status` | `draft` / `ready` / `deprecated` | ○ |
|
|
73
|
-
| `title` | ドキュメント名。表示ページの見出しになる | ○ |
|
|
65
|
+
## 6. 記述ガイド
|
|
74
66
|
|
|
75
|
-
|
|
76
|
-
| `based_on` | 根拠ドキュメント ID の配列 | 任意 |
|
|
77
|
-
| `version` | データバージョン。初期値は `1` | ○ |
|
|
78
|
-
| `project_id` | プロジェクト ID | ○ |
|
|
67
|
+
### 6.1. メタ項目と根拠
|
|
79
68
|
|
|
80
|
-
|
|
69
|
+
`based_on` は、実際に確認した採用判断の根拠を指します。カタログの依存関係がある場合は、その推移閉包内の先行成果物に限定します。新規作成は `draft` とし、`ready` への昇格は人間が判断します。
|
|
81
70
|
|
|
82
|
-
|
|
71
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
72
|
+
| ---------- | ------------------------------------------ | ---------------------------------------- |
|
|
73
|
+
| 根拠の選択 | 採用方針を確認した組織定義の ID を指定する | 同じディレクトリの文書を未確認で列挙する |
|
|
74
|
+
| 準拠先 | 成果物の `rulebook` に本書の ID を指定する | 計画側に記載済みとして成果物から省く |
|
|
83
75
|
|
|
84
|
-
`
|
|
76
|
+
### 6.2. `roles` の採用範囲
|
|
85
77
|
|
|
86
|
-
|
|
87
|
-
| ------------ | ---- | -------------------- |
|
|
88
|
-
| `id` | ○ | 成果物 ID |
|
|
89
|
-
| `type` | ○ | 成果物種別 |
|
|
90
|
-
| `status` | ○ | 成果物状態 |
|
|
91
|
-
| `title` | ○ | ドキュメント名 |
|
|
92
|
-
| `rulebook` | ○ | 参照する rulebook ID |
|
|
93
|
-
| `based_on` | 任意 | 根拠 ID 配列 |
|
|
94
|
-
| `version` | ○ | データバージョン |
|
|
95
|
-
| `project_id` | ○ | プロジェクト ID |
|
|
96
|
-
| `roles` | ○ | 全 Role の配列 |
|
|
78
|
+
組織定義の採用結果と、Schedule・RACI・メンバー定義の参照値を照合します。差分があれば一覧だけを追加・削除せず、採用判断と下流の使い方のどちらを改訂するかを先に確認します。記載順は上位標準の定義順を推奨します。
|
|
97
79
|
|
|
98
|
-
|
|
80
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
81
|
+
| ------------ | -------------------------------------------- | -------------------------------------------- |
|
|
82
|
+
| 最小構成 | 最終判断を担う `PO` を含む採用集合を転記する | 実作業だけを見て `BA` と `QE` だけを列挙する |
|
|
83
|
+
| 兼務時の扱い | 採用済みの `PM` を管理タスクの語彙として残す | 専任者がいないという理由だけで `PM` を除く |
|
|
99
84
|
|
|
100
|
-
|
|
101
|
-
| -------------- | ---- | --------------------------------------------------------------------- |
|
|
102
|
-
| `code` | ○ | Role code。標準 Role code を使う |
|
|
103
|
-
| `name` | ○ | Role の正式名称 |
|
|
104
|
-
| `project_note` | 任意 | プロジェクト固有の扱い、専任化条件、公開判断上の注意を 1 行で記述する |
|
|
85
|
+
### 6.3. `roles[].code` と `roles[].name`
|
|
105
86
|
|
|
106
|
-
|
|
87
|
+
`code` は schema の標準コード `PO`、`PM`、`BA`、`ARC`、`DEV`、`QE`、`UX`、`OPS` に限定します。`name` は人と組織の定義標準の正式名称と対応させ、担当者や職位で置き換えません。
|
|
107
88
|
|
|
108
|
-
|
|
89
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
90
|
+
| -------- | ----------------------------------- | ------------------------------------ |
|
|
91
|
+
| 識別子 | `code: PM` を下流でも同じ表記で使う | `code: project-manager-agent` を使う |
|
|
92
|
+
| 正式名称 | `name: Project Manager` | `name: 開発部長` |
|
|
109
93
|
|
|
110
|
-
|
|
111
|
-
- 記載順は標準ロールの定義順(`PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS`)に揃えることを推奨する。
|
|
112
|
-
- 標準 Role code のみを使用し、プロジェクト固有の独自コードを追加しない。
|
|
113
|
-
- `roles[].code` は重複させない。
|
|
114
|
-
- 専任 member がいない Role code でも、Schedule の `owner`、RACI、レビュー観点、下流文書で責務語彙として使う場合は残す。
|
|
94
|
+
### 6.4. `roles[].project_note`
|
|
115
95
|
|
|
116
|
-
|
|
96
|
+
プロジェクト固有の責務強調、専任化を検討する条件、公開判断上の注意を 1 行で記述します。標準の一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、判断者・判断時点を示します。
|
|
117
97
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
98
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
99
|
+
| ---------------- | ----------------------------------------------------- | ---------------------------------- |
|
|
100
|
+
| 判断できる条件 | 週次管理の滞留が続く場合、PO が PM の専任化を判断する | 必要に応じて管理する |
|
|
101
|
+
| 固有性 | 店頭の欠品と記録漏れを受入確認で重視する | 上位標準の品質責務を全文転記する |
|
|
102
|
+
| 実行主体との分離 | 実行主体はメンバー定義で管理する | PM は特定の個人や agent が担当する |
|
|
122
103
|
|
|
123
|
-
### 6.
|
|
104
|
+
### 6.5. 変更時の追従と完了判断
|
|
124
105
|
|
|
125
|
-
|
|
126
|
-
- 略称だけ、プロジェクト固有の担当者名、組織内の職位名に置き換えない。
|
|
127
|
-
- Role code と対応が分かる一般的な英語名を使う。
|
|
106
|
+
改訂・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM は組織定義、WBS・Schedule の `owner`、RACI、人間・Agent のメンバー定義、レビュー観点の参照を調べ、波及更新をタスク化します。ARC は参照・schema との整合、QE は機械検証と採用集合・コード重複・名称対応の照合を確認し、人間の PO が採用変更と公開可否を判断します。
|
|
128
107
|
|
|
129
|
-
|
|
108
|
+
機械検証は `pm-roles.schema.yaml` を入力 schema とする。SpecDojo 開発リポジトリでは `npm run validate:schema:file -- --schema docs/specdojo/schemas/v1/pm-roles.schema.yaml --data <対象ファイル>` の終了コード 0 を確認する。schema の配列要素全体の一意性だけではコード重複を検出できないため、QE は `roles[].code` の重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合する。
|
|
130
109
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
- 公開文書として再利用できる粒度にし、個別組織の内部事情や非公開運用を含めない。
|
|
136
|
-
- 記載すべき内容がない場合は省略してよい。
|
|
110
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
111
|
+
| ---------- | ---------------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
112
|
+
| 変更完了 | 採用変更と参照元の追従を確認し、未決事項は担当 Role code と転送先を付けて PJR に引き継ぐ | YAML の構文が通ったことだけで変更完了にする |
|
|
113
|
+
| ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
|
|
137
114
|
|
|
138
115
|
## 7. 禁止事項
|
|
139
116
|
|
|
140
|
-
| 禁止事項
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
| ロール採用の根拠・方針・見直し条件を長く記載する | `pm-organization.md` の責務であり重複管理になるため |
|
|
146
|
-
| 公開できない個人情報、連絡先、非公開組織情報、アクセス情報を記載する | PO の公開可否判断と説明責任を損なうため |
|
|
147
|
-
| AI Agent に最終承認、公開可否、説明責任を持たせる記述を置く | 人間の PO が最終判断を担う前提に反するため |
|
|
148
|
-
| schema にない任意メタ項目を追加する | 機械検証と下流処理の互換性が壊れるため |
|
|
117
|
+
| 禁止事項 | 理由 |
|
|
118
|
+
| --------------------------------------------------------------------- | ------------------------------------------------ |
|
|
119
|
+
| schema にないキーを追加し、採用理由や兼務割り当てを独自構造で管理する | 機械処理の互換性と正本の責任境界を損なうため |
|
|
120
|
+
| 個人情報、連絡先、非公開組織情報、アクセス情報を固有メモに含める | 公開可能なロール定義として再利用できなくなるため |
|
|
121
|
+
| AI Agent に最終承認・公開可否・説明責任を持たせる | 人間の PO が最終判断を担う前提に反するため |
|
|
@@ -30,13 +30,14 @@ Progress Report Documentation Rulebook
|
|
|
30
30
|
|
|
31
31
|
- 推奨: `pr-<yyyy-mm-dd>-<nn>.md`
|
|
32
32
|
- 日付はISO形式、連番は2桁ゼロ埋めを推奨する。
|
|
33
|
+
- 文書 ID は `<project-id>:pr-<yyyy-mm-dd>-<nn>` 形式とする(例: `prj-0001:pr-2026-03-01-01`)。
|
|
33
34
|
|
|
34
35
|
## 4. 推奨 Frontmatter 項目
|
|
35
36
|
|
|
36
37
|
| 項目 | 説明 | 必須 |
|
|
37
38
|
|
|
38
39
|
| ------ | -------------------------------- | ---- |
|
|
39
|
-
| id |
|
|
40
|
+
| id | `<project-id>:pr-<yyyy-mm-dd>-<nn>` | ○ |
|
|
40
41
|
|
|
41
42
|
| type | `project` | ○ |
|
|
42
43
|
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
@@ -17,7 +17,7 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Assumptions, Constraints and Dependencies Documentation Rulebook
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。各項目から計画への影響、確認責任、変更時の記録先を追跡できることを目的とする。
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
@@ -33,8 +33,6 @@ Assumptions, Constraints and Dependencies Documentation Rulebook
|
|
|
33
33
|
|
|
34
34
|
### 2.1. 位置づけ
|
|
35
35
|
|
|
36
|
-
本書はスコープで定めた境界を受け、実行上の成立条件と変更時の判断材料を明示する。前提・制約・依存が変化した結果としてリスク、変更要求、計画へ影響を伝える。
|
|
37
|
-
|
|
38
36
|
```mermaid
|
|
39
37
|
flowchart LR
|
|
40
38
|
SCOPE["プロジェクトスコープ"]
|
|
@@ -50,64 +48,42 @@ flowchart LR
|
|
|
50
48
|
|
|
51
49
|
### 2.2. 用語定義
|
|
52
50
|
|
|
53
|
-
| 用語 | 定義
|
|
54
|
-
| -------- |
|
|
55
|
-
|
|
|
56
|
-
|
|
|
57
|
-
| 依存関係 | 外部組織、サービス、先行成果物、意思決定などが提供または確定することを必要とする関係。 |
|
|
58
|
-
| トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
|
|
59
|
-
| 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
|
|
51
|
+
| 用語 | 定義 |
|
|
52
|
+
| -------- | -------------------------------------------------------------------------- |
|
|
53
|
+
| トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
|
|
54
|
+
| 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
|
|
60
55
|
|
|
61
56
|
## 3. ファイル命名・ID規則
|
|
62
57
|
|
|
63
|
-
### 3.1.
|
|
64
|
-
|
|
65
|
-
- 成果物は `docs/ja/projects/<project-id>/020-project-definition/prj-assumptions-constraints-dependencies.md` に配置する。
|
|
66
|
-
- rulebook は `docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md` に配置する。
|
|
67
|
-
- recipe、sample、template は、それぞれ `docs/ja/specdojo/recipes/`、`samples/`、`templates/` の同じ prefix を持つファイルに配置する。
|
|
68
|
-
|
|
69
|
-
### 3.2. ドキュメント ID
|
|
58
|
+
### 3.1. 成果物の配置と文書 ID
|
|
70
59
|
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
60
|
+
- 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
|
|
61
|
+
- 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
|
|
62
|
+
- 文書 ID と、表の行を識別する項目 ID は区別する。別文書から行を追跡するときは、文書 ID と項目 ID の組で識別する。
|
|
74
63
|
|
|
75
|
-
### 3.
|
|
64
|
+
### 3.2. 項目 ID
|
|
76
65
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
66
|
+
- 各登録行の必須キーは、前提条件では `ACD-A01`、制約事項では `ACD-C01`、依存関係では `ACD-D01` から始める。接頭辞に続く正の整数を種別ごとに既採番の最大値から順に増やし、2 桁未満はゼロ埋めする。100 件目以降は桁を増やす。
|
|
67
|
+
- 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
|
|
68
|
+
- 種別を変更する場合は、旧項目を廃止して変更先の種別で新規採番し、変更記録に新旧 ID の対応と理由を残す。変更記録や登録簿でも同じ項目 ID を追跡キーに使う。
|
|
80
69
|
|
|
81
70
|
## 4. 推奨 Frontmatter 項目
|
|
82
71
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
| ---------- | ------------------------------------------------------------ | ---- |
|
|
87
|
-
| id | `<project-id>:prj-assumptions-constraints-dependencies` | ○ |
|
|
88
|
-
| type | `project` | ○ |
|
|
89
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
90
|
-
| rulebook | `specdojo:prj-assumptions-constraints-dependencies-rulebook` | ○ |
|
|
91
|
-
| based_on | 直接参照した上位成果物の ID 配列 | 任意 |
|
|
92
|
-
| supersedes | 置き換える旧成果物の ID 配列 | 任意 |
|
|
93
|
-
|
|
94
|
-
### 4.2. 推奨ルール
|
|
95
|
-
|
|
96
|
-
- `based_on` には、内容の根拠として直接参照した文書だけを記載する。
|
|
97
|
-
- 未確定事項は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きの前提は _ASSUMPTION_: で明示する。
|
|
98
|
-
- H1 には成果物の表示名を置き、frontmatter に `title` を重複して持たせない。
|
|
72
|
+
- 共通項目の必須性、値・構文、未確定事項の目印は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正とし、構造は `deliverable-frontmatter.schema.yaml` に従う。
|
|
73
|
+
- 本系統では `rulebook` に `specdojo:prj-assumptions-constraints-dependencies-rulebook` を必須で指定する。成果物の `type` は本書の `deliverable_type` に従う。
|
|
74
|
+
- `based_on` には、根拠として直接参照したスコープ・憲章などの上位成果物を記載する。計画や技術資料などへの影響先の参照と混同しない。
|
|
99
75
|
|
|
100
|
-
## 5.
|
|
76
|
+
## 5. 本文要件
|
|
101
77
|
|
|
102
|
-
|
|
78
|
+
次の各章を表の順序で必須とする。前提条件・制約事項・依存関係は項目 ID ごとに管理し、登録対象がない章も省略せず、該当なしの理由と追加時の条件を記載する。
|
|
103
79
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
80
|
+
| 章 | 目的と必須の判断材料 |
|
|
81
|
+
| ------------------ | -------------------------------------------------------------------- |
|
|
82
|
+
| 前提条件 | 計画の成立に置く条件の根拠、崩れた場合の影響、確認と対応を示す。 |
|
|
83
|
+
| 制約事項 | 守るべき限界と適用範囲、逸脱の検知と対応を示す。 |
|
|
84
|
+
| 依存関係 | 他者から受ける条件、必要となる理由、成立の判定と変化時の対応を示す。 |
|
|
85
|
+
| 影響評価と対応方針 | 変化が後続成果物・計画に及ぼす影響、一次対応と最終判断の分担を示す。 |
|
|
86
|
+
| 監視・変更管理 | 見直し契機、変更記録の内容と記録先、追従更新と報告の責任を示す。 |
|
|
111
87
|
|
|
112
88
|
## 6. 記述ガイド
|
|
113
89
|
|
|
@@ -116,9 +92,10 @@ flowchart LR
|
|
|
116
92
|
- 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
|
|
117
93
|
- 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
|
|
118
94
|
- 根拠が不足する場合は事実として断定せず、_ASSUMPTION_: または _TODO_: として確認先を残す。
|
|
119
|
-
-
|
|
95
|
+
- スコープで定義済みの境界に該当する前提は、章冒頭でスコープの該当章へ委譲する。委譲先に条件が実在することを確認し、参照だけで未定義の条件を補ったことにしない。
|
|
96
|
+
- リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
|
|
120
97
|
|
|
121
|
-
|
|
98
|
+
良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
|
|
122
99
|
|
|
123
100
|
推奨表:
|
|
124
101
|
|
|
@@ -130,7 +107,9 @@ flowchart LR
|
|
|
130
107
|
- 制約には、適用範囲と、逸脱したと判断する条件を記載する。
|
|
131
108
|
- 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
|
|
132
109
|
- 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
|
|
133
|
-
-
|
|
110
|
+
- スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、追加の運用制約、または「全体方針」に従って監視・対応を補う制約を扱う。
|
|
111
|
+
|
|
112
|
+
良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
|
|
134
113
|
|
|
135
114
|
推奨表:
|
|
136
115
|
|
|
@@ -140,14 +119,20 @@ flowchart LR
|
|
|
140
119
|
### 6.3. 依存関係
|
|
141
120
|
|
|
142
121
|
- 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
|
|
143
|
-
-
|
|
122
|
+
- 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
|
|
123
|
+
- 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
|
|
144
124
|
- 依存先の詳細な契約条件や実装方式は、必要な管理・設計成果物へ委譲する。
|
|
145
125
|
- 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
|
|
126
|
+
- 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
|
|
127
|
+
|
|
128
|
+
良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
|
|
146
129
|
|
|
147
130
|
推奨表:
|
|
148
131
|
|
|
149
|
-
| ID |
|
|
150
|
-
| --- |
|
|
132
|
+
| ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
|
|
133
|
+
| --- | ------------ | -------------- | -------------- | -------------- | ------ | -------- |
|
|
134
|
+
|
|
135
|
+
表の各列は必須の意味を表す。「依存先・条件」は受ける提供物・判断・継続提供を、「必要となる理由」はそれが必要な作業と不成立時の影響を示す。
|
|
151
136
|
|
|
152
137
|
### 6.4. 影響評価と対応方針
|
|
153
138
|
|
|
@@ -155,6 +140,8 @@ flowchart LR
|
|
|
155
140
|
- 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
|
|
156
141
|
- 一次対応を担うロールと最終判断者を区別し、人間の判断が必要な範囲を明示する。
|
|
157
142
|
|
|
143
|
+
良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、PM が順序・期日の変更案をまとめ、人間の責任者が開始可否を判断する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
|
|
144
|
+
|
|
158
145
|
推奨表:
|
|
159
146
|
|
|
160
147
|
| 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
|
|
@@ -163,8 +150,12 @@ flowchart LR
|
|
|
163
150
|
### 6.5. 監視・変更管理
|
|
164
151
|
|
|
165
152
|
- 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
|
|
166
|
-
- 変更記録には、項目 ID
|
|
153
|
+
- 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
|
|
154
|
+
- 発生済みの支障は課題、将来の不確実な影響はリスク、承認済み範囲・計画の変更提案は変更要求、判断結果は決定記録へ接続する。PM が記録先・報告先を明示し、関連する Schedule の作業や PJR 項目から項目 ID を追跡できるようにする。
|
|
167
155
|
- 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
|
|
156
|
+
- 改訂・廃止時の共通手順は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。本系統では PM が計画・Schedule・PJR の追従作業を管理し、ARC が参照と技術制約、QE が受入条件・検証への影響を確認する。
|
|
157
|
+
|
|
158
|
+
良い例: 「端末の利用不能を検知したら、所有者が対象 ID と影響作業を課題に記録し、PM が代替策と再確認時期を報告する。開始条件が変わる場合は変更要求として人間の責任者へ上げる」と書く。悪い例: 「必要に応じて更新する」とだけ書き、記録先と判断責任を示さない。
|
|
168
159
|
|
|
169
160
|
## 7. 禁止事項
|
|
170
161
|
|