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
|
@@ -12,137 +12,105 @@ 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、メンバー定義を同じ責務語彙で接続するためのルールです。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- 専任者の有無と Role code の採用を分け、責務語彙として必要なロールは一覧に残します。
|
|
24
|
+
- 共通の責務や規模別の採用パターンは上位標準を参照し、プロジェクト固有の扱いだけを短く補足します。
|
|
25
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
|
|
24
26
|
|
|
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 に残す前提で記載する。
|
|
27
|
+
## 2. 位置づけ
|
|
32
28
|
|
|
33
|
-
|
|
29
|
+
共通用語と標準ロールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
|
|
34
30
|
|
|
35
|
-
|
|
31
|
+
| 管理先 | 担う情報・接続 |
|
|
32
|
+
| -------------------------------------------------- | ------------------------------------------------------------------ |
|
|
33
|
+
| `pm-organization.md` | 採用・未採用コード、使用可能な `owner`、採用理由、見直し条件の正本 |
|
|
34
|
+
| `pm-roles.yaml` | 採用コード・正式名称・固有メモの機械可読な転記先 |
|
|
35
|
+
| `pm-members.yaml` / `.specdojo/agent-members.yaml` | 人間 / agent の実行主体・対応ロール・兼務 |
|
|
36
|
+
| Schedule / `pm-raci.md` | コードを `owner` / 責任分担の列として参照 |
|
|
36
37
|
|
|
37
|
-
|
|
38
|
-
| -------------------- | ---------------------------------------------- | -------------------------------------- |
|
|
39
|
-
| `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
|
|
38
|
+
## 3. ファイル命名・ID規則
|
|
40
39
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
| `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
|
|
40
|
+
- 組織定義・メンバー定義と同じ `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml` に置くことを推奨します。
|
|
41
|
+
- ID は `<project-id>:pm-roles`、`project_id` は配置先プロジェクトに合わせます。
|
|
42
|
+
- 共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
45
43
|
|
|
46
|
-
|
|
44
|
+
## 4. 推奨メタ項目
|
|
47
45
|
|
|
48
|
-
|
|
49
|
-
| ------------ | ------------------------------------------------------ | ---------------------------------------- |
|
|
50
|
-
| Role code | 責務・判断権限・専門性を表す短い識別子 | `roles[].code` に列挙する |
|
|
51
|
-
| Role name | Role code の正式名称 | `roles[].name` に記載する |
|
|
52
|
-
| Project note | 当該プロジェクトでの扱い、専任化条件、公開判断上の注意 | `roles[].project_note` に 1 行で記載する |
|
|
46
|
+
メタ項目は YAML 先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml` を正本とします。
|
|
53
47
|
|
|
54
|
-
|
|
48
|
+
- `id` / `project_id` / `title` / `type` / `status` / `version` / `rulebook` は必須です。
|
|
49
|
+
- `type` は `project`、`rulebook` は `specdojo:pm-roles-rulebook`、`status` の値域は `draft` / `ready` / `deprecated` です。
|
|
50
|
+
- `based_on` / `supersedes` は任意です。
|
|
55
51
|
|
|
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`
|
|
52
|
+
## 5. 本文要件
|
|
62
53
|
|
|
63
|
-
|
|
54
|
+
骨組みは Frontmatter の template、構造・型は対応 schema を正本とします。
|
|
64
55
|
|
|
65
|
-
|
|
66
|
-
|
|
56
|
+
| キー | 必須・任意 | 目的・内容要件 |
|
|
57
|
+
| ---------------------- | ---------- | ----------------------------------------------------------------------- |
|
|
58
|
+
| `roles` | 必須 | 採用全コードの配列。`PO` を含み、コードは一意。組織定義の採用集合と一致 |
|
|
59
|
+
| `roles[].code` | 必須 | 下流の `owner`・RACI・メンバー定義を接続する識別子 |
|
|
60
|
+
| `roles[].name` | 必須 | 上位標準の正式名称で責務を識別 |
|
|
61
|
+
| `roles[].project_note` | 任意 | プロジェクト固有の扱い。補足がなければ省略する |
|
|
67
62
|
|
|
68
|
-
|
|
69
|
-
| -------- | ---------------------------------------- | ---- |
|
|
70
|
-
| `id` | `<project-id>:pm-roles` 形式の成果物 ID | ○ |
|
|
71
|
-
| `type` | `project` 固定 | ○ |
|
|
72
|
-
| `status` | `draft` / `ready` / `deprecated` | ○ |
|
|
73
|
-
| `title` | ドキュメント名。表示ページの見出しになる | ○ |
|
|
63
|
+
## 6. 記述ガイド
|
|
74
64
|
|
|
75
|
-
|
|
76
|
-
| `based_on` | 根拠ドキュメント ID の配列 | 任意 |
|
|
77
|
-
| `version` | データバージョン。初期値は `1` | ○ |
|
|
78
|
-
| `project_id` | プロジェクト ID | ○ |
|
|
65
|
+
### 6.1. メタ項目と根拠
|
|
79
66
|
|
|
80
|
-
|
|
67
|
+
カタログ利用時、`based_on` は依存の推移閉包内に限定します。
|
|
81
68
|
|
|
82
|
-
|
|
69
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
70
|
+
| ---------- | ------------------------------------------ | ---------------------------------------- |
|
|
71
|
+
| 根拠の選択 | 採用方針を確認した組織定義の ID を指定する | 同じディレクトリの文書を未確認で列挙する |
|
|
83
72
|
|
|
84
|
-
`
|
|
73
|
+
### 6.2. `roles` の採用範囲
|
|
85
74
|
|
|
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 の配列 |
|
|
75
|
+
採用集合と使用可能な `owner` の部分集合を取り違えず、記載順は上位標準の定義順を推奨します。
|
|
97
76
|
|
|
98
|
-
|
|
77
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
78
|
+
| ------------ | -------------------------------------------- | -------------------------------------------- |
|
|
79
|
+
| 最小構成 | 最終判断を担う `PO` を含む採用集合を転記する | 実作業だけを見て `BA` と `QE` だけを列挙する |
|
|
80
|
+
| 兼務時の扱い | 採用済みの `PM` を管理タスクの語彙として残す | 専任者がいないという理由だけで `PM` を除く |
|
|
99
81
|
|
|
100
|
-
|
|
101
|
-
| -------------- | ---- | --------------------------------------------------------------------- |
|
|
102
|
-
| `code` | ○ | Role code。標準 Role code を使う |
|
|
103
|
-
| `name` | ○ | Role の正式名称 |
|
|
104
|
-
| `project_note` | 任意 | プロジェクト固有の扱い、専任化条件、公開判断上の注意を 1 行で記述する |
|
|
82
|
+
### 6.3. `roles[].code` と `roles[].name`
|
|
105
83
|
|
|
106
|
-
|
|
84
|
+
`code` は schema の標準コード `PO`、`PM`、`BA`、`ARC`、`DEV`、`QE`、`UX`、`OPS` に限定します。`name` は人と組織の定義標準の正式名称と対応させ、担当者や職位で置き換えません。
|
|
107
85
|
|
|
108
|
-
|
|
86
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
87
|
+
| -------- | ----------------------------------- | ------------------------------------ |
|
|
88
|
+
| 識別子 | `code: PM` を下流でも同じ表記で使う | `code: project-manager-agent` を使う |
|
|
89
|
+
| 正式名称 | `name: Project Manager` | `name: 開発部長` |
|
|
109
90
|
|
|
110
|
-
|
|
111
|
-
- 記載順は標準ロールの定義順(`PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS`)に揃えることを推奨する。
|
|
112
|
-
- 標準 Role code のみを使用し、プロジェクト固有の独自コードを追加しない。
|
|
113
|
-
- `roles[].code` は重複させない。
|
|
114
|
-
- 専任 member がいない Role code でも、Schedule の `owner`、RACI、レビュー観点、下流文書で責務語彙として使う場合は残す。
|
|
91
|
+
### 6.4. `roles[].project_note`
|
|
115
92
|
|
|
116
|
-
|
|
93
|
+
責務の重点や専任化の条件など、固有の扱いを 1 行で記述します。一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、論点と採用範囲・下流参照への影響を示します。
|
|
117
94
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
95
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
96
|
+
| ---------------- | ----------------------------------------------------- | ---------------------------------- |
|
|
97
|
+
| 判断できる条件 | 週次管理の滞留が続く場合、PO が PM の専任化を判断する | 必要に応じて管理する |
|
|
98
|
+
| 固有性 | 店頭の欠品と記録漏れを受入確認で重視する | 上位標準の品質責務を全文転記する |
|
|
99
|
+
| 実行主体との分離 | 実行主体はメンバー定義で管理する | PM は特定の個人や agent が担当する |
|
|
122
100
|
|
|
123
|
-
### 6.
|
|
101
|
+
### 6.5. 変更時の追従と完了判断
|
|
124
102
|
|
|
125
|
-
|
|
126
|
-
- 略称だけ、プロジェクト固有の担当者名、組織内の職位名に置き換えない。
|
|
127
|
-
- Role code と対応が分かる一般的な英語名を使う。
|
|
103
|
+
受入確認は次の順で行います。
|
|
128
104
|
|
|
129
|
-
|
|
105
|
+
1. `pm-roles.schema.yaml` で検証します。SpecDojo 開発リポジトリでは `npm run validate:schema:file -- --schema docs/specdojo/schemas/v1/pm-roles.schema.yaml --data <対象ファイル>` の終了コード 0 を確認します。
|
|
106
|
+
2. schema の配列要素全体の一意性ではコード重複を検出しきれないため、コードの重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合します。
|
|
107
|
+
3. WBS・Schedule の `owner`、RACI、人間・agent のメンバー定義、レビュー観点の参照を照合し、未定義コードがないことを確認します。採用判断と下流参照に差分があれば修正先を確かめ、ロール削除時は責務の移管先も確認します。
|
|
130
108
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
- 公開文書として再利用できる粒度にし、個別組織の内部事情や非公開運用を含めない。
|
|
136
|
-
- 記載すべき内容がない場合は省略してよい。
|
|
109
|
+
| 判断点 | 良い例 | 悪い例 |
|
|
110
|
+
| ---------- | -------------------------------------------------- | ------------------------------------------- |
|
|
111
|
+
| 変更完了 | 採用集合・名称・下流参照の照合結果がすべて一致する | YAML の構文が通ったことだけで変更完了にする |
|
|
112
|
+
| ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
|
|
137
113
|
|
|
138
114
|
## 7. 禁止事項
|
|
139
115
|
|
|
140
|
-
|
|
141
|
-
| -------------------------------------------------------------------------- | --------------------------------------------------- |
|
|
142
|
-
| 標準にない独自 Role code を追加する | Schedule、RACI、member 定義との接続が壊れるため |
|
|
143
|
-
| `roles[].code` に member nickname、agent 名、個人名、stakeholder ID を書く | Role と実行主体が混同されるため |
|
|
144
|
-
| 兼務の割り当てや実行主体を本ファイルに記載する | member 名簿の責務であり重複管理になるため |
|
|
145
|
-
| ロール採用の根拠・方針・見直し条件を長く記載する | `pm-organization.md` の責務であり重複管理になるため |
|
|
146
|
-
| 公開できない個人情報、連絡先、非公開組織情報、アクセス情報を記載する | PO の公開可否判断と説明責任を損なうため |
|
|
147
|
-
| AI Agent に最終承認、公開可否、説明責任を持たせる記述を置く | 人間の PO が最終判断を担う前提に反するため |
|
|
148
|
-
| schema にない任意メタ項目を追加する | 機械検証と下流処理の互換性が壊れるため |
|
|
116
|
+
- schema にないキーで採用理由や兼務割り当てを管理しません。機械処理の互換性と正本の責任境界を損なうためです。
|
|
@@ -13,15 +13,14 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
Progress Report Documentation Rulebook
|
|
15
15
|
|
|
16
|
-
本ドキュメントは、進捗報告(`pr-<yyyy-mm-dd>-<nn>`)を統一形式で記述するためのルールを定義する。
|
|
17
|
-
|
|
18
16
|
## 1. 全体方針
|
|
19
17
|
|
|
20
18
|
- 報告期間の進捗、リスク、次アクションを定点観測できる形で記録する。
|
|
21
19
|
- 完了事項と未完了事項を区別して報告する。
|
|
22
20
|
- 判断に必要な数値・根拠を明示する。
|
|
21
|
+
- 共通の運用: Frontmatter の項目(`specdojo.type` は `project`)、`status` の昇格と承認、改訂と廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。
|
|
23
22
|
|
|
24
|
-
## 2.
|
|
23
|
+
## 2. 位置づけ
|
|
25
24
|
|
|
26
25
|
- 進捗報告は定期レビューの基礎資料として扱う。
|
|
27
26
|
- 議事録、課題ログ、変更要求ログと整合を取る。
|
|
@@ -30,18 +29,9 @@ Progress Report Documentation Rulebook
|
|
|
30
29
|
|
|
31
30
|
- 推奨: `pr-<yyyy-mm-dd>-<nn>.md`
|
|
32
31
|
- 日付はISO形式、連番は2桁ゼロ埋めを推奨する。
|
|
32
|
+
- 文書 ID は `<project-id>:pr-<yyyy-mm-dd>-<nn>` 形式とする(例: `prj-0001:pr-2026-03-01-01`)。
|
|
33
33
|
|
|
34
|
-
## 4.
|
|
35
|
-
|
|
36
|
-
| 項目 | 説明 | 必須 |
|
|
37
|
-
|
|
38
|
-
| ------ | -------------------------------- | ---- |
|
|
39
|
-
| id | `pr-<yyyy-mm-dd>-<nn>` | ○ |
|
|
40
|
-
|
|
41
|
-
| type | `project` | ○ |
|
|
42
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
43
|
-
|
|
44
|
-
## 5. 本文構成(標準テンプレ)
|
|
34
|
+
## 4. 本文構成(標準テンプレ)
|
|
45
35
|
|
|
46
36
|
| 番号 | 見出し | 必須 |
|
|
47
37
|
| ---- | ------------ | ---- |
|
|
@@ -51,16 +41,14 @@ Progress Report Documentation Rulebook
|
|
|
51
41
|
| 4 | リスク・課題 | ○ |
|
|
52
42
|
| 5 | 次期予定 | ○ |
|
|
53
43
|
|
|
54
|
-
##
|
|
44
|
+
## 5. 記述ガイド
|
|
55
45
|
|
|
56
46
|
- 完了事項は成果物IDまたはタスクIDと紐づける。
|
|
57
|
-
|
|
58
47
|
- リスク・課題は影響度と対応方針を明記する。
|
|
59
48
|
- 次期予定は担当者と期日を設定する。
|
|
60
49
|
|
|
61
|
-
##
|
|
50
|
+
## 6. 禁止事項
|
|
62
51
|
|
|
63
52
|
- 進捗率のみで根拠なく報告しない。
|
|
64
53
|
- リスクを抽象語のみで記載しない。
|
|
65
|
-
|
|
66
54
|
- 予定に期限や責任者を欠いたまま確定しない。
|
|
@@ -17,23 +17,17 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
Assumptions, Constraints and Dependencies Documentation Rulebook
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
プロジェクトの成立条件、守るべき限界、外部・先行成果物への依存を整理し、変化時の影響と対応の判断基準を定める。
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
- 各項目は、条件だけで終わらせず、影響、確認方法、変化または逸脱のトリガー、所有者、対応方針を一組で記載する。
|
|
24
|
+
- 各項目には影響・確認方法・トリガー・所有者・対応方針を記載する。
|
|
26
25
|
- 前提は「成立するものとして置く条件」、制約は「守るべき限界」、依存関係は「他者・外部サービス・先行成果物などから受ける条件」として分離する。
|
|
27
|
-
-
|
|
28
|
-
- 上位文書がすでに継続的な監視・記録先を持つ事項(判断ゲートの記録先が明示された章など)は、内容を要約して再登録せず参照にとどめる。上位文書が結論だけを示し継続監視の仕組みを持たない場合は、監視方法・トリガー・所有者・対応方針を付与して運用可能な形に展開してよいが、その場合は展開元の上位文書と章を明示する。
|
|
26
|
+
- 上位文書で確定済みの対象外・境界・責務や、継続監視・記録先を持つ事項は再登録せず、該当章の冒頭で正本へ委譲する。結論だけで監視の仕組みがない条件は、展開元の文書・章を示し、確認方法・トリガー・所有者・対応方針を補って登録できる。委譲先に条件が実在することを確認する。
|
|
29
27
|
- 文書は計画・設計・実装の詳細やリスク登録簿を代替しない。必要な詳細はそれぞれの成果物に委譲する。
|
|
30
|
-
-
|
|
28
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
|
|
31
29
|
|
|
32
|
-
## 2.
|
|
33
|
-
|
|
34
|
-
### 2.1. 位置づけ
|
|
35
|
-
|
|
36
|
-
本書はスコープで定めた境界を受け、実行上の成立条件と変更時の判断材料を明示する。前提・制約・依存が変化した結果としてリスク、変更要求、計画へ影響を伝える。
|
|
30
|
+
## 2. 位置づけ
|
|
37
31
|
|
|
38
32
|
```mermaid
|
|
39
33
|
flowchart LR
|
|
@@ -48,77 +42,47 @@ flowchart LR
|
|
|
48
42
|
class ACD target
|
|
49
43
|
```
|
|
50
44
|
|
|
51
|
-
### 2.2. 用語定義
|
|
52
|
-
|
|
53
|
-
| 用語 | 定義 |
|
|
54
|
-
| -------- | -------------------------------------------------------------------------------------------- |
|
|
55
|
-
| 前提条件 | プロジェクトの計画または進行が成立するものとして置く条件。崩れた場合の影響と確認方法を伴う。 |
|
|
56
|
-
| 制約事項 | 予算、期限、公開範囲、技術選択、責務境界など、逸脱してはならない限界。 |
|
|
57
|
-
| 依存関係 | 外部組織、サービス、先行成果物、意思決定などが提供または確定することを必要とする関係。 |
|
|
58
|
-
| トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
|
|
59
|
-
| 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
|
|
60
|
-
|
|
61
45
|
## 3. ファイル命名・ID規則
|
|
62
46
|
|
|
63
|
-
### 3.1.
|
|
47
|
+
### 3.1. 成果物の配置と文書 ID
|
|
64
48
|
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
49
|
+
- 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
|
|
50
|
+
- 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
|
|
51
|
+
- 文書 ID と項目 ID は区別し、別文書からの行参照には両者を使う。
|
|
68
52
|
|
|
69
|
-
### 3.2.
|
|
53
|
+
### 3.2. 項目 ID
|
|
70
54
|
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
|
|
75
|
-
### 3.3. ファイル名
|
|
76
|
-
|
|
77
|
-
- 成果物: `prj-assumptions-constraints-dependencies.md`
|
|
78
|
-
- 実践の型: `prj-assumptions-constraints-dependencies-{rulebook,recipe,sample,template}.md`
|
|
79
|
-
- 日本語の表示名を使う場合も、ID とファイル名は一意で検索可能な英小文字・ハイフン区切りを維持する。
|
|
55
|
+
- 項目 ID は前提条件 `ACD-A01`、制約事項 `ACD-C01`、依存関係 `ACD-D01` から種別ごとに既採番の最大値に続ける。整数部は 2 桁未満をゼロ埋めし、100 件目以降は桁を増やす。
|
|
56
|
+
- 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
|
|
57
|
+
- 種別変更は旧項目を廃止して新規採番し、変更記録に新旧 ID と理由を残す。
|
|
80
58
|
|
|
81
59
|
## 4. 推奨 Frontmatter 項目
|
|
82
60
|
|
|
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 配列 | 任意 |
|
|
61
|
+
- 共通項目の必須性、値・構文、未確定事項の目印は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正とし、構造は `deliverable-frontmatter.schema.yaml` に従う。
|
|
62
|
+
- 本系統では `rulebook` に `specdojo:prj-assumptions-constraints-dependencies-rulebook` を必須で指定する。成果物の `type` は本書の `deliverable_type` に従う。
|
|
63
|
+
- `based_on` には、根拠として直接参照したスコープ・憲章などの上位成果物を記載する。計画や技術資料などへの影響先の参照と混同しない。
|
|
93
64
|
|
|
94
|
-
|
|
65
|
+
## 5. 本文要件
|
|
95
66
|
|
|
96
|
-
|
|
97
|
-
- 未確定事項は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きの前提は _ASSUMPTION_: で明示する。
|
|
98
|
-
- H1 には成果物の表示名を置き、frontmatter に `title` を重複して持たせない。
|
|
67
|
+
次の各章を表の順序で必須とする。前提条件・制約事項・依存関係は項目 ID ごとに管理し、登録対象がない章も省略せず、該当なしの理由と追加時の条件を記載する。
|
|
99
68
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
| 2 | 制約事項 | ○ | 守るべき限界、適用範囲、逸脱の検知、対応 |
|
|
108
|
-
| 3 | 依存関係 | ○ | 依存先、必要な理由、成立条件、変化時の対応 |
|
|
109
|
-
| 4 | 影響評価と対応方針 | ○ | 前提・制約・依存の変化に共通する評価と対応 |
|
|
110
|
-
| 5 | 監視・変更管理 | ○ | 見直す契機、記録する情報、判断責任の扱い |
|
|
69
|
+
| 章 | 目的と必須の判断材料 |
|
|
70
|
+
| ------------------ | -------------------------------------------------------------------- |
|
|
71
|
+
| 前提条件 | 計画の成立に置く条件の根拠、崩れた場合の影響、確認と対応を示す。 |
|
|
72
|
+
| 制約事項 | 守るべき限界と適用範囲、逸脱の検知と対応を示す。 |
|
|
73
|
+
| 依存関係 | 他者から受ける条件、必要となる理由、成立の判定と変化時の対応を示す。 |
|
|
74
|
+
| 影響評価と対応方針 | 変化が後続成果物・計画に及ぼす影響、一次対応と最終判断の分担を示す。 |
|
|
75
|
+
| 監視・変更管理 | 見直し契機、変更記録の内容と記録先、追従更新と報告の責任を示す。 |
|
|
111
76
|
|
|
112
77
|
## 6. 記述ガイド
|
|
113
78
|
|
|
114
79
|
### 6.1. 前提条件
|
|
115
80
|
|
|
116
|
-
- 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
|
|
117
81
|
- 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
|
|
118
|
-
-
|
|
119
|
-
-
|
|
82
|
+
- 仮置きの前提には `_ASSUMPTION_`、根拠の確認待ちには `_TODO_` を付け、確認先を残す。
|
|
83
|
+
- リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
|
|
120
84
|
|
|
121
|
-
|
|
85
|
+
良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
|
|
122
86
|
|
|
123
87
|
推奨表:
|
|
124
88
|
|
|
@@ -127,10 +91,10 @@ flowchart LR
|
|
|
127
91
|
|
|
128
92
|
### 6.2. 制約事項
|
|
129
93
|
|
|
130
|
-
- 制約には、適用範囲と、逸脱したと判断する条件を記載する。
|
|
131
94
|
- 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
|
|
132
95
|
- 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
|
|
133
|
-
|
|
96
|
+
|
|
97
|
+
良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
|
|
134
98
|
|
|
135
99
|
推奨表:
|
|
136
100
|
|
|
@@ -140,20 +104,27 @@ flowchart LR
|
|
|
140
104
|
### 6.3. 依存関係
|
|
141
105
|
|
|
142
106
|
- 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
107
|
+
- 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
|
|
108
|
+
- 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
|
|
109
|
+
- 意思決定待ちの依存には `_UNDECIDED_` を付け、論点、不成立時の影響、当面の扱いを示す。
|
|
110
|
+
- 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
|
|
111
|
+
|
|
112
|
+
良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
|
|
146
113
|
|
|
147
114
|
推奨表:
|
|
148
115
|
|
|
149
|
-
| ID |
|
|
150
|
-
| --- |
|
|
116
|
+
| ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
|
|
117
|
+
| --- | ------------ | -------------- | -------------- | -------------- | ------ | -------- |
|
|
118
|
+
|
|
119
|
+
表の各列は必須の意味を表す。「依存先・条件」は受ける提供物・判断・継続提供を、「必要となる理由」はそれが必要な作業と不成立時の影響を示す。
|
|
151
120
|
|
|
152
121
|
### 6.4. 影響評価と対応方針
|
|
153
122
|
|
|
154
123
|
- 影響は、スコープ、期日、費用、品質、公開適性、運用責任など、該当する領域を具体的に示す。
|
|
155
124
|
- 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
|
|
156
|
-
-
|
|
125
|
+
- 所有者は状態確認と一次対応を担う者とし、最終判断者と判断を求める範囲を区別する。
|
|
126
|
+
|
|
127
|
+
良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、順序・期日の変更案を判断者へ提示して開始可否を確認する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
|
|
157
128
|
|
|
158
129
|
推奨表:
|
|
159
130
|
|
|
@@ -163,8 +134,10 @@ flowchart LR
|
|
|
163
134
|
### 6.5. 監視・変更管理
|
|
164
135
|
|
|
165
136
|
- 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
|
|
166
|
-
- 変更記録には、項目 ID
|
|
167
|
-
-
|
|
137
|
+
- 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。
|
|
138
|
+
- 条件の変化が影響するスコープ・計画・Schedule・受入条件を特定し、変更記録と追従作業を項目 ID で結ぶ。
|
|
139
|
+
|
|
140
|
+
良い例: 「端末の利用不能を検知したら、対象 ID と影響作業、代替策、再確認時期を変更記録に残す。復旧確認を Schedule の試用開始の先行作業にする」と書く。悪い例: 「必要に応じて更新する」とだけ書き、追従対象を示さない。
|
|
168
141
|
|
|
169
142
|
## 7. 禁止事項
|
|
170
143
|
|
|
@@ -173,7 +146,4 @@ flowchart LR
|
|
|
173
146
|
| スコープ等の上位文書の決定事項を行として再掲する | 正本との二重管理になり、更新漏れと矛盾を招く。 |
|
|
174
147
|
| 前提・制約・依存を種別なしに混在させる | 条件の性質と対応方法を区別できない。 |
|
|
175
148
|
| 影響、トリガー、所有者、対応方針のない登録 | 変化時に判断・対応へ使えない。 |
|
|
176
|
-
|
|
|
177
|
-
| Agent に最終判断、承認、公開可否を委ねる | 人間の判断責任を代替してしまう。 |
|
|
178
|
-
| API、DB、契約書全文などの詳細を記載する | 本書の責務を越え、詳細成果物と重複する。 |
|
|
179
|
-
| 個人情報、非公開情報、機密情報を記載する | 公開・再利用の前提を損なう。 |
|
|
149
|
+
| 部分決定だけで依存全体を成立済みとする | 未成立の条件に依存する作業を開始してしまう。 |
|