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,70 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
35
|
+
|
|
36
|
+
## 4. 進め方
|
|
37
|
+
|
|
38
|
+
rulebook / recipe / sample / template に原則縛られず、対象領域の類似成果物の実例とプロジェクト文脈との整合を優先して確認する。レビューでは成果物を組み立てるのではなく、成果物が基準を満たすかを照合する。次の基準で確認する。
|
|
39
|
+
|
|
40
|
+
1. レビュー観点(`RVP-NNN`)を満たしているかを主な基準にする。
|
|
41
|
+
2. `depends_on` 成果物の最新の決定事項・用語・制約、およびプロジェクト文脈(背景・目的・関係者の意図)との整合を確認する。
|
|
42
|
+
3. 実践の型は、対象領域の実例やプロジェクト文脈と矛盾しない範囲の補助基準にとどめる。
|
|
43
|
+
4. 内部情報だけで判断できない一般的な観点・用語・標準があり、実行 agent が Web 検索能力を持つ場合は、関連情報を確認して出典を添える。Web 検索能力がない場合は、利用可能な内部情報の範囲で判定し、確認できない事項を result に記録する。
|
|
44
|
+
|
|
45
|
+
実践の型とプロジェクト文脈が矛盾する場合は、プロジェクト文脈を優先し、その理由を記録する。
|
|
46
|
+
|
|
47
|
+
本タスクの実行に必要な freeform の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
48
|
+
|
|
49
|
+
### 4.1. 判断根拠の記録
|
|
50
|
+
|
|
51
|
+
確認した内容と判断根拠を review result に残す。記録先は次のとおり。
|
|
52
|
+
|
|
53
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
54
|
+
- 優先した実例・プロジェクト文脈、実践の型を補助に使った場合の判断根拠、実践の型とプロジェクト文脈が矛盾しプロジェクト文脈を優先した箇所とその理由、Web 出典: review result の `実践の型との整合確認` セクション。
|
|
55
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
56
|
+
|
|
57
|
+
## 5. 完了手順
|
|
58
|
+
|
|
59
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
60
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
61
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
62
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
63
|
+
|
|
64
|
+
## 6. 異常終了の条件
|
|
65
|
+
|
|
66
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
67
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
68
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
69
|
+
|
|
70
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`(`_MISSING_` は `undecided`、`not-needed`、または未整備)
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
35
|
+
|
|
36
|
+
## 4. 進め方
|
|
37
|
+
|
|
38
|
+
対象成果物に紐づく rulebook / recipe / sample / template は、いずれも指定されたファイルを実際に読み込んだうえで、次の役割に沿って確認の基準にする。読み込まずに記憶や推測で代替しない。レビューでは成果物を組み立てるのではなく、成果物が基準を満たすかを照合する。
|
|
39
|
+
|
|
40
|
+
参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備のため「実践の型が存在しない・内容が薄い場合」に従う):
|
|
41
|
+
|
|
42
|
+
- rulebook: `_RULEBOOK_REF_`(`_MISSING_` なら対象外)
|
|
43
|
+
- recipe: `_RECIPE_REF_`(`_MISSING_` なら対象外)
|
|
44
|
+
- sample: `_SAMPLE_REF_`(`_MISSING_` なら対象外)
|
|
45
|
+
- template: `_TEMPLATE_REF_`(`_MISSING_` なら対象外)
|
|
46
|
+
|
|
47
|
+
1. rulebook: 指定された rulebook を読み込み、成果物が必須要素をすべて満たし、禁止事項に抵触していないかを構造面の基準として確認する。
|
|
48
|
+
2. recipe: 指定された recipe を読み込み、示された問い・観点に対して成果物の内容が十分かを確認する。
|
|
49
|
+
3. sample: 指定された sample を読み込み、粒度・文体・表現・表の書き方と整合しているかを確認する。
|
|
50
|
+
4. template: 指定された template を読み込み、章構成と整合しているか、_TODO_ などのプレースホルダが残っていないかを確認する。
|
|
51
|
+
|
|
52
|
+
複数の文書間で記述に矛盾がある場合は rulebook を正として判定する(template の章構成が rulebook と食い違う場合も rulebook を正とする)。
|
|
53
|
+
|
|
54
|
+
参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。クロス文書整合を確認するレビュー観点では、`depends_on` 成果物を実際に読み込み、対象成果物と突き合わせて整合を判定する。目的整合の判断ではプロジェクトコンテキストを参照する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。レビューの判定は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず、該当レビュー観点を unclear とし理由を残す。
|
|
55
|
+
|
|
56
|
+
本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
57
|
+
|
|
58
|
+
### 4.1. 実践の型が存在しない・内容が薄い場合
|
|
59
|
+
|
|
60
|
+
- 指定された rulebook / recipe / sample / template のいずれかが存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を review result の `実践の型との整合確認` セクションに記録する。
|
|
61
|
+
- 欠落を理由にレビュー観点を unclear のまま放置しない。存在する他の実践の型と `depends_on` 成果物・プロジェクト文脈を基準にして判定根拠を補う。
|
|
62
|
+
- template が欠落する場合は、rulebook の構造を骨組みとして整合を確認する。
|
|
63
|
+
- 実践の型そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、findings または申し送りに残す。
|
|
64
|
+
|
|
65
|
+
### 4.2. 具体化の妥当性確認
|
|
66
|
+
|
|
67
|
+
- 対象成果物に、ファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述がある場合、その記述が参照範囲の文書(rulebook / recipe / sample / template、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けられているかを確認する。
|
|
68
|
+
- 裏付けが確認できない具体的な記述は、正確性を検証できないため該当レビュー観点を unclear とし、findings に該当箇所と裏付け不足の理由を記録する。記述がもっともらしく具体的に見えることは、裏付けの代わりにならない。
|
|
69
|
+
|
|
70
|
+
### 4.3. エビデンスの独立性
|
|
71
|
+
|
|
72
|
+
- evidence・notes は、対象成果物・rulebook / recipe / sample / template を実際に読んで得た具体的な観察(該当箇所の内容、章・行・ノード名など)に限る。
|
|
73
|
+
- 実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱わない。executor が「基準を満たした」と報告していることは、review 側の pass 判定の根拠にならない。
|
|
74
|
+
- 対象成果物を自分で確認した結果と executor の報告が一致しない場合は、対象成果物側の内容を優先し、findings に不一致を記録する。
|
|
75
|
+
|
|
76
|
+
### 4.4. 判断根拠の記録
|
|
77
|
+
|
|
78
|
+
確認した文書・確認しなかった文書と、その判断根拠を review result に残す。記録先は次のとおり。
|
|
79
|
+
|
|
80
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
81
|
+
- 参照した rulebook / recipe / sample / template の使い分け、矛盾時に rulebook を正とした箇所、欠落・薄い実践の型の扱い: review result の `実践の型との整合確認` セクション。
|
|
82
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
83
|
+
|
|
84
|
+
## 5. 完了手順
|
|
85
|
+
|
|
86
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
87
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
88
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
89
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
90
|
+
|
|
91
|
+
## 6. 異常終了の条件
|
|
92
|
+
|
|
93
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
94
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
95
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
96
|
+
|
|
97
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
35
|
+
|
|
36
|
+
## 4. 進め方
|
|
37
|
+
|
|
38
|
+
対象成果物に紐づく recipe を、指定されたファイルを実際に読み込んだうえで主な確認基準にする。読み込まずに記憶や推測で代替しない。レビューでは成果物を組み立てるのではなく、成果物が基準を満たすかを照合する。
|
|
39
|
+
|
|
40
|
+
主な確認基準とする recipe(rulebook frontmatter から解決): `_RECIPE_REF_`(`_MISSING_` の場合は「recipe が存在しない・内容が薄い場合」に従う)。
|
|
41
|
+
|
|
42
|
+
1. recipe: 指定された recipe を読み込み、示された問い・観点に照らして成果物の内容が十分かを確認する。
|
|
43
|
+
2. recipe だけでは判断できない箇所は、`depends_on` 成果物・類似成果物・プロジェクト文脈との整合を確認する。
|
|
44
|
+
|
|
45
|
+
rulebook / sample / template は未成熟と判断されているため、存在しても構造・文体・粒度の必須基準としては扱わない。recipe の指示が他の文書と矛盾する場合は recipe を優先する。
|
|
46
|
+
|
|
47
|
+
本タスクの実行に必要な recipe-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
48
|
+
|
|
49
|
+
### 4.1. recipe が存在しない・内容が薄い場合
|
|
50
|
+
|
|
51
|
+
- recipe は recipe-guided の唯一の主基準であるため、存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を review result の `実践の型との整合確認` セクションに記録する。
|
|
52
|
+
- 欠落を理由にレビュー観点を unclear のまま放置しない。`depends_on` 成果物・類似成果物・プロジェクト文脈を基準にして判定根拠を補い、何を recipe の代わりに根拠としたかを明示する。
|
|
53
|
+
- recipe そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、findings または申し送りに残す。
|
|
54
|
+
|
|
55
|
+
### 4.2. 判断根拠の記録
|
|
56
|
+
|
|
57
|
+
確認した文書と判断根拠を review result に残す。記録先は次のとおり。
|
|
58
|
+
|
|
59
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
60
|
+
- recipe に照らした確認内容、rulebook / sample / template を基準にしなかった理由と代わりに根拠にした内容、欠落・薄い recipe の扱い: review result の `実践の型との整合確認` セクション。
|
|
61
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
62
|
+
|
|
63
|
+
## 5. 完了手順
|
|
64
|
+
|
|
65
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
66
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
67
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
68
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
69
|
+
|
|
70
|
+
## 6. 異常終了の条件
|
|
71
|
+
|
|
72
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
73
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
74
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
75
|
+
|
|
76
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
## 4. 進め方
|
|
35
|
+
|
|
36
|
+
確認の向きを「成果物 → recipe」に切り替え、対象成果物に紐づく recipe の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは recipe を編集するのではなく、見直し内容が妥当かを照合する。
|
|
37
|
+
|
|
38
|
+
1. 見直し対象の recipe を読み込み、改訂後の問い・観点・深掘り手順・レビュー観点を把握する。
|
|
39
|
+
2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 recipe の frontmatter から辿れる rulebook、該当する執筆標準のうち必要な文書と照合する。
|
|
40
|
+
3. 複数の成果物・review result・対象領域の慣行と照らし、それらが良い内容の作成に役立つものになっているかを確認する。
|
|
41
|
+
4. 見直し内容が [[specdojo:recipe-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従っているか確認する。
|
|
42
|
+
5. rulebook と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
43
|
+
|
|
44
|
+
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な recipe メンテナンス確認の方針は、このセクションで完結する。
|
|
45
|
+
|
|
46
|
+
### 4.1. 見直しの根拠が不足する場合
|
|
47
|
+
|
|
48
|
+
- finding の message と判定根拠、対象 recipe から辿れる rulebook、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
+
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
+
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
+
|
|
52
|
+
### 4.2. 判断根拠の記録
|
|
53
|
+
|
|
54
|
+
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
+
|
|
56
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
+
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
+
|
|
60
|
+
## 5. 完了手順
|
|
61
|
+
|
|
62
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
63
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
64
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
65
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
66
|
+
|
|
67
|
+
## 6. 異常終了の条件
|
|
68
|
+
|
|
69
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
70
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
71
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
|
+
|
|
73
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. 実装エビデンス
|
|
21
|
+
|
|
22
|
+
次の参照は成果物カタログの `evidence_refs` から展開した読み取り専用の確認入力である。成果物との対応判定に使い、実装は変更しない。
|
|
23
|
+
|
|
24
|
+
_IMPLEMENTATION_EVIDENCE_
|
|
25
|
+
|
|
26
|
+
## 4. レビュー観点
|
|
27
|
+
|
|
28
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
29
|
+
|
|
30
|
+
<!-- prettier-ignore-start -->
|
|
31
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
32
|
+
| --- | ------ | ------------ | -------- |
|
|
33
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
34
|
+
<!-- prettier-ignore-end -->
|
|
35
|
+
|
|
36
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
37
|
+
|
|
38
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
39
|
+
|
|
40
|
+
## 5. 進め方
|
|
41
|
+
|
|
42
|
+
1. 対象成果物、`depends_on`、プロジェクトコンテキストを読み、意図された仕様と `done_criteria` を確認する。
|
|
43
|
+
2. 「実装エビデンス」に列挙されたパスをすべて実際に読み、成果物内の記述と現在動作の対応を確認する。
|
|
44
|
+
3. 各対応を一致・乖離・実装から確認不能・未確認に分類する。成果物に実装上の事実が書かれていても、意図された仕様と異なる場合は pass にしない。
|
|
45
|
+
4. 乖離ごとに、文書が古い、実装が意図された仕様と異なる、承認根拠が不足、複数実装で挙動が異なる、のいずれかを判定し、実装または文書のどちらに修正が必要かを示す。
|
|
46
|
+
5. 実装から目的、業務判断、将来方針を推測しない。列挙されたエビデンスで判定できない場合は unclear とし、不足する根拠を明記する。
|
|
47
|
+
|
|
48
|
+
### 5.1. 判断根拠の記録
|
|
49
|
+
|
|
50
|
+
review result には、少なくとも次を記録する。
|
|
51
|
+
|
|
52
|
+
- 実際に参照した実装エビデンスのパスと確認した現在動作
|
|
53
|
+
- 成果物記述と実装の対応、および一致・乖離・確認不能・未確認の判定
|
|
54
|
+
- 乖離ごとの修正対象候補(実装・文書・意思決定)と根拠
|
|
55
|
+
- 調査できなかったパス、分岐、外部依存などの未確認範囲
|
|
56
|
+
|
|
57
|
+
各レビュー観点の pass / fail / unclear と証跡は `レビュー観点別結果`、問題点は `findings`、実装エビデンス全体の対応状況は `実践の型との整合確認` または申し送りへ記録する。
|
|
58
|
+
|
|
59
|
+
本タスクの実行に必要な retrofit の確認方針は、このセクションで完結する。approach 全体の定義を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
60
|
+
|
|
61
|
+
## 6. 完了手順
|
|
62
|
+
|
|
63
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
64
|
+
2. result の各レビュー観点セクションと実装エビデンスの対応記録を埋める。
|
|
65
|
+
3. `evidence` の文書参照は `[[id]]` 形式、実装参照はリポジトリルート相対パスで記載し、絶対パスを使わない。
|
|
66
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
67
|
+
|
|
68
|
+
## 7. 異常終了の条件
|
|
69
|
+
|
|
70
|
+
- `evidence_refs` 欠落、実装エビデンス不存在、対象ファイル不明、result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
71
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
72
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
73
|
+
|
|
74
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
17
|
+
- `result`: `_RESULT_REF_`
|
|
18
|
+
|
|
19
|
+
_PROJECT_CONTEXT_
|
|
20
|
+
|
|
21
|
+
## 3. レビュー観点
|
|
22
|
+
|
|
23
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
24
|
+
|
|
25
|
+
<!-- prettier-ignore-start -->
|
|
26
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
27
|
+
| --- | ------ | ------------ | -------- |
|
|
28
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
29
|
+
<!-- prettier-ignore-end -->
|
|
30
|
+
|
|
31
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
32
|
+
|
|
33
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
34
|
+
|
|
35
|
+
## 4. 進め方
|
|
36
|
+
|
|
37
|
+
確認の向きを「成果物 → rulebook」に切り替え、対象成果物に紐づく rulebook の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは rulebook を編集するのではなく、見直し内容が妥当かを照合する。
|
|
38
|
+
|
|
39
|
+
1. 見直し対象の rulebook を読み込み、改訂後の章構成・必須項目・禁止事項・判定基準を把握する。
|
|
40
|
+
2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 rulebook の frontmatter から辿れる recipe / sample / template、`併せて適用する rulebook`、該当する執筆標準のうち必要な文書と照合する。
|
|
41
|
+
3. 複数の成果物・review result・対象領域の慣行と照らし、それらが成果物の実態と整合しているかを確認する。
|
|
42
|
+
4. 見直し内容が [[specdojo:rulebook-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従っているか確認する。
|
|
43
|
+
5. recipe / sample / template、および `併せて適用する rulebook`(`_MISSING_` でない場合)と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
44
|
+
|
|
45
|
+
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な rulebook メンテナンス確認の方針は、このセクションで完結する。
|
|
46
|
+
|
|
47
|
+
### 4.1. 見直しの根拠が不足する場合
|
|
48
|
+
|
|
49
|
+
- finding の message と判定根拠、対象 rulebook から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
50
|
+
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
51
|
+
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
52
|
+
|
|
53
|
+
### 4.2. 判断根拠の記録
|
|
54
|
+
|
|
55
|
+
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
56
|
+
|
|
57
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
58
|
+
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
59
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
60
|
+
|
|
61
|
+
## 5. 完了手順
|
|
62
|
+
|
|
63
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
64
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
65
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
66
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
67
|
+
|
|
68
|
+
## 6. 異常終了の条件
|
|
69
|
+
|
|
70
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
71
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
72
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
73
|
+
|
|
74
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
## 4. 進め方
|
|
35
|
+
|
|
36
|
+
確認の向きを「成果物 → sample」に切り替え、対象成果物に紐づく sample の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは sample を編集するのではなく、見直し内容が妥当かを照合する。
|
|
37
|
+
|
|
38
|
+
1. 見直し対象の sample を読み込み、改訂後の粒度・文体・表の書き方を把握する。
|
|
39
|
+
2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 sample の frontmatter から辿れる rulebook / recipe、該当する執筆標準のうち必要な文書と照合する。rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として確認する。
|
|
40
|
+
3. 複数の成果物・review result・対象領域の慣行と照らし、それらが完成例として適切か、実成果物の丸写しになっていないかを確認する。
|
|
41
|
+
4. 見直し内容が [[specdojo:sample-authoring-standard]](構成・記述ルール・禁止事項の正本)に従っているか確認する。
|
|
42
|
+
5. rulebook / recipe と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
43
|
+
|
|
44
|
+
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な sample メンテナンス確認の方針は、このセクションで完結する。
|
|
45
|
+
|
|
46
|
+
### 4.1. 見直しの根拠が不足する場合
|
|
47
|
+
|
|
48
|
+
- finding の message と判定根拠、対象 sample から辿れる rulebook / recipe、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
+
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
+
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
+
|
|
52
|
+
### 4.2. 判断根拠の記録
|
|
53
|
+
|
|
54
|
+
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
+
|
|
56
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
+
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
+
|
|
60
|
+
## 5. 完了手順
|
|
61
|
+
|
|
62
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
63
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
64
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
65
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
66
|
+
|
|
67
|
+
## 6. 異常終了の条件
|
|
68
|
+
|
|
69
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
70
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
71
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
|
+
|
|
73
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 対象成果物
|
|
10
|
+
|
|
11
|
+
- `name`: _DELIVERABLE_NAME_
|
|
12
|
+
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
|
+
- `path`: `_DELIVERABLE_PATH_`
|
|
15
|
+
- `rulebook`: `_RULEBOOK_REF_`
|
|
16
|
+
- `result`: `_RESULT_REF_`
|
|
17
|
+
|
|
18
|
+
_PROJECT_CONTEXT_
|
|
19
|
+
|
|
20
|
+
## 3. レビュー観点
|
|
21
|
+
|
|
22
|
+
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
|
+
|
|
24
|
+
<!-- prettier-ignore-start -->
|
|
25
|
+
| ID | ロール | viewpoint_id | 確認基準 |
|
|
26
|
+
| --- | ------ | ------------ | -------- |
|
|
27
|
+
_REVIEW_VIEWPOINT_ROWS_
|
|
28
|
+
<!-- prettier-ignore-end -->
|
|
29
|
+
|
|
30
|
+
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
|
+
|
|
32
|
+
_REVIEW_VIEWPOINT_DETAILS_
|
|
33
|
+
|
|
34
|
+
## 4. 進め方
|
|
35
|
+
|
|
36
|
+
確認の向きを「成果物 → template」に切り替え、対象成果物に紐づく template の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは template を編集するのではなく、見直し内容が妥当かを照合する。
|
|
37
|
+
|
|
38
|
+
1. 見直し対象の template を読み込み、改訂後の章構成の骨組みとプレースホルダの配置・網羅性を把握する。
|
|
39
|
+
2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 template の frontmatter から辿れる rulebook / recipe / sample、該当する執筆標準のうち必要な文書と照合する。
|
|
40
|
+
3. 複数の成果物・review result・対象領域の慣行と照らし、それらが成果物作成の開始点として適切かを確認する。
|
|
41
|
+
4. 見直し内容が [[specdojo:template-authoring-standard]](構成・プレースホルダ規約・禁止事項の正本)に従っているか確認する。
|
|
42
|
+
5. rulebook / recipe / sample と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
43
|
+
|
|
44
|
+
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な template メンテナンス確認の方針は、このセクションで完結する。
|
|
45
|
+
|
|
46
|
+
### 4.1. 見直しの根拠が不足する場合
|
|
47
|
+
|
|
48
|
+
- finding の message と判定根拠、対象 template から辿れる rulebook / recipe / sample、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
+
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
+
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
+
|
|
52
|
+
### 4.2. 判断根拠の記録
|
|
53
|
+
|
|
54
|
+
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
+
|
|
56
|
+
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
+
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
+
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
+
|
|
60
|
+
## 5. 完了手順
|
|
61
|
+
|
|
62
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
63
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
64
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
65
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
66
|
+
|
|
67
|
+
## 6. 異常終了の条件
|
|
68
|
+
|
|
69
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
70
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
71
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
|
+
|
|
73
|
+
_COMMON_CONVENTIONS_
|