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
|
@@ -13,51 +13,32 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
Impact Analysis (Interface) Rulebook
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
変更要求による I/F への影響を整理し、変更要否・影響度・対応方針・未解決事項を判断するための記述基準を定めます。
|
|
17
17
|
|
|
18
18
|
## 1. 全体方針
|
|
19
19
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
- データ仕様、テスト仕様、運用手順への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
|
|
20
|
+
- I/F 責任者とプロジェクト管理者が合意できる粒度で、影響と判断根拠を記載する。
|
|
21
|
+
- 複数の連携方式を扱う場合も影響詳細は I/F 単位とする。データ仕様・テスト仕様・運用手順への波及は概要と判断を示し、詳細は各文書へ委ねる。
|
|
22
|
+
- **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
24
23
|
|
|
25
|
-
## 2.
|
|
24
|
+
## 2. 位置づけ
|
|
26
25
|
|
|
27
|
-
|
|
28
|
-
| ----------- | -------------------------------------------------------------------- |
|
|
29
|
-
| 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
|
|
30
|
-
| 影響対象I/F | 変更要求の影響を受ける API、ファイル連携、メッセージ連携、通知連携 |
|
|
31
|
-
| 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
|
|
32
|
-
| 影響度 | 影響の強さ。契約変更、互換性、障害波及、利用者影響を踏まえて評価する |
|
|
33
|
-
| 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
|
|
34
|
-
| 未解決事項 | 判断や実施に必要な情報が不足している課題 |
|
|
26
|
+
起票済みの要求・課題を含む変更要求を受け、連携先との契約・互換性・障害波及・利用者への影響を判断する。詳細な実装設計は扱わない。
|
|
35
27
|
|
|
36
28
|
## 3. ファイル命名・ID規則
|
|
37
29
|
|
|
38
|
-
- 対象ドキュメント ID は
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
- 関連する追補文書を分割する場合は
|
|
30
|
+
- 対象ドキュメント ID は `<project-id>:imp-interface` とする(例: `prj-0001:imp-interface`)。
|
|
31
|
+
- 推奨配置は `docs/ja/projects/<project-id>/050-impact-analysis/imp-interface.md` とし、適用先の成果物カタログに合わせる。
|
|
32
|
+
- 命名の共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
|
|
33
|
+
- 関連する追補文書を分割する場合は `<project-id>:imp-interface-<term>` 形式を用いる。
|
|
42
34
|
|
|
43
35
|
## 4. 推奨 Frontmatter 項目
|
|
44
36
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| 項目 | 説明 | 必須 |
|
|
48
|
-
|
|
49
|
-
| ---------- | -------------------------------------- | ---- |
|
|
50
|
-
| id | ドキュメント ID(例: `imp-interface`) | ○ |
|
|
51
|
-
| type | `project` | ○ |
|
|
52
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
53
|
-
| rulebook | `specdojo:imp-interface-rulebook` 固定 | ○ |
|
|
54
|
-
| part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
|
|
55
|
-
| based_on | 変更要求や根拠資料の ID 配列 | 任意 |
|
|
56
|
-
| supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
|
|
37
|
+
共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-interface-rulebook` とする。
|
|
57
38
|
|
|
58
39
|
## 5. 本文構成(標準テンプレ)
|
|
59
40
|
|
|
60
|
-
|
|
41
|
+
本文は次の6章を標準とする。
|
|
61
42
|
|
|
62
43
|
| 章 | 見出し | 必須 | 目的 |
|
|
63
44
|
| --- | -------------- | ---- | --------------------------------------------- |
|
|
@@ -77,17 +58,15 @@ Impact Analysis (Interface) Rulebook
|
|
|
77
58
|
|
|
78
59
|
### 6.2. 変更要求の概要
|
|
79
60
|
|
|
80
|
-
-
|
|
81
|
-
- 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
|
|
61
|
+
- 変更の背景・狙い・成功条件を示す。要求詳細は判断に必要な要点に絞る。
|
|
82
62
|
|
|
83
63
|
### 6.3. 影響分析サマリ
|
|
84
64
|
|
|
85
|
-
-
|
|
86
|
-
- サマリで使用した評価観点(例: 契約互換性、接続先調整、障害影響、監査影響)を先に示す。
|
|
65
|
+
- 契約互換性、接続先調整、障害・利用者・監査への影響などの評価観点と、高・中・低を分ける尺度を先に定義し、件数と優先対応対象を示す。
|
|
87
66
|
|
|
88
67
|
### 6.4. 影響詳細一覧
|
|
89
68
|
|
|
90
|
-
-
|
|
69
|
+
- 影響詳細は表形式で、次の6列を必須とする。
|
|
91
70
|
|
|
92
71
|
| カラム | 内容 |
|
|
93
72
|
| ----------- | ------------------------------------------------------ |
|
|
@@ -105,13 +84,10 @@ Impact Analysis (Interface) Rulebook
|
|
|
105
84
|
|
|
106
85
|
### 6.6. 未解決事項
|
|
107
86
|
|
|
108
|
-
-
|
|
109
|
-
- 未解決事項は放置せず、次回レビューでの処理方針を記録する。
|
|
87
|
+
- 論点、不足情報、判断・対応への影響と当面の扱いを記載する。未解決事項がなければ「なし」とする。
|
|
110
88
|
|
|
111
89
|
## 7. 禁止事項
|
|
112
90
|
|
|
113
91
|
- 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
|
|
114
92
|
- 「影響あり」「要対応」のみで根拠を記載しない。
|
|
115
93
|
- 影響度の尺度を定義せずに高・中・低を混在させない。
|
|
116
|
-
- 未解決事項に期限や担当を設定せずに放置しない。
|
|
117
|
-
- 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
|
|
@@ -4,99 +4,76 @@ specdojo:
|
|
|
4
4
|
type: rulebook
|
|
5
5
|
deliverable_type: project
|
|
6
6
|
status: draft
|
|
7
|
-
recipe:
|
|
7
|
+
recipe: not-needed
|
|
8
8
|
sample: specdojo:imp-operations-sample
|
|
9
|
-
template:
|
|
9
|
+
template: not-needed
|
|
10
10
|
---
|
|
11
11
|
|
|
12
12
|
# 影響調査(運用)作成ルール
|
|
13
13
|
|
|
14
14
|
Impact Analysis (Operations) Rulebook
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
変更要求による運用への影響を整理し、変更要否・影響度・対応方針を判断する基準を定めます。
|
|
17
17
|
|
|
18
18
|
## 1. 全体方針
|
|
19
19
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
20
|
+
- 運用責任者とプロジェクト管理者が合意できる粒度で、影響と判断根拠を記載する。
|
|
21
|
+
- 複数領域を扱う場合も影響詳細は運用対象単位とし、実運用手順の詳細化は扱わない。
|
|
22
|
+
- 標準6章・6列と sample で記入形式が定まるため、別の作成手順・雛形は不要とし、`recipe`・`template` は `not-needed` とする。
|
|
23
|
+
- **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
24
24
|
|
|
25
|
-
## 2.
|
|
25
|
+
## 2. 位置づけ
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
| ------------ | -------------------------------------------------------------------------- |
|
|
29
|
-
| 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
|
|
30
|
-
| 影響対象運用 | 変更要求の影響を受ける監視、アラート、手順、体制、運用統制、SLA 運用 |
|
|
31
|
-
| 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
|
|
32
|
-
| 影響度 | 影響の強さ。運用品質、障害対応力、継続運用性、利用者影響を踏まえて評価する |
|
|
33
|
-
|
|
34
|
-
| 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
|
|
35
|
-
| 未解決事項 | 判断や実施に必要な情報が不足している課題 |
|
|
27
|
+
波及の概要と判断は本書に残し、詳細はデータ仕様(`bdd-*`)、I/F 仕様(`ifx-*`)、テスト戦略・方針(`tsp-index`)などへ委譲する。「備考」に適用先カタログの対応する成果物 ID を示す。
|
|
36
28
|
|
|
37
29
|
## 3. ファイル命名・ID規則
|
|
38
30
|
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
- `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
|
|
42
|
-
- 関連する追補文書を分割する場合は `imp-operations-<term>` 形式を用いる。
|
|
31
|
+
- 文書 ID は `<project-id>:imp-operations`、推奨ファイル名は `imp-operations.md` とする。
|
|
32
|
+
- 追補は `<project-id>:imp-operations-<term>` とし、共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
|
|
43
33
|
|
|
44
34
|
## 4. 推奨 Frontmatter 項目
|
|
45
35
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
| 項目 | 説明 | 必須 |
|
|
49
|
-
| ---------- | --------------------------------------- | ---- |
|
|
50
|
-
| id | ドキュメント ID(例: `imp-operations`) | ○ |
|
|
51
|
-
| type | `project` | ○ |
|
|
52
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
53
|
-
| rulebook | `specdojo:imp-operations-rulebook` 固定 | ○ |
|
|
54
|
-
| part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
|
|
55
|
-
| based_on | 変更要求や根拠資料の ID 配列 | 任意 |
|
|
56
|
-
| supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
|
|
36
|
+
共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-operations-rulebook` とする。`based_on` は直接の根拠とした変更要求や資料の ID を記載する任意項目とする。
|
|
57
37
|
|
|
58
38
|
## 5. 本文構成(標準テンプレ)
|
|
59
39
|
|
|
60
|
-
|
|
40
|
+
本文は次の6章を標準とする。
|
|
61
41
|
|
|
62
|
-
| 章 | 見出し | 必須 | 目的
|
|
63
|
-
| --- | -------------- | ---- |
|
|
64
|
-
| 1 | 目的と適用範囲 | ○ |
|
|
65
|
-
| 2 | 変更要求の概要 | ○ |
|
|
66
|
-
| 3 | 影響分析サマリ | ○ |
|
|
67
|
-
| 4 | 影響詳細一覧 | ○ |
|
|
68
|
-
| 5 | 対応方針 | ○ |
|
|
69
|
-
| 6 | 未解決事項 | ○ |
|
|
42
|
+
| 章 | 見出し | 必須 | 目的 |
|
|
43
|
+
| --- | -------------- | ---- | -------------------- |
|
|
44
|
+
| 1 | 目的と適用範囲 | ○ | 対象と判断範囲 |
|
|
45
|
+
| 2 | 変更要求の概要 | ○ | 背景・要求・成功条件 |
|
|
46
|
+
| 3 | 影響分析サマリ | ○ | 尺度・件数・優先対象 |
|
|
47
|
+
| 4 | 影響詳細一覧 | ○ | 対象別の判定と根拠 |
|
|
48
|
+
| 5 | 対応方針 | ○ | 実施条件・担当・時期 |
|
|
49
|
+
| 6 | 未解決事項 | ○ | 論点・不足情報・影響 |
|
|
70
50
|
|
|
71
51
|
## 6. 記述ガイド
|
|
72
52
|
|
|
73
53
|
### 6.1. 目的と適用範囲
|
|
74
54
|
|
|
75
|
-
|
|
76
|
-
- 「何を判断する文書か」を 2〜4 行で示す。
|
|
55
|
+
変更要求の識別子、対象運用領域、対象期間、判断目的を示す。
|
|
77
56
|
|
|
78
57
|
### 6.2. 変更要求の概要
|
|
79
58
|
|
|
80
|
-
|
|
81
|
-
- 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
|
|
59
|
+
背景・要求・狙いと成功条件を判断に必要な要点に絞って要約する。
|
|
82
60
|
|
|
83
61
|
### 6.3. 影響分析サマリ
|
|
84
62
|
|
|
85
|
-
|
|
86
|
-
- サマリで使用した評価観点(例: 監視体制、障害初動、運用負荷、統制・監査影響)を先に示す。
|
|
63
|
+
運用品質・障害対応力・継続運用性・利用者影響の評価観点と高・中・低の尺度を先に示し、件数と優先対象をまとめる。監視体制、障害初動、運用負荷、統制・監査への影響を検討する。
|
|
87
64
|
|
|
88
65
|
### 6.4. 影響詳細一覧
|
|
89
66
|
|
|
90
|
-
|
|
67
|
+
影響詳細は次の6列を含む表とする。
|
|
91
68
|
|
|
92
|
-
| カラム | 内容
|
|
93
|
-
| ------------ |
|
|
94
|
-
| 影響対象運用 |
|
|
95
|
-
| 変更要否 | `要` / `否`
|
|
96
|
-
| 影響度 | `高` / `中` / `低`
|
|
97
|
-
| 対応方針 | 実施・代替・見送りなどの方針
|
|
98
|
-
| 判断根拠 | 判定理由の要点
|
|
99
|
-
| 備考 | 制約、前提、関連ドキュメント
|
|
69
|
+
| カラム | 内容 |
|
|
70
|
+
| ------------ | ---------------------------------------------- |
|
|
71
|
+
| 影響対象運用 | 監視・アラート・手順・体制・統制・SLA 運用など |
|
|
72
|
+
| 変更要否 | `要` / `否` |
|
|
73
|
+
| 影響度 | `高` / `中` / `低` |
|
|
74
|
+
| 対応方針 | 実施・代替・見送りなどの方針 |
|
|
75
|
+
| 判断根拠 | 判定理由の要点 |
|
|
76
|
+
| 備考 | 制約、前提、関連ドキュメント |
|
|
100
77
|
|
|
101
78
|
### 6.5. 対応方針
|
|
102
79
|
|
|
@@ -105,13 +82,9 @@ Impact Analysis (Operations) Rulebook
|
|
|
105
82
|
|
|
106
83
|
### 6.6. 未解決事項
|
|
107
84
|
|
|
108
|
-
|
|
109
|
-
- 未解決事項は放置せず、次回レビューでの処理方針を記録する。
|
|
85
|
+
論点、不足情報、運用判断への影響と当面の扱いを記載する。
|
|
110
86
|
|
|
111
87
|
## 7. 禁止事項
|
|
112
88
|
|
|
113
|
-
- 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
|
|
114
89
|
- 「影響あり」「要対応」のみで根拠を記載しない。
|
|
115
90
|
- 影響度の尺度を定義せずに高・中・低を混在させない。
|
|
116
|
-
- 未解決事項に期限や担当を設定せずに放置しない。
|
|
117
|
-
- 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
|
|
@@ -13,50 +13,31 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
Impact Analysis (Test) Rulebook
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
変更要求によるテストへの影響を整理し、変更要否・影響度・対応方針・未解決事項を判断する記述基準を定めます。
|
|
17
17
|
|
|
18
18
|
## 1. 全体方針
|
|
19
19
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
- 仕様変更、I/F 変更、運用変更への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
|
|
20
|
+
- テスト責任者とプロジェクト管理者が合意できる粒度で影響と根拠を示す。
|
|
21
|
+
- 複数のテストレベルを扱う場合も影響詳細はテスト対象単位とする。仕様・I/F・運用への波及は概要と判断を示し、詳細は各仕様へ委ねる。
|
|
22
|
+
- **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
24
23
|
|
|
25
|
-
## 2.
|
|
24
|
+
## 2. 位置づけ
|
|
26
25
|
|
|
27
|
-
|
|
28
|
-
| -------------- | -------------------------------------------------------------------------- |
|
|
29
|
-
| 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
|
|
30
|
-
| 影響対象テスト | 変更要求の影響を受けるテスト観点、テスト条件、テストケース、判定基準 |
|
|
31
|
-
| 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
|
|
32
|
-
| 影響度 | 影響の強さ。品質リスク、検証網羅性、実行コスト、納期影響を踏まえて評価する |
|
|
33
|
-
| 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
|
|
34
|
-
| 未解決事項 | 判断や実施に必要な情報が不足している課題 |
|
|
26
|
+
起票済みの要求・課題を含む変更要求を受け、テスト観点・条件・ケース・判定基準への影響を判断する。個別テスト手順の詳細設計は扱わない。
|
|
35
27
|
|
|
36
28
|
## 3. ファイル命名・ID規則
|
|
37
29
|
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
- 関連する追補文書を分割する場合は `imp-test-<term>` 形式を用いる。
|
|
30
|
+
- 文書 ID は `<project-id>:imp-test`、推奨ファイル名は `imp-test.md` とする。
|
|
31
|
+
- 命名の共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
|
|
32
|
+
- 追補文書は `<project-id>:imp-test-<term>` とする。
|
|
42
33
|
|
|
43
34
|
## 4. 推奨 Frontmatter 項目
|
|
44
35
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| 項目 | 説明 | 必須 |
|
|
48
|
-
| ---------- | ----------------------------------- | ---- |
|
|
49
|
-
| id | ドキュメント ID(例: `imp-test`) | ○ |
|
|
50
|
-
| type | `project` | ○ |
|
|
51
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
52
|
-
| rulebook | `specdojo:imp-test-rulebook` 固定 | ○ |
|
|
53
|
-
| part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
|
|
54
|
-
| based_on | 変更要求や根拠資料の ID 配列 | 任意 |
|
|
55
|
-
| supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
|
|
36
|
+
共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-test-rulebook` とする。
|
|
56
37
|
|
|
57
38
|
## 5. 本文構成(標準テンプレ)
|
|
58
39
|
|
|
59
|
-
|
|
40
|
+
本文は次の6章を標準とする。
|
|
60
41
|
|
|
61
42
|
| 章 | 見出し | 必須 | 目的 |
|
|
62
43
|
| --- | -------------- | ---- | ---------------------------------------------- |
|
|
@@ -76,42 +57,38 @@ Impact Analysis (Test) Rulebook
|
|
|
76
57
|
|
|
77
58
|
### 6.2. 変更要求の概要
|
|
78
59
|
|
|
79
|
-
-
|
|
80
|
-
- 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
|
|
60
|
+
- 背景・狙いと要求の要点を示す。成功条件は指標と閾値、または達成状態に加え、確認対象・判定方法を記載する。
|
|
81
61
|
|
|
82
62
|
### 6.3. 影響分析サマリ
|
|
83
63
|
|
|
84
|
-
-
|
|
85
|
-
-
|
|
64
|
+
- 欠陥流出リスク・検証網羅性・実行コスト・納期など、採用する評価観点ごとに高・中・低を分ける条件(数値の境界または状態)を先に定義する。
|
|
65
|
+
- 複数観点で判定が分かれる場合の集約規則(例: 最も高い影響度を採用)を定め、同じ規則で件数を集計する。
|
|
66
|
+
- 優先対応対象を明記し、同じ影響度で順序を分ける場合は理由を添える。
|
|
86
67
|
|
|
87
68
|
### 6.4. 影響詳細一覧
|
|
88
69
|
|
|
89
|
-
-
|
|
70
|
+
- 表形式で次の6列を必須とする。
|
|
90
71
|
|
|
91
|
-
| カラム | 内容
|
|
92
|
-
| -------------- |
|
|
93
|
-
| 影響対象テスト |
|
|
94
|
-
| 変更要否 | `要` / `否`
|
|
95
|
-
| 影響度 | `高` / `中` / `低`
|
|
96
|
-
| 対応方針 | 実施・代替・見送りなどの方針
|
|
97
|
-
| 判断根拠 |
|
|
98
|
-
| 備考 | 制約、前提、関連ドキュメント
|
|
72
|
+
| カラム | 内容 |
|
|
73
|
+
| -------------- | -------------------------------------------------------------- |
|
|
74
|
+
| 影響対象テスト | 影響を受けるテスト対象(レベル、観点、条件、ケース、判定基準) |
|
|
75
|
+
| 変更要否 | `要` / `否` |
|
|
76
|
+
| 影響度 | `高` / `中` / `低` |
|
|
77
|
+
| 対応方針 | 実施・代替・見送りなどの方針 |
|
|
78
|
+
| 判断根拠 | 変更要否の理由、評価観点ごとの事実と尺度・集約規則の適用結果 |
|
|
79
|
+
| 備考 | 制約、前提、関連ドキュメント |
|
|
99
80
|
|
|
100
81
|
### 6.5. 対応方針
|
|
101
82
|
|
|
102
|
-
-
|
|
83
|
+
- 影響度の高い順に、実施時期、担当、前提条件を記載する。
|
|
103
84
|
- 見送りの場合は、再評価条件と時期を必ず記載する。
|
|
85
|
+
- 受入確認では「変更要求の概要」の成功条件に判定方法を適用し、全条件の達成を合格とする。未達は影響対象と対応方針へ戻す。
|
|
104
86
|
|
|
105
87
|
### 6.6. 未解決事項
|
|
106
88
|
|
|
107
|
-
-
|
|
108
|
-
- 未解決事項は放置せず、次回レビューでの処理方針を記録する。
|
|
89
|
+
- 論点、不足情報、判断・対応への影響と当面の扱いを記載する。該当がなければ「なし」とする。
|
|
109
90
|
|
|
110
91
|
## 7. 禁止事項
|
|
111
92
|
|
|
112
|
-
- 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
|
|
113
93
|
- 「影響あり」「要対応」のみで根拠を記載しない。
|
|
114
|
-
|
|
115
94
|
- 影響度の尺度を定義せずに高・中・低を混在させない。
|
|
116
|
-
- 未解決事項に期限や担当を設定せずに放置しない。
|
|
117
|
-
- 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
|