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
|
@@ -11,86 +11,80 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
RACI Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
責任衝突が起きやすい成果物と判断だけを選び、Schedule の担当まで整理する作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 成果物別と判断・プロセス別のRACIを作ります。
|
|
20
|
-
- Schedule owner、member割り当てとの整合を確認します。
|
|
21
|
-
- 責任衝突や判断停滞の回避(Why)、対象となる主要成果物・判断(What)、RACI と owner 方針(How)を扱い、行名・Role code・Schedule owner の対応で追跡します(Trace)。member 割り当ては再掲しません。
|
|
18
|
+
- 責任衝突や判断停滞を防ぐ理由(Why)から対象の成果物・判断(What)を選び、責任配置と担当(How)を決め、行名・Role code・Schedule の `owner` でたどれるようにする(Trace)。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
| 項目 |
|
|
26
|
-
| --------- |
|
|
27
|
-
| Role
|
|
28
|
-
|
|
|
29
|
-
| 判断 |
|
|
30
|
-
| 実行 |
|
|
31
|
-
| 割り当て | member、兼務、Agent支援の正本 |
|
|
22
|
+
| 項目 | 集める情報と取り出し元 |
|
|
23
|
+
| --------- | ----------------------------------------------------- |
|
|
24
|
+
| 採用 Role | 列に使う Role code(組織定義) |
|
|
25
|
+
| 対象 | 主要成果物・公開対象(初期スコープ) |
|
|
26
|
+
| 判断 | 価値・費用・変更・品質例外・公開の判断者(PM に聞く) |
|
|
27
|
+
| 実行 | 明示 `owner`、タスク種別(WBS・Schedule) |
|
|
32
28
|
|
|
33
29
|
## 3. 全体の作成手順
|
|
34
30
|
|
|
35
|
-
1.
|
|
36
|
-
2.
|
|
37
|
-
3.
|
|
38
|
-
4.
|
|
39
|
-
5.
|
|
40
|
-
6. 生成ビューや通常手順の重複行を削除します。
|
|
31
|
+
1. 対象の成果物と判断を先に選ぶ。カタログから始めると責任が埋もれる。
|
|
32
|
+
2. 列の Role を必要な分だけ残す。
|
|
33
|
+
3. 成果物別、判断・プロセス別の順に表を作る。承認者が先に決まると、プロセス行の判断を分けやすい。
|
|
34
|
+
4. Schedule と照合する。不一致で表を直すため表の後に行う。
|
|
35
|
+
5. 見直し条件を書く。
|
|
41
36
|
|
|
42
37
|
## 4. 各章の書き方
|
|
43
38
|
|
|
44
39
|
### 4.1. 適用方針
|
|
45
40
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
- 未使用Role code列を置かない理由を示します。
|
|
41
|
+
- 問い: どの成果物・判断で責任がぶつかり得るか。外す範囲の理由は何か。
|
|
42
|
+
- コツ: PM に「誰の判断を待って作業が止まったか」を聞く。採用 Role の一覧は写さず参照に置き換える。
|
|
49
43
|
|
|
50
44
|
### 4.2. 成果物別RACI
|
|
51
45
|
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
- 成果物の作業責任と内容の最終責任を区別します。
|
|
46
|
+
- 問い: 誰が作成し、どの Role の人間が内容を承認するか。
|
|
47
|
+
- コツ: 作業担当が複数なら、分担をその場で聞いて注記する。後から Schedule を見て選ぶと根拠が残らない。
|
|
55
48
|
|
|
56
49
|
### 4.3. 判断・プロセス別RACI
|
|
57
50
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
- 当事者確認が必要な場合は内部Roleだけで代替しません。
|
|
51
|
+
- 問い: 判断者が異なる判断はどれか。成果物行の承認と重なるとき、それぞれ何を判断するか。
|
|
52
|
+
- コツ: 「作成フローの運営」は内容の承認も含むと読まれやすいため、順序・進捗の判断と分ける。
|
|
61
53
|
|
|
62
54
|
### 4.4. Schedule・実行主体との対応
|
|
63
55
|
|
|
64
|
-
- owner
|
|
65
|
-
-
|
|
66
|
-
|
|
56
|
+
- 問い: WBS に明示の `owner` はあるか。なければ、どの `R` から担当を展開するか。
|
|
57
|
+
- コツ: 担当が一意に決まらなければ、タスクの分割を WBS の担当者に相談する。
|
|
58
|
+
|
|
59
|
+
### 4.5. 見直し条件
|
|
60
|
+
|
|
61
|
+
- 問い: 何が変わると見直し、どの行と Schedule が追従するか。
|
|
62
|
+
- コツ: 判断が止まった場面を聞くと、契機を具体的に書ける。
|
|
67
63
|
|
|
68
64
|
## 5. 深掘り手順
|
|
69
65
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
66
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
67
|
+
|
|
68
|
+
1. 各行が防ぐ責任衝突・判断停滞を確かめ、目的のない行を外す。
|
|
69
|
+
2. 各行の `A` が実際の最終判断者かを確かめる。
|
|
70
|
+
3. `C`・`I` がどの判断に効くかを確かめ、効かないものを外す。
|
|
71
|
+
4. Schedule の各 `owner` がどの行から来たかをたどる。
|
|
74
72
|
|
|
75
73
|
## 6. 良い例 / 悪い例
|
|
76
74
|
|
|
77
|
-
| 観点
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
75
|
+
| 観点 | 良い例 | 悪い例 |
|
|
76
|
+
| ---------- | --------------------------------------------- | ----------------------------------- |
|
|
77
|
+
| 判断の行名 | 「初期公開の可否」のように判断を名指す | 「プロジェクト運営」とだけ書く |
|
|
78
|
+
| 承認タスク | 別タスクにした承認を、その行の `A` と照合する | 承認タスクも作成者の `R` にそろえる |
|
|
79
|
+
| AI Agent | 支援として注記し、`A` は人間の Role に置く | AI Agent を承認者の列に入れる |
|
|
82
80
|
|
|
83
81
|
## 7. レビュー観点
|
|
84
82
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
- 責任境界が重要でない行を増やしていないか。
|
|
83
|
+
| 観点 | 確認内容 |
|
|
84
|
+
| -------- | ------------------------------------------------------------- |
|
|
85
|
+
| 判断範囲 | 成果物行とプロセス行で、同じ判断を二つの `A` が持っていないか |
|
|
89
86
|
|
|
90
87
|
## 8. 仕上げチェック
|
|
91
88
|
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
- member・Agent割り当てを再掲していない。
|
|
95
|
-
- Agentに`A`を割り当てていない。
|
|
96
|
-
- 各行の採用理由、`A` / `R`、Schedule owner または判断記録先の対応を追跡できる。
|
|
89
|
+
- 各行の採用理由、`A`・`R`、Schedule の `owner` をたどれる。
|
|
90
|
+
- メンバーの割り当てを写していない。
|
|
@@ -11,126 +11,97 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Project Role Definition Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
ロール定義を、PO が全 Role code とプロジェクト固有メモを承認・保留・差し戻しできる内容に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
- 最後に、member nickname、agent 名、個人名、兼務割り当てを混ぜず、プロジェクト固有メモだけを残す。
|
|
21
|
-
- schema にないメタ項目を追加しない。rulebook 参照は成果物カタログまたは計画側で解決する。
|
|
22
|
-
- 組織上必要な責任領域(Why)、採用する Role code(What)、プロジェクト固有の責務強調(How)を扱い、`based_on` と下流の Role code 参照で追跡する(Trace)。割り当てや一般責務は各正本へ委譲する。
|
|
18
|
+
- ロール定義は、組織定義の採用判断(Why)を引き継ぎ、採用する Role code の集合(What)を転記し、プロジェクト固有の扱い(How)だけを `project_note` に添える。採用根拠は `based_on`、下流の利用は Schedule・RACI・メンバー定義の Role code 参照でたどる(Trace)。
|
|
19
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
|
|
23
20
|
|
|
24
21
|
## 2. 作成前に集める情報
|
|
25
22
|
|
|
26
|
-
| 項目
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| 下流文書 | `pm-members.yaml`、Schedule、RACI が参照する Role code |
|
|
34
|
-
| schema | `pm-roles.yaml` に許可されるメタ項目、Role code、型制約 |
|
|
35
|
-
| 公開制約 | 個人情報、連絡先、非公開組織情報を含めない条件 |
|
|
23
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
24
|
+
| ---------------------- | ------------------------------------------------------ | ---------------------------- |
|
|
25
|
+
| 採用集合 | 採用・未採用の Role code、使用可能な `owner`、採用理由 | 組織定義 |
|
|
26
|
+
| 正式名称 | 各 Role code の正式名称 | 人と組織の定義標準 |
|
|
27
|
+
| 下流の参照値 | 実際に使われている Role code と、その使い手 | Schedule、RACI、メンバー定義 |
|
|
28
|
+
| プロジェクト固有の扱い | 強調する責務、専任化を検討する条件、公開判断上の注意 | PO・PM への確認 |
|
|
29
|
+
| 識別情報 | `project_id`、名称、版 | 配置先プロジェクト |
|
|
36
30
|
|
|
37
31
|
## 3. 全体の作成手順
|
|
38
32
|
|
|
39
|
-
1. `
|
|
40
|
-
2.
|
|
41
|
-
3. `roles`
|
|
42
|
-
4.
|
|
43
|
-
5. `
|
|
44
|
-
6. schema にないキー、重複 Role code、標準外 Role code がないことを確認する。
|
|
45
|
-
7. PO が承認できるよう、全 Role code の過不足、公開可否、下流文書への入力適合を確認する。
|
|
33
|
+
1. 組織定義を読み、採用集合を確かめてから `based_on` へ接続する。採用集合が決まらないと、`roles` の範囲が決まらない。
|
|
34
|
+
2. 下流の参照値を洗い出し、採用集合との差分を先に見つける。転記の後で見つけると、どちらを直すかの判断が遅れる。
|
|
35
|
+
3. 採用集合を `roles` へ転記し、`code` と正式名称を対応付ける。
|
|
36
|
+
4. PO の判断に要る固有の扱いだけを `project_note` に添える。
|
|
37
|
+
5. 最後にメタ項目を整える。採用根拠が決まってからだと、`based_on` を未確認の文書で埋めずに済む。
|
|
46
38
|
|
|
47
|
-
## 4.
|
|
39
|
+
## 4. 各章の書き方
|
|
48
40
|
|
|
49
|
-
### 4.1.
|
|
41
|
+
### 4.1. メタ項目と根拠
|
|
50
42
|
|
|
51
43
|
問い:
|
|
52
44
|
|
|
53
|
-
- `
|
|
54
|
-
-
|
|
55
|
-
- `based_on` はロール採用の根拠を指しているか。
|
|
45
|
+
- `based_on` の各 ID は、採用集合を実際に確かめた文書か。
|
|
46
|
+
- 準拠先を、成果物自身から識別できるか。
|
|
56
47
|
|
|
57
|
-
|
|
48
|
+
コツ:
|
|
58
49
|
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
- 根拠 ID は、内容を実際に確認した文書だけを記載する。
|
|
62
|
-
- `rulebook` など schema が許可しないキーを追加しない。
|
|
50
|
+
- 同じディレクトリの文書をまとめて `based_on` に入れたくなったら、採用判断に使った文書だけに絞る。
|
|
51
|
+
- 採用理由の本文は組織定義から写さず、ID での参照に置き換える。
|
|
63
52
|
|
|
64
53
|
### 4.2. `roles`
|
|
65
54
|
|
|
66
55
|
問い:
|
|
67
56
|
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
- 専任 member がいない Role code でも、責務語彙として必要なら残せているか。
|
|
57
|
+
- 専任 member がいない Role code を、未採用と取り違えて落としていないか。
|
|
58
|
+
- 下流で使われているのに採用集合にない Role code はないか。
|
|
71
59
|
|
|
72
|
-
|
|
60
|
+
コツ:
|
|
73
61
|
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
- `roles` は責務語彙の一覧であり、実行主体の一覧ではないことを意識する。
|
|
77
|
-
- 下流の `pm-members.yaml` や Schedule が参照する Role code を後から推測しなくてよいよう、採用する責務語彙を明示する。
|
|
62
|
+
- 「今いる人」から Role を数えると、兼務中のロールが抜けやすい。PO・PM に「誰もいなくても語彙として要るロールはどれか」と聞く。
|
|
63
|
+
- Role code を変えたり除いたりするときは、使っている下流の文書と使い手を先に聞き、責務の移り先を決めてから変える。
|
|
78
64
|
|
|
79
65
|
### 4.3. `roles[].project_note`
|
|
80
66
|
|
|
81
67
|
問い:
|
|
82
68
|
|
|
83
|
-
- PO
|
|
84
|
-
-
|
|
85
|
-
- member nickname、agent 名、個人名、兼務割り当てを書いていないか。
|
|
86
|
-
- 未決事項がある場合、_UNDECIDED_: または _TODO_: で明示しているか。
|
|
69
|
+
- PO が承認・保留を決めるのに、このメモがないと何が判断できないか。
|
|
70
|
+
- このプロジェクトに固有の扱いか、どのプロジェクトにも当てはまる一般責務か。
|
|
87
71
|
|
|
88
|
-
|
|
72
|
+
コツ:
|
|
89
73
|
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
- 未決事項は推測で確定させず、_UNDECIDED_:(判断未了)または _TODO_:(後で確認・追記が必要)から書き始め、判断時点や判断者が分かる形で残す。
|
|
74
|
+
- 担当者の名前や agent 名を書きたくなったら、メンバー定義へ移す。メモに書くと、割り当ての変更のたびに一覧を直すことになる。
|
|
75
|
+
- 「必要に応じて」と書きそうになったら、PO に「何が起きたら専任化を考えるか」を聞き、その条件を書く。
|
|
76
|
+
- 決めきれない点は推測で埋めず、判断する人と時期を PO に確かめる。
|
|
94
77
|
|
|
95
78
|
## 5. 深掘り手順
|
|
96
79
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
6. PO の最終判断、公開可否、説明責任が agent や member nickname に移っていないことを確認する。
|
|
80
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
81
|
+
|
|
82
|
+
1. `roles` の各 Role code が、組織定義の採用判断のどれに対応するかを確かめ、対応のないコードを外す。
|
|
83
|
+
2. 下流の各参照値が `roles` にあるかを確かめ、未定義のコードを見つける。
|
|
84
|
+
3. 各 `project_note` が、PO のどの判断に使われるかを確かめ、判断に使われないメモを削る。
|
|
103
85
|
|
|
104
86
|
## 6. 良い例 / 悪い例
|
|
105
87
|
|
|
106
|
-
| 観点
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
| 下流入力 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
|
|
113
|
-
| schema 適合 | メタ項目は schema が許可するキーだけにする | `rulebook: specdojo:pm-roles-rulebook` |
|
|
88
|
+
| 観点 | 良い例 | 悪い例 |
|
|
89
|
+
| ---------- | ------------------------------------------------------------- | ---------------------------------- |
|
|
90
|
+
| 公開判断 | 公開可否の最終判断は PO に残す | agent が公開可否を判断する |
|
|
91
|
+
| 下流の参照 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
|
|
92
|
+
| 準拠先 | 成果物自身に `rulebook` を残す | カタログにあるので成果物から省く |
|
|
93
|
+
| 専任化 | 「実装タスクが継続して増えたら DEV の専任化を検討する」と書く | 「必要に応じて体制を見直す」と書く |
|
|
114
94
|
|
|
115
95
|
## 7. レビュー観点
|
|
116
96
|
|
|
117
|
-
| 観点
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
| owner 語彙 | Schedule の `owner` に使う値が `roles[].code` として定義されているか |
|
|
123
|
-
| スキーマ適合 | 必須メタ項目、`roles` 配列、Role code の列挙が YAML スキーマに沿っているか |
|
|
124
|
-
| 公開可否 | 個人情報、連絡先、非公開情報、agent への最終判断委任が含まれていないか |
|
|
125
|
-
| 下流入力 | `pm-members.yaml`、Schedule、RACI が参照できる安定した Role code になっているか |
|
|
97
|
+
| 観点 | 確認内容 |
|
|
98
|
+
| ---------- | ------------------------------------------------------------------------- |
|
|
99
|
+
| 採用の対応 | 各 Role code が組織定義の採用判断に対応し、未採用のコードが紛れていないか |
|
|
100
|
+
| 下流の接続 | Schedule、RACI、メンバー定義が使う値がすべて `roles[].code` にあるか |
|
|
101
|
+
| 委譲の境界 | 一般責務・採用理由・実行主体の割り当てを、各正本へ委ねているか |
|
|
126
102
|
|
|
127
103
|
## 8. 仕上げチェック
|
|
128
104
|
|
|
129
|
-
-
|
|
130
|
-
- `
|
|
131
|
-
-
|
|
132
|
-
- `roles[].project_note` の未決事項は _UNDECIDED_: または _TODO_: で明示され、放置されていない。
|
|
133
|
-
- `pm-organization.md` の採用方針と矛盾していない。
|
|
134
|
-
- `pm-members.yaml` の `members[].roles` から参照できる Role code 語彙になっている。
|
|
135
|
-
- 公開してよい情報だけで構成され、最終判断と説明責任が人間の PO に残っている。
|
|
136
|
-
- 各 Role code の採用根拠と下流利用を、`based_on` と既存の参照値から追跡できる。
|
|
105
|
+
- 各 Role code の採用根拠を `based_on` から、下流での利用を参照値からたどれる。
|
|
106
|
+
- `project_note` に担当者・agent 名・兼務の割り当てがない。
|
|
107
|
+
- 公開してよい情報だけで構成され、最終判断が PO に残っている。
|
|
@@ -11,36 +11,31 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Assumptions, Constraints and Dependencies Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
前提・制約・依存関係を、条件が変わったときに所有者が影響を確かめ、判断者へつなげられる内容に仕上げるための作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- 守る成果や境界(Why)、前提・制約・依存(What)、確認・監視・変化時対応(How)を整理し、項目 ID、`based_on`、根拠、影響、対応の同じ行で追跡する(Trace)。上位文書で確定済みの境界や詳細設計は再掲しない。
|
|
18
|
+
- 本書は、スコープ・憲章が定めた守る成果と境界(Why)を引き継ぎ、それを実行するために置く条件・守る限界・受ける提供(What)を定め、確認・変化時の対応と判断者(How)を決める。各条件は項目 ID の同じ行で根拠から対応までたどれるようにする(Trace)。
|
|
19
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
|
|
20
|
+
- 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
|
|
22
21
|
|
|
23
22
|
## 2. 作成前に集める情報
|
|
24
23
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| ---------------- |
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
| 確認と判断 | 状態を確認する方法、変化のトリガー、所有者、最終判断者 |
|
|
24
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
25
|
+
| ---------------- | ---------------------------------------------------------- | ------------------------------ |
|
|
26
|
+
| 境界 | 対象外、境界の判断基準、すでに監視・記録先を持つ判断 | スコープ、憲章 |
|
|
27
|
+
| 結論だけの制約 | 予算枠・公開情報など、結論はあるが監視の仕組みがない条件 | 憲章の主要前提・制約 |
|
|
28
|
+
| 成立条件 | 欠けると進めない人・情報・環境・先行成果物 | 計画担当・実行担当への聞き取り |
|
|
29
|
+
| 受ける提供・判断 | 依存先、受け取る物、受け取れたと分かる記録、決定待ちの論点 | 依存先の担当、登録簿の決定記録 |
|
|
30
|
+
| 変化の知らせ | 変化を最初に知る人と、その記録 | 所有者候補への聞き取り |
|
|
33
31
|
|
|
34
32
|
## 3. 全体の作成手順
|
|
35
33
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
41
|
-
6. 変化の種別ごとに、最初に確認することと対応方針をまとめる。
|
|
42
|
-
7. 監視・変更管理に、見直す契機と変更記録に残す情報を置く。
|
|
43
|
-
8. 表の各行について、前提・制約・依存の分類、根拠、所有者、対応が欠けていないか確認する。
|
|
34
|
+
1. 候補を挙げ、スコープ・憲章ですでに決まっている境界を先に外す。外さずに分類を始めると、上位文書の言い直しが行に残る。
|
|
35
|
+
2. 残った候補を、自分たちが成り立つと置く仮説(前提条件)、守る限界(制約事項)、他者から受ける提供・判断(依存関係)に分ける。迷う候補は「誰が提供を止められるか」で分ける。
|
|
36
|
+
3. 前提条件・制約事項・依存関係を、それぞれ根拠・影響・確認方法・対応と対にして書く。
|
|
37
|
+
4. 変化の種別ごとに、最初に確かめることと次の判断者を影響評価と対応方針へまとめる。
|
|
38
|
+
5. 最後に監視・変更管理と冒頭文を書く。登録した条件が決まってからだと、見直しの契機を条件から逆算できる。
|
|
44
39
|
|
|
45
40
|
## 4. 各章の書き方
|
|
46
41
|
|
|
@@ -48,115 +43,93 @@ Assumptions, Constraints and Dependencies Writing Recipe
|
|
|
48
43
|
|
|
49
44
|
問い:
|
|
50
45
|
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
- どの記録・確認で変化を検知できるか。
|
|
46
|
+
- 何が成り立たないと計画が止まり、それはどの記録で確かめられるか。
|
|
47
|
+
- 崩れたとき、誰のどの作業が止まるか。
|
|
54
48
|
|
|
55
|
-
|
|
49
|
+
コツ:
|
|
56
50
|
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
- スコープで定義済みの境界は前提として再掲せず、章冒頭でスコープの該当章へ委譲する。
|
|
60
|
-
- リポジトリ、作業環境、外部ツールなど、継続的な提供が必要な基盤は前提ではなく依存関係(4.3.)として書く。
|
|
61
|
-
- 例: 「店頭で使う端末を利用できる」を前提として、利用不可時の代替記録を対応に置く。
|
|
51
|
+
- 「誰が止められるか」と聞き、相手が自分たち以外なら依存関係へ移す。端末・リポジトリ・作業環境は前提に入れやすいので注意する。
|
|
52
|
+
- 確かめられない仮説は断定せず、仮置きと確認先を残す。
|
|
62
53
|
|
|
63
54
|
### 4.2. 制約事項
|
|
64
55
|
|
|
65
56
|
問い:
|
|
66
57
|
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
- 何が起きたら逸脱として扱うか。
|
|
58
|
+
- どの行為が起きたら、限界を越えたと判定するか。
|
|
59
|
+
- その限界は、どの作業・期間に掛かるか。
|
|
70
60
|
|
|
71
|
-
|
|
61
|
+
コツ:
|
|
72
62
|
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
- スコープの対象外・境界の判断基準と同内容の制約は再掲せず、上位文書に現れない運用上の制約だけを書く。
|
|
76
|
-
- 詳細な設計方法や受入条件は、対応する後続成果物に委譲する。
|
|
63
|
+
- 憲章が結論だけを示す制約は、展開元の章を書き、監視と逸脱時の対応を足す。憲章がすでに監視・記録先を持つ判断は、写さず参照に置き換える。
|
|
64
|
+
- 製品名で書きたくなったら、守りたい意図(費用・外部依存・公開適性)を聞き直す。
|
|
77
65
|
|
|
78
66
|
### 4.3. 依存関係
|
|
79
67
|
|
|
80
68
|
問い:
|
|
81
69
|
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
- 依存先が変わった場合に、どの文書または判断を見直すか。
|
|
70
|
+
- 誰から何を受け取れたら成立とし、誰がいつどの記録で確かめるか。
|
|
71
|
+
- 決定のうち、どこまで決まり、どこが未決か。
|
|
85
72
|
|
|
86
|
-
|
|
73
|
+
コツ:
|
|
87
74
|
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
- 意思決定待ちの依存はプロジェクト登録簿へ登録し、本書からは登録項目 ID を参照する。
|
|
91
|
-
- 期限や責任者が未確定なら、推測で埋めず決定先を残す。
|
|
75
|
+
- 依存先の担当に「受け取ったと言える記録は何か」を聞く。名前だけの依存は成立を判定できない。
|
|
76
|
+
- 本書の根拠として読んだだけの文書を依存先に入れやすいので注意する。
|
|
92
77
|
|
|
93
78
|
### 4.4. 影響評価と対応方針
|
|
94
79
|
|
|
95
80
|
問い:
|
|
96
81
|
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
- 一次対応を担うロールと、最終判断者は誰か。
|
|
82
|
+
- 変化したとき、最初に確かめる範囲はどこか。
|
|
83
|
+
- 一次対応を担う所有者と、最終判断者はそれぞれ誰か。
|
|
100
84
|
|
|
101
|
-
|
|
85
|
+
コツ:
|
|
102
86
|
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
- 最終判断者を未確認のロールで補わない。未確定なら _TODO_: として記録先を示す。
|
|
87
|
+
- 「遅れる」「困る」で止まったら、どの成果物・作業・判断に響くかを聞き直す。
|
|
88
|
+
- 判断者が決まっていなければロールで補わず、決定先を残す。
|
|
106
89
|
|
|
107
90
|
### 4.5. 監視・変更管理
|
|
108
91
|
|
|
109
92
|
問い:
|
|
110
93
|
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
- どの役割が構造整合を確認し、どの部分を人間の責任者が最終判断するか。
|
|
94
|
+
- 本書を見直す具体的な出来事は何か。
|
|
95
|
+
- 変化を検知したら、どの記録へ残し、どの計画・作業へ追従させるか。
|
|
114
96
|
|
|
115
|
-
|
|
97
|
+
コツ:
|
|
116
98
|
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
- 文書構造の整合確認は `ARC` 、公開可否やスコープ変更などの最終判断は人間の責任者が行うと明示する。
|
|
99
|
+
- 登録した各行の変化のトリガーを集めると、見直しの契機の漏れが見つかる。
|
|
100
|
+
- 発生済みの支障・将来の不確実性・計画変更・決定を一つの記録に混ぜやすいので、記録先を分けて聞く。
|
|
120
101
|
|
|
121
102
|
## 5. 深掘り手順
|
|
122
103
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
104
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
105
|
+
|
|
106
|
+
1. 各行が、スコープ・憲章のどの守る成果または境界に応えるかを確かめ、対応のない行と、上位文書で決まった境界の言い直しを外す。
|
|
107
|
+
2. 各行の対応方針が、その行の影響を減らすかを確かめる。
|
|
108
|
+
3. 影響評価と対応方針の各行が、どの項目 ID の変化から来るかを確かめる。
|
|
109
|
+
4. 監視・変更管理の契機に、登録した各行のトリガーが入っているかを確かめる。
|
|
128
110
|
|
|
129
111
|
## 6. 良い例 / 悪い例
|
|
130
112
|
|
|
131
|
-
| 観点 | 良い例
|
|
132
|
-
| -------- |
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
| トリガー | 「対象外の機能を初期対象へ追加しようとした」と書く | 「必要に応じて確認する」と書く |
|
|
140
|
-
| 未確定 | 「_TODO_: 公開判断の記録先を決定する」と書く | 未確認の責任者や期限を断定する |
|
|
113
|
+
| 観点 | 良い例 | 悪い例 |
|
|
114
|
+
| -------- | ------------------------------------------------------------------------ | ------------------------------------------ |
|
|
115
|
+
| 分類 | 「代表試行への協力者を確保できる」を前提にし、未確保時の延期判断を添える | 「店頭で使う端末を利用できる」を前提に書く |
|
|
116
|
+
| 依存 | 端末を依存先にし、営業開始前の動作確認とその記録先を書く | 「端末がある」とだけ書く |
|
|
117
|
+
| 重複排除 | 対象外の境界は章冒頭でスコープへ委ねる | スコープの対象外を言い換えて制約に書く |
|
|
118
|
+
| 制約 | 「承認済み予算枠がない間は発注しない」と、発注前の確認を書く | 「予算に注意する」とだけ書く |
|
|
119
|
+
| 部分決定 | 決定済みの部分と未決の部分を分け、未決の当面の扱いを書く | 一部の決定だけで依存を成立済みとする |
|
|
120
|
+
| トリガー | 「対象外の機能を初期対象へ足そうとした」と書く | 「必要に応じて確認する」と書く |
|
|
141
121
|
|
|
142
122
|
## 7. レビュー観点
|
|
143
123
|
|
|
144
|
-
| 観点 | 確認内容
|
|
145
|
-
| ------------ |
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
| 技術制約 | 特定製品への過度な依存、実装詳細、責務外の設計が混入していないか。 |
|
|
151
|
-
| 下流入力 | 業務、受入、計画・統制の担当者が、必要な条件と未確定事項を識別できるか。 |
|
|
152
|
-
| 公開適性 | 個人情報、機密情報、非公開情報を含めていないか。 |
|
|
124
|
+
| 観点 | 確認内容 |
|
|
125
|
+
| ------------ | ---------------------------------------------------------------- |
|
|
126
|
+
| 根拠 | 各行がスコープ・憲章と食い違わず、守る成果か境界に対応しているか |
|
|
127
|
+
| 変化への備え | 所有者が変化を知る手段と、次の判断者へつなぐ対応があるか |
|
|
128
|
+
| 下流入力 | 計画・受入の担当者が、待つべき条件と未決の論点を見分けられるか |
|
|
129
|
+
| 責務の境界 | 計画・設計・実装の詳細やリスクの管理を本書に書き込んでいないか |
|
|
153
130
|
|
|
154
131
|
## 8. 仕上げチェック
|
|
155
132
|
|
|
156
|
-
-
|
|
157
|
-
-
|
|
158
|
-
-
|
|
159
|
-
- 前提、制約、依存の各章があり、種別を混在させていない。
|
|
160
|
-
- 未確定事項を推測で埋めず、確認先または決定時期を明示している。
|
|
161
|
-
- 技術設計、実装詳細、最終判断の代替を書き込んでいない。
|
|
162
|
-
- 各項目について、守る成果または境界、成立条件、影響、確認・対応方法を同じ ID から追跡できる。
|
|
133
|
+
- 未確認の事実・責任者・期限を断定せず、確認先または決定時期を残している。
|
|
134
|
+
- 個人情報、秘密情報、非公開の組織情報を含めていない。
|
|
135
|
+
- 影響評価と対応方針・監視・変更管理から、変化した条件の項目 ID へたどれる。
|