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,235 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:prj-comparison-of-alternatives-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:prj-comparison-of-alternatives-rulebook
|
|
7
|
+
sample: specdojo:prj-comparison-of-alternatives-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 代替案比較 作成レシピ
|
|
11
|
+
|
|
12
|
+
Comparison of Alternatives Writing Recipe
|
|
13
|
+
|
|
14
|
+
本ドキュメントは、代替案比較を「採択案、非採択案、技術的影響、見直し条件を説明できる内容」に仕上げるための作り方です。
|
|
15
|
+
本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
|
|
16
|
+
|
|
17
|
+
## 1. このレシピの使い方
|
|
18
|
+
|
|
19
|
+
- 最初に、スコープ、課題と解決アプローチ、前提・制約から、解くべき課題、必要能力、制約、評価条件を抜き出す。
|
|
20
|
+
- 次に、意思決定を比較レイヤーへ分け、候補カテゴリと選定基準を決めてから具体候補を調査する。
|
|
21
|
+
- 標準・方法論と製品・ツールを区別し、同じ意思決定を代替できる候補を各レイヤーで最低 2 案に広げる。
|
|
22
|
+
- 最後に、採択、比較試行、保留、非採択、技術的影響、再評価条件を残し、判断の再現性を確保する。
|
|
23
|
+
- 解くべき課題と必要能力(Why)、同じ意思決定と評価条件(What)、候補案・採択方針・軽減策(How)を整理し、決定 ID、課題 ID、評価理由、根拠資料、記録先で追跡する(Trace)。後続の設計詳細は比較結果から委譲する。
|
|
24
|
+
|
|
25
|
+
## 2. 作成前に集める情報
|
|
26
|
+
|
|
27
|
+
最初から比較表を書かず、以下を短いメモで集める。
|
|
28
|
+
|
|
29
|
+
| 項目 | 集める情報 |
|
|
30
|
+
| -------------- | --------------------------------------------------------------- |
|
|
31
|
+
| 比較目的 | 何を決めるための比較か、どの判断を支援するか |
|
|
32
|
+
| 根拠資料 | スコープ、課題と解決アプローチ、前提・制約、関連する決定事項 |
|
|
33
|
+
| 必要能力 | 課題を解くために必要な能力。特定の解決手段とは分けて集める |
|
|
34
|
+
| 決定と順序 | 解決方式、購入 / 構築、製品など、先に決めることと後で決めること |
|
|
35
|
+
| 代替案 | 同じ課題を解決できる一式の案 |
|
|
36
|
+
| 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など |
|
|
37
|
+
| 候補カテゴリ | 非システム、汎用ツール、既存製品、個別構築など |
|
|
38
|
+
| 候補選定根拠 | 公式資料で確認した責務、保管場所、対応環境、移行可能性 |
|
|
39
|
+
| 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性 |
|
|
40
|
+
| 技術的成立条件 | 既存資産、外部依存、制約、後続成果物への影響 |
|
|
41
|
+
| 採択判断者 | 最終判断を行う人間の責任ロール。通常は `PO` |
|
|
42
|
+
| 再評価条件 | 方針を見直すトリガー、次に確認する指標、記録先 |
|
|
43
|
+
| 正本・撤退条件 | 正しい情報源、同期方向、試行や外部ツールをやめる方法 |
|
|
44
|
+
|
|
45
|
+
## 3. 全体の作成手順
|
|
46
|
+
|
|
47
|
+
1. H1 で比較対象の成果物名またはプロジェクト名を明示する。
|
|
48
|
+
2. 比較目的と前提条件で、決定 ID、判断順序、比較レイヤー、扱わない範囲を書く。
|
|
49
|
+
3. 前段文書から課題・制約・必要能力を抽出し、レイヤーごとの候補カテゴリと選定基準を定める。
|
|
50
|
+
4. 公式資料を調査し、現行方式、外部の直接競合、採用しない案を含む具体候補へ絞る。
|
|
51
|
+
5. 比較対象案で、同じ意思決定に属する候補を、ID、責務、強み、制約を揃えて並べる。
|
|
52
|
+
6. 評価軸と評価基準を比較レイヤーごとに定義し、同一レイヤー内では固定する。
|
|
53
|
+
7. 比較結果で、採択、一部採択、比較試行、保留、非採択と再評価条件を説明する。
|
|
54
|
+
8. 製品・サービスはデータの正本、移行、ロックイン、撤退方法を含めて技術的影響を示す。
|
|
55
|
+
9. リスクとトレードオフ、最終判断者、再評価条件、記録先を明示する。
|
|
56
|
+
|
|
57
|
+
## 4. 各章の書き方
|
|
58
|
+
|
|
59
|
+
### 4.1. 比較目的と前提条件
|
|
60
|
+
|
|
61
|
+
問い:
|
|
62
|
+
|
|
63
|
+
- この比較で、どの判断を支援するのか。
|
|
64
|
+
- 業務運用、解決方式、購入 / 構築、製品、開発方式のどの比較レイヤーを扱うのか。
|
|
65
|
+
- 対象プロジェクトの業務課題・利用者課題を直接解く判断になっているか。
|
|
66
|
+
- 複数の判断がある場合、どれを先に決め、後続判断へ何を引き継ぐのか。
|
|
67
|
+
- 比較対象に含める範囲と、含めない範囲は何か。
|
|
68
|
+
- 根拠資料から引き継ぐ課題、必要能力、制約、評価条件は何か。
|
|
69
|
+
- 根拠資料が示す対象外範囲や、初期段階で優先する最小成立範囲は、前提条件に引き継いでいるか。
|
|
70
|
+
|
|
71
|
+
書き方:
|
|
72
|
+
|
|
73
|
+
- 比較目的は 1〜2 文で書き、設計詳細や実装方式の説明に寄せすぎない。
|
|
74
|
+
- 根拠資料は、直接判断に使う文書に絞る。
|
|
75
|
+
- 未確定事項は _TODO_ / _UNDECIDED_ / _ASSUMPTION_ で明示する。
|
|
76
|
+
- 対象外とする範囲や、全体を一度に完成させきれない場合の扱いがあれば、前提条件で明示する。
|
|
77
|
+
- 複数レイヤーには `D-01` のような決定 ID を付け、各決定で扱わない範囲も書く。
|
|
78
|
+
|
|
79
|
+
### 4.2. 比較対象案
|
|
80
|
+
|
|
81
|
+
問い:
|
|
82
|
+
|
|
83
|
+
- 同じ目的を達成しうる案が最低 2 案あるか。
|
|
84
|
+
- 各案の対象範囲は同じ粒度で説明できているか。
|
|
85
|
+
- 各案は単独でも目的達成への道筋を説明できるか。
|
|
86
|
+
- 現行案と根拠の異なる、採択しない可能性がある有力な外部案を含めたか。
|
|
87
|
+
- 業務方式、製品、開発方式など抽象度の異なる候補を混在させていないか。
|
|
88
|
+
- 具体候補より先に、候補カテゴリと選定基準を定めたか。
|
|
89
|
+
- 「代表的」「標準」と呼ぶ根拠があるか。ない場合は比較候補と表現しているか。
|
|
90
|
+
|
|
91
|
+
書き方:
|
|
92
|
+
|
|
93
|
+
- 案 ID は `ALT-01` のように安定した形式にし、複数レイヤーを扱う場合はレイヤーを識別できる prefix を使う。
|
|
94
|
+
- 案名は手段だけでなく、優先する方針が分かる名前にする。
|
|
95
|
+
- 対象範囲には、成果物、活動、機能、運用範囲を混在させすぎない。
|
|
96
|
+
- 前段文書の案 ID を再掲する場合も、それだけで候補を閉じず、外部調査で得た候補を追加する。
|
|
97
|
+
- 相互に組み合わせる要素は、業務運用を含む一式の解決案へまとめる。
|
|
98
|
+
- 購入 / 構築の比較と具体製品の比較を分け、上位判断で必要性が残った場合だけ製品比較へ進む。
|
|
99
|
+
- 開発戦略や作業管理は、プロジェクト運営そのものが比較目的の場合だけ主レイヤーにする。
|
|
100
|
+
- 候補カテゴリは、非システム対応 / 汎用ツール / 既存製品 / 個別構築など、課題解決への道筋が異なる単位で分ける。
|
|
101
|
+
- 公式資料から責務、データ保管、対応環境、移行可能性を確認し、市場占有率を調べていない候補を市場代表と断定しない。
|
|
102
|
+
|
|
103
|
+
### 4.3. 評価軸と評価基準
|
|
104
|
+
|
|
105
|
+
問い:
|
|
106
|
+
|
|
107
|
+
- 評価軸は案ごとに変わっていないか。
|
|
108
|
+
- 業務価値、意思決定、技術制約、リスクの観点が揃っているか。
|
|
109
|
+
- 利用者適合、業務継続、データ移行、保守、将来変更を評価できるか。
|
|
110
|
+
- `High` / `Middle` / `Low` の判定理由を説明できるか。
|
|
111
|
+
- 評価軸は、根拠資料の課題 ID や業務価値のどの項目に対応するか説明できるか。
|
|
112
|
+
|
|
113
|
+
書き方:
|
|
114
|
+
|
|
115
|
+
- 効果、コスト、期間、リスク、運用適合、技術実現性を最低ラインにし、比較目的に応じて適応性、追跡性、AI 適合、成熟度を追加する。
|
|
116
|
+
- 重みを使う場合は、重みの理由を備考に書く。
|
|
117
|
+
- 低いほどよい軸は、備考で判定方向を明示する。
|
|
118
|
+
- 評価軸の説明には、根拠資料の課題 ID や業務価値との対応を添え、評価が業務価値から離れないようにする。
|
|
119
|
+
- レイヤーが異なれば評価軸を分けてよいが、同一レイヤーの候補には同じ軸と判定方向を使う。
|
|
120
|
+
- 製品・サービスには、業務適合、データ移行、ロックイン、可逆性、成熟度を必要に応じて加える。
|
|
121
|
+
|
|
122
|
+
### 4.4. 比較結果と採択理由
|
|
123
|
+
|
|
124
|
+
問い:
|
|
125
|
+
|
|
126
|
+
- 採択案は、どの評価軸で優位なのか。
|
|
127
|
+
- 非採択案や一部採択案の理由は、再評価時に使える粒度か。
|
|
128
|
+
- 比較試行と正式採用を区別し、試行の入力、評価軸、終了条件が決まっているか。
|
|
129
|
+
- 技術的実現性と後続成果物への影響が読み取れるか。
|
|
130
|
+
|
|
131
|
+
書き方:
|
|
132
|
+
|
|
133
|
+
- 比較結果表の直後に、採択案と組み合わせ方を 1 文で書く。
|
|
134
|
+
- 採択理由は評価軸に対応させ、同じ理由を複数の表と段落へ重複させない。
|
|
135
|
+
- 技術的実現性と影響は、決定または案ごとの表にまとめて埋もれないようにする。
|
|
136
|
+
- 比較試行では同じ入力と完了条件を使い、採用・撤退の判定と記録先を先に決める。
|
|
137
|
+
- 製品・サービスを採択する場合は、データの正本、移行方法、利用停止時の取り出し方を書く。
|
|
138
|
+
|
|
139
|
+
### 4.5. リスクとトレードオフ
|
|
140
|
+
|
|
141
|
+
問い:
|
|
142
|
+
|
|
143
|
+
- 採択によって先送りする範囲、受容する負荷、失う選択肢は何か。
|
|
144
|
+
- 起きうる失敗と軽減策は対になっているか。
|
|
145
|
+
- PM や後続作業がリスク登録簿へ転記できる粒度か。
|
|
146
|
+
|
|
147
|
+
書き方:
|
|
148
|
+
|
|
149
|
+
- 区分は `リスク` / `トレードオフ` など少数に揃える。
|
|
150
|
+
- 軽減策は「確認する」だけで終えず、何を残すか、誰が判断するかまで書く。
|
|
151
|
+
- 技術詳細に踏み込む場合は、後続の設計成果物へ委譲する。
|
|
152
|
+
- 軽減策や記録先の具体名称(計画書、登録簿等)は、根拠資料で存在が確認できる仕組みに限定する。根拠資料に存在しない計画書名・台帳名を新設せず、確認できない場合は「後続の品質確認」「成果物カタログと後続作業」のように確認済みの仕組みに言い換える。
|
|
153
|
+
|
|
154
|
+
### 4.6. 決定と見直し
|
|
155
|
+
|
|
156
|
+
問い:
|
|
157
|
+
|
|
158
|
+
- 現時点の採択方針は一文で言えるか。
|
|
159
|
+
- 採択案の最終判断者が人間の責任ロールとして明記されているか。
|
|
160
|
+
- どの条件で再評価し、どこに判断理由を残すか。
|
|
161
|
+
|
|
162
|
+
書き方:
|
|
163
|
+
|
|
164
|
+
- `PO` が最終判断し、AI Agent は比較分析の支援に留めることを明記する。
|
|
165
|
+
- 再評価条件は、時間、指標、利用者フィードバック、依存変更など具体的なトリガーにする。
|
|
166
|
+
- 方針変更時の記録先を、決定記録、変更要求ログ、プロジェクト登録簿などから選ぶ。
|
|
167
|
+
|
|
168
|
+
## 5. 深掘り手順
|
|
169
|
+
|
|
170
|
+
内容が浅いと感じる場合は、次の順で深掘りする。
|
|
171
|
+
|
|
172
|
+
1. 比較目的を「何を決めるためか」に言い換える。
|
|
173
|
+
2. 前段文書から、課題、必要能力、制約、評価条件を抽出する。
|
|
174
|
+
3. 比較レイヤーごとに候補カテゴリと選定基準を定める。
|
|
175
|
+
4. 現行案から独立して、既存標準、方式、製品、ツールの公式資料を調査する。
|
|
176
|
+
5. 同じ意思決定を代替できる具体候補に絞り、標準・方法論と製品を区別する。
|
|
177
|
+
6. 評価軸を業務価値、費用、期間、リスク、運用、技術に分類する。
|
|
178
|
+
7. 評価軸を根拠資料の課題 ID や業務価値に対応付ける。
|
|
179
|
+
8. `High` / `Middle` / `Low` の根拠を 1 行ずつ補う。
|
|
180
|
+
9. 採択案の不利条件をトレードオフとして書く。
|
|
181
|
+
10. 採択・試行・保留・非採択の条件と、最終判断者、記録先、撤退方法を明示する。
|
|
182
|
+
|
|
183
|
+
## 6. 良い例 / 悪い例
|
|
184
|
+
|
|
185
|
+
| 観点 | 良い例 | 悪い例 |
|
|
186
|
+
| ------------ | ---------------------------------------------------------------- | -------------------------------------------------------------- |
|
|
187
|
+
| 比較目的 | 販売・在庫・つけの記録を継続できる解決方式を選ぶ | どれがよいか考える |
|
|
188
|
+
| 代替案 | 紙運用改善、既存サービス、個別構築を解決案として比較 | 画面、データ、開発ツールを別案として並べ、すべて採択する |
|
|
189
|
+
| 比較レイヤー | 購入 / 構築を先に判断し、必要な場合だけ製品を比較 | 販売管理方式と開発タスク管理ツールを同じ表で採点 |
|
|
190
|
+
| 候補選定 | カテゴリと基準を定め、各カテゴリの具体候補を公式資料で確認 | 知っている製品だけを代表例として比較 |
|
|
191
|
+
| 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性を同じ基準で評価 | 案ごとに都合のよい観点だけを書く |
|
|
192
|
+
| 採択理由 | 業務適合と記録継続を重視し、ALT-04 を採択する | ALT-04 がよさそうだから |
|
|
193
|
+
| 技術影響 | タブレット 1 台で試行でき、ノート移行と紙への切り戻しを要する | 実現性や影響の根拠を書かずに結論だけ述べる |
|
|
194
|
+
| 見直し条件 | 2 週間の試行で記録漏れが許容値を超えた場合、採択案を見直す | 必要なら見直す |
|
|
195
|
+
| 試行 | 同じ販売・つけ記録を 2 候補で試し、操作時間と記録漏れを測る | 導入してから使いやすそうか判断する |
|
|
196
|
+
| 軽減策の根拠 | 後続の品質確認で対応する(根拠資料にある仕組みを指す) | 品質管理計画で対応する(根拠資料に存在しない計画名を断定する) |
|
|
197
|
+
|
|
198
|
+
## 7. レビュー観点
|
|
199
|
+
|
|
200
|
+
作成後は、次の観点で確認する。
|
|
201
|
+
|
|
202
|
+
| 観点 | 確認内容 |
|
|
203
|
+
| -------------------- | ---------------------------------------------------------------------------------------------------- |
|
|
204
|
+
| 比較目的の明確性 | 何を決めるための比較かが最初に分かるか |
|
|
205
|
+
| 根拠資料との整合 | スコープ、課題と解決アプローチ、前提・制約と矛盾していないか |
|
|
206
|
+
| 候補案の妥当性 | 最低 2 案あり、同じ目的を解ける案として並んでいるか |
|
|
207
|
+
| 外部候補の網羅 | 前段文書の案の再掲だけでなく、既存標準・方式・製品を調査しているか |
|
|
208
|
+
| 候補選定の再現性 | 候補カテゴリ、選定基準、公式資料が示され、特定製品へ恣意的に絞っていないか |
|
|
209
|
+
| 比較レイヤーの統一 | 業務方式、製品、開発方式など抽象度が異なる候補を同じ表に混在させていないか |
|
|
210
|
+
| 評価軸の一貫性 | 案ごとに評価軸や判定基準を変えていないか。根拠資料の課題 ID・業務価値に対応しているか |
|
|
211
|
+
| 採択理由の説明可能性 | 採択、一部採択、非採択の理由が評価軸で説明されているか |
|
|
212
|
+
| 技術的実現性 | 外部依存、既存資産、後続成果物への影響が読み取れるか |
|
|
213
|
+
| 正本と可逆性 | 製品・サービスのデータ正本、移行、試行・採用からの撤退方法が読み取れるか |
|
|
214
|
+
| 軽減策の実在性 | 軽減策や記録先が根拠資料で確認できる仕組みに基づいているか。未確認の計画書名・台帳名を作っていないか |
|
|
215
|
+
| 人間の判断責任 | 採択案の最終判断者が `PO` など人間の責任ロールになっているか |
|
|
216
|
+
| 再評価可能性 | 見直し条件と記録先が明記されているか |
|
|
217
|
+
|
|
218
|
+
## 8. 仕上げチェック
|
|
219
|
+
|
|
220
|
+
- 「全体の作成手順」で示した章立てと必須表がそろっている。
|
|
221
|
+
- 比較対象案が最低 2 案ある。
|
|
222
|
+
- 各案が単独で目的達成への道筋を説明でき、同じ比較レイヤーにある。
|
|
223
|
+
- 前段文書の候補案を名称変更して再掲するだけでなく、有力な外部案を調査している。
|
|
224
|
+
- 候補カテゴリと選定基準を先に定め、根拠なく製品を代表・標準扱いしていない。
|
|
225
|
+
- 業務運用、解決方式、購入 / 構築、製品、開発方式を必要に応じて分離している。
|
|
226
|
+
- 開発戦略や作業管理を、業務課題と無関係に主比較へ持ち込んでいない。
|
|
227
|
+
- 評価軸と評価基準が案ごとに固定されている。
|
|
228
|
+
- 採択案、非採択案、一部採択案の理由が記載されている。
|
|
229
|
+
- 評価軸が根拠資料の課題 ID や業務価値に対応している。
|
|
230
|
+
- 技術的実現性と後続成果物への影響が比較されている。
|
|
231
|
+
- 比較試行の条件と、製品・サービスのデータ移行・撤退方法が明確である。
|
|
232
|
+
- リスクとトレードオフに軽減策がある。
|
|
233
|
+
- 軽減策・記録先が根拠資料で確認できる仕組みに基づいている。
|
|
234
|
+
- 採択案の最終判断者と再評価条件が明記されている。
|
|
235
|
+
- 各採否を、解くべき課題、評価条件、評価結果、判断理由、再評価記録へ決定 ID から追跡できる。
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:prj-issues-and-approach-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:prj-issues-and-approach-rulebook
|
|
7
|
+
sample: specdojo:prj-issues-and-approach-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# プロジェクト課題と解決アプローチ 作成レシピ
|
|
11
|
+
|
|
12
|
+
Project Issues and Approach Writing Recipe
|
|
13
|
+
|
|
14
|
+
本ドキュメントは、プロジェクト課題と解決アプローチを「関係者が、何が課題で、どれを、どう解く方針かを合意できる内容」に仕上げるための作り方です。
|
|
15
|
+
本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
|
|
16
|
+
|
|
17
|
+
## 1. このレシピの使い方
|
|
18
|
+
|
|
19
|
+
- 最初に、プロジェクト概要・スコープ・前提制約から「何を実現したいか」と「成立条件」を短く抜き出す。
|
|
20
|
+
- 次に、課題一覧、原因、解決策候補、採用アプローチと理由を順に書く。
|
|
21
|
+
- 最後に、トレードオフ/リスクと次の検討事項を置き、未確定のまま判断を進めないようにする。
|
|
22
|
+
- 目指す価値と課題の影響(Why)、優先課題と到達方針(What)、解決策候補・採用アプローチ・軽減策(How)を整理し、課題 ID、案 ID、根拠、採否理由、記録先で追跡する(Trace)。方式設計と実装詳細は後続成果物へ委譲する。
|
|
23
|
+
|
|
24
|
+
## 2. 作成前に集める情報
|
|
25
|
+
|
|
26
|
+
最初から正確に書こうとせず、以下を短いメモで集める。
|
|
27
|
+
|
|
28
|
+
| 項目 | 集める情報 |
|
|
29
|
+
| -------------- | -------------------------------------------------------------- |
|
|
30
|
+
| 背景と必要性 | なぜ取り組むか、放置すると何が悪化するか |
|
|
31
|
+
| 困っている現象 | 利用者や運用で実際に起きている問題(解決策ではなく現象) |
|
|
32
|
+
| 影響 | 課題を放置した場合の損失、リスク、誰がどう困るか |
|
|
33
|
+
| 原因の手がかり | 情報不足、判断基準の不在、手順のばらつき、システム制約など |
|
|
34
|
+
| 解決の選択肢 | 取りうる方針(2 件以上)と、代替・補完の関係 |
|
|
35
|
+
| 判断軸 | 効果、コスト、期間、リスク、再利用性、公開適性など重視する観点 |
|
|
36
|
+
| 前提・制約 | スコープ、前提・制約・依存関係から、守るべき境界と成立条件 |
|
|
37
|
+
| 未確定事項 | 追加調査、確認、承認が必要な事項と、その責任ロール |
|
|
38
|
+
|
|
39
|
+
## 3. 全体の作成手順
|
|
40
|
+
|
|
41
|
+
1. H1 で対象プロジェクト名を明示し、本書の目的(何が課題で、どれを、どう解く方針かを合意する材料)と利用ロール(PO は方針承認、BA は利用者影響整理、ARC は技術的境界識別、PM は作業計画入力など)、合意対象・非合意対象を 1〜2 段落で書く。
|
|
42
|
+
2. 課題一覧で、困っている現象、影響、優先度を書く。
|
|
43
|
+
3. 原因で、事実と仮説を分けて、課題ごとの発生要因を書く。
|
|
44
|
+
4. 解決策候補で、2 件以上の方針を概要、期待できる効果、対応課題、代替・補完の関係とともに並べる。
|
|
45
|
+
5. 採用アプローチと理由で、採用方針、補完策を組み合わせる理由、代替案の採否を判断軸で説明する。
|
|
46
|
+
6. トレードオフ/リスクで、捨てるもの・起きうることと軽減策を書く。
|
|
47
|
+
7. 次の検討事項で、未確定事項と責任ロールを書く。
|
|
48
|
+
8. 見直しと変更管理で、本書を見直す契機・確認観点・対応方針と記録先を書く。
|
|
49
|
+
9. 最後に、設計詳細や曖昧表現を書きすぎていないか確認する。
|
|
50
|
+
|
|
51
|
+
## 4. 各章の書き方
|
|
52
|
+
|
|
53
|
+
### 4.1. 課題一覧
|
|
54
|
+
|
|
55
|
+
問い:
|
|
56
|
+
|
|
57
|
+
- 利用者や運用で、実際に困っている現象は何か。
|
|
58
|
+
- 放置すると、誰が、どの業務価値で、どう困るか。
|
|
59
|
+
- どの課題から先に決めるべきか(優先度)。
|
|
60
|
+
|
|
61
|
+
書き方:
|
|
62
|
+
|
|
63
|
+
- 課題は「困っている現象」で書き、解決策の欠落(例:「自動発注がない」)にしない。
|
|
64
|
+
- 各課題に最低限「影響」と「優先度」を添える。
|
|
65
|
+
- 課題ID(例: P-01)を振り、原因表や決定記録から参照できるようにする。
|
|
66
|
+
|
|
67
|
+
良い例:
|
|
68
|
+
|
|
69
|
+
- 文書の粒度・構成・記述ルールがプロジェクトごとにばらつき、再利用・レビュー・引き継ぎが難しい。
|
|
70
|
+
|
|
71
|
+
悪い例:
|
|
72
|
+
|
|
73
|
+
- 共通テンプレートがない。
|
|
74
|
+
|
|
75
|
+
### 4.2. 原因(仮説でも可)
|
|
76
|
+
|
|
77
|
+
問い:
|
|
78
|
+
|
|
79
|
+
- その課題は、なぜ起きているか。
|
|
80
|
+
- 確認できている事実はどれで、推測はどれか。
|
|
81
|
+
- 根拠となる文書や観察事実は何か。
|
|
82
|
+
|
|
83
|
+
書き方:
|
|
84
|
+
|
|
85
|
+
- 原因区分(事実 / 仮説)を明示し、混ぜない。
|
|
86
|
+
- 課題IDで課題一覧と対応づける。
|
|
87
|
+
- 根拠文書、観察事実、補足を添える。
|
|
88
|
+
|
|
89
|
+
### 4.3. 解決策候補
|
|
90
|
+
|
|
91
|
+
問い:
|
|
92
|
+
|
|
93
|
+
- 課題を解くために取りうる方針は何か。
|
|
94
|
+
- 候補同士は同じ判断を置き換える代替案か、別の課題・原因を扱う補完策か。
|
|
95
|
+
- 各案は、どの業務価値に近づけるか。
|
|
96
|
+
- 案ごとに失うもの・効果は何か。
|
|
97
|
+
|
|
98
|
+
書き方:
|
|
99
|
+
|
|
100
|
+
- 2 件以上の方針を、案ID・関係・概要・期待できる効果・対応課題とともに並べる。
|
|
101
|
+
- 単一案の押し付けにしない。
|
|
102
|
+
- 案IDを振り、採用アプローチや代替案比較から参照できるようにする。
|
|
103
|
+
- 同じ判断を置き換える案の詳細比較は代替案比較へ委譲し、本書では比較が必要な論点を示す。
|
|
104
|
+
|
|
105
|
+
### 4.4. 採用アプローチと理由
|
|
106
|
+
|
|
107
|
+
問い:
|
|
108
|
+
|
|
109
|
+
- どの案を採用し、補完策を組み合わせる場合は各案がどの課題・原因を担うか。
|
|
110
|
+
- 各案を単独で採用した場合に不足することは何か。
|
|
111
|
+
- 採用・非採用の判断軸は何で、今回重視する順序はどうか。
|
|
112
|
+
- 採用しない案は、なぜ採用しないか。
|
|
113
|
+
|
|
114
|
+
書き方:
|
|
115
|
+
|
|
116
|
+
- 採用案を明記し、判断軸で採用理由を説明する。
|
|
117
|
+
- 「採用対象」「判定」「理由」の表にすると、採否と根拠が読み取りやすい。
|
|
118
|
+
- 補完策を組み合わせる場合は、併用する理由を説明する。中核・補助または実行順序がある場合だけ、その関係も示す。
|
|
119
|
+
- 判断軸の優先順位を 1 文で示す。
|
|
120
|
+
|
|
121
|
+
### 4.5. トレードオフ/リスク
|
|
122
|
+
|
|
123
|
+
問い:
|
|
124
|
+
|
|
125
|
+
- 採用の代償として、何を捨てる・先送りする・我慢するか。
|
|
126
|
+
- 起きうる失敗・遅延・品質低下は何か。
|
|
127
|
+
- それぞれの軽減策は何か。
|
|
128
|
+
|
|
129
|
+
書き方:
|
|
130
|
+
|
|
131
|
+
- 区分(`トレードオフ` / `リスク`)で揃え、課題ログやリスク登録簿へ転記しやすい粒度にする。区切りの `/` の前後にはスペースを置かない。
|
|
132
|
+
- リスクは「起きうること」と「軽減策」をセットで書く。
|
|
133
|
+
|
|
134
|
+
### 4.6. 次の検討事項(ToDo)
|
|
135
|
+
|
|
136
|
+
問い:
|
|
137
|
+
|
|
138
|
+
- 次の意思決定に必要な追加調査・確認・承認は何か。
|
|
139
|
+
- それぞれの責任ロールは誰か。
|
|
140
|
+
|
|
141
|
+
書き方:
|
|
142
|
+
|
|
143
|
+
- 「ToDo」「目的」「責任ロール」の表にする。
|
|
144
|
+
- ToDo の項目は、未確定事項を示す場合は _TODO_: または _UNDECIDED_ ラベルを先頭に付け、後続で検索・フィルタできるようにする(例: _TODO_: 公開先にGitHub を採用するか決定する)。
|
|
145
|
+
- 責任ロールは、体制定義で採用済みのロールまたは担当単位で書く。
|
|
146
|
+
|
|
147
|
+
### 4.7. 見直しと変更管理
|
|
148
|
+
|
|
149
|
+
問い:
|
|
150
|
+
|
|
151
|
+
- 本書の合意は、どんな変化で見直す必要があるか。
|
|
152
|
+
- 見直したとき、何を確認し、どう対応するか。
|
|
153
|
+
- 見直し結果は、どこに記録するか。
|
|
154
|
+
|
|
155
|
+
書き方:
|
|
156
|
+
|
|
157
|
+
- 見直しの契機(仮説の反証、スコープ・前提制約の変更、採用アプローチに影響する決定、リスクの顕在化など)を挙げる。
|
|
158
|
+
- 契機ごとに、確認する観点と対応方針をセットで書く。
|
|
159
|
+
- 記録先(プロジェクト登録簿、決定記録など)と、監視・取りまとめ・最終判断のロールを示す。
|
|
160
|
+
|
|
161
|
+
## 5. 深掘り手順
|
|
162
|
+
|
|
163
|
+
内容が浅いと感じる場合は、次の順で深掘りする。
|
|
164
|
+
|
|
165
|
+
1. **困っている現象** を、解決策抜きで言い換える。
|
|
166
|
+
2. **影響** を、誰がどの業務価値で困るかで具体化する。
|
|
167
|
+
3. **原因** を、事実と仮説に分けて分解する。
|
|
168
|
+
4. **解決策候補** を 2 件以上に広げ、代替・補完の関係と対応課題を整理する。
|
|
169
|
+
5. **判断軸の優先順位** を決める。
|
|
170
|
+
6. **採用・非採用の理由** を判断軸で説明する。
|
|
171
|
+
7. **未確定事項と責任ロール** を残す。
|
|
172
|
+
|
|
173
|
+
## 6. 良い例 / 悪い例
|
|
174
|
+
|
|
175
|
+
| 観点 | 良い例 | 悪い例 |
|
|
176
|
+
| ---------- | ----------------------------------------------------------------- | ------------------------ |
|
|
177
|
+
| 課題 | 記録ルールがばらつき、引き継ぎ時に確認に時間がかかる | テンプレートがない |
|
|
178
|
+
| 原因 | 事実: 担当ごとに記述様式が異なる / 仮説: 共通様式が浸透していない | なんとなく属人化している |
|
|
179
|
+
| 解決策候補 | A 案と B 案は同じ課題への代替、C 案は別原因への補完と整理する | とにかく標準化する |
|
|
180
|
+
| 採用理由 | A 案と C 案が異なる原因を扱い、単独では不足するため併用する | A 案がよさそうだから採用 |
|
|
181
|
+
| リスク | 実践の型の整合が崩れる → 品質管理とレビューで確認する | 特に問題はない |
|
|
182
|
+
|
|
183
|
+
## 7. レビュー観点
|
|
184
|
+
|
|
185
|
+
作成後は、次の観点で確認する。
|
|
186
|
+
|
|
187
|
+
| 観点 | 確認内容 |
|
|
188
|
+
| -------------------- | ------------------------------------------------------------------ |
|
|
189
|
+
| 業務価値との対応 | 課題と解決アプローチが、業務目的・利用者・期待効果と対応しているか |
|
|
190
|
+
| 課題の妥当性 | 課題が困っている現象で書かれ、解決策の先取りになっていないか |
|
|
191
|
+
| 事実と仮説の区別 | 原因で事実と仮説が混ざっていないか |
|
|
192
|
+
| 候補の関係 | 方針が 2 件以上あり、代替・補完の関係と対応課題が明確か |
|
|
193
|
+
| 採用理由の説明可能性 | 採用・非採用が判断軸で説明され、後から再現できるか |
|
|
194
|
+
| 関係者・利用場面 | 関係者、利用場面、確認者、合意対象が読み取れるか |
|
|
195
|
+
| 責務分担 | 設計詳細・実装詳細・テスト設計を書きすぎていないか |
|
|
196
|
+
| 未確定の明示 | 未確定事項が _TODO_ / _UNDECIDED_ 等で明示されているか |
|
|
197
|
+
|
|
198
|
+
## 8. 仕上げチェック
|
|
199
|
+
|
|
200
|
+
- 「全体の作成手順」で示した章立てと必須表がそろっている。
|
|
201
|
+
- 課題一覧、原因、解決策候補、採用アプローチと理由がすべて記述されている。
|
|
202
|
+
- 解決策候補が 2 件以上あり、代替・補完の関係と対応課題がある。
|
|
203
|
+
- 採用アプローチに判断軸と採用理由がある。
|
|
204
|
+
- 各採用アプローチを、目指す価値、課題・原因、候補案、採否理由、見直し記録へ ID で追跡できる。
|
|
205
|
+
- 曖昧表現や設計詳細を書きすぎていない。
|