specdojo 0.1.0 → 0.2.1
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 +142 -35
- 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 +990 -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 +54 -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 +33 -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 +56 -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 +472 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -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 +121 -24
- package/templates/antigravity/README.md +35 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
- package/templates/antigravity/orchestrator.md +146 -0
- package/templates/antigravity/pm-members-snippet.yaml +55 -0
- 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/agents/specdojo-orchestrator.md +153 -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/codex/agents/specdojo-orchestrator.toml +154 -0
- package/templates/codex/orchestrator.md +146 -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/templates/opencode/agents/specdojo-orchestrator.md +193 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,428 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:review-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# レビューガイド
|
|
9
|
+
|
|
10
|
+
Review Guide
|
|
11
|
+
|
|
12
|
+
本ドキュメントは SpecDojo における成果物レビューの進め方を定義します。
|
|
13
|
+
|
|
14
|
+
レビューは「問題なし」を宣言する作業ではありません。どの観点を確認し、どの根拠を見て、何を未確認として残したかを記録する作業です。
|
|
15
|
+
|
|
16
|
+
**対象読者**
|
|
17
|
+
|
|
18
|
+
- SpecDojo の成果物をレビューする担当者、review plan を実行するエージェント、品質管理者
|
|
19
|
+
|
|
20
|
+
**この文書で分かること**
|
|
21
|
+
|
|
22
|
+
- レビューの入力と確認経路、coverage type、review plan・result、finding の分類、成果物を ready にする条件
|
|
23
|
+
|
|
24
|
+
**次に読む文書**
|
|
25
|
+
|
|
26
|
+
- レビュー時の実践の型の使い方は [実践の進め方ガイド](ryu-guide.md)、plan・result の共通ライフサイクルは [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照してください。
|
|
27
|
+
|
|
28
|
+
最初にレビューを実行する場合は、`レビューの位置づけ`、`レビューの観点とパス`、`review plan と review result`、`完了と確定` を読めば実施できます。finding の転記判断は `レビュー結果の記録`、手動でagentへ依頼する場合の文面は `Agent への指示テンプレート` を参照してください。
|
|
29
|
+
|
|
30
|
+
## 1. レビューの位置づけ
|
|
31
|
+
|
|
32
|
+
レビューが何を確認する活動か、何を入力とするか、機械検証とどう分担するかを示します。
|
|
33
|
+
|
|
34
|
+
### 1.1. レビューの役割
|
|
35
|
+
|
|
36
|
+
SpecDojo のレビューは次を扱います。
|
|
37
|
+
|
|
38
|
+
| 項目 | 内容 |
|
|
39
|
+
| ---------- | ------------------------------------------------------------------ |
|
|
40
|
+
| 完全性 | 要求、要件、仕様、設計、運用に抜けがないか |
|
|
41
|
+
| 整合性 | 成果物間で目的、用語、状態、責務、制約が矛盾していないか |
|
|
42
|
+
| 妥当性 | 上位目的、業務価値、制約、判断方針に合っているか |
|
|
43
|
+
| 検証可能性 | pass / fail を判断できる完了条件、受入条件、証跡があるか |
|
|
44
|
+
| 追跡可能性 | 上位目的から要求、要件、仕様、設計、テスト、運用まで対応を追えるか |
|
|
45
|
+
|
|
46
|
+
レビューの合格条件は、対象プロジェクトの成果物カタログに定義された `done_criteria` を正とします。
|
|
47
|
+
|
|
48
|
+
### 1.2. レビューの入力
|
|
49
|
+
|
|
50
|
+
レビューでは次を入力として扱います。
|
|
51
|
+
|
|
52
|
+
| 入力 | 正本ファイル | 役割 |
|
|
53
|
+
| ----------------- | -------------------------------------- | ---------------------------------------------------------------------------------- |
|
|
54
|
+
| 対象成果物 | - | レビュー対象の Markdown / YAML / JSON など |
|
|
55
|
+
| 成果物カタログ | `dct-*.yaml` | 成果物、依存関係、`done_criteria`(text / roles / viewpoint)を定義する |
|
|
56
|
+
| rulebook | `*-rulebook.md` | 成果物ごとの構造、必須章、必須キー、禁止事項を定義する |
|
|
57
|
+
| sample | `*-sample.*` | 期待する成果物の具体例 |
|
|
58
|
+
| review viewpoints | 共通正本 + `pm-review-viewpoints.yaml` | Role code 別の観点、severity、verdict、coverage_types とプロジェクト差分を定義する |
|
|
59
|
+
| 関連成果物 | - | 上位・下位・隣接成果物、Schedule、RACI、PJR |
|
|
60
|
+
| 機械検証結果 | - | lint、schema validation、生成確認、リンク確認 |
|
|
61
|
+
| 登録簿 | `generated/pjr-index.md` | 未解決事項、課題、リスク、変更要求、決定の転記先 |
|
|
62
|
+
|
|
63
|
+
### 1.3. 機械検証とレビューの分担
|
|
64
|
+
|
|
65
|
+
機械で確認できることは、レビュー判断の前に検証します。
|
|
66
|
+
|
|
67
|
+
| 確認対象 | 主な方法 |
|
|
68
|
+
| ---------------------- | ---------------------- |
|
|
69
|
+
| YAML / JSON の必須キー | JSON Schema |
|
|
70
|
+
| 型、enum、ID形式 | JSON Schema |
|
|
71
|
+
| Markdown の基本構造 | lint、custom validator |
|
|
72
|
+
| リンク、参照先 | custom validator |
|
|
73
|
+
| IDの一意性 | custom validator |
|
|
74
|
+
| 生成物の同期 | generate command、diff |
|
|
75
|
+
| 意味の妥当性 | agent / human review |
|
|
76
|
+
| 判断責任 | human approver |
|
|
77
|
+
|
|
78
|
+
機械検証で失敗した成果物は、意味レビューの前に修正します。ただし、検証不能な前提や設計判断は review result に残して構いません。
|
|
79
|
+
|
|
80
|
+
### 1.2.1. 共通観点とプロジェクト差分
|
|
81
|
+
|
|
82
|
+
レビュー観点の共通正本は [[specdojo:pm-review-viewpoints|共通レビュー観点一覧]] です。プロジェクトの `viewpoints_path` は共通正本の全量コピーではなく、次の差分だけを保持します。
|
|
83
|
+
|
|
84
|
+
- `extends: specdojo:pm-review-viewpoints` で共通正本を1段だけ継承する。
|
|
85
|
+
- `categories`、`coverage_types`、`severity_levels`、`verdict_definitions`、`viewpoints` は `id`、`role_viewpoint_sets` は `role` が同じ項目を全体上書きし、新しいキーを追加する。
|
|
86
|
+
- `disabled` は共通項目または追加項目を解決結果から除外する。同じキーの upsert と無効化は同時に宣言できない。
|
|
87
|
+
- 解決順序は「共通正本 → プロジェクト upsert → `disabled`」で固定する。多段継承は行わない。
|
|
88
|
+
|
|
89
|
+
標準ロールは PO、PM、BA、ARC、DEV、QE、UX、OPS です。独自ロールを使うプロジェクトは、その Role code を `pm-roles.yaml` に定義したうえで、同じ role の `viewpoints` と `role_viewpoint_sets` をプロジェクト差分へ追加します。既存の全量形式は互換入力として読み込めますが、`exec scaffold` が新規生成するのは差分形式です。
|
|
90
|
+
|
|
91
|
+
## 2. レビューの観点とパス
|
|
92
|
+
|
|
93
|
+
どの方向から成果物をたどり、何の型を確認したかをどう記録するかを扱います。
|
|
94
|
+
|
|
95
|
+
### 2.1. レビューの基本パス
|
|
96
|
+
|
|
97
|
+
レビューは 3 つのパスで行います。
|
|
98
|
+
|
|
99
|
+
#### 2.1.1. 上位から下位へ
|
|
100
|
+
|
|
101
|
+
上位成果物の目的、要求、制約が下位成果物に展開されているかを確認します。
|
|
102
|
+
|
|
103
|
+
主に検出するもの
|
|
104
|
+
|
|
105
|
+
- 上位要求に対応する要件や仕様がない
|
|
106
|
+
- 重要な制約が設計や運用に反映されていない
|
|
107
|
+
- 非機能、例外、運用、監査の観点が下位成果物で消えている
|
|
108
|
+
|
|
109
|
+
#### 2.1.2. 下位から上位へ
|
|
110
|
+
|
|
111
|
+
下位成果物の記述に、上位根拠のない機能、仕様、設計判断が混ざっていないかを確認します。
|
|
112
|
+
|
|
113
|
+
主に検出するもの
|
|
114
|
+
|
|
115
|
+
- 根拠のない仕様追加
|
|
116
|
+
- スコープ外の設計判断
|
|
117
|
+
- agent の推測による機能追加
|
|
118
|
+
- 成果物間で説明されていない制約や例外
|
|
119
|
+
|
|
120
|
+
#### 2.1.3. 横断観点
|
|
121
|
+
|
|
122
|
+
成果物の種類にかかわらず、抜けやすい観点を横断して確認します。
|
|
123
|
+
|
|
124
|
+
主に確認するもの
|
|
125
|
+
|
|
126
|
+
- ステークホルダー
|
|
127
|
+
- 利用シーン
|
|
128
|
+
- 業務イベント
|
|
129
|
+
- 例外・異常系
|
|
130
|
+
- 権限・責務
|
|
131
|
+
- 状態遷移
|
|
132
|
+
- 入出力・データ
|
|
133
|
+
- 外部連携
|
|
134
|
+
- 非機能要求
|
|
135
|
+
- 運用・保守
|
|
136
|
+
- 監査・証跡
|
|
137
|
+
- 受入条件
|
|
138
|
+
- トレーサビリティ
|
|
139
|
+
|
|
140
|
+
### 2.2. coverage_types の使い方
|
|
141
|
+
|
|
142
|
+
`coverage_types` は、レビュー時に「何の型を確認したか」を記録するための語彙です。
|
|
143
|
+
|
|
144
|
+
`coverage_types` は観点そのものではなく、レビュー探索の軸です。たとえば `vp-qe-omissions-consistency` を使う場合でも、実際には `stakeholder`、`exception_case`、`non_functional`、`traceability` など、どの型を確認したかを分けて記録します。
|
|
145
|
+
|
|
146
|
+
review result では、`レビュー観点別結果` セクションの各 `RVP-NNN` に対して、確認した coverage_types と根拠を記述します。
|
|
147
|
+
|
|
148
|
+
例
|
|
149
|
+
|
|
150
|
+
```text
|
|
151
|
+
### RVP-003
|
|
152
|
+
|
|
153
|
+
- result: fail
|
|
154
|
+
- evidence: dct-project-definition.yaml の done_criteria / prj-scope.md / prj-success-criteria-and-acceptance-criteria.md
|
|
155
|
+
- notes: 例外ケースと非機能要求の展開に不足がある(確認できたのは stakeholder, use_case, exception_case, non_functional。traceability は未確認)。
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
確認できなかった coverage_types は、上記のように `notes` に範囲と理由を明記します。重大な抜けは `findings` に指摘として残します。
|
|
159
|
+
|
|
160
|
+
### 2.3. 要求・要件・仕様レビュー
|
|
161
|
+
|
|
162
|
+
要求、要件、仕様のヌケモレや間違いは、成果物単体だけでは検出しにくいものです。必ず隣接成果物との対応を確認します。各概念(要求 / 要件 / 仕様 / 設計 / 実装)の定義と、Why → What → How のトレース欠落・粒度混在などの典型的な失敗は [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) を正本とし、レビュー観点の土台にします。
|
|
163
|
+
|
|
164
|
+
| 対象 | 主な確認 |
|
|
165
|
+
| ---- | -------------------------------------------------------------------------------- |
|
|
166
|
+
| 要求 | 業務目的、利用者、業務イベント、制約、成功条件、非機能、運用要求が抜けていないか |
|
|
167
|
+
| 要件 | 要求から機能・非機能・権限・データ・受入条件へ展開されているか |
|
|
168
|
+
| 仕様 | 要件に対する画面、API、状態、業務ルール、例外、データ、検証条件が明確か |
|
|
169
|
+
| 設計 | 仕様を実現する構造、制約、責務、データ、外部依存、運用方法が明確か |
|
|
170
|
+
| 運用 | 公開後の変更、問い合わせ、障害対応、監査、保守の扱いが明確か |
|
|
171
|
+
|
|
172
|
+
### 2.1. grade と共有する評価属性・rubric
|
|
173
|
+
|
|
174
|
+
viewpoint は review 専用ではなく、継続品質評価 `specdojo grade` と共有する正本です。各 viewpoint の `evaluation` は判定層(`deterministic` / `agent` / `human`)、`continuous` は grade 対象かを宣言します。`grade_targets` を省略した観点は kata と成果物の両方、指定した観点は列挙対象だけに適用します。grade 専用の別観点 ID は作りません。
|
|
175
|
+
|
|
176
|
+
`grade_rubric` の level 0-4 は category を跨いで共有し、viewpoint score を `level × 25` とします。review との対応は level 4 が `pass`、level 3 が `conditional_pass`、level 0-2 が `changes_requested` です。`blocked` は前提不足で判定できない状態なので level へ写像しません。
|
|
177
|
+
|
|
178
|
+
grade は継続監視の最新スナップショット、review result は完成時の合意形成履歴です。Kata の grade は schedule strategy の approach 導出に使われますが、目的・業務価値など `evaluation: human` の観点や最終承認を代替しません。
|
|
179
|
+
|
|
180
|
+
#### 成果物 grade と review result の責務境界
|
|
181
|
+
|
|
182
|
+
成果物の現在品質と変更後の再評価は `grade --target deliverable` を正とします。成果物カタログの `done_criteria` は grade plan に取り込まれ、score とは独立して条件ごとの充足を判定します。充足数・総数・未充足条件の担当 Role code・詳細参照は grade result サイドカーに置き、条件文と不足理由は成果物ごとの grade 詳細ファイルに記録します。
|
|
183
|
+
|
|
184
|
+
評価が現在内容に対するものかは、保存された `content_hash` と現在の成果物ファイル全体のハッシュが一致するかで判断します。不一致の grade と、実行後に成果物が変更された review result は、どちらも現在品質の根拠には使いません。`grade list --target deliverable --changed-only` と定期 routine は、この不一致を再評価対象として検出します。
|
|
185
|
+
|
|
186
|
+
review result は特定時点に誰が何を確認し、どの合意を行ったかを残す不変の履歴です。既存 review result は削除・移行せず、最新状態の判定には利用しません。090 の review タスクと `G-*-review-pass` は人の合意形成・最終承認のゲートとして維持し、継続品質の再評価は grade が担います。これにより二つの結果を同じ最新状態として同期させる必要をなくします。
|
|
187
|
+
|
|
188
|
+
`vp-arc-single-responsibility` は、異なる主題を一つの文書へ同居させている状態を検出します。章を独立して参照・更新できるか、対象読者と利用時点が異なるか、別々の sample・recipe・template に対応するかを組み合わせて判断します。長さや対応する実践の型の数だけでは fail にせず、複数主題の案内自体を責務とする index、catalog、overview は対象外です。同じ主張の反復や正本の過剰な再掲は `vp-arc-conciseness` で扱います。
|
|
189
|
+
|
|
190
|
+
分割が必要な場合、finding には独立する主題と境界候補、参照・カタログへの影響を記録します。grade はファイル作成や ID 採番を行わず、人が finding を確認して分割の採否と PJR 起票を判断します。起票後は新規ファイル、成果物カタログ、参照元、対応する sample・recipe・template の変更を通常の edit task として扱います。
|
|
191
|
+
|
|
192
|
+
## 3. review plan と review result
|
|
193
|
+
|
|
194
|
+
SpecDojo のレビューは、原則として review plan を作ってから実施し、review result を残します。
|
|
195
|
+
|
|
196
|
+
review plan は `specdojo exec plan` または `specdojo exec run` が必要時に生成します。review result は `specdojo exec claim` 時に scaffold され(`specdojo exec run` が claim を兼ねる場合も含む)、`specdojo exec run` または人の作業によって Frontmatter + Markdown 形式で更新します。
|
|
197
|
+
|
|
198
|
+
```text
|
|
199
|
+
共通レビュー観点 + プロジェクト差分(pm-review-viewpoints.yaml)
|
|
200
|
+
↓ 解決
|
|
201
|
+
dct-*.yaml
|
|
202
|
+
↓
|
|
203
|
+
rulebook
|
|
204
|
+
↓
|
|
205
|
+
exec plan / exec run → review plan(exec/plans/<task-id>-plan.md)
|
|
206
|
+
↓
|
|
207
|
+
human / agent review(exec run)
|
|
208
|
+
↓
|
|
209
|
+
review result(exec/results/<task-id>-result.md)
|
|
210
|
+
↓
|
|
211
|
+
PJR / 修正 / 再レビュー
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
review plan は「今回のレビューで何を見るか」を固定します。review result は「実際に何を見て、何が分かり、何を未確認として残したか」を記録します。
|
|
215
|
+
|
|
216
|
+
| 成果物 | 役割 |
|
|
217
|
+
| ------------- | ------------------------------------------------------------------------------------- |
|
|
218
|
+
| review plan | 対象成果物、Role code、viewpoint、coverage_required、エビデンス例、完了手順を定義する |
|
|
219
|
+
| review result | レビュー観点ごとの判定(pass / fail / unclear)、根拠、findings、decision を記録する |
|
|
220
|
+
|
|
221
|
+
review result を直接作らず、review plan を挟むことで、レビュー範囲の揺れ、観点の抜け、未実施レビューを検出しやすくします。
|
|
222
|
+
|
|
223
|
+
### 3.1. edit plan の完了の狙い
|
|
224
|
+
|
|
225
|
+
通常の成果物編集を行う edit plan は、観点別の自己レビューを行いません。代わりに、`done_criteria` を「完了の狙い」として素の箇条書き(観点・coverage なし)で提示し、編集者は rulebook / recipe / sample / template と「進め方」に沿って記述する中で、その狙いを満たすことを目指します。
|
|
226
|
+
|
|
227
|
+
- 品質の担保は rulebook(必須項目・禁止事項)・recipe(書き方・レビュー観点・仕上げチェック)・sample・template が担います。
|
|
228
|
+
- `done_criteria` を満たしているかの継続的な一次判定は成果物 grade、完成時の多観点確認と最終合意は後続の独立した review plan / review result が行います。
|
|
229
|
+
- maintenance 系 approach は対象と判定基準が異なるため、完了の狙いの提示は行いません。
|
|
230
|
+
|
|
231
|
+
edit plan で観点別の自己レビューを行わないのは、各観点を満たそうとして成果物へ過剰な記述を挿入する副作用を避けるためです。多観点での判定と証跡は review task に集約し、review task では成果物を修正せず第三者的な立場で残します。
|
|
232
|
+
|
|
233
|
+
### 3.2. review plan の生成
|
|
234
|
+
|
|
235
|
+
review plan は `specdojo exec plan` または `specdojo exec run` によって機械生成します(`mode: review` のタスクが対象)。`exec refresh` は Ready などの実行状態を更新しますが、plan は生成しません。
|
|
236
|
+
|
|
237
|
+
主な入力
|
|
238
|
+
|
|
239
|
+
- 成果物カタログの `local_id`、`path`、`depends_on`、`done_criteria`
|
|
240
|
+
- 共通正本と `pm-review-viewpoints.yaml` の差分を解決した `viewpoints`、`coverage_types`
|
|
241
|
+
- 対応する rulebook
|
|
242
|
+
- `sch-strategy-<track>.yaml` が宣言する `mode: review` フェーズ
|
|
243
|
+
|
|
244
|
+
review plan は、成果物カタログの `done_criteria[].roles` と `done_criteria[].viewpoint` から `レビュー観点` セクションの review item(`RVP-NNN`)を作ります。
|
|
245
|
+
|
|
246
|
+
### 3.3. review plan の配置
|
|
247
|
+
|
|
248
|
+
review plan は `<execution_path>/exec/plans/<task-id>-plan.md` に生成します。`<execution_path>` はプロジェクトの実行ディレクトリ(例: `execution`)を指します。
|
|
249
|
+
|
|
250
|
+
例
|
|
251
|
+
|
|
252
|
+
```text
|
|
253
|
+
exec/plans/T-LAUNCH-prj-overview-030-plan.md
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
### 3.4. review plan の構成
|
|
257
|
+
|
|
258
|
+
review plan は Frontmatter と本文セクションで構成します。
|
|
259
|
+
|
|
260
|
+
```yaml
|
|
261
|
+
specdojo:
|
|
262
|
+
id: <project-id>:xrp-<task-id>
|
|
263
|
+
type: exec-plan
|
|
264
|
+
rulebook: none
|
|
265
|
+
task_id: <task-id>
|
|
266
|
+
name: <フェーズ名>
|
|
267
|
+
mode: review
|
|
268
|
+
status: ready
|
|
269
|
+
project_id: <project_id>
|
|
270
|
+
owner: <Role code>
|
|
271
|
+
on_critical_path: true | false
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
| セクション | 内容 |
|
|
275
|
+
| ---------------------- | ------------------------------------------------------------------------------------------------- |
|
|
276
|
+
| このフェーズで行うこと | 担当ロールが何を判断するか(承認・修正指示・差し戻し) |
|
|
277
|
+
| 対象成果物 | 対象パス、rulebook、対応する review result のパス |
|
|
278
|
+
| レビュー観点 | `RVP-NNN` 単位の Role code、viewpoint_id、確認基準、coverage_required、チェック観点、エビデンス例 |
|
|
279
|
+
| 完了手順 | レビュー観点ごとの判定方法と review result への記入手順 |
|
|
280
|
+
| 異常終了の条件 | done_criteria を満たさない場合などに block を記録する条件 |
|
|
281
|
+
|
|
282
|
+
### 3.5. review execution
|
|
283
|
+
|
|
284
|
+
人または agent は review plan に従ってレビューします。`<execution_path>/exec/results/<task-id>-result.md` は `specdojo exec claim` の時点で scaffold される(手動 claim でも `exec run` 経由の claim でも同様)ため、agent または人はそこに結果を記入します。
|
|
285
|
+
|
|
286
|
+
レビューでどこまで rulebook / recipe / sample / template に照らすかは、タスクに付与された `approach` に従います。詳細は [実践の進め方ガイド](ryu-guide.md) を参照してください。
|
|
287
|
+
|
|
288
|
+
実行時の原則
|
|
289
|
+
|
|
290
|
+
- `レビュー観点` の各項目(`RVP-NNN`)を勝手に省略しません。
|
|
291
|
+
- plan にない観点で重大な問題を見つけた場合は、`findings` に追加します。
|
|
292
|
+
- 確認できない範囲は pass にせず、`unclear` として根拠とともに残します。
|
|
293
|
+
- 機械検証の失敗は、意味レビューの結果と分けて記録します。
|
|
294
|
+
- agent は最終承認、公開可否判断、説明責任を担いません。
|
|
295
|
+
|
|
296
|
+
### 3.6. review result の構成
|
|
297
|
+
|
|
298
|
+
review result は `<execution_path>/exec/results/<task-id>-result.md` に生成・更新します。
|
|
299
|
+
|
|
300
|
+
```yaml
|
|
301
|
+
specdojo:
|
|
302
|
+
id: <project-id>:xrr-<task-id>
|
|
303
|
+
type: exec-result
|
|
304
|
+
task_id: <task-id>
|
|
305
|
+
mode: review
|
|
306
|
+
status: in_progress | complete | blocked
|
|
307
|
+
project_id: <project_id>
|
|
308
|
+
plan_ref: exec/plans/<task-id>-plan.md
|
|
309
|
+
started_at: <ISO8601>
|
|
310
|
+
completed_at: <ISO8601>
|
|
311
|
+
agent: <member nickname>
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
| セクション | 内容 |
|
|
315
|
+
| ------------------ | ----------------------------------------------------------------------- |
|
|
316
|
+
| レビュー観点別結果 | `RVP-NNN` ごとの `result`(pass / fail / unclear)、`evidence`、`notes` |
|
|
317
|
+
| findings | 指摘事項(severity、対象箇所、概要、修正方針を含めて記述する) |
|
|
318
|
+
| decision | `recommendation`(approve / revise / reject)と承認要否 |
|
|
319
|
+
|
|
320
|
+
## 4. レビュー結果の記録
|
|
321
|
+
|
|
322
|
+
review result に何をどう残し、findings をどう分類し、どこへ引き継ぐかを扱います。
|
|
323
|
+
|
|
324
|
+
### 4.1. レビュー結果の残し方
|
|
325
|
+
|
|
326
|
+
レビュー結果は、成果物単位、フェーズ単位、Role code 単位で記録します。review result は必ず review plan に対応させ、Frontmatter の `plan_ref` で参照します。
|
|
327
|
+
|
|
328
|
+
`レビュー観点別結果` セクションには、`RVP-NNN` ごとに次を記入します。
|
|
329
|
+
|
|
330
|
+
| 項目 | 内容 |
|
|
331
|
+
| -------- | ------------------------------------------------------------------------ |
|
|
332
|
+
| result | `pass` / `fail` / `unclear` |
|
|
333
|
+
| evidence | 確認した根拠(参照箇所、具体的な記述) |
|
|
334
|
+
| notes | 判定根拠の補足、coverage_required のうち確認できた範囲とできなかった範囲 |
|
|
335
|
+
|
|
336
|
+
`findings` セクションには、確認した中で見つかった指摘事項を次の観点で記述します。
|
|
337
|
+
|
|
338
|
+
| 項目 | 内容 |
|
|
339
|
+
| -------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
|
340
|
+
| severity | `blocker` / `major` / `minor` / `note` |
|
|
341
|
+
| category | `purpose` / `planning` / `business` / `architecture` / `implementation` / `quality` / `usability` / `operations` / `consistency` |
|
|
342
|
+
| location | 見出し、行、キー、またはファイル全体 |
|
|
343
|
+
| summary | 指摘概要 |
|
|
344
|
+
| recommendation | 修正方針 |
|
|
345
|
+
|
|
346
|
+
`decision` セクションには、レビュー全体としての判断(`approve` / `revise` / `reject`)と、PO 判断が必要かどうかを記述します。
|
|
347
|
+
|
|
348
|
+
### 4.2. finding の分類
|
|
349
|
+
|
|
350
|
+
| 種別 | 内容 |
|
|
351
|
+
| ---------------- | ------------------------------------------------ |
|
|
352
|
+
| missing | 必要な要求、要件、仕様、章、キー、参照がない |
|
|
353
|
+
| inconsistency | 成果物間で矛盾している |
|
|
354
|
+
| unsupported | 上位根拠のない記述がある |
|
|
355
|
+
| ambiguous | 判断、実装、検証に必要な具体性が不足している |
|
|
356
|
+
| unverifiable | pass / fail を判断できない |
|
|
357
|
+
| risk | 後続作業、公開、運用で問題になる可能性がある |
|
|
358
|
+
| policy_violation | 禁止事項、承認責任、agent 委任境界に違反している |
|
|
359
|
+
|
|
360
|
+
### 4.3. PJR への転記
|
|
361
|
+
|
|
362
|
+
すべてのレビュー指摘を PJR に転記しません。review result には詳細を残し、プロジェクト管理対象だけを PJR に転記します。
|
|
363
|
+
|
|
364
|
+
PJR に転記する条件
|
|
365
|
+
|
|
366
|
+
- PO 判断が必要です。
|
|
367
|
+
- 後続成果物、Schedule、公開判断に影響します。
|
|
368
|
+
- スコープ、責任分担、成果物追加に影響します。
|
|
369
|
+
- 重大な矛盾によりレビュー継続ができません。
|
|
370
|
+
- 将来リスクとして監視する必要があります。
|
|
371
|
+
|
|
372
|
+
## 5. Agent への指示テンプレート
|
|
373
|
+
|
|
374
|
+
### 5.1. 単体レビュー
|
|
375
|
+
|
|
376
|
+
```text
|
|
377
|
+
review plan に従って対象成果物をレビューしてください。
|
|
378
|
+
各 RVP-NNN について result(pass / fail / unclear)を判定し、viewpoint_id、確認した coverage_types、evidence、notes を記入し、指摘は findings、全体判断は decision(recommendation: approve / revise / reject)に記録してください。
|
|
379
|
+
```
|
|
380
|
+
|
|
381
|
+
### 5.2. トレーサビリティレビュー
|
|
382
|
+
|
|
383
|
+
```text
|
|
384
|
+
対象成果物を単体でレビューせず、上位成果物と下位成果物の対応を確認してください。
|
|
385
|
+
上位から下位への未展開、下位から上位への根拠なし、横断観点の抜けを findings として整理してください。
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
### 5.3. 差分レビュー
|
|
389
|
+
|
|
390
|
+
```text
|
|
391
|
+
前回レビュー結果と現在の成果物を比較してください。
|
|
392
|
+
解消済み、未解消、新規発生、再発を分類し、再レビューが必要な viewpoint_id を明示してください。
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
### 5.4. 再レビュー
|
|
396
|
+
|
|
397
|
+
```text
|
|
398
|
+
前回 findings の対応結果だけでなく、修正により新しい矛盾や抜けが発生していないかを確認してください。
|
|
399
|
+
変更箇所、関連成果物、coverage_types を根拠付きで記録してください。
|
|
400
|
+
```
|
|
401
|
+
|
|
402
|
+
## 6. 完了と確定
|
|
403
|
+
|
|
404
|
+
レビューを完了と見なす条件と、成果物を `ready` へ昇格させる条件を扱います。
|
|
405
|
+
|
|
406
|
+
### 6.1. 完了条件
|
|
407
|
+
|
|
408
|
+
レビューを完了とするには、次を満たします。
|
|
409
|
+
|
|
410
|
+
- review result が review plan の全 `RVP-NNN` に対応しています。
|
|
411
|
+
- 対象成果物の `done_criteria` に対応する観点を確認しています。
|
|
412
|
+
- 確認した `viewpoint_id` と `coverage_types` が記録されています。
|
|
413
|
+
- pass / fail の根拠となる `evidence` が記録されています。
|
|
414
|
+
- 未確認範囲がある場合は `notes` に残しています。
|
|
415
|
+
- `blocker` と `major` の未解決指摘が扱われています。
|
|
416
|
+
- PO 判断が必要な事項は PJR または decision に接続されています。
|
|
417
|
+
- agent が最終承認者になっていません。
|
|
418
|
+
|
|
419
|
+
### 6.2. 成果物 ready 化条件
|
|
420
|
+
|
|
421
|
+
成果物を完成版または `ready` 候補にするには、次をすべて満たすことが必要です。
|
|
422
|
+
|
|
423
|
+
- 対象成果物の `done_criteria` に対応する全 Role code のレビューが完了しています。
|
|
424
|
+
- `blocker` と `major` の未解決指摘が 0 件です。
|
|
425
|
+
- 条件付き合格とした指摘が PO により許容または対応済みと判断されています。
|
|
426
|
+
- 関連する PJR がある場合、対応方針、担当 Role code、期限が記録されています。
|
|
427
|
+
- `npm run -s lint:md`、必要な YAML schema 検証、生成物再作成など、対象成果物に必要な機械検証が完了しています。
|
|
428
|
+
- 最終承認、公開可否判断、説明責任を人間の `PO` が担っています。
|