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
|
@@ -18,7 +18,7 @@ specdojo:
|
|
|
18
18
|
|
|
19
19
|
Project Register Documentation Rules
|
|
20
20
|
|
|
21
|
-
本ドキュメントは、プロジェクト登録簿の個別登録項目(`pjr-XXXX-<topic>.md
|
|
21
|
+
本ドキュメントは、プロジェクト登録簿の個別登録項目(`pjr-XXXX-<topic>.md`)、項目別イベントログ、そこから生成する一覧・派生ビューの記述ルールです。
|
|
22
22
|
|
|
23
23
|
## 1. 全体方針
|
|
24
24
|
|
|
@@ -28,8 +28,10 @@ Project Register Documentation Rules
|
|
|
28
28
|
- 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
|
|
29
29
|
- `generated/pjr-index.md` とすべての派生ビューは個票から `register build` で生成し、直接編集しない。
|
|
30
30
|
- `<project-id>:pjr-index` は `generated/pjr-index.md` の文書 ID とする。`controls/**/generated/` はdoc-indexの限定走査対象とし、`register build` の後に `index build` を実行する。
|
|
31
|
-
-
|
|
32
|
-
-
|
|
31
|
+
- 本書で登録項目の分類を指すときは `item_type` と書き、文書種別の `type`(`project`)と区別する。CLI の `--type` は `item_type` を指定する。
|
|
32
|
+
- 個票の template は `item_type` ごとに異なり、`register add` が `本文構成(標準テンプレ)` の表に従って選ぶ。Frontmatter の `template` は 1 件しか宣言できないため `not-needed` とし、対応は同表を正とする。
|
|
33
|
+
- 値の型と enum は `docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml`(個票)と `docs/specdojo/schemas/v1/register-events.schema.yaml`(イベント)、コマンドの選び方と例は [[specdojo:register-operation-guide|登録簿運用ガイド]] を正本とし、本書で言い直さない。
|
|
34
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。個票の `status` は register コマンドが `個票 status の遷移基準` に従って更新する。文書の整形・lint はリポジトリの検証で扱い、個票の完了条件に含めない。
|
|
33
35
|
|
|
34
36
|
## 2. ファイル命名・ID規則
|
|
35
37
|
|
|
@@ -50,78 +52,88 @@ Project Register Documentation Rules
|
|
|
50
52
|
- 項目別イベントログは同ディレクトリの `events/` 配下に置き、個票 1 件につき 1 ファイルとする。
|
|
51
53
|
- 登録項目一覧は `docs/ja/projects/<project-id>/controls/project-register/generated/pjr-index.md` に生成する。
|
|
52
54
|
- 状態別・優先度別・担当者別の補助一覧と、元の項目から派生先を辿る一覧は同じ `generated/` 配下に生成する。
|
|
53
|
-
- controls 全体の
|
|
55
|
+
- controls 全体の `item_type` 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
|
|
54
56
|
|
|
55
57
|
## 3. 推奨 Frontmatter 項目
|
|
56
58
|
|
|
57
|
-
個票には
|
|
58
|
-
|
|
59
|
-
| 項目 | 説明
|
|
60
|
-
| ----------------- |
|
|
61
|
-
| `id` | `<project-id>:pjr-XXXX-<topic>`
|
|
62
|
-
| `type` | `project`
|
|
63
|
-
| `status` | 文書成熟度。`draft` / `ready` / `deprecated`
|
|
64
|
-
| `rulebook` | `specdojo:pjr-rulebook`
|
|
65
|
-
| `part_of` | `<project-id>:pjr-index` を要素に持つ配列
|
|
66
|
-
| `item_type` | 登録項目の分類
|
|
67
|
-
| `track` | epic が担う track。ほかの
|
|
68
|
-
| `
|
|
69
|
-
| `
|
|
70
|
-
| `
|
|
71
|
-
| `
|
|
72
|
-
| `
|
|
73
|
-
| `
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
| `
|
|
78
|
-
| `
|
|
79
|
-
| `
|
|
80
|
-
| `
|
|
81
|
-
| `
|
|
82
|
-
| `
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
59
|
+
個票には schema が定義する次の項目を置く。未定の担当、期限、完了日時、結論はプレースホルダ(`_TODO_` など)を保存せず、該当キーを省略する(期限なしだけは `due_on: null`)。
|
|
60
|
+
|
|
61
|
+
| 項目 | 説明 | 必須 |
|
|
62
|
+
| ----------------- | ------------------------------------------------------------------------ | ----------- |
|
|
63
|
+
| `id` | `<project-id>:pjr-XXXX-<topic>` | ○ |
|
|
64
|
+
| `type` | `project` | ○ |
|
|
65
|
+
| `status` | 文書成熟度。`draft` / `ready` / `deprecated` | ○ |
|
|
66
|
+
| `rulebook` | `specdojo:pjr-rulebook` | ○ |
|
|
67
|
+
| `part_of` | `<project-id>:pjr-index` を要素に持つ配列 | ○ |
|
|
68
|
+
| `item_type` | 登録項目の分類 | ○ |
|
|
69
|
+
| `track` | epic が担う track。ほかの `item_type` では指定しない | epic で必須 |
|
|
70
|
+
| `domains` | epic が対象とする domain の文字列配列。ほかの `item_type` では指定しない | 任意 |
|
|
71
|
+
| `item_status` | 登録項目の処理状態 | ○ |
|
|
72
|
+
| `priority` | 対応優先度 | ○ |
|
|
73
|
+
| `difficulty` | agent 振り分け用の作業難易度 | 任意 |
|
|
74
|
+
| `owner` | 主担当者または役割 | 任意 |
|
|
75
|
+
| `registered_at` | 起票日時 | 任意 |
|
|
76
|
+
| `due_on` | 対応期限または判断期限 | 任意 |
|
|
77
|
+
| `start_on` | epic の予定開始日。ほかの `item_type` では指定しない | 任意 |
|
|
78
|
+
| `completed_at` | 完了・却下・決定日時 | 条件 |
|
|
79
|
+
| `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
|
|
80
|
+
| `conclusion` | 終端時の結論要約 | 任意 |
|
|
81
|
+
| `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
|
|
82
|
+
| `depends_on` | 実行前に完了しているべき先行の登録項目 ID の配列 | 任意 |
|
|
83
|
+
| `approach` | 対象を作成・修正するときの進め方 | 任意 |
|
|
84
|
+
| `target_path` | カタログなしで作成する成果物のリポジトリ相対パス | 任意 |
|
|
85
|
+
| `target_rulebook` | 対象成果物の rulebook ID | 任意 |
|
|
86
|
+
| `targets` | 変更対象文書の doc id リスト | 任意 |
|
|
87
|
+
|
|
86
88
|
- `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
|
|
87
|
-
- `
|
|
88
|
-
- `
|
|
89
|
-
-
|
|
90
|
-
- `
|
|
91
|
-
- `
|
|
92
|
-
- `
|
|
93
|
-
- すべての先行項目が `done` / `decided` のときだけ実行を許可する。`rejected` / `deferred`
|
|
89
|
+
- `difficulty` を省略した場合は agent を自動で選ぶ。
|
|
90
|
+
- `epic` は track ごとの全体計画の正本であり、自身は実行しない。`track` は英小文字・数字・ハイフンの識別子とし、先頭は英小文字または数字にする。同じ project 内の epic どうしで track を重複させず、epic の `track` は削除できない。`domains` を省略した場合だけ互換用 timeline へ範囲の解決を委ね、空配列は対象なしの明示指定とする。
|
|
91
|
+
- 全体計画の順序は epic 間の `depends_on`、範囲は `domains`、期間は `start_on`・着手・完了の記録と `due_on` から導く。epic 間の依存は循環させない。開始日・終了日の決め方は登録簿運用ガイドの `全体計画を確認する` に従う。
|
|
92
|
+
- `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`block_reason` は `waiting` 以外へ遷移すると現在値から削除され、削除前の理由はイベントログに残る。
|
|
93
|
+
- `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目、未設定の project は使用しない。別 project の存在確認は、その project のローカル統合ブランチを正とする。
|
|
94
|
+
- `depends_on` は実行順序、`derived_from` は起票の由来を表す。両者を相互に推測・転記しない。参照書式と存在確認は `derived_from` と同じとし、存在しない ID、自己参照、project をまたぐ循環を記帳前と `register build` で拒否する。
|
|
95
|
+
- すべての先行項目が `done` / `decided` のときだけ実行を許可する。`rejected` / `deferred` は依存を満たさない。依存を理由に状態を自動で `waiting` へ変更しない。
|
|
94
96
|
|
|
95
97
|
### 3.1. 日時と日付の使い分け
|
|
96
98
|
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
+
- 起票と、完了・決定・却下による終端は瞬間として記録し、`registered_at` / `completed_at` に UTC の RFC 3339・秒精度(`YYYY-MM-DDTHH:MM:SSZ`)で保存する。`deferred` は `completed_at` を持たない。
|
|
100
|
+
- 予定開始日と期限は瞬間ではなくプロジェクトタイムゾーン上の暦日であるため、`start_on` と `due_on` は `YYYY-MM-DD` のまま保持する。未定の `start_on` は省略する。
|
|
99
101
|
- 一覧・派生ビューの「登録日」「完了日」は、保存した日時をプロジェクトの登録日タイムゾーンへ変換して導出する表示値であり、個票へ日付として重複保存しない。
|
|
100
|
-
- 日時は register
|
|
102
|
+
- 日時は register コマンドが記録し、後追いの入力もタイムゾーン付きの値から UTC へ変換して保存する。
|
|
101
103
|
|
|
102
104
|
### 3.2. Register event と責務境界
|
|
103
105
|
|
|
104
|
-
-
|
|
105
|
-
- イベントファイルのルートは YAML
|
|
106
|
-
-
|
|
107
|
-
-
|
|
106
|
+
- 保存・配布・差分レビューは Git が担うが、Git コミットを履歴再構成の正本にしない。
|
|
107
|
+
- イベントファイルのルートは YAML 配列とし、イベントを古い順に追記する。項目ごとに配置し、異なる項目の並行更新で共有ログが競合しないようにする。
|
|
108
|
+
- イベントの項目と action は register-events schema に従い、各イベントは遷移前後の `item_status` と直前イベント ID で前のイベントにつなぐ。
|
|
109
|
+
- actor には、決定・承認した人の nickname、実行した agent、または予約 actor を記録する。`PO` などの Role code を actor にせず、`specdojo-orchestrator` で人の判断主体を代替しない。受け付ける名前は登録簿運用ガイドに従う。
|
|
110
|
+
- 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。既存イベントの置換や削除で重複を解消しない。
|
|
108
111
|
- `register build` は個票とイベントファイルの 1 対 1 対応、イベント ID の一意性、時刻順、直前イベント参照、遷移前後状態の連鎖、最新イベントの状態と個票の `item_status` の一致を検証する。不正なイベントを無視して一覧を生成しない。
|
|
109
112
|
|
|
110
113
|
## 4. 本文構成(標準テンプレ)
|
|
111
114
|
|
|
112
115
|
### 4.1. 個別登録項目
|
|
113
116
|
|
|
114
|
-
| 順序 | 内容 | 必須 | 説明 |
|
|
115
|
-
| ---- | ---------------- | ---- | -------------------------------------- |
|
|
116
|
-
| 1 | type 固有の記録 | ○ | 対象、背景、評価、対応・判断、結果など |
|
|
117
|
-
| 末尾 | 関連ドキュメント | ○ | 根拠、影響先、追跡先を文書 ID で示す |
|
|
118
|
-
|
|
119
117
|
- H1 は `PJR-XXXX <タイトル>` 形式とする。
|
|
120
|
-
-
|
|
121
|
-
- `
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
118
|
+
- 本文は `item_type` ごとの template の節(必須節)をこの順ですべて持つ。該当する内容がない節は削らず `-` を書く。
|
|
119
|
+
- 必須節を満たす判定は、本文のコード(インラインコード・コードブロック)の外に `_TODO_` が残っていないことである。`register close` はこの判定で `ready` へ昇格させるかを決める。
|
|
120
|
+
|
|
121
|
+
| `item_type` | template | 必須節 |
|
|
122
|
+
| ---------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
123
|
+
| `epic` | `specdojo:pjr-epic-template` | 概要、範囲(track と domain)、完了の判断の基準、子項目、対応結果、関連ドキュメント |
|
|
124
|
+
| `todo` | `specdojo:pjr-todo-template` | 概要、入力、完了条件、作業内容、対応結果、関連ドキュメント |
|
|
125
|
+
| `question` | `specdojo:pjr-question-template` | 確認事項、入力、背景、回答候補、回答・結論、承認、関連ドキュメント |
|
|
126
|
+
| `decision` | `specdojo:pjr-decision-template` | 背景、検討した選択肢、決定内容、採択理由、承認、影響範囲とフォローアップ、関連ドキュメント |
|
|
127
|
+
| `note` | `specdojo:pjr-note-template` | メモ、背景・文脈、フォローアップ、関連ドキュメント |
|
|
128
|
+
| `risk` | `specdojo:pjr-risk-template` | リスク内容、入力、影響評価、対応方針、モニタリング、関連ドキュメント |
|
|
129
|
+
| `issue` | `specdojo:pjr-issue-template` | 課題内容、入力、影響範囲、対応方針、対応結果、関連ドキュメント |
|
|
130
|
+
| `change-request` | `specdojo:pjr-change-request-template` | 変更要求、入力、影響評価、審査・決定、実施追跡、関連ドキュメント |
|
|
131
|
+
|
|
132
|
+
- `入力` 節には対話で得た前提・制約・委任範囲を箇条書きで残し、入力がない場合は `-` とする。完了条件・回答の確定条件とは分け、完了条件へ転記しない。既存個票に節がなくても読み込め、初回の入力更新時に節を追加する。
|
|
133
|
+
- 承認の節には承認者・承認方式・証跡を記録する。承認方式の選び方は登録簿運用ガイドに従う。
|
|
134
|
+
- `epic` の範囲には domain と境界、完了の判断の基準には子項目と schedule を確認する判断条件、対応結果には人が完了を判断した根拠を記録する。
|
|
135
|
+
- 子 todo は epic から起票し、`derived_from` に epic を記録する。epic 別ビューは直接の子だけを表示し、状態の自動集約や自動 close は行わない。
|
|
136
|
+
- 関連ドキュメントには、根拠、影響先、追跡先を文書 ID で示す。
|
|
125
137
|
- 終端前に未確定の結果・結論がある場合は、`-` または共通ラベルを用い、確定済みの記述と混在させない。
|
|
126
138
|
|
|
127
139
|
### 4.2. 生成一覧と派生ビュー
|
|
@@ -135,11 +147,10 @@ Project Register Documentation Rules
|
|
|
135
147
|
| `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
|
|
136
148
|
| `generated/pjr-epic-items.md` | epic ごとの直接の子項目と状態 | 不可 |
|
|
137
149
|
| `generated/pjr-dependent-items.md` | 先行項目から後続項目を逆引きする一覧 | 不可 |
|
|
138
|
-
| `controls/generated/pm-*.md` |
|
|
150
|
+
| `controls/generated/pm-*.md` | `item_type` 別の管理ビュー | 不可 |
|
|
139
151
|
|
|
140
152
|
- 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票、`depends_on` とする。
|
|
141
|
-
- タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter
|
|
142
|
-
- 登録日と完了日の列は、`registered_at` / `completed_at` をプロジェクトの登録日タイムゾーンへ変換した暦日として生成する。
|
|
153
|
+
- タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。登録日と完了日は `日時と日付の使い分け` に従って導出する。
|
|
143
154
|
- 生成ビューに独自の詳細情報や手作業の修正を追加しない。修正は個票に行い、`register build` を再実行する。
|
|
144
155
|
|
|
145
156
|
## 5. 記述ガイド
|
|
@@ -150,35 +161,22 @@ Project Register Documentation Rules
|
|
|
150
161
|
- 評価や選択肢には、比較可能な観点と根拠を記載し、結論だけを先に固定しない。
|
|
151
162
|
- 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
|
|
152
163
|
- 結果・結論には、完了を判定した根拠と後続対応を記載する。
|
|
153
|
-
- 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
|
|
154
164
|
- 実行中に問題や後続作業を見つけて別の登録項目を起票するときは、起票元を `derived_from` に必ず記録する。decision から todo を起票する場合も同じ関係を使い、decision 本文へ追跡先を重複記載しない。既存本文の追跡先は移行のために書き換えない。
|
|
155
|
-
-
|
|
156
|
-
- `approach` を宣言する場合、`targets` は 1
|
|
157
|
-
|
|
158
|
-
- カタログなしの完了基準は個票の完了条件と rulebook とする。recipe・sample・template は rulebook frontmatter から辿り、`not-needed` のものを対象に含めない。`fully-guided` の必要な一式、`recipe-guided` の recipe が不足する場合は起票・更新を拒否する。
|
|
159
|
-
- カタログなしの `bootstrap` は `target_path`、新しい `target_rulebook`、設定の `kata_authority` を必須とする。既存 rulebook を再利用しない。rulebook の名前部分から recipe・sample・template の ID を導出し、`docs/ja/specdojo/<kind>s/<kata_authority>/` に配置する候補を plan へ示す。成果物には新しい `specdojo.rulebook` を記録する。
|
|
160
|
-
- `finalize`・`bootstrap-finalize` は既存成果物だけを対象にし、カタログなしでは個票の完了条件を確認チェック表にする。後者は成果物と frontmatter から辿る kata 一式を確定対象とする。
|
|
161
|
-
|
|
162
|
-
- 対話で得た前提は `register add --input <text>` で個票本文の `入力` へ記録する。繰り返し指定した順に箇条書きとし、`register update --input` は指定した一覧で置換する。追記する場合は既存分を含めて渡し、`--input -` 単独で全削除する。未指定時は保持する。空文字、削除指定と他の入力の混在、add での削除指定は拒否する。
|
|
163
|
-
- 入力の変更は event の `input` フィールドへ変更前後の JSON 配列として記録し、値がない場合は `-` とする。register 経由の plan は approach の有無を問わず、入力がある場合だけ「個票の入力(前提)」に展開する。入力を完了条件へ転記しない。
|
|
165
|
+
- 確実に変更する対象文書が分かっている場合は、その文書 ID を `targets` へ宣言する。`targets` は agent 実行時の変更網羅検証(target coverage)に使う。未知の場合や対象を固定しない場合は省略する。
|
|
166
|
+
- `approach` を宣言する場合、`targets` は 1 件だけ必須とする。成果物の対象はカタログを優先して解決し、カタログにない新規文書は `target_path` と `target_rulebook` を両方記録する。`*-maintenance` の対象は名前に対応する種別の kata の doc id とする。解決できない ID や、`approach` と種別が合わない対象は使用しない。approach ごとのカタログなしでの解決と拒否の条件は [[specdojo:ryu-guide|実践の進め方ガイド]] の `成果物カタログなしで進める` と [[specdojo:command-reference|CLIコマンドリファレンス]] に従う。
|
|
164
167
|
|
|
165
168
|
### 5.2. 構造化フィールドと生成
|
|
166
169
|
|
|
167
|
-
- 新しい項目は `register add`
|
|
168
|
-
-
|
|
169
|
-
- `register
|
|
170
|
-
-
|
|
171
|
-
- `--by` に指定できるのは、project の `pm-members.yaml` にある人の nickname、repository の `.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` に限る。agent の alias は実体の nickname に解決して記録し、名簿にも予約一覧にもない値は書き込み前に拒否する。
|
|
172
|
-
- 決定・承認を記録する actor には、`PO` などの Role code や予約 actor ではなく、決定・承認した人の nickname を使う。`specdojo-orchestrator` は対話型オーケストレーター自身の操作だけに使い、人の判断主体を代替しない。
|
|
173
|
-
- 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
|
|
174
|
-
- ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。
|
|
175
|
-
- 主題の変化に伴う `<topic>` の変更は `register update --topic` で行う。個票のファイル名と Frontmatter の文書 ID、他文書中の旧文書 ID 参照を同時に更新し、生成ビューを再生成する。
|
|
170
|
+
- 新しい項目は `register add` で作成し、全 `item_type` で個票を省略しない。
|
|
171
|
+
- 構造化フィールドは `register update`、処理状態は状態遷移コマンドで変更する。
|
|
172
|
+
- `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを項目別ログへ記録する。一覧を編集して個票へ反映する経路はない。
|
|
173
|
+
- ID の変更は `register renumber`、主題の変化に伴う `<topic>` の変更は `register update --topic` で行い、個票のファイル名・文書 ID・他文書の参照と生成ビューを整合させる。
|
|
176
174
|
|
|
177
175
|
### 5.3. 登録項目の item_status 遷移基準
|
|
178
176
|
|
|
179
177
|
#### 5.3.1. item_type 別の item_status 終端基準
|
|
180
178
|
|
|
181
|
-
`item_status` の通常終端は、登録した目的を達成したときに使用する。
|
|
179
|
+
`item_status` の通常終端は、登録した目的を達成したときに使用する。
|
|
182
180
|
|
|
183
181
|
| `item_type` | 通常終端 | 遷移条件 | `conclusion` に残す内容 |
|
|
184
182
|
| ---------------- | --------- | ---------------------------------------------------------------------- | ---------------------------- |
|
|
@@ -191,12 +189,8 @@ Project Register Documentation Rules
|
|
|
191
189
|
| `issue` | `done` | 問題を解消し、必要な確認を終えた | 解決内容と確認結果 |
|
|
192
190
|
| `change-request` | `done` | 採択した変更を対象へ反映し、必要な確認を終えた | 反映内容と確認結果 |
|
|
193
191
|
|
|
194
|
-
- `
|
|
195
|
-
- `
|
|
196
|
-
- `epic` は todo と同じ処理状態と例外終端(`rejected` / `deferred`)を使用する。`exec run --register` の実行対象にはせず、filter と夜間 queue も飛ばす。具体的な作業は子 todo で実行する。
|
|
197
|
-
- `note` の `open` は未対応を意味しない。内容を継続して更新できる、生きている記録であることを示す。
|
|
198
|
-
- `note` から対応・回答・判断が必要になった場合は、`todo` / `question` / `decision` など目的に合う別項目を起票し、note 自体は `open` のまま参照元として保持する。
|
|
199
|
-
- `note` の内容が陳腐化または置換された場合は、その事実と参照先を本文へ追記する。`done` / `decided` / `rejected` / `deferred` へ遷移させて閉じない。
|
|
192
|
+
- `epic` は todo と同じ処理状態と例外終端を使用する。`exec run --register` の実行対象にはせず、filter と夜間 queue も飛ばす。具体的な作業は子 todo で実行する。
|
|
193
|
+
- `note` の `open` は未対応を意味せず、継続して更新できる記録であることを示す。対応・回答・判断が必要になった場合は目的に合う別項目を起票し、陳腐化・置換された場合はその事実と参照先を追記する。note 自体は終端させない。
|
|
200
194
|
|
|
201
195
|
#### 5.3.2. 例外的な追跡終了
|
|
202
196
|
|
|
@@ -207,30 +201,26 @@ Project Register Documentation Rules
|
|
|
207
201
|
| `rejected` | 対応・回答・判断の対象外、前提不成立、または変更を採択しないことが確定した | 採択しない理由と、必要なら代替の追跡先を記録する |
|
|
208
202
|
| `deferred` | 現時点の追跡を停止し、再開条件または再評価時期を定めた | 再開条件または再評価時期を記録する |
|
|
209
203
|
|
|
210
|
-
- `rejected`
|
|
211
|
-
- `deferred`
|
|
212
|
-
- `question` / `decision` で回答または決定を得た場合は `rejected` ではなく `decided` を使う。問い・判断自体が不要になった場合だけ `rejected` を使う。
|
|
204
|
+
- `rejected` は完了・決定の代用にせず、実施または採択しない判断が確定した場合だけ使う。`question` / `decision` で回答・決定を得た場合は `decided` とし、問い・判断自体が不要になった場合だけ `rejected` を使う。
|
|
205
|
+
- `deferred` は状態遷移上の終端だが、完了を意味しない。再開するときは `register reopen` を使う。
|
|
213
206
|
- `risk` を受容して監視を終える場合は、受容判断と残存影響を `conclusion` に記録したうえで `done` とする。リスクの前提が誤りだった場合は `rejected` とする。
|
|
214
207
|
|
|
215
208
|
#### 5.3.3. 中間状態を経ない終端
|
|
216
209
|
|
|
217
210
|
終端への遷移は、`in-progress` / `waiting` / `review` を経ていることを前提としない。`open` から直接終端させてよい。
|
|
218
211
|
|
|
219
|
-
- 人または対話型 orchestrator
|
|
220
|
-
-
|
|
221
|
-
- 中間状態を経ない場合は、誰がどの経路で対応したかを終端イベントの `reason` へ記録する。exec の plan / result / evidence が存在しないため、実施内容と検証結果は個票の対応結果へ残す。
|
|
222
|
-
- 実行していない主体を actor とする遷移を、記録の体裁を整える目的で追加しない。
|
|
212
|
+
- 人または対話型 orchestrator が着手を記録する前に完了した項目で、`start` を遡って記録しない。`exec run` の項目は runner が `start` を記録する。
|
|
213
|
+
- 中間状態を経ない場合は、誰がどの経路で対応したかを終端イベントの `reason` へ記録し、実施内容と検証結果を個票の対応結果へ残す(exec の plan / result / evidence がないため)。
|
|
223
214
|
|
|
224
215
|
### 5.4. 個票 status の遷移基準
|
|
225
216
|
|
|
226
|
-
| `status` | 意味
|
|
227
|
-
| ------------ |
|
|
228
|
-
| `draft` |
|
|
229
|
-
| `ready` |
|
|
230
|
-
| `deprecated` | 却下・破棄され成熟度を追う必要がない
|
|
217
|
+
| `status` | 意味 | 遷移させる時点 |
|
|
218
|
+
| ------------ | -------------------------------------- | ------------------------------------------------- |
|
|
219
|
+
| `draft` | 作成直後。必須節が未確定 | `register add` で個票を生成した時点 |
|
|
220
|
+
| `ready` | 必須節が固まり `_TODO_` が残っていない | `register close` 時に必須節を満たすと判定した時点 |
|
|
221
|
+
| `deprecated` | 却下・破棄され成熟度を追う必要がない | `register reject` 時点 |
|
|
231
222
|
|
|
232
|
-
-
|
|
233
|
-
- `ready` への昇格には、type 固有の必須節に `_TODO_` が残っていないことを要する。
|
|
223
|
+
- 必須節とその判定は `個別登録項目` に従う。
|
|
234
224
|
- `reopen` は過去の結果を消さず、再開理由と新しい対応状況を個票本文へ追記する。
|
|
235
225
|
|
|
236
226
|
## 6. 禁止事項
|
|
@@ -238,9 +228,9 @@ Project Register Documentation Rules
|
|
|
238
228
|
- 生成された `pjr-index.md`、補助一覧、controls 全体の派生ビューを直接編集しない。
|
|
239
229
|
- 一覧と個票の同期、一覧から個票への書き戻し、または個票を作るかどうかの分離基準を設けない。
|
|
240
230
|
- 構造化フィールドを個票本文や別の正本へ重複管理しない。
|
|
241
|
-
- `
|
|
231
|
+
- `item_type` / `item_status` / `priority` / `difficulty` に schema 未定義の値を使用しない。
|
|
242
232
|
- `registered_at` / `completed_at` に、UTC 以外のオフセットやタイムゾーンを伴わない値、暦日だけの値を保存しない。
|
|
243
233
|
- 個票の文書 ID から `<topic>` を省略したり、ファイル名と異なるローカル ID を使用したりしない。
|
|
244
|
-
-
|
|
234
|
+
- 必須節を、見出しだけ残した空欄のまま終端状態にしない。
|
|
245
235
|
- 実行していない主体を actor とする状態遷移を、記録の体裁を揃える目的で追加しない。
|
|
246
236
|
- `events/pjr-XXXX.yaml` を手書きで追加・修正・並べ替え・削除しない。履歴補正が必要な場合も register コマンドを使い、監査イベントを破壊しない。
|
|
@@ -16,31 +16,24 @@ Change Request Log Documentation Rules
|
|
|
16
16
|
|
|
17
17
|
## 1. 全体方針
|
|
18
18
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
19
|
+
- 変更要求ごとに、申請から影響評価、審査・決定、実施追跡までを判定できる形で残す。
|
|
20
|
+
- 審査は `pm-plan` のスコープと優先順位に照らして行い、その対応を決定の根拠に書く。
|
|
21
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
22
22
|
|
|
23
|
-
## 2.
|
|
23
|
+
## 2. 位置づけ
|
|
24
24
|
|
|
25
|
-
- `pm-
|
|
26
|
-
-
|
|
27
|
-
- `pm-risk-register
|
|
28
|
-
- `pm-change-request-log`: 変更要求の審査・決定と実施追跡。
|
|
25
|
+
- プロジェクト登録簿を使うプロジェクトでは、変更要求 1 件を `item_type: change-request` の個票に書き、`controls/generated/pm-change-request-log.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
|
|
26
|
+
- 本書の章ごとの判断基準は、個票の同名の節と、登録簿を使わない単独の変更要求ログの両方に適用する。
|
|
27
|
+
- 変更から生じたリスク・課題は `pm-risk-register`・`pm-issue-log` 側の項目として起票し、関連ドキュメントで結ぶ。
|
|
29
28
|
|
|
30
29
|
## 3. ファイル命名・ID規則
|
|
31
30
|
|
|
32
|
-
- `id` は `pm-change-request-log`
|
|
33
|
-
-
|
|
31
|
+
- `id` は `<project-id>:pm-change-request-log`、ファイル名は `pm-change-request-log.md` とする。
|
|
32
|
+
- 変更 ID は登録簿では `PJR-XXXX`、単独のログでは `CR-NNN` とし、再利用しない。
|
|
34
33
|
|
|
35
34
|
## 4. 推奨 Frontmatter 項目
|
|
36
35
|
|
|
37
|
-
|
|
38
|
-
| ---------- | -------------------------------- | ---- |
|
|
39
|
-
| id | `pm-change-request-log` | ○ |
|
|
40
|
-
| type | `project` 固定 | ○ |
|
|
41
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
42
|
-
| based_on | 根拠仕様ID(配列) | 任意 |
|
|
43
|
-
| supersedes | 置換関係ID(配列) | 任意 |
|
|
36
|
+
- 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
|
|
44
37
|
|
|
45
38
|
## 5. 本文構成(標準テンプレ)
|
|
46
39
|
|
|
@@ -61,35 +54,33 @@ Change Request Log Documentation Rules
|
|
|
61
54
|
|
|
62
55
|
### 6.2. 変更要求一覧
|
|
63
56
|
|
|
64
|
-
- 変更 ID
|
|
65
|
-
|
|
66
|
-
推奨フォーマット(表):
|
|
67
|
-
|
|
68
|
-
| 変更ID | 要求内容 | 申請者 | 申請日 | 状態 |
|
|
69
|
-
| ------ | -------- | ------ | ------ | ---- |
|
|
57
|
+
- 変更 ID、要求内容、申請者、申請日、状態に加え、変更理由(応える業務課題・期待価値)を書く。
|
|
58
|
+
- 要求内容は「何を・どう変えるか」が 1 文で分かる形にする(例: 「日次売上CSVの列順を会計ソフトの取込順に変える」)。
|
|
70
59
|
|
|
71
60
|
### 6.3. 影響評価
|
|
72
61
|
|
|
73
|
-
-
|
|
62
|
+
- スコープ・工数・品質・納期の観点ごとに、影響の有無と量(人日・日数など)と根拠を書く。
|
|
63
|
+
- 採否の判断材料として、見送ったときの影響と期待効果を書く。
|
|
74
64
|
|
|
75
65
|
### 6.4. 審査・決定
|
|
76
66
|
|
|
77
|
-
-
|
|
67
|
+
- 審査結果は「承認・条件付き承認・却下・保留」のいずれかとし、決定者・決定日・実施条件と、`pm-plan` のスコープ・優先順位との対応を書く。
|
|
78
68
|
|
|
79
69
|
### 6.5. 実施追跡
|
|
80
70
|
|
|
81
|
-
-
|
|
71
|
+
- 実施担当、期限、進捗、完了条件を書く。完了条件は確認の手段と合格の基準で書く(例: 「受入テストで新しい列順を会計ソフトへ取り込めること」)。
|
|
82
72
|
|
|
83
73
|
### 6.6. 関連ドキュメント
|
|
84
74
|
|
|
85
|
-
-
|
|
86
|
-
- 関連がない場合でも `(本書のみ)` を明記する。
|
|
75
|
+
- 根拠(`pm-plan` など)、影響先、変更から起票したリスク・課題を文書 ID で示す。関連がない場合は `(本書のみ)` と書く。
|
|
87
76
|
|
|
88
77
|
## 7. 禁止事項
|
|
89
78
|
|
|
90
|
-
| 禁止事項
|
|
91
|
-
|
|
|
92
|
-
| 変更IDを未採番で記録する
|
|
93
|
-
| 影響評価なしで承認可否を記載する
|
|
94
|
-
| 決定者・決定日を省略する
|
|
95
|
-
| 実装詳細やコード差分を本文に貼り付ける
|
|
79
|
+
| 禁止事項 | 理由 |
|
|
80
|
+
| -------------------------------------------- | -------------------------- |
|
|
81
|
+
| 変更IDを未採番で記録する | 追跡不能になるため |
|
|
82
|
+
| 影響評価なしで承認可否を記載する | 判断根拠が欠落するため |
|
|
83
|
+
| 決定者・決定日を省略する | 監査性が失われるため |
|
|
84
|
+
| 実装詳細やコード差分を本文に貼り付ける | 管理対象が肥大化するため |
|
|
85
|
+
| 個人情報・認証情報を要求内容や根拠に書き写す | 公開範囲を超えて広がるため |
|
|
86
|
+
| 生成された `pm-change-request-log.md` を直す | 再生成で修正が失われるため |
|
|
@@ -16,102 +16,79 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
Communication Plan Documentation Rulebook
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
判断・確認・共有のためのコミュニケーション機会と証跡を定義する基準です。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
- 関係者の期待・懸念・影響度、Role code の定義、個人連絡先は本書へ複製しません。
|
|
27
|
-
- 重要判断、当事者確認、費用・負荷の合意、公開判断が伝達漏れにならないことを優先します。
|
|
28
|
-
- AI Agent は草案や整理を支援できますが、合意・承認・公開判断は人間が行います。
|
|
23
|
+
- 重要判断、当事者確認、費用・負荷の合意、公開判断の伝達漏れを防ぎます。
|
|
24
|
+
- 会議・報告・通知は一表へ統合し、定例会議は必須とせず、非同期確認を選べます。
|
|
25
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
|
|
29
26
|
|
|
30
|
-
## 2.
|
|
27
|
+
## 2. 位置づけ
|
|
31
28
|
|
|
32
|
-
|
|
33
|
-
| ---------------------- | ------------------------------------------------------------ |
|
|
34
|
-
| コミュニケーション機会 | 判断、確認、共有、相談が必要になるイベントまたは作業節目 |
|
|
35
|
-
| 対象 | 情報を受け取り、確認または判断する関係者・Role code |
|
|
36
|
-
| 証跡 | 合意、判断、確認結果を後から追跡できる記録 |
|
|
37
|
-
| エスカレーション | 所定の条件で、一次対応から人間の最終判断者へ判断を上げること |
|
|
29
|
+
管理計画の判断ゲートとステークホルダー登録簿の情報要求を、報告・連絡・会議へ具体化します。担当者は作業節目や問題発生時に、伝達先・時期・判断経路・記録先を本計画で確認します。関係者の期待・懸念・影響度は登録簿、Role code はロール定義を正とします。
|
|
38
30
|
|
|
39
31
|
## 3. ファイル命名・ID規則
|
|
40
32
|
|
|
41
33
|
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-communication-plan.md` を推奨します。
|
|
42
|
-
- ID は `<project-id>:pm-communication-plan
|
|
43
|
-
|
|
34
|
+
- ID は `<project-id>:pm-communication-plan` とします。
|
|
44
35
|
- 関係者はステークホルダー ID、責任主体は採用済み Role code で記述します。
|
|
45
36
|
|
|
46
37
|
## 4. 推奨 Frontmatter 項目
|
|
47
38
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
| rulebook | `specdojo:pm-communication-plan-rulebook` | ○ |
|
|
54
|
-
| based_on | 管理計画、ステークホルダー登録簿などの ID | 任意 |
|
|
55
|
-
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
39
|
+
共通項目はドキュメントメタ情報標準に従います。
|
|
40
|
+
|
|
41
|
+
- `type`: `project`
|
|
42
|
+
- `rulebook`: `specdojo:pm-communication-plan-rulebook`
|
|
43
|
+
- `based_on`: 管理計画・ステークホルダー登録簿など、直接の根拠
|
|
56
44
|
|
|
57
45
|
## 5. 本文構成(標準テンプレ)
|
|
58
46
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
47
|
+
| 章 | 必須 | 内容・受入条件 |
|
|
48
|
+
| ---------------------- | ---- | ------------------------------------------------ |
|
|
49
|
+
| 方針と適用範囲 | ○ | 対象・目的と同期・非同期の選択が分かること |
|
|
50
|
+
| コミュニケーション機会 | ○ | 情報要求に対応する実施機会と結果を追跡できること |
|
|
51
|
+
| エスカレーション | ○ | 条件に応じた判断経路を辿れること |
|
|
52
|
+
| 情報管理と公開 | ○ | 情報区分ごとの共有範囲と記録先が分かること |
|
|
53
|
+
| 見直し条件と未決事項 | 任意 | 見直しトリガー、未決論点と影響 |
|
|
66
54
|
|
|
67
55
|
## 6. 記述ガイド
|
|
68
56
|
|
|
69
57
|
### 6.1. 方針と適用範囲
|
|
70
58
|
|
|
71
|
-
|
|
72
|
-
- 常設会議を置くか、作業節目の非同期確認を基本とするかを示します。
|
|
73
|
-
- 個人名や連絡先ではなく、ステークホルダー ID または Role code を使います。
|
|
59
|
+
対象プロジェクト、主要な関係者、必要な合意の種類を要約し、常設会議か作業節目の非同期確認かを示します。
|
|
74
60
|
|
|
75
61
|
### 6.2. コミュニケーション機会
|
|
76
62
|
|
|
77
63
|
| 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
|
|
78
64
|
| ---------- | -------------------- | ---------- | ---- | ---- | ---- |
|
|
79
65
|
|
|
80
|
-
|
|
81
|
-
- 会議、報告、通知を同じ表で扱い、同じ内容を複数行へ重複させません。
|
|
82
|
-
- 対象者が判断または確認できる内容と、結果の記録先を明記します。
|
|
66
|
+
登録簿の情報要求を判断・確認・共有・相談の機会へ変換し、対象者が判断できる内容と結果の記録先を明記します。
|
|
83
67
|
|
|
84
68
|
### 6.3. エスカレーション
|
|
85
69
|
|
|
86
70
|
| 条件 | 一次対応 | 最終判断 | 証跡 |
|
|
87
71
|
| ---- | -------- | -------- | ---- |
|
|
88
72
|
|
|
89
|
-
|
|
90
|
-
- 緊急度よりも、誰の判断が必要かを基準にします。
|
|
91
|
-
- Agent 出力の疑義は人間の成果物責任者または最終判断者へ上げます。
|
|
73
|
+
目的・スコープ、当事者価値、費用・負荷、品質・安全(Agent 出力の疑義を含む)、公開・権利など、判断者が変わる条件を分けます。緊急度よりも、誰の判断が必要かを基準にします。
|
|
92
74
|
|
|
93
75
|
### 6.4. 情報管理と公開
|
|
94
76
|
|
|
95
77
|
| 情報区分 | 取扱い | 記録先 |
|
|
96
78
|
| -------- | ------ | ------ |
|
|
97
79
|
|
|
98
|
-
|
|
99
|
-
- 個人情報、秘密情報、認証情報を公開記録や Agent 入力へ含めません。
|
|
100
|
-
- 正本と生成ビューがある場合は、正本側で更新して再生成します。
|
|
80
|
+
公開、限定共有、記録禁止など必要な区分を定義し、各手段で扱える情報と記録先を対応させます。
|
|
101
81
|
|
|
102
82
|
### 6.5. 見直し条件と未決事項
|
|
103
83
|
|
|
104
84
|
- ステークホルダー、判断ゲート、公開方針、連絡手段が変わった場合に見直します。
|
|
105
|
-
- 未決事項は _UNDECIDED_
|
|
106
|
-
- 日常的に追跡する課題は本書ではなく登録簿へ移します。
|
|
85
|
+
- 未決事項は `_UNDECIDED_` を付し、論点と伝達先・時期・手段への影響を示します。
|
|
107
86
|
|
|
108
87
|
## 7. 禁止事項
|
|
109
88
|
|
|
110
|
-
| 禁止事項
|
|
111
|
-
|
|
|
112
|
-
| ステークホルダー登録簿やRole code一覧を再掲する
|
|
113
|
-
| 会議体、報告、チャネルへ同じ情報を重複記載する
|
|
114
|
-
| 目的や証跡のない定例会議を必須にする
|
|
115
|
-
| エスカレーション条件を「必要に応じて」とだけ書く
|
|
116
|
-
| Agent に合意、承認、公開判断を委ねる | 人間の判断責任を代替するため |
|
|
117
|
-
| 個人名、連絡先、秘密・認証情報、実装詳細を記載する | 公開適性と文書責務に反するため |
|
|
89
|
+
| 禁止事項 | 理由 |
|
|
90
|
+
| ------------------------------------------------ | -------------------------------------- |
|
|
91
|
+
| ステークホルダー登録簿やRole code一覧を再掲する | 正本が分散するため |
|
|
92
|
+
| 会議体、報告、チャネルへ同じ情報を重複記載する | 更新漏れと過剰な運用を招くため |
|
|
93
|
+
| 目的や証跡のない定例会議を必須にする | コミュニケーション自体が負荷になるため |
|
|
94
|
+
| エスカレーション条件を「必要に応じて」とだけ書く | 判断時点が不明になるため |
|