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,67 @@
|
|
|
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
|
+
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
36
|
+
|
|
37
|
+
## 4. 進め方
|
|
38
|
+
|
|
39
|
+
- exec plan frontmatter の `approach` を確認する。
|
|
40
|
+
- `approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、確認の向きを「成果物 → 対象の実践の型」に切り替え、対象の実践の型が見直しに値するかを確認する。
|
|
41
|
+
- それ以外の場合は、対象成果物に紐づく rulebook / recipe / sample / template の有無を確認し、`approach` に応じて確認の基準を決める。
|
|
42
|
+
- `fully-guided`: rulebook の必須要素・禁止事項、recipe の問いとレビュー観点、sample の粒度・文体、template の章構成との整合を確認する(プレースホルダが残っていないことも確認する)。`併せて適用する rulebook` が `_MISSING_` でない場合は、その記法などのルールとの整合も確認する。
|
|
43
|
+
- `recipe-guided`: recipe の問いとレビュー観点に照らして確認する(rulebook / sample / template の構造・文体は基準にしない)。
|
|
44
|
+
- `freeform`: 実践の型より、類似成果物の実例やプロジェクト文脈との整合を確認する。
|
|
45
|
+
- 未指定の場合は、存在するすべての実践の型をそれぞれの役割に沿って確認の基準にする。
|
|
46
|
+
- 複数の文書間で記述に矛盾がある場合、確認の基準に rulebook を含む `approach`(`fully-guided` など)では rulebook を正とする。
|
|
47
|
+
- `freeform` と実践の型メンテナンス系(`*-maintenance`)を除く `approach` では、確認に用いてよい文書をこの plan に記載されたもの(対象成果物に紐づく rulebook / 併せて適用する rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキスト)に限定する。クロス文書整合のレビュー観点では `depends_on` 成果物を読み込んで対象成果物と突き合わせ、目的整合の判断ではプロジェクトコンテキストを参照する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
|
|
48
|
+
- `freeform` を除く `approach` では、対象成果物中のファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述が、確認に用いてよい文書で裏付けられているかを確認する。裏付けが確認できない具体的な記述は、正確性を検証できないため該当レビュー観点を unclear とし、findings に記録する。もっともらしく具体的に見えることは裏付けの代わりにならない。
|
|
49
|
+
- evidence・notes は、対象成果物・実践の型を実際に読んで得た具体的な観察に限る。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱わない。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先し findings に記録する。
|
|
50
|
+
- 存在しない、または確認の基準から外れた文書がある場合は、他に存在する文書、類似成果物、対象領域の慣行と整合しているかを確認し、判断の根拠を review result に残す。
|
|
51
|
+
|
|
52
|
+
詳細は [[specdojo:ryu-guide]] を参照する。
|
|
53
|
+
|
|
54
|
+
## 5. 完了手順
|
|
55
|
+
|
|
56
|
+
1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
|
|
57
|
+
2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
58
|
+
3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
59
|
+
4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
|
|
60
|
+
|
|
61
|
+
## 6. 異常終了の条件
|
|
62
|
+
|
|
63
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
|
|
64
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
|
|
65
|
+
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
66
|
+
|
|
67
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Review Result
|
|
4
|
+
|
|
5
|
+
## 1. レビュー観点別結果
|
|
6
|
+
|
|
7
|
+
各 RVP セクションの `result` / `evidence` / `notes` を記入する。`evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載し、行番号アンカーや絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
|
|
8
|
+
|
|
9
|
+
_REVIEW_RESULT_SECTIONS_
|
|
10
|
+
|
|
11
|
+
## 2. findings
|
|
12
|
+
|
|
13
|
+
_TODO_: 問題点・指摘事項を記入する(なければ削除)。
|
|
14
|
+
|
|
15
|
+
## 3. 実践の型との整合確認
|
|
16
|
+
|
|
17
|
+
_TODO_: `approach` に従ってどう確認したか(`fully-guided` で rulebook の必須要素・禁止事項、recipe の作り方、sample の粒度・文体、template の章構成との整合、`recipe-guided` で recipe のみを基準にした確認、`freeform` で実践の型より優先した実例やプロジェクト文脈との整合、`retrofit` で実際に参照した実装パス・成果物との対応判定・乖離ごとの修正対象候補・未確認範囲、`rulebook-maintenance` などの maintenance 系で見直した実践の型とその根拠、など)を記入する。複数文書間に矛盾があり rulebook を正として判定した箇所、確認の基準から外れていた文書とその代わりに根拠にした内容があれば、あわせて記録する。
|
|
18
|
+
|
|
19
|
+
## 4. decision
|
|
20
|
+
|
|
21
|
+
- recommendation: _TODO_(approve / revise / reject)
|
|
@@ -0,0 +1,354 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:branch-workflow-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
based_on:
|
|
7
|
+
- specdojo:git-branching-standard
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ブランチワークフローガイド
|
|
11
|
+
|
|
12
|
+
Branch Workflow Guide
|
|
13
|
+
|
|
14
|
+
[Git ブランチ運用標準](../standards/git-branching-standard.md) に従い、project `develop`、feature、exec worktree を作成・同期・統合・終了する手順を説明します。対象読者は、複数の `prj-xxxx` と Git worktree を同じリポジトリで運用する開発者・運用者です。
|
|
15
|
+
|
|
16
|
+
**対象読者**
|
|
17
|
+
|
|
18
|
+
- project、feature、exec の各ブランチと Git worktree を運用する開発者、実行管理者
|
|
19
|
+
|
|
20
|
+
**この文書で分かること**
|
|
21
|
+
|
|
22
|
+
- 標準ブランチ構成、project `develop` の準備、feature・exec の開始から統合・終了までの手順
|
|
23
|
+
|
|
24
|
+
**次に読む文書**
|
|
25
|
+
|
|
26
|
+
- exec の実行経路は [exec運用ガイド](exec-operation-guide.md)、worktree の分割操作は [exec worktree運用ガイド](exec-worktree-guide.md) を参照してください。
|
|
27
|
+
|
|
28
|
+
## 1. 前提と全体像
|
|
29
|
+
|
|
30
|
+
作業を始める前に、対象 project ID、現在ブランチ、作業ツリーの状態を確認します。
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
git branch --show-current
|
|
34
|
+
git status --short
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
標準の変更経路は次のとおりです。
|
|
38
|
+
|
|
39
|
+
```text
|
|
40
|
+
main
|
|
41
|
+
└─ project/prj-0001/develop
|
|
42
|
+
├─ feature/prj-0001/<topic>
|
|
43
|
+
└─ exec/prj-0001-<task-id>
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
| ブランチ | 主な用途 | 主な操作主体 |
|
|
47
|
+
| -------------------------- | ----------------------------- | ---------------- |
|
|
48
|
+
| `main` | 安定した共有状態 | リポジトリ管理者 |
|
|
49
|
+
| `project/prj-0001/develop` | prj-0001 の変更統合と検証 | プロジェクト |
|
|
50
|
+
| `feature/prj-0001/<topic>` | 人が行う目的別の変更 | 開発者 |
|
|
51
|
+
| `exec/prj-0001-<task-id>` | task 単位の隔離された自動変更 | SpecDojo CLI |
|
|
52
|
+
|
|
53
|
+
以降の例では project ID に `prj-0001` を使用します。
|
|
54
|
+
|
|
55
|
+
## 2. project developを準備する
|
|
56
|
+
|
|
57
|
+
新しい project の統合ブランチを作る場合は、更新済みの `main` を起点にします。
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
git switch main
|
|
61
|
+
git pull --ff-only origin main
|
|
62
|
+
git switch -c project/prj-0001/develop
|
|
63
|
+
git push -u origin project/prj-0001/develop
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
既存の project `develop` で作業を再開する場合は、ブランチと同期状態を確認します。
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
git switch project/prj-0001/develop
|
|
70
|
+
git status --short
|
|
71
|
+
git fetch origin
|
|
72
|
+
git merge origin/main
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
共有中の project `develop` では rebase せず、`main` を merge して履歴を維持します。リモートを使用しない環境では、取得済みのローカル `main` を merge 対象にします。
|
|
76
|
+
|
|
77
|
+
## 3. featureブランチで作業する
|
|
78
|
+
|
|
79
|
+
### 3.1. 通常の作業ツリーで開始する
|
|
80
|
+
|
|
81
|
+
対象 project の `develop` を起点に、project ID を含む feature を作成します。複数人・複数 actor 運用では、先にリモートの更新を取り込み、ローカルの `develop` を push します。push 後の先端がリモートと一致することを確認してから feature を切ります。これにより、ローカルの `develop` にだけ存在する無関係な commit が Pull Request の差分へ混入することを防ぎます。
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
git switch project/prj-0001/develop
|
|
85
|
+
git status --short
|
|
86
|
+
git fetch origin
|
|
87
|
+
git merge --ff-only origin/project/prj-0001/develop
|
|
88
|
+
git push origin project/prj-0001/develop
|
|
89
|
+
git rev-parse HEAD
|
|
90
|
+
git rev-parse origin/project/prj-0001/develop
|
|
91
|
+
git switch -c feature/prj-0001/branch-policy
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
2つの `git rev-parse` が同じ SHA を返さない場合は feature を切らず、未 push commit、リモートの更新、誤った分岐を確認します。リモートや Pull Request を使わない単独運用では fetch、push、リモートとの SHA 比較を省略できます。
|
|
95
|
+
|
|
96
|
+
作業・検証・commitを終えたら、project `develop` へ統合します。共有リポジトリでは Pull Request を使い、ローカル統合する場合も統合前に差分と検証結果を確認します。
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
git switch project/prj-0001/develop
|
|
100
|
+
git merge --no-ff feature/prj-0001/branch-policy
|
|
101
|
+
git branch -d feature/prj-0001/branch-policy
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### 3.2. feature用worktreeを作る
|
|
105
|
+
|
|
106
|
+
main worktree を project `develop` に置いたまま並行作業する場合は、feature 専用 worktree を作成できます。
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
git worktree add \
|
|
110
|
+
../worktrees/prj-0001-branch-policy \
|
|
111
|
+
-b feature/prj-0001/branch-policy \
|
|
112
|
+
project/prj-0001/develop
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
worktree 内でベースの最新変更を確認・取り込みするときは、project `develop` を明示します。
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
npm run worktree:sync -- --base project/prj-0001/develop --dry-run
|
|
119
|
+
npm run worktree:sync -- --base project/prj-0001/develop
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
統合後に worktree と branch を片付けます。
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
git worktree remove ../worktrees/prj-0001-branch-policy
|
|
126
|
+
git branch -d feature/prj-0001/branch-policy
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### 3.3. Pull Requestの差分表示が更新されない場合
|
|
130
|
+
|
|
131
|
+
Pull Request の作成後に base の project `develop` を push しても、画面の Files changed がすぐに再計算されない場合があります。画面だけで判断せず、GitHub の compare API で base と head の実差分を確認します。次の `<owner>`、`<repo>`、branch 名、`<pr-number>` は対象に置き換えます。branch 名に含まれる `/` は compare API のパスでは `%2F` として指定します。
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
gh api \
|
|
135
|
+
"/repos/<owner>/<repo>/compare/project%2Fprj-0001%2Fdevelop...feature%2Fprj-0001%2Fbranch-policy" \
|
|
136
|
+
--jq '{status, ahead_by, files: [.files[].filename]}'
|
|
137
|
+
gh pr view <pr-number> --json files --jq '.files[].path'
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
compare API のファイル一覧が期待どおりで、Pull Request の Files changed だけが古い場合は、レビュー中の操作がないことを確認してから Pull Request を close / reopen し、表示の再計算を促します。
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
gh pr close <pr-number>
|
|
144
|
+
gh pr reopen <pr-number>
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
再度 Files changed を確認し、compare API の一覧と一致するまで merge しません。close / reopen 後は、必須 CI、review、conversation の状態も再確認します。compare API にも無関係な差分がある場合は表示の問題ではないため、base の push 状態と feature の分岐元を修正します。
|
|
148
|
+
|
|
149
|
+
## 4. SpecDojo execを実行する
|
|
150
|
+
|
|
151
|
+
SpecDojo exec は task ID から `exec/<project-id>-<task-id>` を作成します。作成元と統合先を一致させるため、実行前に main worktree を対象 project の `develop` に切り替えます。
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
git switch project/prj-0001/develop
|
|
155
|
+
git branch --show-current
|
|
156
|
+
git status --short
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
自動実行では、SpecDojo が worktree の準備、agent 実行、commit、現在ブランチへの統合、状態更新を行います。
|
|
160
|
+
|
|
161
|
+
worktree 実行の `prepare execution` / `apply task changes` と実行管理の記帳は exec ブランチに保持されます。成功時に project `develop` の first-parent へ追加されるのは `--no-ff` の merge commit 1件だけで、subject は Schedule タスクなら `exec(<task-id>): <task name>`、register 項目なら `exec(register <PJR-ID>): <title>` です。register 実行では `start → review` の遷移をこの merge commit に同梱し、失敗時は `start → waiting` の遷移、plan、result を `wait` commit 1件にまとめます(worktree は再開のため保持します)。再開後に成功した場合も merge commit 1件です。squash / rebase は使わず、既存履歴は書き換えません。
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
specdojo exec run \
|
|
165
|
+
--project prj-0001 \
|
|
166
|
+
--task <task-id> \
|
|
167
|
+
--worktree
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
段階ごとに確認する場合は [exec worktree運用ガイド](exec-worktree-guide.md) の分割手順を使います。特に `worktree merge` の直前には、root worktree が対象 project の `develop` であることを再確認します。
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
git branch --show-current
|
|
174
|
+
specdojo exec worktree merge \
|
|
175
|
+
--project prj-0001 \
|
|
176
|
+
--task <task-id>
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
## 5. mainの更新を取り込む
|
|
180
|
+
|
|
181
|
+
project の作業期間中は、`main` の更新を project `develop` へ定期的に取り込みます。
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
git fetch origin
|
|
185
|
+
git switch project/prj-0001/develop
|
|
186
|
+
git status --short
|
|
187
|
+
git merge origin/main
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
取り込み後は、変更対象に必要な test、build、schema 検証を実行します。生成物を持つ構成では、必要に応じて再生成も行います。
|
|
191
|
+
|
|
192
|
+
feature または exec worktree 側へ project `develop` の更新を取り込む場合は、worktree 内でベースを明示します。
|
|
193
|
+
|
|
194
|
+
```bash
|
|
195
|
+
npm run worktree:sync -- --base project/prj-0001/develop
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
## 6. project developをmainへ統合する
|
|
199
|
+
|
|
200
|
+
project の変更が受入可能になったら、次の順序で `main` への統合を準備します。
|
|
201
|
+
|
|
202
|
+
1. project `develop` に未統合の feature / exec がないか確認します。
|
|
203
|
+
2. 最新の `main` を project `develop` へ mergeします。
|
|
204
|
+
3. project 全体に必要な test、build、schema 検証を実行します。
|
|
205
|
+
4. project register、exec result、未解決事項を確認します。
|
|
206
|
+
5. project `develop` から `main` への Pull Request を作成します。
|
|
207
|
+
6. レビューとCIが成功した後、merge commit を作る方式で統合します。squash merge と rebase merge は選びません。
|
|
208
|
+
|
|
209
|
+
昇格前に、最新の `main` を取り込んだ `develop` の先端 SHA を記録します。次の `<promoted-develop-sha>` にはこの値を使います。
|
|
210
|
+
|
|
211
|
+
```bash
|
|
212
|
+
git fetch origin
|
|
213
|
+
git switch project/prj-0001/develop
|
|
214
|
+
git status --short
|
|
215
|
+
git merge origin/main
|
|
216
|
+
git rev-parse HEAD
|
|
217
|
+
git log --oneline main..project/prj-0001/develop
|
|
218
|
+
git diff --stat main...project/prj-0001/develop
|
|
219
|
+
git branch --no-merged project/prj-0001/develop
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Pull Request の head は project `develop`、base は `main` とします。一時ブランチで commit を並べ替えたり、squash や rebase で履歴を作り直したりしません。exec の記帳(register の `start` / `review` 遷移、plan、result)は task ごとの merge commit または `wait` commit に同梱されているため、昇格時に除外する commit はありません。統合後は `main` を取得し、昇格した `develop` の先端が祖先になったことと、first-parent 上で昇格が1件の merge commit として見えることを確認します。
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
git fetch origin
|
|
226
|
+
git merge-base --is-ancestor <promoted-develop-sha> origin/main
|
|
227
|
+
git log --first-parent --oneline origin/main
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
`git merge-base --is-ancestor` が終了コード0にならない場合、squash merge または rebase merge により祖先関係が失われた可能性があります。次の昇格を進めず、使用した merge 方式と Pull Request を確認します。push 済み履歴を rebase や force-push で直してはいけません。
|
|
231
|
+
|
|
232
|
+
`git log --first-parent --oneline origin/main` の出力に exec / register の遷移 commit が並ぶ区間があっても、本手順の適用前に行った昇格の区間であれば異常ではありません。過去に merge の向きが逆(`develop` 上で `main` を取り込み、`main` を fast-forward)だった場合、その区間の first-parent 系列は `develop` の詳細 commit を辿ります。押し込み済みの履歴は書き換えないため、そのまま残します。確認するのは、**本手順で行った昇格が1件の merge commit として見えているか**です。
|
|
233
|
+
|
|
234
|
+
project `develop` を引き続き使う場合は、昇格後の `main` を取り込みます。fast-forward になる場合も、分岐して merge commit が作られる場合もあります。
|
|
235
|
+
|
|
236
|
+
```bash
|
|
237
|
+
git switch project/prj-0001/develop
|
|
238
|
+
git merge origin/main
|
|
239
|
+
git log --oneline origin/main..project/prj-0001/develop
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
同期直後の最後のコマンドは出力なしになります。その後の出力は次回昇格の新しい commit だけであり、過去の昇格済み commit は再表示されません。project 完了後に `develop` を削除する場合は、祖先確認と未退避作業の確認を終えてから行います。
|
|
243
|
+
|
|
244
|
+
## 7. 承認方式を使い分ける
|
|
245
|
+
|
|
246
|
+
登録項目の承認は、既定で commit(register の状態遷移とチケット個票の承認節)で残し、PR 承認は強制する 3 ケースに限定します。判定条件は [Git ブランチ運用標準](../standards/git-branching-standard.md) の `承認ゲートと PR 強制条件`、type 別の承認フローは [登録簿運用ガイド](register-operation-guide.md) の `承認フローと承認者` を参照します。
|
|
247
|
+
|
|
248
|
+
この承認方式は register 項目の正式な承認証跡を選ぶものです。人または対話型 agent が内容を書いた変更を feature Pull Request で事前レビューする経路とは別に判定します。PR 強制3ケース以外でも内容変更は feature Pull Request で統合し、register 項目の正式承認は commit とチケット個票へ残します。
|
|
249
|
+
|
|
250
|
+
commit ベースで承認する場合(`decision` / `risk` / `question` / `issue` / `todo` の通常運用)は、チケット個票の承認節と register の状態遷移で承認事実を残します。
|
|
251
|
+
|
|
252
|
+
```bash
|
|
253
|
+
specdojo register close \
|
|
254
|
+
--project prj-0001 \
|
|
255
|
+
--id PJR-0005 \
|
|
256
|
+
--conclusion "回答者・回答日を承認節に記入し decided へ遷移"
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
PR 承認を強制する 3 ケース(`develop → main` 昇格 / `change-request` 承認 / 不可逆・高リスク・framework schema 破壊的変更)では、承認対象の差分を Pull Request として作成し、承認者が approve します。作成者自身の承認は職務分離のためカウントしません。
|
|
260
|
+
|
|
261
|
+
```bash
|
|
262
|
+
git switch project/prj-0001/develop
|
|
263
|
+
git switch -c feature/prj-0001/schema-change
|
|
264
|
+
# 変更を commit した後に PR を作成する
|
|
265
|
+
gh pr create --base project/prj-0001/develop --title "PJR-XXXX schema 破壊的変更" --body "対象個票: prj-0001:pjr-xxxx-topic"
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
merge 後は、承認者・承認日・承認対象・証跡(PR URL・merge SHA)をチケット個票の承認節へ書き戻します。`main` と `project/<project-id>/develop` の承認者は `CODEOWNERS` と branch protection で強制します。
|
|
269
|
+
|
|
270
|
+
### 7.1. CODEOWNERS と branch protection を設定する
|
|
271
|
+
|
|
272
|
+
`CODEOWNERS` は PR の base branch にあるファイルが評価されます。保護ルールを有効にする前に、`.github/CODEOWNERS` を `main` と保護対象の `project/<project-id>/develop` へ反映し、指定した user または team にリポジトリへの明示的な write 権限があることを確認します。
|
|
273
|
+
|
|
274
|
+
リポジトリ管理者は GitHub の `Settings` → `Branches` で、次の branch protection rule を設定します。ruleset を使う場合も、同等の条件を設定します。
|
|
275
|
+
|
|
276
|
+
| 対象 branch | 必須設定 |
|
|
277
|
+
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
278
|
+
| `main` | Pull Request 経由、承認 1 件以上、Code Owners のレビュー、新規 commit 時の古い承認無効化、未解決 conversation の解消、必須 CI、管理者を含む bypass・force-push・削除の禁止 |
|
|
279
|
+
| `project/<project-id>/develop` | Pull Request 経由、承認 1 件以上、Code Owners のレビュー、新規 commit 時の古い承認無効化、未解決 conversation の解消、統合専用 actor 以外の bypass・force-push・削除の禁止 |
|
|
280
|
+
|
|
281
|
+
`project/<project-id>/develop` では通常の自動 `exec → develop` 統合を止めないように、SpecDojo の統合専用 GitHub App または service account だけを bypass actor に指定します。人の管理者や承認者へ広い bypass を付与してはいけません。統合専用 actor を分離できない間は develop の保護を有効化せず、その未設定期間を project register で追跡します。`main` の保護は自動統合の bypass 対象にしません。
|
|
282
|
+
|
|
283
|
+
設定後、管理者は次を確認します。
|
|
284
|
+
|
|
285
|
+
1. `main` を base にした PR で `@naoji3x` が Code Owner として review request される。
|
|
286
|
+
2. 未承認、作成者自身の操作、古い承認、未成功の必須 CI の各状態では `main` へ merge できない。
|
|
287
|
+
3. PR 強制ケースの差分を base にした `project/<project-id>/develop` 向け PR で、Code Owner の承認なしに merge できない。
|
|
288
|
+
4. 統合専用 actor による通常の `exec → develop` だけが bypass でき、人の変更は bypass できない。
|
|
289
|
+
|
|
290
|
+
### 7.2. 独立した承認者がいない期間を扱う
|
|
291
|
+
|
|
292
|
+
PR の作成者と独立した Code Owner がいない場合、PR 強制 3 ケースは「承認待ち」とし、作成者自身の approve、管理者権限、または bypass を承認として記録しません。独立した承認者が参加して approve するまで merge と承認対象チケットの close を保留します。
|
|
293
|
+
|
|
294
|
+
緊急対応で管理者 bypass による merge が不可避な場合は、承認済みとは扱わず、例外として対象、理由、実施者、期間、PR URL、merge SHA、復帰条件を project register に記録します。独立した承認者が参加した後に差分を遡及レビューし、その結果を同じ登録項目へ追記します。
|
|
295
|
+
|
|
296
|
+
## 8. 複数projectを並行する
|
|
297
|
+
|
|
298
|
+
`worktree:sync` は既定で main worktree が checkout しているブランチをベースにします。複数 project の worktree が同時に存在する場合は、対象 project の `develop` を毎回明示します。
|
|
299
|
+
|
|
300
|
+
```bash
|
|
301
|
+
npm run worktree:sync -- --base project/prj-0001/develop
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
| 状況 | 対応 |
|
|
305
|
+
| ----------------------------------------- | ------------------------------------------------------ |
|
|
306
|
+
| main worktree が対象 project の `develop` | 自動判定を利用できるが、実行前に現在ブランチを確認する |
|
|
307
|
+
| main worktree が別 project の `develop` | `--base project/<project-id>/develop` を指定する |
|
|
308
|
+
| 定型コマンドや自動実行から同期する | `SPECDOJO_WORKTREE_BASE_BRANCH` でベースを固定する |
|
|
309
|
+
| 複数 project が同じ共通ファイルを変更する | 統合順序を決め、共通変更を `main` 経由で同期する |
|
|
310
|
+
|
|
311
|
+
環境変数で固定する例:
|
|
312
|
+
|
|
313
|
+
```bash
|
|
314
|
+
export SPECDOJO_WORKTREE_BASE_BRANCH=project/prj-0001/develop
|
|
315
|
+
npm run worktree:sync
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
## 9. 既存featureブランチを移行する
|
|
319
|
+
|
|
320
|
+
未公開または単独作業中の `feature/<topic>` は、project ID を含む名前へ変更できます。
|
|
321
|
+
|
|
322
|
+
```bash
|
|
323
|
+
git branch -m \
|
|
324
|
+
feature/branch-policy \
|
|
325
|
+
feature/prj-0001/branch-policy
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
現在 checkout 中の branch を変更する場合:
|
|
329
|
+
|
|
330
|
+
```bash
|
|
331
|
+
git branch -m feature/prj-0001/branch-policy
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
リモート公開済みの場合は、新しい名前を公開して追跡先を設定した後、利用者と Pull Request への影響を確認して旧名を削除します。
|
|
335
|
+
|
|
336
|
+
```bash
|
|
337
|
+
git push -u origin feature/prj-0001/branch-policy
|
|
338
|
+
git push origin --delete feature/branch-policy
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
レビュー中または共同作業中の branch は無理に改名せず、完了後に新しい命名へ切り替える方が安全です。
|
|
342
|
+
|
|
343
|
+
## 10. 作業前後のチェックリスト
|
|
344
|
+
|
|
345
|
+
| 時点 | 確認内容 |
|
|
346
|
+
| -------------------- | -------------------------------------------------------------------- |
|
|
347
|
+
| 分岐前 | 対象 project ID、現在ブランチ、未commit変更、分岐元の同期状態 |
|
|
348
|
+
| worktree作成後 | branch 名、worktree パス、ベース commit |
|
|
349
|
+
| 同期前 | worktree が clean であること、取り込み元 branch |
|
|
350
|
+
| feature / exec統合前 | 統合先が対象 project の `develop` であること、検証結果、未commit変更 |
|
|
351
|
+
| main統合前 | 最新 `main` の取り込み、project全体の検証、レビュー対象、未解決事項 |
|
|
352
|
+
| 削除前 | 統合済みであること、未退避のcommit・変更・resultがないこと |
|
|
353
|
+
|
|
354
|
+
誤ったブランチから作業を始めた場合は、そのまま統合せず、現在の commit と正しいベースとの差分を確認します。修正方法を決められない場合は branch と worktree を保持し、変更を失う操作を行わずにレビューを依頼します。
|