specdojo 0.1.0 → 0.2.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/LICENSE +22 -0
- package/README.md +82 -38
- package/dist/agent-response.js +27 -0
- package/dist/agent.js +124 -0
- package/dist/build-command.js +149 -0
- package/dist/build-if-stale.js +35 -0
- package/dist/catalog-build.js +1079 -0
- package/dist/catalog-generate.js +226 -0
- package/dist/catalog-paths.js +31 -0
- package/dist/catalog-plan-generate.js +301 -0
- package/dist/catalog-plan-prompt.js +73 -0
- package/dist/catalog-plan.js +471 -0
- package/dist/catalog-scaffold.js +255 -0
- package/dist/catalog-types.js +4 -0
- package/dist/catalog.js +606 -0
- package/dist/dashboard.js +980 -0
- package/dist/deliverable-trash.js +148 -0
- package/dist/deliverable.js +97 -0
- package/dist/dist-freshness.js +150 -0
- package/dist/doc-index.js +424 -0
- package/dist/exec-agent-config.js +172 -0
- package/dist/exec-agent-git-state.js +136 -0
- package/dist/exec-agent-protected-config.js +276 -0
- package/dist/exec-events.js +250 -112
- package/dist/exec-evidence.js +317 -0
- package/dist/exec-format.js +45 -0
- package/dist/exec-limit.js +202 -0
- package/dist/exec-parent-validation.js +169 -0
- package/dist/exec-pipeline-state.js +160 -0
- package/dist/exec-plans.js +1016 -0
- package/dist/exec-project.js +25 -11
- package/dist/exec-protection-handoff.js +169 -0
- package/dist/exec-provider-scaffold.js +99 -0
- package/dist/exec-register-resume.js +196 -0
- package/dist/exec-register.js +281 -0
- package/dist/exec-reporter.js +329 -0
- package/dist/exec-results.js +510 -0
- package/dist/exec-run-lock.js +149 -0
- package/dist/exec-run.js +4953 -0
- package/dist/exec-schedule-calendar.js +86 -9
- package/dist/exec-schedule-cpm.js +30 -12
- package/dist/exec-schedule-gantt-chart-render.js +428 -0
- package/dist/exec-schedule-gantt-chart-scope.js +111 -0
- package/dist/exec-schedule-gantt-chart.js +2 -0
- package/dist/exec-schedule-hash.js +34 -25
- package/dist/exec-schedule-index.js +200 -67
- package/dist/exec-schedule-initial.js +100 -0
- package/dist/exec-schedule-progress.js +51 -26
- package/dist/exec-schedule-ready.js +71 -27
- package/dist/exec-schedule.js +171 -93
- package/dist/exec-shared.js +146 -25
- package/dist/exec-strategy.js +547 -0
- package/dist/exec-task-view.js +64 -0
- package/dist/exec-trial.js +895 -0
- package/dist/exec-worktree-command.js +426 -0
- package/dist/exec-worktree-ops.js +847 -0
- package/dist/exec-worktree.js +359 -0
- package/dist/exec.js +744 -192
- package/dist/frontmatter-namespace.js +48 -0
- package/dist/git-environment.js +23 -0
- package/dist/grade-result.js +137 -0
- package/dist/grade.js +2456 -0
- package/dist/index-command.js +103 -0
- package/dist/job.js +1081 -0
- package/dist/kata-command.js +303 -0
- package/dist/kata.js +187 -0
- package/dist/package-paths.js +15 -0
- package/dist/practice-id.js +24 -0
- package/dist/register-date.js +122 -0
- package/dist/register-events.js +363 -0
- package/dist/register-history.js +323 -0
- package/dist/register-item.js +455 -0
- package/dist/register-migrate-timestamps.js +176 -0
- package/dist/register.js +2199 -0
- package/dist/review-plan.js +199 -0
- package/dist/review-types.js +1 -0
- package/dist/role-types.js +1 -0
- package/dist/routine.js +814 -0
- package/dist/schedule-approach.js +252 -0
- package/dist/schedule-build.js +552 -0
- package/dist/schedule-phase-sets.js +73 -0
- package/dist/schedule-strategy-generate.js +812 -0
- package/dist/schedule-strategy-profiles.js +276 -0
- package/dist/schedule.js +420 -0
- package/dist/spawn-self.js +28 -0
- package/dist/specdojo-config.js +133 -39
- package/dist/specdojo.js +55 -7
- package/dist/template-frontmatter.js +89 -0
- package/dist/template-resolution.js +92 -0
- package/dist/timeline-build.js +334 -0
- package/dist/timeline.js +107 -0
- package/dist/watch.js +313 -0
- package/dist/yaml-pages-command.js +28 -0
- package/dist/yaml-pages.js +180 -0
- package/dist/yaml-schema-modeline.js +49 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
- package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
- package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
- package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
- package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
- package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
- package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
- package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
- package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
- package/docs/ja/specdojo/guides/kata-guide.md +89 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/review-guide.md +428 -0
- package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
- package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
- package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
- package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
- package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
- package/docs/ja/specdojo/guides/waza-guide.md +224 -0
- package/docs/ja/specdojo/index.md +33 -0
- package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
- package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
- package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
- package/docs/ja/specdojo/references/command-reference.md +718 -0
- package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
- package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
- package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/atc-sample.md +41 -0
- package/docs/ja/specdojo/samples/bac-sample.md +38 -0
- package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
- package/docs/ja/specdojo/samples/bds-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-sample.md +38 -0
- package/docs/ja/specdojo/samples/bps-sample.md +38 -0
- package/docs/ja/specdojo/samples/br-sample.md +40 -0
- package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
- package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cld-sample.md +38 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-sample.md +38 -0
- package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
- package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
- package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
- package/docs/ja/specdojo/samples/dec-sample.md +39 -0
- package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
- package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
- package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/etc-sample.md +38 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
- package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
- package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
- package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
- package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/itc-sample.md +38 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/mm-sample.md +35 -0
- package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
- package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
- package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
- package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
- package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
- package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
- package/docs/ja/specdojo/samples/opd-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
- package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
- package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
- package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
- package/docs/ja/specdojo/samples/otp-sample.md +68 -0
- package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
- package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
- package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
- package/docs/ja/specdojo/samples/pr-sample.md +39 -0
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
- package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
- package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
- package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
- package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
- package/docs/ja/specdojo/samples/sac-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-sample.md +38 -0
- package/docs/ja/specdojo/samples/sld-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-sample.md +38 -0
- package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
- package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
- package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/uis-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-sample.md +38 -0
- package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
- package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
- package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
- package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
- package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
- package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
- package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
- package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
- package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
- package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
- package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
- package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
- package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
- package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
- package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
- package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
- package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
- package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
- package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
- package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
- package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
- package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
- package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
- package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
- package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
- package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
- package/docs/ja/specdojo/templates/opr-template.md +85 -0
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
- package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
- package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
- package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
- package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
- package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
- package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
- package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
- package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
- package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
- package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
- package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
- package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
- package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
- package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
- package/docs/ja/specdojo/templates/stsd-template.md +57 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
- package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
- package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
- package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
- package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
- package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
- package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
- package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
- package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
- package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
- package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
- package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
- package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
- package/package.json +120 -24
- package/templates/claude/README.md +46 -0
- package/templates/claude/agents/claude-expert-review-executor.md +14 -0
- package/templates/claude/agents/claude-review-executor.md +14 -0
- package/templates/claude/settings.edit.json +6 -0
- package/templates/claude/settings.report.json +6 -0
- package/templates/claude/settings.review.json +7 -0
- package/templates/codex/README.md +61 -0
- package/templates/codex/agents/codex-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
- package/templates/codex/agents/codex-review-executor.toml +10 -0
- package/templates/copilot/README.md +41 -0
- package/templates/copilot/exec-defaults-snippet.yaml +28 -0
- package/templates/copilot/pm-members-snippet.yaml +44 -0
- package/templates/opencode/README.md +41 -0
- package/templates/opencode/agents/opencode-executor.md +59 -0
- package/templates/opencode/agents/opencode-reporter.md +26 -0
- package/templates/opencode/agents/opencode-review-executor.md +48 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:prj-stakeholder-register-rulebook
|
|
4
|
+
type: rulebook
|
|
5
|
+
status: ready
|
|
6
|
+
target_format: markdown
|
|
7
|
+
recipe: specdojo:prj-stakeholder-register-recipe
|
|
8
|
+
sample: specdojo:prj-stakeholder-register-sample
|
|
9
|
+
template: specdojo:prj-stakeholder-register-template
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# ステークホルダー登録簿 作成ルール
|
|
13
|
+
|
|
14
|
+
Stakeholder Register Documentation Rulebook
|
|
15
|
+
|
|
16
|
+
本書は、プロジェクトに影響する、または影響を受ける関係者を、業務価値と利用者影響の観点で一貫して整理する規約です。関係者との合意対象と関与方針を明確にし、後続のコミュニケーション統制で利用できる入力にします。
|
|
17
|
+
|
|
18
|
+
## 1. 全体方針
|
|
19
|
+
|
|
20
|
+
- 対象は、プロジェクトの意思決定、実行、利用、運用、評価または影響受容に関わる個人、組織、集団である。
|
|
21
|
+
- 目的は、誰が何に関心を持ち、どの程度の影響を持つかを可視化し、合意漏れと利用者影響の見落としを防ぐことである。
|
|
22
|
+
- 本文では、関係者の識別、影響度/関心度、関与方針、情報要求、見直し条件を一組として管理する。
|
|
23
|
+
- 詳細な会議体、配信頻度、議事録の運用はコミュニケーション計画へ委譲し、本書ではその入力となる要求だけを扱う。
|
|
24
|
+
- ステークホルダーは人または組織との関係を示す。タスクの担当責務を示す Role とは区別し、対応する Role がある場合だけ対応 Role code として併記する。
|
|
25
|
+
- AI Agent やツールなどの実行主体は、単独のステークホルダーとしては扱わず、入力・制約・確認責任を持つ人または組織の関係者として記載する。
|
|
26
|
+
|
|
27
|
+
## 2. 位置づけと用語定義
|
|
28
|
+
|
|
29
|
+
### 2.1. 位置づけ
|
|
30
|
+
|
|
31
|
+
ステークホルダー登録簿は、プロジェクト概要で示した目的、利用者、期待効果を受けて、合意対象と関与方針を具体化する文書である。後続のコミュニケーション計画は、本書の情報要求、合意・報告の必要性、証跡要件を入力として詳細化する。
|
|
32
|
+
|
|
33
|
+
### 2.2. 用語定義
|
|
34
|
+
|
|
35
|
+
| 用語 | 定義 |
|
|
36
|
+
| -------------------- | ------------------------------------------------------------------------------------ |
|
|
37
|
+
| ステークホルダー | プロジェクトの成果に影響を与える、または成果・進め方から影響を受ける個人、組織、集団 |
|
|
38
|
+
| 関与区分 | 意思決定者、利用者、実行担当者、外部協力者、影響受容者など、関係者の立場を表す分類 |
|
|
39
|
+
| 影響度 | 方針、範囲、優先順位、利用、運用、合意形成に与えられる影響の強さ |
|
|
40
|
+
| 関心度 | 成果、進捗、利用条件、変更に対して継続的に関与する必要性または意向の強さ |
|
|
41
|
+
| エンゲージメント方針 | 現状から目標とする関与状態へ近づけるための情報提供、相談、合意、巻き込みの進め方 |
|
|
42
|
+
| 必要な合意 | 着手、変更、公開、利用、運用のために当該関係者と確認または承認する事項 |
|
|
43
|
+
|
|
44
|
+
## 3. ファイル命名・ID規則
|
|
45
|
+
|
|
46
|
+
### 3.1. 配置(推奨)
|
|
47
|
+
|
|
48
|
+
- `docs/ja/projects/<project-id>/020-project-definition/prj-stakeholder-register.md` に配置する。
|
|
49
|
+
- 個人連絡先、非公開の利害情報、詳細な連絡網は、アクセス制限された管理資料へ分離する。
|
|
50
|
+
- 関与方針の証跡は、議事録、決定記録、Issue、Pull Request など、実際に管理する文書またはツールへ残す。
|
|
51
|
+
|
|
52
|
+
### 3.2. ドキュメントID(推奨)
|
|
53
|
+
|
|
54
|
+
- 推奨: `<project-id>:prj-stakeholder-register`
|
|
55
|
+
- 例: `prj-0001:prj-stakeholder-register`
|
|
56
|
+
- ID はプロジェクト内で一意にし、関係者の ID と混同しない。
|
|
57
|
+
|
|
58
|
+
### 3.3. ファイル名(推奨)
|
|
59
|
+
|
|
60
|
+
- 推奨: `prj-stakeholder-register.md`
|
|
61
|
+
- 関係者 ID は `STH-<KEY>` 形式とし、同じ関係者を全ての表で同じ ID で参照する。
|
|
62
|
+
- 個人名ではなく、役割名、組織名、または集団名を優先して識別する。
|
|
63
|
+
|
|
64
|
+
## 4. 推奨 Frontmatter 項目
|
|
65
|
+
|
|
66
|
+
### 4.1. 設定内容
|
|
67
|
+
|
|
68
|
+
| 項目 | 説明 | 必須 |
|
|
69
|
+
| ---------- | ----------------------------------------------------- | ---- |
|
|
70
|
+
| id | `<project-id>:prj-stakeholder-register` 形式の文書 ID | ○ |
|
|
71
|
+
| type | `project` | ○ |
|
|
72
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
73
|
+
| rulebook | `specdojo:prj-stakeholder-register-rulebook` | ○ |
|
|
74
|
+
| based_on | 関係者の根拠にした概要、憲章など | 任意 |
|
|
75
|
+
| supersedes | 置き換えた旧文書 ID | 任意 |
|
|
76
|
+
|
|
77
|
+
### 4.2. 推奨ルール
|
|
78
|
+
|
|
79
|
+
- `based_on` には、本文の関係者、期待、合意対象を判断した直接根拠だけを列挙する。
|
|
80
|
+
- 個人名、メールアドレス、電話番号、住所、非公開の組織情報、機密性の高い利害関係は記載しない。
|
|
81
|
+
- 対応 Role code は、プロジェクトで採用済みであることを確認できる場合だけ記載する。該当しない外部集団には割り当てない。
|
|
82
|
+
- 変更時は、関係者の追加・削除・関与変更のいずれかと、見直しの証跡を残す。
|
|
83
|
+
|
|
84
|
+
## 5. 本文構成(標準テンプレ)
|
|
85
|
+
|
|
86
|
+
ステークホルダー登録簿は次の順序で構成する。
|
|
87
|
+
|
|
88
|
+
| 番号 | 見出し | 必須 | 内容(要点) |
|
|
89
|
+
| ---- | ---------------------- | ---- | --------------------------------------------------------------------- |
|
|
90
|
+
| 1 | 関係者一覧 | ○ | ID、関与区分、所属/組織、対応 Role code、主な責任、利用場面または備考 |
|
|
91
|
+
| 2 | 影響度/関心度分析 | ○ | 影響度、関心度、期待、懸念、必要な合意、評価根拠 |
|
|
92
|
+
| 3 | エンゲージメント方針 | ○ | 現状、目標、対応方針、責任者、期限、証跡 |
|
|
93
|
+
| 4 | コミュニケーション要件 | ○ | 情報要求、希望チャネル、合意・報告の必要性、証跡要件、計画への反映 |
|
|
94
|
+
| 5 | 見直し条件 | ○ | 更新トリガー、見直し内容、見直し責任者、承認者、証跡 |
|
|
95
|
+
|
|
96
|
+
## 6. 記述ガイド
|
|
97
|
+
|
|
98
|
+
### 6.1. 関係者一覧
|
|
99
|
+
|
|
100
|
+
- 関係者を、意思決定、実行、利用、運用、外部協力、影響受容のいずれに関わるかで識別する。
|
|
101
|
+
- 1 行には、関係者の主な責任と、プロジェクトへの関わり方が分かる備考を記載する。
|
|
102
|
+
- ステークホルダー ID は全章で再利用し、同じ対象を別名で重複登録しない。
|
|
103
|
+
|
|
104
|
+
推奨表:
|
|
105
|
+
|
|
106
|
+
| ID | 関係者 | 関与区分 | 所属/組織 | 対応 Role code | 主な責任 | 備考 |
|
|
107
|
+
| --- | ------ | -------- | --------- | -------------- | -------- | ---- |
|
|
108
|
+
|
|
109
|
+
### 6.2. 影響度/関心度分析
|
|
110
|
+
|
|
111
|
+
- 影響度と関心度は High / Medium / Low を使い、方針・範囲・利用・合意形成への影響を根拠として示す。
|
|
112
|
+
- 各関係者について、期待、懸念、必要な合意を一組で記載する。
|
|
113
|
+
- High の関係者は、必要な合意または関与方針を空欄にしない。
|
|
114
|
+
|
|
115
|
+
| 評価 | 影響度の基準 | 関心度の基準 |
|
|
116
|
+
| ------ | -------------------------------------------------- | ---------------------------------------------- |
|
|
117
|
+
| High | 方針、範囲、優先順位、公開・利用可否を直接左右する | 成果または進行に継続的な確認・判断を必要とする |
|
|
118
|
+
| Medium | 一部の成果物、利用、運用、合意形成に影響する | 節目または変更時に確認・調整を必要とする |
|
|
119
|
+
| Low | 影響は限定的または間接的である | 通知または必要時の共有で足りる |
|
|
120
|
+
|
|
121
|
+
### 6.3. エンゲージメント方針
|
|
122
|
+
|
|
123
|
+
- 現状と目標を対比し、差分を埋める対応方針を記載する。
|
|
124
|
+
- 対応方針には、目的が情報提供、相談、合意形成、承認依頼、巻き込み、リスク低減のどれか分かる行動を書く。
|
|
125
|
+
- 責任者、期限、証跡を記載し、未確定の場合は _TODO_:、_UNDECIDED_:、_ASSUMPTION_: を用いる。
|
|
126
|
+
|
|
127
|
+
推奨表:
|
|
128
|
+
|
|
129
|
+
| ID | 関係者 | 現状 | 目標 | 対応方針 | 責任者 | 期限 | 証跡 |
|
|
130
|
+
| --- | ------ | ---- | ---- | -------- | ------ | ---- | ---- |
|
|
131
|
+
|
|
132
|
+
### 6.4. コミュニケーション要件
|
|
133
|
+
|
|
134
|
+
- 情報要求は、受け取る情報と、その情報で行う判断または確認が分かる粒度で書く。
|
|
135
|
+
- 希望チャネルは、会議体や配信頻度の詳細ではなく、対面、Issue、文書、公開ページなどの手段を示す。
|
|
136
|
+
- 詳細なコミュニケーション計画を作る場合は、本章をその入力とし、同じ配信計画を二重管理しない。
|
|
137
|
+
|
|
138
|
+
推奨表:
|
|
139
|
+
|
|
140
|
+
| ID | 関係者 | 情報要求 | 希望チャネル | 合意・報告の必要性 | 証跡要件 | コミュニケーション計画への反映 |
|
|
141
|
+
| --- | ------ | -------- | ------------ | ------------------ | -------- | ------------------------------ |
|
|
142
|
+
|
|
143
|
+
### 6.5. 見直し条件
|
|
144
|
+
|
|
145
|
+
- 概要、範囲、体制、公開方針、主要な利用者影響が変わるときは見直す。
|
|
146
|
+
- 定期見直しを行う場合は、周期だけでなく、確認する内容と承認者を明記する。
|
|
147
|
+
- 見直しの結果は、変更差分、決定記録、Issue、Pull Request のいずれかで追跡可能にする。
|
|
148
|
+
|
|
149
|
+
推奨表:
|
|
150
|
+
|
|
151
|
+
| 更新トリガー | 見直し内容 | 見直し責任者 | 承認者 | 証跡 |
|
|
152
|
+
| ------------ | ---------- | ------------ | ------ | ---- |
|
|
153
|
+
|
|
154
|
+
## 7. 禁止事項
|
|
155
|
+
|
|
156
|
+
| 項目 | 理由 |
|
|
157
|
+
| --------------------------------------------------------------------- | -------------------------------------------------------------- |
|
|
158
|
+
| 関係者の役割・責任・関与区分を記載しない | 調整先と利用者影響を判断できないため |
|
|
159
|
+
| 影響度または関心度を根拠なく評価する | 対応優先度を説明できないため |
|
|
160
|
+
| 必要な合意を空欄にする | 意思決定者や合意対象を識別できないため |
|
|
161
|
+
| ステークホルダー ID をタスクの owner として使う | ステークホルダーと責務 Role の境界が崩れるため |
|
|
162
|
+
| 未採用の Role code を推測で記載する | 組織・責務定義との不整合を招くため |
|
|
163
|
+
| 個人連絡先、非公開情報、機密性の高い利害関係を記載する | 公開時の情報管理リスクを高めるため |
|
|
164
|
+
| 詳細な会議運営や配信計画を重複管理する | コミュニケーション計画との二重管理になるため |
|
|
165
|
+
| AI Agent やツールなどの実行主体を単独のステークホルダーとして記載する | 人または組織との関係として整理できず、責任境界が曖昧になるため |
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:prj-success-criteria-and-acceptance-criteria-rulebook
|
|
4
|
+
type: rulebook
|
|
5
|
+
status: ready
|
|
6
|
+
target_format: markdown
|
|
7
|
+
recipe: specdojo:prj-success-criteria-and-acceptance-criteria-recipe
|
|
8
|
+
sample: specdojo:prj-success-criteria-and-acceptance-criteria-sample
|
|
9
|
+
template: specdojo:prj-success-criteria-and-acceptance-criteria-template
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# 成功基準と受入条件 作成ルール
|
|
13
|
+
|
|
14
|
+
Success Criteria and Acceptance Criteria Documentation Rulebook
|
|
15
|
+
|
|
16
|
+
本ドキュメントは、プロジェクト成功判定と受入可否判定を定義するためのルールです。
|
|
17
|
+
判定基準、責任者、証跡を揃え、完了判断のぶれを防ぎます。
|
|
18
|
+
|
|
19
|
+
## 1. 全体方針
|
|
20
|
+
|
|
21
|
+
- 本ルールの対象は、プロジェクトの成功基準と受入条件です。
|
|
22
|
+
- 目的は、業務価値に対して何を確認し、誰が、いつ、どの証跡で合否を判断するかを固定することです。
|
|
23
|
+
- 成功基準は「対応する業務価値」「条件」「判定基準」「測定方法」「判定時期」「確認者」を 1 セットで定義します。
|
|
24
|
+
- 受入条件は、業務価値、合格基準、証跡、確認者、承認者を対応付けます。
|
|
25
|
+
- 成功基準は、初期公開・初期リリース、公開・運用開始後の短期、中長期の事業・社会的成果に分けます。後続時期の基準は初期受入の合否から分離します。
|
|
26
|
+
- 受入条件は、対象成果物やリリースが利用者価値の提供を開始できるかを判定する条件であり、中長期の成功そのものとは区別します。
|
|
27
|
+
- 実装詳細、個別テスト手順、設計判断は扱わず、判定に必要な要求レベルの条件のみを扱います。
|
|
28
|
+
|
|
29
|
+
## 2. 位置づけと用語定義
|
|
30
|
+
|
|
31
|
+
### 2.1. 位置づけ(他ドキュメントとの関係)
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
flowchart LR
|
|
35
|
+
POV["プロジェクト概要"]
|
|
36
|
+
PSC["プロジェクトスコープ"]
|
|
37
|
+
SAC["成功基準と受入条件"]
|
|
38
|
+
BAC["業務受入条件"]
|
|
39
|
+
SYS["システム受入条件"]
|
|
40
|
+
|
|
41
|
+
POV --> PSC --> SAC --> BAC
|
|
42
|
+
SAC --> SYS
|
|
43
|
+
|
|
44
|
+
classDef target stroke-width:4px
|
|
45
|
+
class SAC target
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### 2.2. 用語定義(本ルール内)
|
|
49
|
+
|
|
50
|
+
| 用語 | 定義 |
|
|
51
|
+
| -------- | ------------------------------------------------------------------ |
|
|
52
|
+
| 成功基準 | 利用者、業務、事業または社会に期待する成果が達成されたかを示す条件 |
|
|
53
|
+
| 受入条件 | 成果物やリリースを利用側が受け入れ可能と判断する条件 |
|
|
54
|
+
| 業務価値 | 利用者・業務にとって実現したい効果または状態 |
|
|
55
|
+
| 判定段階 | 初期公開・初期リリース、短期、中長期など、条件を評価する時間区分 |
|
|
56
|
+
| 完了定義 | 完了とみなすために満たすべき必須条件 |
|
|
57
|
+
| 証跡 | 判定結果を確認できる記録(報告書、ログ、議事録等) |
|
|
58
|
+
| 確認者 | 条件の充足と証跡を確認する役割 |
|
|
59
|
+
| 承認者 | 判定結果に対して最終責任を持つ役割 |
|
|
60
|
+
|
|
61
|
+
## 3. ファイル命名・ID規則
|
|
62
|
+
|
|
63
|
+
### 3.1. 配置(推奨)
|
|
64
|
+
|
|
65
|
+
- `docs/ja/projects/<project-id>/020-project-definition/prj-success-criteria-and-acceptance-criteria.md` へ配置します。
|
|
66
|
+
- 判定結果の証跡(評価表、受入記録)は参照可能な場所に配置します。
|
|
67
|
+
|
|
68
|
+
### 3.2. ドキュメントID(推奨)
|
|
69
|
+
|
|
70
|
+
- 推奨: `<project-id>:prj-success-criteria-and-acceptance-criteria`
|
|
71
|
+
- 例: `prj-0001:prj-success-criteria-and-acceptance-criteria`
|
|
72
|
+
|
|
73
|
+
### 3.3. ファイル名(推奨)
|
|
74
|
+
|
|
75
|
+
- 推奨: `prj-success-criteria-and-acceptance-criteria.md`
|
|
76
|
+
- 日本語ファイル名の場合: `成功基準と受入条件.md`
|
|
77
|
+
|
|
78
|
+
## 4. 推奨 Frontmatter 項目
|
|
79
|
+
|
|
80
|
+
### 4.1. 設定内容
|
|
81
|
+
|
|
82
|
+
- 参照スキーマ: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
|
|
83
|
+
- メタ情報標準: [document-metadata-standard.md](../standards/document-metadata-standard.md)
|
|
84
|
+
|
|
85
|
+
| 項目 | 説明 | 必須 |
|
|
86
|
+
| ---------- | ---------------------------------------------------------------- | ---- |
|
|
87
|
+
| id | `<project-id>:prj-success-criteria-and-acceptance-criteria` | ○ |
|
|
88
|
+
| type | `project` 固定 | ○ |
|
|
89
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
90
|
+
| rulebook | `specdojo:prj-success-criteria-and-acceptance-criteria-rulebook` | ○ |
|
|
91
|
+
| based_on | `prj-scope` など、直接の根拠となる文書を含む配列 | 任意 |
|
|
92
|
+
| supersedes | 置き換え対象の旧文書 ID | 任意 |
|
|
93
|
+
|
|
94
|
+
### 4.2. 推奨ルール
|
|
95
|
+
|
|
96
|
+
- 成功基準と受入条件は混在させず、別表で管理します。
|
|
97
|
+
- 各成功基準・受入条件には、少なくとも一つの業務価値を対応付けます。技術的受入条件は、支援する業務価値と技術条件を区別します。
|
|
98
|
+
- `based_on` には、根拠となる `prj-scope` に加え、期待効果を定義した `prj-overview` がある場合は含めます。
|
|
99
|
+
- 閾値が未確定の場合は _UNDECIDED_: を使い、確定期限と担当を記載します。
|
|
100
|
+
|
|
101
|
+
## 5. 本文構成(標準テンプレ)
|
|
102
|
+
|
|
103
|
+
### 5.1. 成功基準と受入条件(Success Criteria and Acceptance Criteria)
|
|
104
|
+
|
|
105
|
+
| 番号 | 見出し | 必須 | 内容(要点) |
|
|
106
|
+
| ---- | -------------------- | ---- | ------------------------------------------ |
|
|
107
|
+
| 1 | 判定対象と適用範囲 | ○ | 判定段階、初期受入の必須条件、対象外 |
|
|
108
|
+
| 2 | 成功基準 | ○ | 業務価値、判定段階、指標、判定方法、確認者 |
|
|
109
|
+
| 3 | 受入条件 | ○ | 業務価値、受入項目、合否基準、証跡、承認者 |
|
|
110
|
+
| 4 | 判定手順と証跡 | ○ | 判定タイミング、証跡、承認経路 |
|
|
111
|
+
| 5 | 例外条件と未解決事項 | 任意 | 保留条件、暫定対応、解決期限 |
|
|
112
|
+
|
|
113
|
+
## 6. 記述ガイド
|
|
114
|
+
|
|
115
|
+
### 6.1. 共通
|
|
116
|
+
|
|
117
|
+
- 各条件は測定可能で再現可能な表現にします。
|
|
118
|
+
- 業務価値は、対象利用者、利用場面、期待効果のいずれかを読み取れる表現にします。
|
|
119
|
+
- 成果物の存在、機能数、文書数、lint 合格などは業務価値ではなく、必要に応じて受入条件へ置きます。
|
|
120
|
+
- 章参照は章番号ではなく章タイトルで記述します。
|
|
121
|
+
- 条件追加/変更時は、変更理由と影響範囲を追記します。
|
|
122
|
+
|
|
123
|
+
### 6.2. 成功基準
|
|
124
|
+
|
|
125
|
+
- 初期公開・初期リリースでは代表利用者による作業完遂、短期では利用・定着・直接的改善、中長期では事業・社会的成果への寄与を扱います。
|
|
126
|
+
- 公開後にしか測定できない成功基準も、判定時期と測定責任を定めて本文に置き、初期受入の合否から分離します。
|
|
127
|
+
- KPI のような定量指標だけでなく、運用定着や利用者受容など定性条件も明示します。
|
|
128
|
+
- 各条件に対応する業務価値、判定タイミング、確認ロールを必ず設定する。
|
|
129
|
+
- 閾値を置く場合は、測定対象、単位、母数または比較対象を明記する。
|
|
130
|
+
- 外部要因を受ける成果は、当該プロジェクトだけの因果と断定せず、利用前後の変化と寄与を確認します。
|
|
131
|
+
- 低コスト、費用負担の軽減、無償提供などを業務価値に置く場合は、少なくとも追加の現金支出、人の作業時間、継続的な運用負荷を分けて測定します。既存資産、寄付、無償枠を使う場合は評価上の扱いを定め、人の無償労働への負荷転嫁を成功とみなしません。
|
|
132
|
+
|
|
133
|
+
推奨表(成功基準):
|
|
134
|
+
|
|
135
|
+
| ID | 対応する業務価値 | 条件 | 判定基準 | 測定方法 | 判定時期 | 確認者 |
|
|
136
|
+
| --- | ---------------- | ---- | -------- | -------- | -------- | ------ |
|
|
137
|
+
|
|
138
|
+
### 6.3. 受入条件
|
|
139
|
+
|
|
140
|
+
- `種別` 列で受入観点(利用者視点、文書体系、実践の型、技術的受入、品質、公開適性など)を分類する。
|
|
141
|
+
- 各条件に業務価値、合格基準、証跡(参照先ファイル、ログ、記録等)、確認者、承認者を明記する。
|
|
142
|
+
- 初期公開・初期リリースの受入条件は、価値提供を開始できる状態を判定します。公開後の利用件数や中長期成果を、初期受入の必須条件にしません。
|
|
143
|
+
- 否決時の是正内容、再確認する受入条件、再判定時期を例外条件または是正プロセスで定義する。
|
|
144
|
+
- 技術的な確認条件は、業務価値の受入条件と混在させず、種別と確認者を明示する。
|
|
145
|
+
|
|
146
|
+
推奨表(受入条件):
|
|
147
|
+
|
|
148
|
+
| ID | 対応する業務価値 | 種別 | 条件 | 合格基準 | 証跡 | 確認者 | 承認者 |
|
|
149
|
+
| --- | ---------------- | ---- | ---- | -------- | ---- | ------ | ------ |
|
|
150
|
+
|
|
151
|
+
## 7. 禁止事項
|
|
152
|
+
|
|
153
|
+
| 項目 | 理由 |
|
|
154
|
+
| -------------------------------------------------------------- | ------------------------------------------ |
|
|
155
|
+
| 「十分に」「問題ない」等のみで基準記載 | 合否判定ができないため |
|
|
156
|
+
| 業務価値と対応しない成功基準または受入条件 | 何のための判定か追跡できないため |
|
|
157
|
+
| 成果物数、機能数、作業完了率だけを業務価値として扱う | 利用者や事業に生じる変化を判定できないため |
|
|
158
|
+
| 公開後の成功基準を未解決事項へ移し、測定責任を定めない | 成功の判定が初期受入だけで終わるため |
|
|
159
|
+
| 中長期の事業・社会的成果を短期の利用件数だけで置き換える | プロジェクトの最終目的を矮小化するため |
|
|
160
|
+
| 測定方法なしの閾値記載 | 再現性が担保できないため |
|
|
161
|
+
| 現金支出の削減だけで低コストと判定し、作業・運用負荷を除外する | 人への負荷転嫁を成功と誤認するため |
|
|
162
|
+
| 確認者または承認者不在の受入判定 | 確認責任または最終責任が不明確になるため |
|
|
163
|
+
| 証跡なしの合格宣言 | 監査と追跡ができないため |
|
|
164
|
+
| Agent に最終判断・GO 判定を委ねる | 人間の判断責任を代替してしまうため |
|
|
165
|
+
| 公開リポジトリに個人名・個人連絡先・非公開の組織情報を記載する | 公開範囲とプライバシーに反するため |
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:sac-rulebook
|
|
4
|
+
type: rulebook
|
|
5
|
+
status: draft
|
|
6
|
+
recipe: undecided
|
|
7
|
+
sample: specdojo:sac-sample
|
|
8
|
+
template: undecided
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# システム受入条件仕様(SAC)作成ルール
|
|
12
|
+
|
|
13
|
+
本ドキュメントは、品質保証・運用設計・テスト設計のために **システム受入条件(System Acceptance Criteria: SAC)を統一形式で記述する標準ルール**です。
|
|
14
|
+
SAC は「システム全体としての合格基準(機能・非機能・障害・移行など)」を、**Markdown 形式**で検証可能な形に落とし、受入判断の根拠を明確にします。
|
|
15
|
+
|
|
16
|
+
## 1. 全体方針
|
|
17
|
+
|
|
18
|
+
- SAC は **システム全体としての出口条件(合格基準)** です。
|
|
19
|
+
- 例: 「性能試験で全ての NFR を満たし、重大障害 0 件であること」
|
|
20
|
+
- 受入条件は **観測・計測できる事実**として書きます。
|
|
21
|
+
- 「正しく動作する」「問題ない」などの曖昧表現は禁止。
|
|
22
|
+
- 手順書を作るのが目的ではありません。
|
|
23
|
+
- クリック手順や画面遷移の逐語列挙は避け、**システムに与える入力/操作**と**期待結果**を要約します。
|
|
24
|
+
- 実装詳細(例: 物理テーブル名、SQL全文、実装クラス/関数名、特定ライブラリの設定値)は記載しません。
|
|
25
|
+
- 1ファイル = 1 受入対象(合格基準のまとまり)を基本とします。
|
|
26
|
+
|
|
27
|
+
- 例: `性能(主要API/画面)`, `障害復旧`, `セキュリティ(権限/監査)`, `移行(初期データ)` など
|
|
28
|
+
|
|
29
|
+
## 2. 用語定義
|
|
30
|
+
|
|
31
|
+
| 用語 | 定義 |
|
|
32
|
+
| -------- | ---------------------------------------------------------- |
|
|
33
|
+
| SAC | システム受入条件。システム全体としての合格基準(出口条件) |
|
|
34
|
+
| 受入対象 | 受入として保証したい範囲や品質(例: 性能、障害復旧、移行) |
|
|
35
|
+
| シナリオ | 受入条件の具体ケース |
|
|
36
|
+
| 前提 | シナリオ開始前の条件(前提状態、試験環境、負荷条件など) |
|
|
37
|
+
| 操作 | システムに与える入力/操作/イベントの要約 |
|
|
38
|
+
| 期待結果 | 観測可能な事実(状態変化、記録、通知、計測値など) |
|
|
39
|
+
|
|
40
|
+
## 3. ファイル命名・ID規則
|
|
41
|
+
|
|
42
|
+
- ファイル名: `sac-<番号>-<短い日本語名>.md` (例: `sac-0010-性能.md`)
|
|
43
|
+
- Frontmatter:
|
|
44
|
+
- `id`: `sac-performance`, `sac-disaster-recovery` のように小文字ハイフン形式。
|
|
45
|
+
- `title`: 「システム受入条件: 性能」など。
|
|
46
|
+
|
|
47
|
+
推奨:
|
|
48
|
+
|
|
49
|
+
- 受入対象が肥大化する場合は、カテゴリやサブシステム単位で分割し、下位文書側で `part_of` に上位SACを指定します。
|
|
50
|
+
|
|
51
|
+
- `based_on` には、根拠となる仕様 ID(例: `nfr-...`, `bac-...`, `br-...`, `bps-...`)を列挙します。
|
|
52
|
+
|
|
53
|
+
## 4. 推奨 Frontmatter 項目
|
|
54
|
+
|
|
55
|
+
Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` の制約に従います。
|
|
56
|
+
|
|
57
|
+
| 項目 | 説明 | 必須 |
|
|
58
|
+
| ---------- | --------------------------------------------- | ---- |
|
|
59
|
+
| id | 受入条件ID(`sac-...`) | ○ |
|
|
60
|
+
| type | `test` 固定 | ○ |
|
|
61
|
+
| title | 受入条件名(例: システム受入条件: 性能) | ○ |
|
|
62
|
+
| status | `draft`/`ready`/`deprecated` | ○ |
|
|
63
|
+
| part_of | 上位SAC ID(分割している場合) | 任意 |
|
|
64
|
+
| based_on | 根拠となる仕様ID(NFR/BAC/BR/BPS/DEC/TSL 等) | 任意 |
|
|
65
|
+
| supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
|
|
66
|
+
|
|
67
|
+
推奨:
|
|
68
|
+
|
|
69
|
+
- `based_on` に、受入条件の根拠となる NFR/BAC を必ず紐づけます。
|
|
70
|
+
- SAC が下位のテスト設計(テスト条件一覧、システムテスト仕様など)へ分解される場合、`tests` から参照できるよう ID は安定させます。
|
|
71
|
+
|
|
72
|
+
## 5. 本文構成(標準テンプレ)
|
|
73
|
+
|
|
74
|
+
各 SAC ファイルは以下の見出しを順番に並べます。
|
|
75
|
+
|
|
76
|
+
1. 概要
|
|
77
|
+
2. 受入条件
|
|
78
|
+
3. メモ / 将来課題
|
|
79
|
+
|
|
80
|
+
## 6. 記述ガイド詳細
|
|
81
|
+
|
|
82
|
+
### 6.1 概要
|
|
83
|
+
|
|
84
|
+
- 1〜3文で「何を合格とするか(出口条件)」を書きます。
|
|
85
|
+
- 可能なら対象仕様(NFR/BAC/主要機能)を言及し、`based_on` と整合させます。
|
|
86
|
+
|
|
87
|
+
### 6.2 受入条件
|
|
88
|
+
|
|
89
|
+
SAC は **Markdown** で「受入対象」と「シナリオ」を記述します。
|
|
90
|
+
|
|
91
|
+
基本:
|
|
92
|
+
|
|
93
|
+
- 1ファイル = 1 受入対象(大きい場合はファイル分割)。
|
|
94
|
+
- シナリオは 2〜8 個程度を目安に、合否判定が必要な代表パターンを押さえます。
|
|
95
|
+
- 期待結果は **観測・計測できる事実** として書きます(可能な限り数値・単位を含める)。
|
|
96
|
+
|
|
97
|
+
シナリオの標準テンプレ(推奨):
|
|
98
|
+
|
|
99
|
+
- `### シナリオ: <短い条件名>`
|
|
100
|
+
- `#### 前提`(箇条書き)
|
|
101
|
+
- `#### 操作`(箇条書き。クリック手順の逐語列挙ではなく、入力/操作/イベントとして要約)
|
|
102
|
+
- `#### 期待結果`(箇条書き。観測点/計測値/閾値を含める)
|
|
103
|
+
- `#### 判定方法`(任意。どこを見て合否判定するか)
|
|
104
|
+
|
|
105
|
+
記述のコツ:
|
|
106
|
+
|
|
107
|
+
- 非機能は「指標+基準(閾値)」まで書きます。
|
|
108
|
+
- 例: 応答時間(P95)/ 稼働率 / エラー率 / RTO / RPO / 監査ログの保持期間 など
|
|
109
|
+
- “環境や負荷条件”が重要な場合は、「前提」に条件を明記します。
|
|
110
|
+
- 例: 「ピーク時相当の負荷(100 RPS)を与えている」
|
|
111
|
+
- 1つのシナリオに要求を詰め込みすぎない(レビュー・切り分けが難しくなる)。
|
|
112
|
+
|
|
113
|
+
#### 6.2.1 ケース表
|
|
114
|
+
|
|
115
|
+
同じ操作を **条件/入力だけ変えて反復**する場合は、シナリオを増やす代わりに **ケース表**で差分をまとめてよいです。
|
|
116
|
+
|
|
117
|
+
書き方(最小):
|
|
118
|
+
|
|
119
|
+
- `### シナリオ: <共通の操作/イベント>` を 1 つ置く
|
|
120
|
+
- その下に `#### ケース一覧`(表)を置き、ケースごとの違いを表にまとめる
|
|
121
|
+
|
|
122
|
+
ケース表の例(列は必要に応じて調整):
|
|
123
|
+
|
|
124
|
+
| ケース | 前提(条件/負荷/データ量) | 操作 | 期待結果(観測点/基準) |
|
|
125
|
+
| ------ | -------------------------- | ---- | ----------------------- |
|
|
126
|
+
| C1 | … | … | … |
|
|
127
|
+
|
|
128
|
+
### 6.3 メモ / 将来課題
|
|
129
|
+
|
|
130
|
+
- 未確定の前提(例: ピーク時の定義、想定データ量、外部依存のSLA)
|
|
131
|
+
- 将来追加したい SAC(例: DR訓練頻度、監査ログの検索性)
|
|
132
|
+
|
|
133
|
+
## 7. 禁止事項
|
|
134
|
+
|
|
135
|
+
| 項目 | 理由 |
|
|
136
|
+
| ----------------------------------------------- | ---------------------------- |
|
|
137
|
+
| 物理テーブル名・物理カラム名・SQL全文 | 概念レベル逸脱、変更に弱い |
|
|
138
|
+
| 実装クラス/関数名、特定ライブラリの設定値の列挙 | 実装依存で変更に弱い |
|
|
139
|
+
| クリック/画面遷移の逐語列挙 | UI変更に弱い・本質が埋もれる |
|
|
140
|
+
| 「正しく動く」「問題ない」等の曖昧表現 | 検証不能 |
|
|
141
|
+
|
|
142
|
+
## 8. よくある誤りと対策
|
|
143
|
+
|
|
144
|
+
- 期待結果が曖昧(「性能が良い」) → 指標と基準(数値/単位)に分解する
|
|
145
|
+
- 前提がない(平常/ピークが不明) → 前提に条件(負荷、データ量、時間帯)を書く
|
|
146
|
+
- 期待結果が測れない → 観測点(ログ/監視/試験レポート等)を期待結果や判定方法に含める
|
|
147
|
+
- 1つのシナリオに要件を詰め込みすぎ → シナリオを分割する
|
|
148
|
+
|
|
149
|
+
## 9. サンプル(簡易)
|
|
150
|
+
|
|
151
|
+
### メタ情報
|
|
152
|
+
|
|
153
|
+
```yaml
|
|
154
|
+
---
|
|
155
|
+
id: sac-performance
|
|
156
|
+
type: test
|
|
157
|
+
title: システム受入条件: 性能
|
|
158
|
+
status: draft
|
|
159
|
+
part_of: []
|
|
160
|
+
based_on:
|
|
161
|
+
- nfr-performance
|
|
162
|
+
supersedes: []
|
|
163
|
+
---
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### 概要
|
|
167
|
+
|
|
168
|
+
主要な画面操作と主要 API が、平常時およびピーク時において業務上許容できる時間内で完了することを合格基準として定義する。
|
|
169
|
+
|
|
170
|
+
### 受入条件
|
|
171
|
+
|
|
172
|
+
#### シナリオ: 販売登録の応答時間
|
|
173
|
+
|
|
174
|
+
##### 前提
|
|
175
|
+
|
|
176
|
+
- 対象環境はシステムテスト環境である
|
|
177
|
+
|
|
178
|
+
##### 操作
|
|
179
|
+
|
|
180
|
+
- おばあちゃんが販売登録画面で一般的な会計を行う
|
|
181
|
+
|
|
182
|
+
##### 期待結果
|
|
183
|
+
|
|
184
|
+
- 会計確定から結果表示までが 3 秒以内であること
|
|
185
|
+
|
|
186
|
+
#### シナリオ: 在庫照会APIの応答時間(平常時)
|
|
187
|
+
|
|
188
|
+
##### 前提
|
|
189
|
+
|
|
190
|
+
- 平常時相当の負荷(20 RPS)を与えている
|
|
191
|
+
|
|
192
|
+
##### 操作
|
|
193
|
+
|
|
194
|
+
- 在庫照会APIを呼び出す
|
|
195
|
+
|
|
196
|
+
##### 期待結果
|
|
197
|
+
|
|
198
|
+
- 応答時間(P95)が 500ms 以内であること
|
|
199
|
+
|
|
200
|
+
### メモ / 将来課題
|
|
201
|
+
|
|
202
|
+
- ピーク時の同時接続数・データ量の確定
|