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,74 +11,73 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Project Human Member Roster Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
人間の実行主体と担える Role code を、履歴で変わらない nickname で名簿にする作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 実行ログへ残す人間の nickname、公開可能な表示名、兼務を整理します。
|
|
20
|
-
- agent の provider、能力、優先度、command は `.specdojo/agent-members.yaml` へ分離します。
|
|
21
|
-
- 既存名簿に agent がある場合は、手編集より先に移行コマンドの dry-run を確認します。
|
|
18
|
+
- 名簿は、組織定義の最終判断の集約先(Why)を引き継ぎ、誰がどの Role を担えるか(What)を決め、`--by` と実行ログが nickname で人を指す(Trace)。agent の定義は名簿に持たない。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
| 項目
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
| agent 定義 | 人間 nickname と重複しないことを確認するための nickname 一覧 |
|
|
32
|
-
| 公開制約 | 個人情報、私用連絡先、非公開組織情報を含めない条件 |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ------------ | ------------------------------------------------ | -------------------- |
|
|
24
|
+
| 最終判断 | 承認・受入・公開可否を誰に集めるか、兼務の方針 | 組織定義 |
|
|
25
|
+
| Role code | 名簿で使える Role code の一覧 | ロール定義 |
|
|
26
|
+
| 使用中の名前 | 実行ログに記録済みの nickname、agent の nickname | 実行ログ・agent 定義 |
|
|
27
|
+
| 公開の可否 | 表示名と連絡先を公開してよいか | 本人への確認 |
|
|
33
28
|
|
|
34
29
|
## 3. 全体の作成手順
|
|
35
30
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4. 実行ログと `.specdojo/agent-members.yaml` を確認し、nickname の重複と改名を避けます。
|
|
40
|
-
5. 非公開の連絡先は `null` にし、最終判断範囲を `note` に簡潔に記載します。
|
|
41
|
-
6. schema 検証で agent 用フィールドや未定義キーが混入していないことを確認します。
|
|
31
|
+
1. 最終判断を担う人を先に決める。ここが決まると兼務の範囲が決まる。
|
|
32
|
+
2. 使用中の nickname を集めてから名前を決める。後から変えると履歴の参照先が切れる。
|
|
33
|
+
3. 各人の Role code を割り当て、最後に `rules` へ project 固有の制約だけを書く。
|
|
42
34
|
|
|
43
|
-
## 4.
|
|
35
|
+
## 4. 各章の書き方
|
|
44
36
|
|
|
45
|
-
### 4.1.
|
|
37
|
+
### 4.1. members
|
|
46
38
|
|
|
47
|
-
|
|
48
|
-
- 人物が交代しても意味が変わらない nickname になっていますか。
|
|
49
|
-
- 兼務する Role code は責務正本と一致していますか。
|
|
50
|
-
- 公開できない個人情報を推測で補っていませんか。
|
|
39
|
+
問い:
|
|
51
40
|
|
|
52
|
-
|
|
41
|
+
- 承認・受入・公開可否を最後に決めるのは誰か。
|
|
42
|
+
- その人が交代しても、nickname の意味は変わらないか。
|
|
53
43
|
|
|
54
|
-
|
|
55
|
-
- 人間 nickname が repository 共通の agent nickname と重複していませんか。
|
|
56
|
-
- agent の追加・優先度変更を通常成果物の編集として扱っていませんか。
|
|
57
|
-
- 既存 agent の移行には `specdojo config migrate-members --dry-run` を先に使いましたか。
|
|
44
|
+
コツ:
|
|
58
45
|
|
|
59
|
-
|
|
46
|
+
- 個人名が要らなければ `po` のような役割の名前にする。本人に公開の可否を聞き、答えがなければ連絡先を空にする。
|
|
47
|
+
- 最終判断の範囲は `note` に 1 文で書き、組織定義を写さない。
|
|
60
48
|
|
|
61
|
-
|
|
62
|
-
- Schedule の `owner` と member nickname を混同していませんか。
|
|
63
|
-
- 実行ログに記録済みの nickname を変更していませんか。
|
|
64
|
-
- nickname を廃止する場合も履歴参照を維持できる記録がありますか。
|
|
49
|
+
### 4.2. rules
|
|
65
50
|
|
|
66
|
-
|
|
51
|
+
問い:
|
|
67
52
|
|
|
68
|
-
|
|
69
|
-
| ---------------- | ------------------------------------------------------------- |
|
|
70
|
-
| schema | `pm-members.schema.yaml` に適合し、人間だけを含む |
|
|
71
|
-
| Role code | `members[].roles` がロール定義と一致する |
|
|
72
|
-
| nickname | project 内と agent 定義との合成後に一意で、履歴上安定している |
|
|
73
|
-
| 責任境界 | 人間の最終判断と agent の実行支援が混在していない |
|
|
74
|
-
| 公開適性 | 私用連絡先、秘密情報、非公開組織情報を含まない |
|
|
75
|
-
| トレーサビリティ | 組織定義、ロール定義、変更記録から割り当て理由を追える |
|
|
53
|
+
- この project だけの公開制約や交代時の扱いは何か。
|
|
76
54
|
|
|
77
|
-
|
|
55
|
+
コツ:
|
|
78
56
|
|
|
79
|
-
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
57
|
+
- 共通の標準や agent の起動設定を書き足したくなったら、正本への参照に置き換える。
|
|
58
|
+
|
|
59
|
+
## 5. 深掘り手順
|
|
60
|
+
|
|
61
|
+
1. 各 member の Role code から、組織定義の最終判断へたどれるかを確かめる。
|
|
62
|
+
2. `rules` の各行が、この project 固有の制約かを確かめ、共通の内容を外す。
|
|
63
|
+
|
|
64
|
+
## 6. 良い例 / 悪い例
|
|
65
|
+
|
|
66
|
+
| 観点 | 良い例 | 悪い例 |
|
|
67
|
+
| -------- | -------------------------------------- | ------------------------------ |
|
|
68
|
+
| nickname | 交代時は新しい member を足す | 記録済みの nickname を改名する |
|
|
69
|
+
| 連絡先 | 公開の確認がなければ `email: null` | 推測した私用アドレスを書く |
|
|
70
|
+
| `rules` | 「公開文書に個人名を書かない」だけ書く | agent の起動設定を写す |
|
|
71
|
+
|
|
72
|
+
## 7. レビュー観点
|
|
73
|
+
|
|
74
|
+
| 観点 | 確認内容 |
|
|
75
|
+
| ---------- | ------------------------------------------------ |
|
|
76
|
+
| 責任の所在 | 最終判断を担う人間が名簿から読み取れるか |
|
|
77
|
+
| 一意性 | agent 定義と合わせても nickname が重ならないか |
|
|
78
|
+
| 公開適性 | 個人名・私用連絡先・非公開の組織情報を含まないか |
|
|
79
|
+
|
|
80
|
+
## 8. 仕上げチェック
|
|
81
|
+
|
|
82
|
+
- 各 member の Role code が、組織定義の最終判断の範囲と食い違っていない。
|
|
83
|
+
- `rules` に共通の標準や agent の設定の再掲がない。
|
|
@@ -11,86 +11,97 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Organization Definition Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
判断・実行・確認の分担を最小体制で設計する作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 兼務可能な最小組織モデルを定めます。
|
|
20
|
-
- ロール・member・RACIの正本へ責務を委譲します。
|
|
21
|
-
- プロジェクトの目的と主要判断(Why)、必要な責任領域と最終判断先(What)、最小組織モデルと owner 方針(How)を扱い、正本の対応と見直し条件で追跡します(Trace)。Role code 全量や member 割り当ては各正本へ委譲します。
|
|
18
|
+
- 組織定義は、概要の目的と主要判断(Why)を引き継ぎ、責任領域と採用ロール(What)、兼務と見直しの方針(How)を決める。採用判断は `owner` と正本への参照でたどる(Trace)。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
| 項目
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
| 正本 | ロール定義、メンバー定義、RACI、ステークホルダー登録簿 |
|
|
31
|
-
| 拡張条件 | 滞留、参加者増加、外部責任、専門性の必要性 |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| -------------- | ------------------------------------------- | ---------------------- |
|
|
24
|
+
| 目的と主要判断 | 価値、優先順位、費用、受入、公開の判断 | プロジェクト概要 |
|
|
25
|
+
| 規模と関係者 | 参加者数、外部関係者、継続運用の有無 | ステークホルダー登録簿 |
|
|
26
|
+
| 担い手と兆し | 作業の担い手、AI Agent の関与、滞留する判断 | 最終判断者への確認 |
|
|
32
27
|
|
|
33
28
|
## 3. 全体の作成手順
|
|
34
29
|
|
|
35
|
-
1.
|
|
36
|
-
2.
|
|
37
|
-
3.
|
|
38
|
-
4.
|
|
39
|
-
5. 情報ごとの正本を一表で示します。
|
|
40
|
-
6. 体制を拡張する見直し条件を定めます。
|
|
30
|
+
1. 組織モデルを最初に書く。最終判断の置き場が決まらないと、採否を決められない。
|
|
31
|
+
2. ロール・owner方針で、標準ロールの採否と `owner` を決める。
|
|
32
|
+
3. 正本と責任境界で、本書で決めることと他に任せることを分ける。
|
|
33
|
+
4. 見直し条件を書く。兼務が崩れる兆しは組織モデルで見えている。
|
|
41
34
|
|
|
42
35
|
## 4. 各章の書き方
|
|
43
36
|
|
|
44
37
|
### 4.1. 組織モデル
|
|
45
38
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
-
|
|
39
|
+
問い:
|
|
40
|
+
|
|
41
|
+
- 価値・計画・品質・公開を、それぞれ誰が最終判断するか。
|
|
42
|
+
- 当事者の確認を、どのロールが受け止めるか。
|
|
43
|
+
|
|
44
|
+
コツ:
|
|
45
|
+
|
|
46
|
+
- 「誰がやるか」より先に「どの判断が要るか」を聞くと、人数に引きずられない。
|
|
49
47
|
|
|
50
48
|
### 4.2. ロール・owner方針
|
|
51
49
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
-
|
|
50
|
+
問い:
|
|
51
|
+
|
|
52
|
+
- 採用しないロールの責務を、誰が代わりに担うか。
|
|
53
|
+
- Schedule の `owner` に、どのロールを使うか。
|
|
54
|
+
|
|
55
|
+
コツ:
|
|
56
|
+
|
|
57
|
+
- 採用と専任配置を分けて聞く。兼務者だけのロールを未採用にしやすい。
|
|
55
58
|
|
|
56
59
|
### 4.3. 正本と責任境界
|
|
57
60
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
-
|
|
61
|
+
問い:
|
|
62
|
+
|
|
63
|
+
- 採用結果・実行主体・成果物別の分担を、どこで更新するか。
|
|
64
|
+
- まだない定義をいつ作るか。
|
|
65
|
+
|
|
66
|
+
コツ:
|
|
67
|
+
|
|
68
|
+
- 一覧や名簿は写さず参照に置き換え、採用判断だけを残す。
|
|
61
69
|
|
|
62
70
|
### 4.4. 見直し条件
|
|
63
71
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
-
|
|
72
|
+
問い:
|
|
73
|
+
|
|
74
|
+
- 何が起きたら体制の見直しを始めるか。
|
|
75
|
+
- 誰が判断し、どの定義を追従させるか。
|
|
76
|
+
|
|
77
|
+
コツ:
|
|
78
|
+
|
|
79
|
+
- 「忙しくなったら」でなく、承認の滞留など観測できる出来事で聞く。
|
|
67
80
|
|
|
68
81
|
## 5. 深掘り手順
|
|
69
82
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
83
|
+
浅いときは次の順で対応のない主張を探す。
|
|
84
|
+
|
|
85
|
+
1. 責任領域ごとに応える主要判断を確かめ、対応のない行を外す。
|
|
86
|
+
2. 採用ロールごとに、担う責任領域を確かめる。
|
|
87
|
+
3. 見直し条件ごとに、崩れる兼務の前提を確かめる。
|
|
74
88
|
|
|
75
89
|
## 6. 良い例 / 悪い例
|
|
76
90
|
|
|
77
|
-
| 観点
|
|
78
|
-
|
|
|
79
|
-
| 体制
|
|
80
|
-
|
|
|
81
|
-
| 正本 | member割当はYAMLへ委譲する | 本文にも同じ一覧を書く |
|
|
91
|
+
| 観点 | 良い例 | 悪い例 |
|
|
92
|
+
| ---- | ---------------------------------- | ---------------------------- |
|
|
93
|
+
| 体制 | 兼務で始め、承認が滞ったら分担する | すべてのロールに専任者を置く |
|
|
94
|
+
| 兼務 | 作業と最終判断を別のロールで書く | 「全員で責任を持つ」 |
|
|
82
95
|
|
|
83
96
|
## 7. レビュー観点
|
|
84
97
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
98
|
+
| 観点 | 確認内容 |
|
|
99
|
+
| ---------- | ------------------------------------------------------ |
|
|
100
|
+
| 目的整合 | 責任領域が概要の主要判断に対応しているか |
|
|
101
|
+
| 採用の根拠 | 採否を責任領域で説明でき、未採用の責務に担い手がいるか |
|
|
89
102
|
|
|
90
103
|
## 8. 仕上げチェック
|
|
91
104
|
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
- Agentに最終判断を委ねていない。
|
|
96
|
-
- 各責任領域が目的または主要判断に対応し、owner 方針と委譲先を追跡できる。
|
|
105
|
+
- 責任領域の各行から採用ロールと `owner` までたどれる。
|
|
106
|
+
- 個人名・連絡先を書いていない。
|
|
107
|
+
- AI Agent に最終判断を任せていない。
|
|
@@ -11,88 +11,110 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Project Management Plan Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
価値検証に要る管理・判断・証跡だけを、軽量な管理計画へまとめる作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 管理領域を一表へ統合し、判断ゲートと正本を接続します。
|
|
20
|
-
- 個別計画、RACI、Schedule、登録簿との重複を削除して仕上げます。
|
|
21
|
-
- 検証する価値と逸脱リスク(Why)、管理基準・上限・判断ゲート(What)、確認契機・逸脱時対応・責任(How)を整理し、成功基準 ID と各正本の証跡で追跡します(Trace)。個別計画の詳細は参照先へ委譲します。
|
|
18
|
+
- 成功基準の価値と逸脱リスク(Why)から、管理基準・上限・判断ゲート(What)と確認契機・逸脱時対応・責任(How)を決め、各管理行を条件 ID と正本の記録でたどる(Trace)。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| ---------- |
|
|
27
|
-
| 価値と判定 | 成功基準 ID、受入条件 ID、判定時期
|
|
28
|
-
| 境界 |
|
|
29
|
-
| 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
| 正本 | 組織、RACI、品質、コミュニケーション、記録の参照先 |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| ---------- | -------------------------------------- | -------------------- |
|
|
24
|
+
| 価値と判定 | 成功基準 ID、受入条件 ID、判定時期 | 成功基準 |
|
|
25
|
+
| 境界 | スコープ内外、管理を厚くする条件 | スコープ |
|
|
26
|
+
| 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限 | 成功基準、承認責任者 |
|
|
27
|
+
| 判断者 | 公開・例外・変更・停止の最終判断者 | 組織定義、RACI |
|
|
28
|
+
| 記録先 | 課題・リスク・変更・品質・費用の記録先 | 登録簿、Schedule |
|
|
33
29
|
|
|
34
30
|
## 3. 全体の作成手順
|
|
35
31
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5. Schedule、RACI、費用記録、品質証跡、登録簿の正本を示します。
|
|
41
|
-
6. 未決事項へ決定時期と判断者を付けます。
|
|
42
|
-
7. 他文書の一覧や詳細手順を削除します。
|
|
32
|
+
1. 管理目的を価値と期間で 1 文にする。これがないと網羅目的の行が増える。
|
|
33
|
+
2. 統合管理表は、一般的な PM 項目ではなく条件 ID ごとの行から書く。
|
|
34
|
+
3. 判断ゲートは、逸脱時対応のうち人間の判断が要るものから作る。
|
|
35
|
+
4. 未決事項は、決めきれない上限や判断者を最後に集める。
|
|
43
36
|
|
|
44
37
|
## 4. 各章の書き方
|
|
45
38
|
|
|
46
39
|
### 4.1. 管理目的と適用方針
|
|
47
40
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
-
|
|
41
|
+
問い:
|
|
42
|
+
|
|
43
|
+
- どの価値を、いつからいつまで検証するのか。
|
|
44
|
+
- 契約・監査・組織規模の何が変わると管理を厚くするか。
|
|
45
|
+
|
|
46
|
+
コツ:
|
|
47
|
+
|
|
48
|
+
- 比較基準値の収集は前提作業に置く。
|
|
51
49
|
|
|
52
50
|
### 4.2. 統合管理方針
|
|
53
51
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
-
|
|
52
|
+
問い:
|
|
53
|
+
|
|
54
|
+
- この行は、どの条件 ID の何を守るのか。
|
|
55
|
+
- 誰が、いつ逸脱に気づき、次に何をするのか。
|
|
56
|
+
|
|
57
|
+
コツ:
|
|
58
|
+
|
|
59
|
+
- 費用を聞くと現金支出だけが返る。準備時間と日々の操作時間を別に聞く。
|
|
60
|
+
- 数値や測定手順は成功基準から写さず、条件 ID で参照する。
|
|
57
61
|
|
|
58
62
|
### 4.3. 判断ゲートとエスカレーション
|
|
59
63
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
-
|
|
64
|
+
問い:
|
|
65
|
+
|
|
66
|
+
- 未達や材料不足なら何を保留し、誰が再判定を起案するのか。
|
|
67
|
+
- 初期受入と後続の観測を同じゲートで判定してよいか。
|
|
68
|
+
|
|
69
|
+
コツ:
|
|
70
|
+
|
|
71
|
+
- 材料を整理する Role と最終判断する Role を別に聞く。
|
|
63
72
|
|
|
64
73
|
### 4.4. 正本・報告・見直し
|
|
65
74
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
-
|
|
75
|
+
問い:
|
|
76
|
+
|
|
77
|
+
- 判断・逸脱・作業節目のどれを報告の契機にするのか。
|
|
78
|
+
- 目的や体制が変わったら、どの文書をどの順で直すのか。
|
|
79
|
+
|
|
80
|
+
コツ:
|
|
81
|
+
|
|
82
|
+
- Schedule の作業担当を承認者と取り違えやすい。承認者は別に聞く。
|
|
83
|
+
|
|
84
|
+
### 4.5. 未決事項
|
|
85
|
+
|
|
86
|
+
問い:
|
|
87
|
+
|
|
88
|
+
- 決まるまで、何の着手や判定を止めるのか。
|
|
89
|
+
- 決まったら、どの管理行・ゲートが変わるのか。
|
|
90
|
+
|
|
91
|
+
コツ:
|
|
92
|
+
|
|
93
|
+
- 別の正本で追う論点は写さず参照に置き換える。
|
|
69
94
|
|
|
70
95
|
## 5. 深掘り手順
|
|
71
96
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
97
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
98
|
+
|
|
99
|
+
1. 管理行ごとに応える条件 ID を確かめ、対応のない行を外す。
|
|
100
|
+
2. 判断ゲートの各条件が材料を受ける管理行を確かめる。
|
|
101
|
+
3. 個別計画・RACI・Schedule・登録簿と重なる説明を参照に戻す。
|
|
76
102
|
|
|
77
103
|
## 6. 良い例 / 悪い例
|
|
78
104
|
|
|
79
|
-
| 観点 | 良い例
|
|
80
|
-
| -------- |
|
|
81
|
-
| 管理目的 | SC-01〜SC-03の代表試行を管理する
|
|
82
|
-
| コスト |
|
|
83
|
-
| 正本 | 課題・リスクは登録簿を正とする | 本文にも同じ一覧を持つ |
|
|
105
|
+
| 観点 | 良い例 | 悪い例 |
|
|
106
|
+
| -------- | ---------------------------------- | ---------------------------- |
|
|
107
|
+
| 管理目的 | SC-01〜SC-03 の代表試行を管理する | 一般的な PM 項目を管理する |
|
|
108
|
+
| コスト | 現金支出と作業時間を別の上限で確認 | 金額予算はないので管理しない |
|
|
84
109
|
|
|
85
110
|
## 7. レビュー観点
|
|
86
111
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
112
|
+
| 観点 | 確認内容 |
|
|
113
|
+
| ------ | ------------------------------------------ |
|
|
114
|
+
| 判断者 | 継続・保留・停止の判断に使う記録が分かるか |
|
|
115
|
+
| 作業者 | 自分の確認契機と逸脱時の行動が分かるか |
|
|
91
116
|
|
|
92
117
|
## 8. 仕上げチェック
|
|
93
118
|
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
- Agentに最終判断を委ねていない。
|
|
97
|
-
- 必要性のない章・表・関連文書一覧を残していない。
|
|
98
|
-
- 各管理対象について、価値またはリスク、基準・上限、確認契機、逸脱時対応、証跡が一続きで追跡できる。
|
|
119
|
+
- 各管理行から、条件 ID、逸脱時の行動、記録先までたどれる。
|
|
120
|
+
- AI Agent に最終判断を委ねていない。
|
|
@@ -11,87 +11,78 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Quality Management Plan Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
利用者価値と成果物品質を、少数の品質ゲートと是正の流れへまとめる作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
- 品質目標・メトリクス・検査基準を品質ゲートへ統合します。
|
|
20
|
-
- レビュー、証跡、是正、再判定を接続します。
|
|
21
|
-
- 利用者価値と品質リスク(Why)、合格状態とゲート(What)、検査・是正・再判定(How)を整理し、成功基準・受入条件 ID と検証証跡で追跡します(Trace)。成功基準や個別検証手順は再掲しません。
|
|
18
|
+
- 成功基準の利用者価値(Why)を引き継ぎ、ゲートの合格状態(What)を定め、レビュー・是正・再判定(How)で守る。各ゲートは条件 ID と証跡の記録先でたどる(Trace)。
|
|
22
19
|
|
|
23
20
|
## 2. 作成前に集める情報
|
|
24
21
|
|
|
25
|
-
| 項目
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
| 証跡
|
|
31
|
-
| 責任
|
|
32
|
-
| 例外 | 未達時の対応、再判定、変更判断 |
|
|
22
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
23
|
+
| -------- | ------------------------------------------------ | ------------- |
|
|
24
|
+
| 守る価値 | どの条件 ID が誰のどの変化を判定するか | 成功基準 |
|
|
25
|
+
| 節目 | どの判断の前に確かめるか、適用の開始と終了 | 管理計画 |
|
|
26
|
+
| 公開対象 | 何を公開し、個人情報・非公開情報がどこに混ざるか | `PO` への確認 |
|
|
27
|
+
| 証跡 | 試行・検査・費用と作業時間の記録をどこに残すか | `QE` への確認 |
|
|
28
|
+
| 責任 | 誰が照合し、誰が判断し、誰が是正するか | RACI |
|
|
33
29
|
|
|
34
30
|
## 3. 全体の作成手順
|
|
35
31
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
41
|
-
6. 成功基準や検証手順の再掲を削除します。
|
|
32
|
+
1. 品質方針と適用範囲を先に書く。守る価値が決まらないと、ゲートの数が決まらない。
|
|
33
|
+
2. 判断の前に要る時点だけを品質ゲートにする。
|
|
34
|
+
3. 各ゲートの前に終えるレビューと証跡を書く。
|
|
35
|
+
4. 不適合と是正を書く。
|
|
36
|
+
5. 最後に見直し条件と未決事項を書く。途中で決めきれなかった点がここに集まる。
|
|
42
37
|
|
|
43
38
|
## 4. 各章の書き方
|
|
44
39
|
|
|
45
40
|
### 4.1. 品質方針と適用範囲
|
|
46
41
|
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
- 人間とAI Agentの確認・判断境界を示します。
|
|
42
|
+
- 問い: 利用者のどの変化を価値品質とするか。人間が最終判断する価値・例外・公開は何か。
|
|
43
|
+
- コツ: 成功基準の閾値は写さず参照に置き換える。終了日が決まらなければ終了のイベントを聞く。
|
|
50
44
|
|
|
51
45
|
### 4.2. 品質ゲート
|
|
52
46
|
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
- 費用・負荷は現金支出、作業時間、継続運用負荷を分けます。
|
|
47
|
+
- 問い: そのゲートがないと、どの判断を誤るか。証跡不足のときどう扱うか。
|
|
48
|
+
- コツ: 費用は「無償」で済ませず、現金支出と作業時間を別々に聞く。
|
|
56
49
|
|
|
57
50
|
### 4.3. レビューと証跡
|
|
58
51
|
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
- 生成物は正本から再生成します。
|
|
52
|
+
- 問い: どの対象版を誰が確認するか。公開対象を全件確かめたことを何で示すか。
|
|
53
|
+
- コツ: 保存先が未定なら仮のパスを書かず未決事項へ回す。
|
|
62
54
|
|
|
63
55
|
### 4.4. 不適合と是正
|
|
64
56
|
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
|
|
57
|
+
- 問い: どの不適合で作業や公開を止めるか。是正後に何を確かめ直すか。
|
|
58
|
+
- コツ: 区分は止めるゲートが異なるものに絞る。
|
|
59
|
+
|
|
60
|
+
### 4.5. 見直し条件と未決事項
|
|
61
|
+
|
|
62
|
+
- 問い: 何が変わると合格条件を直すか。未決の間どの判定を保留するか。
|
|
63
|
+
- コツ: 未決事項に、決まったとき直す条件を添える。
|
|
68
64
|
|
|
69
65
|
## 5. 深掘り手順
|
|
70
66
|
|
|
71
|
-
1.
|
|
72
|
-
2.
|
|
73
|
-
3.
|
|
74
|
-
4. 使用されない指標を削除します。
|
|
67
|
+
1. 各ゲートが守る条件 ID を確かめ、対応のないゲートを外す。
|
|
68
|
+
2. 技術検証だけで閉じるゲートに利用者価値を付ける。
|
|
69
|
+
3. どの判定にも使わない指標を外す。
|
|
75
70
|
|
|
76
71
|
## 6. 良い例 / 悪い例
|
|
77
72
|
|
|
78
|
-
| 観点
|
|
79
|
-
|
|
|
80
|
-
| 価値品質
|
|
81
|
-
|
|
|
82
|
-
| 是正
|
|
73
|
+
| 観点 | 良い例 | 悪い例 |
|
|
74
|
+
| -------- | ------------------------------------ | ---------------------- |
|
|
75
|
+
| 価値品質 | 利用者が主要操作を完遂できる | lint が成功する |
|
|
76
|
+
| 費用 | 支出と追加の作業時間を別々に判定する | 無償なので低コスト |
|
|
77
|
+
| 是正 | 未達 ID を直し同じゲートで再判定する | 問題ないことを確認する |
|
|
83
78
|
|
|
84
79
|
## 7. レビュー観点
|
|
85
80
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
81
|
+
| 観点 | 確認内容 |
|
|
82
|
+
| -------- | ------------------------------------------------- |
|
|
83
|
+
| 判断責任 | AI Agent に価値・例外・公開の判断を委ねていないか |
|
|
84
|
+
| 公開適性 | 公開対象に個人情報・非公開情報が残っていないか |
|
|
90
85
|
|
|
91
86
|
## 8. 仕上げチェック
|
|
92
87
|
|
|
93
|
-
-
|
|
94
|
-
- 費用と人の負荷を必要に応じて分けている。
|
|
95
|
-
- 生成物の直接編集を認めていない。
|
|
96
|
-
- Agentに価値・例外・公開判断を委ねていない。
|
|
97
|
-
- 各品質ゲートが、守る価値または品質リスク、合格条件、検査・是正方法、証跡に対応している。
|
|
88
|
+
- 各ゲートから、守る価値・合格条件・証跡の記録先までたどれる。
|