specdojo 0.4.6 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +14 -9
- package/CHANGELOG.md +62 -0
- package/dist/catalog/document-target.js +75 -0
- package/dist/commands/agent.js +2 -80
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/agent-config.js +28 -16
- package/dist/exec/agent-plan.js +108 -0
- package/dist/exec/commands.js +3 -3
- package/dist/exec/core.js +2 -0
- package/dist/exec/grade-checkpoint.js +12 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +7 -67
- package/dist/exec/plans-generation.js +28 -7
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/project.js +4 -1
- package/dist/exec/register.js +82 -6
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/lifecycle-commands.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +23 -0
- package/dist/exec/run/register-state.js +4 -1
- package/dist/exec/run/register-worktree.js +28 -1
- package/dist/exec/run/schedule-prepare.js +7 -1
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-command.js +8 -1
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree-ops-merge.js +40 -1
- package/dist/grade/apply.js +13 -7
- package/dist/grade/command-inspect.js +2 -1
- package/dist/grade/command-run.js +39 -0
- package/dist/grade/grade.js +3 -1
- package/dist/grade/markdown.js +11 -6
- package/dist/grade/pipeline-state.js +8 -6
- package/dist/grade/plan.js +14 -10
- package/dist/grade/run.js +307 -0
- package/dist/grade/target-discovery.js +1 -1
- package/dist/grade/targets.js +44 -22
- package/dist/register/approach.js +35 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +83 -5
- package/dist/register/deliverable-target.js +215 -0
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +8 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +18 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/review/grade.js +19 -17
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-plan.js +1 -0
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/provider-scaffold.js +5 -3
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/dist/specdojo.js +5 -1
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-config-guide.md +44 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +59 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
- package/docs/ja/specdojo/guides/review-guide.md +2 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +92 -29
- package/docs/ja/specdojo/references/specdojo-config-reference.md +49 -16
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +56 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +73 -4
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +21 -3
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/devcontainer.json +1 -0
- package/templates/init-agent-members.yaml +46 -3
- package/templates/opencode/README.md +118 -14
- package/templates/opencode/agents/specdojo-orchestrator.md +15 -10
- package/templates/opencode/opencode.json +25 -0
|
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
|
|
|
34
34
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
35
35
|
|
|
36
36
|
<!-- prettier-ignore-start -->
|
|
37
|
-
| ID
|
|
38
|
-
| --- |
|
|
37
|
+
| ID | ロール | `viewpoint_id` | 完了条件 |
|
|
38
|
+
| --- | --- | --- | --- |
|
|
39
39
|
_DONE_CRITERIA_ROWS_
|
|
40
40
|
<!-- prettier-ignore-end -->
|
|
41
41
|
|
|
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
|
|
|
34
34
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
35
35
|
|
|
36
36
|
<!-- prettier-ignore-start -->
|
|
37
|
-
| ID
|
|
38
|
-
| --- |
|
|
37
|
+
| ID | ロール | `viewpoint_id` | 完了条件 |
|
|
38
|
+
| --- | --- | --- | --- |
|
|
39
39
|
_DONE_CRITERIA_ROWS_
|
|
40
40
|
<!-- prettier-ignore-end -->
|
|
41
41
|
|
|
@@ -35,8 +35,8 @@ _GRADE_SUMMARY_
|
|
|
35
35
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
36
36
|
|
|
37
37
|
<!-- prettier-ignore-start -->
|
|
38
|
-
| ID
|
|
39
|
-
| --- |
|
|
38
|
+
| ID | ロール | `viewpoint_id` | 完了条件 |
|
|
39
|
+
| --- | --- | --- | --- |
|
|
40
40
|
_DONE_CRITERIA_ROWS_
|
|
41
41
|
<!-- prettier-ignore-end -->
|
|
42
42
|
|
|
@@ -336,7 +336,20 @@ npm install --save-dev @specdojo/docs-site
|
|
|
336
336
|
npx specdojo-docs-site build .
|
|
337
337
|
```
|
|
338
338
|
|
|
339
|
-
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev`
|
|
339
|
+
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリの `docs/` と package 同梱の kata・guide・reference を `.vitepress/kata-staging/docs/` に重ねた閲覧用ツリーを作り、`/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先し、`dev` 中の編集・追加・削除も同期するため、サイト表示のために `kata install --all` を実行する必要はありません。ページ走査のルートをこのツリーに限定し、`.vitepress/dist` や cache、利用者の設定ファイルはページに含めません。
|
|
340
|
+
|
|
341
|
+
Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .` を使います。SVG と manifest は `.vitepress/mermaid/`、サイトの build 結果は `.vitepress/dist/`、cache は `.vitepress/cache/` に置きます。図の公開 URL は `/mermaid/<hash>.svg` を維持し、利用者の `public/` のファイルも従来どおり配信します。
|
|
342
|
+
|
|
343
|
+
`specdojo config init` は `.gitignore` の既存の内容を保持して、次の生成ディレクトリだけを除外します。既存のリポジトリでは再実行するか、手動で追記してください。`.vitepress/` 全体を除外せず、利用者の設定ファイルは Git 管理対象に残します。
|
|
344
|
+
|
|
345
|
+
```text
|
|
346
|
+
/.vitepress/dist/
|
|
347
|
+
/.vitepress/cache/
|
|
348
|
+
/.vitepress/mermaid/
|
|
349
|
+
/.vitepress/kata-staging/
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動で削除しません。移行時は内容を確認し、不要な生成物だけを手動で片付けてください。
|
|
340
353
|
|
|
341
354
|
### 6.1. Mermaid 図を組み立てる
|
|
342
355
|
|
|
@@ -527,13 +527,15 @@ app1-specdojo-worktrees/
|
|
|
527
527
|
|
|
528
528
|
統合は次の順序で行います。
|
|
529
529
|
|
|
530
|
-
1. 全リポジトリで commit 対象を commit し、merge
|
|
531
|
-
2.
|
|
532
|
-
3.
|
|
530
|
+
1. 全リポジトリで commit 対象を commit し、merge するリポジトリでは merge 可否、`branch-only` では exec worktree に未 commit の変更が無いことを事前に検査する。1つでも検査に失敗したリポジトリがあれば、どのリポジトリも統合しない。
|
|
531
|
+
2. 宣言順にプロダクトを処理する。`repos[].integration_strategy` が `merge`(既定)の場合は exec branch を統合先ブランチへ merge commit で統合し、`branch-only` の場合は merge せず exec branch を保持する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
|
|
532
|
+
3. プロダクトの trace key、exec branch 名、状態、統合先の commit snapshot を、プロジェクト側の result 本文へ記録する(register 項目の場合)。`branch-only` は未統合と明示し、統合先の snapshot と PR は `not applicable` とする。
|
|
533
533
|
4. プロジェクトの exec branch を `app1-specdojo/` の統合先ブランチへ統合する。
|
|
534
|
-
5.
|
|
534
|
+
5. 処理成功後に全リポジトリの worktree を撤去する。`merge` の exec branch とプロジェクトの exec branch は削除し、`branch-only` の exec branch は変更の有無によらず残す。
|
|
535
535
|
|
|
536
|
-
|
|
536
|
+
ソースを先に処理することで、プロダクトの処理を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、全プロダクトが merge 済み・変更なし・`branch-only` の保持のいずれかになった後に統合先へ入ります。`review` は SpecDojo のタスク成果を確認する段階であり、プロダクト側の PR が merge 済みであることを意味しません。
|
|
537
|
+
|
|
538
|
+
PR レビューを必須にするプロダクトは、[[specdojo:specdojo-config-reference|設定リファレンス]] の `repos` で `"integration_strategy": "branch-only"` を選びます。統合先への merge 可否や統合先 checkout の未 commit 変更は、そのリポジトリの事前検査を妨げません。runner は push と PR 作成(`gh` を含む)を実装せず、利用者が必要な承認のもと、保持された branch を push してプロダクト側で PR を作ります。squash merge では `Refs:` を commit メッセージに残してください。未統合の branch は `exec worktree prune` でも削除しません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除します。
|
|
537
539
|
|
|
538
540
|
### 10.7. 複数リポジトリの統合の失敗と再開
|
|
539
541
|
|
|
@@ -545,10 +547,10 @@ app1-specdojo-worktrees/
|
|
|
545
547
|
| n 番目のプロダクトの統合 | 1〜n-1 番目のプロダクトだけ統合済み | 項目を `waiting` とし、統合済みのプロダクトを飛ばして n 番目から再開する |
|
|
546
548
|
| プロジェクトの統合 | 全プロダクトが統合済み、プロジェクトは未統合 | 項目を `waiting` とし、プロダクトを再統合せずプロジェクトの統合だけ再開する |
|
|
547
549
|
|
|
548
|
-
- リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
|
|
550
|
+
- リポジトリ別の状態(`pending` / `merged` / `unchanged` / `branch-only` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
|
|
549
551
|
- `block_reason` には、失敗したリポジトリ、統合済みのリポジトリ、未統合のリポジトリを記録します。
|
|
550
552
|
- 失敗後も全リポジトリの worktree と exec branch を保持します。原因を解消した後、`exec run --register <item-id> --worktree --resume` で統合段から再開します。agent は再実行しません。
|
|
551
|
-
- 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged
|
|
553
|
+
- 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)または方式が `branch-only` のプロダクトは取り込まず、exec branch に merge commit を作りません。
|
|
552
554
|
- 再開時は、統合先へ取り込み済みのプロダクトを merge し直さず、最初の統合で作った merge commit を result の trace 表へ記録します。
|
|
553
555
|
|
|
554
|
-
|
|
556
|
+
`branch-only` の保持はそのリポジトリの処理完了とします。これを除き、一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
|
|
@@ -262,6 +262,36 @@ rate_limit_policy:
|
|
|
262
262
|
|
|
263
263
|
この例では共有 defaults の検証は両 project に適用され、`specdojo-lp` の 2 件は `prj-0002` の run だけに適用されます。`prj-0001` は `specdojo-lp` を `repos` に持たなくても影響を受けません。共有側と project 側に同じ ID・同じ `repo` の組を書くと、合成後の重複として agent 起動前にエラーになります。project 固有の検証も親 runner が固定 argv で実行し、evidence には `source: runner` と実行先の `repo` が記録されます。
|
|
264
264
|
|
|
265
|
+
共有 defaults の検証を減らす場合は、`projects.<id>.run.parent_validations_exclude` に除外する検証を指定します。たとえば共有一覧が `lint-fm`・`lint-md`・`lint-ts`・`typecheck`・`test-unit`・`test-integration`・`validate-schema` の場合、文書と LP を扱う `prj-0002` だけで本体の検証を外す設定は次のとおりです。`exec-defaults.yaml` の複製は不要です。
|
|
266
|
+
|
|
267
|
+
```json
|
|
268
|
+
{
|
|
269
|
+
"projects": {
|
|
270
|
+
"prj-0001": {
|
|
271
|
+
"run": { "exec_defaults": ".specdojo/exec-defaults.yaml" }
|
|
272
|
+
},
|
|
273
|
+
"prj-0002": {
|
|
274
|
+
"repos": [{ "name": "specdojo-lp", "path": "../specdojo-lp" }],
|
|
275
|
+
"run": {
|
|
276
|
+
"exec_defaults": ".specdojo/exec-defaults.yaml",
|
|
277
|
+
"parent_validations_exclude": [
|
|
278
|
+
"lint-ts",
|
|
279
|
+
"typecheck",
|
|
280
|
+
"test-unit",
|
|
281
|
+
"test-integration",
|
|
282
|
+
"validate-schema"
|
|
283
|
+
],
|
|
284
|
+
"parent_validations": [{ "id": "typecheck", "repo": "specdojo-lp" }]
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
有効な一覧は「共有 defaults から除外 → project の追加」の順で求めます。この例の `prj-0002` では `lint-fm`・`lint-md`・`specdojo-lp` の `typecheck` だけが実行され、`prj-0001` の 7 件は変わりません。除外を省略するか `[]` にすると従来の追記動作を保ちます。検証以外の共有 defaults の設定も保持します。
|
|
292
|
+
|
|
293
|
+
除外の要素も ID または `{ id, repo }` です。ID だけなら `repo: project` と同じで、同じ ID のプロダクトリポジトリ向け検証は除外しません。除外先は共有一覧に存在する ID と実行先の組に限り、project の追加一覧からは除外しません。未知の ID、不正な要素、共有一覧に存在しない組の除外、除外一覧内または最終一覧内の組の重複は、agent 起動前に設定エラーになります。除外前の共有一覧自体も検証するため、除外で不正な共有設定を隠すことはできません。除外した組を追加一覧で末尾に戻すことはできます。
|
|
294
|
+
|
|
265
295
|
`wait` の待機中は、同一 worktree と register / pipeline の状態を別 run から保護するため project の実行ロックを保持します。register worktree の `--join` 実行は共有枠の範囲で引き続き動作できます。wait / fallback の再開時刻と切替元・切替先は pipeline state と executor evidence に記録されます。
|
|
266
296
|
|
|
267
297
|
### 5.1. register の難易度別振り分け
|
|
@@ -538,17 +568,17 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
538
568
|
|
|
539
569
|
agent が exec 実行時に読み込む provider 固有の設定(agent 定義・permission 設定)は、npm package 内の `templates/<provider>/` を配布原本とし、利用プロジェクトへコピーして使います。worktree 実行はコミット済み内容から worktree を作るため、コピーした設定は必ずコミットします。
|
|
540
570
|
|
|
541
|
-
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules
|
|
571
|
+
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
542
572
|
|
|
543
573
|
| provider | 配布内容 | 配置先 |
|
|
544
574
|
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
545
575
|
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
|
|
546
576
|
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
|
|
547
|
-
| opencode | `agents/*.md`(permission frontmatter 込みの agent
|
|
577
|
+
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
|
|
548
578
|
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
|
|
549
579
|
| antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
|
|
550
580
|
|
|
551
|
-
|
|
581
|
+
導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
|
|
552
582
|
|
|
553
583
|
`.specdojo/exec-defaults.yaml` の `providers.claude.command_template` には `--settings .specdojo/claude/settings.{mode}.json` を指定します。`--permission-mode bypassPermissions` は使いません(`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します)。
|
|
554
584
|
|
|
@@ -585,15 +615,15 @@ specdojo config scaffold --provider claude
|
|
|
585
615
|
|
|
586
616
|
`specdojo init --exec` と `config scaffold` が配布する agent の名簿と定義は、実体と別名の 2 段構成です(0.4.0 から)。実体は model の系統と役割で名付け、provider・`model`・役割を持ちます。従来の名前は `aliases` で実体を指す別名として残します。claude と opencode の agent の定義は役割(executor・review executor・reporter)ごとの 1 ファイルで `model` を持たず、`command_params.by_mode` で mode から定義を選び、model は実体の `model` を `--model {model}` で渡します。
|
|
587
617
|
|
|
588
|
-
| provider | init が生成する実体
|
|
589
|
-
| ----------- |
|
|
590
|
-
| claude | `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter`
|
|
591
|
-
| claude | `opus-executor`・`opus-review-executor`(expert)
|
|
592
|
-
| codex | `luna-executor`・`luna-review-executor`・`luna-reporter`
|
|
593
|
-
| codex | `sol-executor`・`sol-review-executor`(expert)
|
|
594
|
-
| opencode | `gemma-executor`・`gemma-review-executor`・`gemma-reporter`
|
|
595
|
-
| antigravity | `flash-executor`・`flash-review-executor`・`flash-reporter`
|
|
596
|
-
| copilot | `copilot-executor`・`copilot-review-executor`・`copilot-reporter`
|
|
618
|
+
| provider | init が生成する実体 | 別名(従来の名前) | model の書き場所 |
|
|
619
|
+
| ----------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------- |
|
|
620
|
+
| claude | `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter` | `claude-executor`・`claude-review-executor`・`claude-reporter` | 実体の `model`(`sonnet`) |
|
|
621
|
+
| claude | `opus-executor`・`opus-review-executor`(expert) | `claude-expert-executor`・`claude-expert-review-executor` | 実体の `model`(`opus`) |
|
|
622
|
+
| codex | `luna-executor`・`luna-review-executor`・`luna-reporter` | `codex-executor`・`codex-review-executor`・`codex-reporter` | 実体の `model`(`gpt-6-luna`、effort は `by_proficiency`) |
|
|
623
|
+
| codex | `sol-executor`・`sol-review-executor`(expert) | `codex-expert-executor`・`codex-expert-review-executor` | 実体の `model`(`gpt-6.1-sol`、effort は `by_proficiency`) |
|
|
624
|
+
| opencode | `gemma-executor`・`gemma-review-executor`・`gemma-reporter`、`qwen-executor`・`qwen-review-executor`・`qwen-reporter` | `opencode-executor`・`opencode-review-executor`・`opencode-reporter` | 実体の `model`(`opencode.json` の provider 名込み、原則 `*-mlx-work-64k`) |
|
|
625
|
+
| antigravity | `flash-executor`・`flash-review-executor`・`flash-reporter` | `agy-executor`・`agy-review-executor`・`agy-reporter` | 実体の `model`(推論強度を含む ID) |
|
|
626
|
+
| copilot | `copilot-executor`・`copilot-review-executor`・`copilot-reporter` | なし(`--model auto` で model を自動選択するため系統で名付けない) | `command_template` の `--model auto` |
|
|
597
627
|
|
|
598
628
|
claude と codex は normal と expert の 2 段を持ちます(0.4.6 から)。expert の実体には `proficiency: expert` を付けます。init が書く振り分けの表(`routing`)は、hard を expert の別名(`claude-expert-executor`・`codex-expert-executor`)、medium と easy を normal の別名にし、reporter はどの難易度でも normal の別名にします。expert の段がない provider(opencode・antigravity など)は、hard も normal の別名を使います。codex の reasoning effort は `by_proficiency` で normal が `medium`、expert が `high` で、`gpt-6-luna` は Max までしか受け付けないため Ultra を割り当てません。
|
|
599
629
|
|
|
@@ -779,6 +809,8 @@ runner は agent の各試行前後でファイル内容を比較し、差分が
|
|
|
779
809
|
|
|
780
810
|
agentと親検証の子プロセスを起動する際は、`gitEnvironment()`で`GIT_DIR`、`GIT_WORK_TREE`、`GIT_COMMON_DIR`、index・object・replace関連のrepository固有環境変数を除去します。除去対象は`src/shared/git-environment.ts`の`GIT_LOCAL_ENV_VARS`を正本とします。Vitestの全3設定も共通setupを使ってtest module読込前に同じ変数をworkerから除去するため、Git hook経由で`npm test`が起動されても、テストfixtureはcwdの一時repositoryを参照し、linked worktreeのgitdirや共有configを参照しません。
|
|
781
811
|
|
|
812
|
+
Vitestの共通setupは、シェルから継承した`SPECDOJO_PROJECT`も除去します。これにより、orchestratorの対象projectがテストfixtureの設定に存在しなくても、unit・integrationのworkerとその子プロセスはfixture側の設定からprojectを解決できます。project選択を検証するテスト自身がsetupの後に設定する`SPECDOJO_PROJECT`は有効です。
|
|
813
|
+
|
|
782
814
|
TypeScriptのテスト・tool・本体コードが`spawnSync`、`spawn`、`execFileSync`、`execFile`でGitを直接起動する箇所は、AST検査により`gitEnvironment()`から作った`env`だけを許可します。`env: process.env`や単なる`env`プロパティは隔離済みとは扱いません。shell scriptとnpm scriptのGit起動はこのAST検査の対象外ですが、現状のhook経路はVitest setupを必ず通り、hookから直接Gitを起動するテスト用scriptはありません。今後その経路を追加する場合は、入口で`GIT_LOCAL_ENV_VARS`相当を除去する専用検査を追加します。
|
|
783
815
|
|
|
784
816
|
executor / reporter pipelineのexecutor promptは、commitとrepository設定を親runnerが所有することを明記し、`git commit`およびlocal / global / system configの変更(`user.name` / `user.email`を含む)を禁止します。fixture commitに使うテスト用identityはVitest workerと子プロセスの環境変数だけへ注入し、fixtureを含むrepositoryのlocal configへは書き込みません。
|
|
@@ -43,25 +43,26 @@ exec が扱う関心事、タスクの出どころによる実行経路の選び
|
|
|
43
43
|
|
|
44
44
|
### 1.2. 実行経路の使い分け
|
|
45
45
|
|
|
46
|
-
agent
|
|
47
|
-
|
|
48
|
-
| 観点 |
|
|
49
|
-
| ------------ |
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
46
|
+
agent にタスクを実行させる経路には、業務の起点・着手承認・完了判断を担う register と、成果物カタログに基づく途中の進み具合を担う schedule があります。両者は同格の 2 経路ではなく、register を親、schedule を子とする階層関係にあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(register の項目 / schedule のタスク)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
|
|
47
|
+
|
|
48
|
+
| 観点 | register 実行(親: 起点・承認・完了) | schedule 実行(子: 途中の進捗・依存実行) | routine(トリガー層) |
|
|
49
|
+
| ------------ | --------------------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------- |
|
|
50
|
+
| 役割 | 業務の起点、着手承認、完了判断、単発の調査・対応 | 成果物の依存関係に基づく進捗管理・実行 | 定期起動・スケジューリング |
|
|
51
|
+
| 実行対象 | `generated/pjr-index.md` の項目(todo / issue / change-request 等) | `sch-track-*.yaml` のタスク(依存グラフ) | `rtn-*.yaml` の定義(実体は左の 2 経路) |
|
|
52
|
+
| 代表コマンド | `exec run --register` | `exec run --task` / `exec run --auto` | `routine run --due` |
|
|
53
|
+
| 起動 | 人、または routine(`job-register-sweep`) | 人、または routine(`job-exec-auto`) | 外部スケジューラ(cron / CI) |
|
|
54
|
+
| 状態追跡 | register の遷移(in-progress / review / waiting) | exec events(claim / complete / block) | `last_run` の記録のみ |
|
|
55
|
+
| 隔離 | `run.register_execution` または CLI で選択 | worktree(`--worktree` / `--auto`) | -(実行経路へ委譲) |
|
|
56
|
+
| 終端の扱い | 人が確認して `register close`(epic も人が判断) | `complete` event(human finalize で確定) | -(発火の記録のみ) |
|
|
57
|
+
| 典型用途 | 課題・判断、track の epic 起票、カタログ・strategy 計画、計画外の対応・調査 | 計画された成果物群の作成・レビュー・確定 | 日次スイープ・夜間バッチなどの定期実行 |
|
|
57
58
|
|
|
58
59
|
迷った場合は次で判断します。
|
|
59
60
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
61
|
+
- 業務の起点・着手承認・完了判断、未整理な課題や判断、単発の対応・調査、およびカタログや strategy の計画は register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。まとまった仕事は track ごとに `epic` を起票する。手順は [登録簿運用ガイド](register-operation-guide.md))。
|
|
62
|
+
- `epic` のもとで成果物カタログと依存関係を展開し、途中の進み具合を管理しながら進める作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
|
|
63
|
+
- 上記のいずれかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
|
|
63
64
|
|
|
64
|
-
register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate
|
|
65
|
+
register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。まとまった仕事は track ごとに `epic` を起票し、その子 todo でカタログ作成(`catalog-planning`)や strategy 作成(`strategy-planning`)を進めて schedule へ展開します。途中の進み具合は schedule が持ち、トラック完了時に人が `epic` の完了を判断して close します。
|
|
65
66
|
|
|
66
67
|
登録の判断、type の選び方、個票の作成などの台帳運用は [登録簿運用ガイド](register-operation-guide.md) を参照します。
|
|
67
68
|
|
|
@@ -90,6 +91,10 @@ register 実行は exec events を記録しないため、schedule の Ready・C
|
|
|
90
91
|
|
|
91
92
|
worktree の checkpoint 作成時に root の index に staged 変更がある場合、checkpoint 対象の plan、result、event、登録簿記帳と重なるパスだけを停止理由にします。重ならない staged 変更はパスを警告へ表示して保持したまま実行を続けます。checkpoint または register の runner commit が失敗した場合も、runner が対象にしたパスだけを unstage し、無関係な staged 変更は変更しません。
|
|
92
93
|
|
|
94
|
+
grade の結果・完了条件・未完了段のサイドカー(`execution_path/grade/results/`、`criteria/`、`pipeline/`)の未コミット変更も checkpoint に含めます。worktree は分岐前の評価結果を読み取り、更新したサイドカーを統合します。分岐後に root で同じサイドカーが更新された場合は、古い評価で上書きしないよう統合を止めます。両側の評価対象と内容を照合してから再開してください。
|
|
95
|
+
|
|
96
|
+
schedule の review 前の評価は、同じ package の `grade run` を起動します。最新の評価結果は再利用し、必要な評価では選択済み review agent の実体名と起動設定を引き継ぎます。開発用スクリプトの配置は不要です。失敗時は対象文書と理由を review plan に示し、review が評価結果の鮮度・利用可否を判断します。`viewpoints_path` がない project では同梱の `specdojo:pm-review-viewpoints` を参照し、固有の差分が必要なら設定したパスへ `exec scaffold --project <id>` で雛形を生成します。
|
|
97
|
+
|
|
93
98
|
register 実行の場所は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選びます。設定がない既存リポジトリは互換性のため in-place のままです。CLI の `--worktree` / `--in-place` は設定を上書きし、両方を同時に指定するとエラーになります。
|
|
94
99
|
|
|
95
100
|
通常は、失敗時の変更を隔離でき、`--resume` / `--force-restart` を使える worktree を選びます。worktree の準備時間が作業時間に見合わない、変更対象が小さく、失敗時に作業ツリーへ残る差分をその場で整理できる場合だけ `--in-place` を使います。in-place では `--resume` / `--force-restart` / `--join` と `--parallel` は使えません。`--register-commit` は in-place だけで意味を持ち、worktree は常に checkpoint と統合 commit を作ります。
|
|
@@ -17,7 +17,7 @@ Orchestrator Operation Guide
|
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
-
|
|
20
|
+
- オーケストレーターの位置づけ、起動用スクリプト、VS Code からの使い方、対話フロー、承認と安全の扱い、設定ファイルの構成
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
@@ -109,6 +109,24 @@ npx specdojo config scaffold --provider antigravity --global
|
|
|
109
109
|
|
|
110
110
|
分離環境が必要な場合は、追加の任意手順として `devcontainer scaffold` を利用できます。既存の `.devcontainer/` は上書きされず、provider の設定ディレクトリは名前付きボリュームへ保存されます。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `devcontainer` を参照してください。
|
|
111
111
|
|
|
112
|
+
### 2.2. VS Code から使う
|
|
113
|
+
|
|
114
|
+
VS Code の各種 AI 拡張機能からオーケストレーターを利用することもできます。拡張機能ごとの起動手順は次のとおりです。
|
|
115
|
+
|
|
116
|
+
- **GitHub Copilot Chat**:
|
|
117
|
+
`npx specdojo config scaffold --provider copilot` を実行して設定を配置した後、VS Code の Copilot Chat パネルで agent の選択肢から `specdojo-orchestrator` を選びます(`.github/agents/specdojo-orchestrator.md` が読み込まれます)。
|
|
118
|
+
- **Claude Code 拡張**:
|
|
119
|
+
設定(settings)の `agent` キーに `specdojo-orchestrator` を設定すると、セッションがオーケストレーターとして開始されます。共有の `.claude/settings.json` に書くとそのリポジトリを利用する全員のすべてのセッションが対象になるため、各自のローカル設定である `.claude/settings.local.json` に記述することを推奨します。
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"agent": "specdojo-orchestrator"
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
- **Codex 拡張**:
|
|
128
|
+
Codex の VS Code 拡張(`Codex – OpenAI's coding agent`)で名前付きの agent の定義を選ぶ仕組みは、公式の文書では確かめられていません(2026-10 時点で未確認)。そのため、会話開始時に SSOT である `.agents/specdojo-orchestrator.agent.md` の本文を最初の指示(プロンプト)として渡して対話を開始します。
|
|
129
|
+
|
|
112
130
|
## 3. 対話の進め方
|
|
113
131
|
|
|
114
132
|
オーケストレーターは「提案 → 承認 → 実行」を基本とします。
|
|
@@ -145,7 +145,9 @@ plan の構造と生成規則は schema・本ガイド・各テンプレート
|
|
|
145
145
|
|
|
146
146
|
`approach` が指定されていれば `xep-fully-guided-template.md`、`xep-recipe-guided-template.md`、`xep-freeform-template.md`、`xep-retrofit-template.md`、`xep-rulebook-maintenance-template.md` のような approach 別テンプレートを優先します。該当テンプレートが存在しない場合は標準テンプレートにフォールバックします。
|
|
147
147
|
|
|
148
|
-
|
|
148
|
+
register のカタログなしの成果物 plan は、個票の `target_path`・`target_rulebook` または既存文書の索引と frontmatter から対象を解決します。カタログの `done_criteria` がないことを明記し、個票の完了条件と rulebook を使います。`bootstrap` は未作成 kata の ID・パスと参照宣言の指示、`finalize`・`bootstrap-finalize` は既存成果物の確認チェック表と確定対象を plan に載せます。実 agent は `status: ready` への昇格を行いません。対象と起票の条件は [[specdojo:command-reference]] を参照してください。
|
|
149
|
+
|
|
150
|
+
`approach: retrofit` では、対象成果物の DCT エントリに宣言された `evidence_refs` を edit / review plan の「実装エビデンス」へ展開します。カタログ経由で `evidence_refs` がない場合は plan 生成をエラーにします。カタログなしでは実装の調査パスを個票に明記して調査入力とします。実装エビデンスは調査入力であり、frontmatter の `targets` には追加しません。実行者は実際に参照したパス、抽出した現在動作、成果物との一致・乖離、未確認範囲を result に記録します。
|
|
149
151
|
|
|
150
152
|
実践の型の扱いは [実践の進め方ガイド](ryu-guide.md) を参照します。
|
|
151
153
|
|
|
@@ -64,6 +64,8 @@ package の探索では `node_modules` 全体を再帰走査せず、resolver
|
|
|
64
64
|
|
|
65
65
|
template は記述する部分を _TODO_ などのプレースホルダとして配置した雛形で、内容が埋まった完成例である sample と役割を分担します。
|
|
66
66
|
|
|
67
|
+
sample は成果物として成り立つ完成例であり、template の `type: template` と異なり、見本にする成果物の type を持ちます。`type` と sample の識別の原則は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
|
|
68
|
+
|
|
67
69
|
ここでいう `reference` は文書種別です。exec plan が実行時に参照する実践の型(rulebook / recipe / sample / template)とは別の役割として扱います。
|
|
68
70
|
|
|
69
71
|
## 3. 種別間の関係と成果物への紐付け
|
|
@@ -27,7 +27,7 @@ SpecDojo CLI の初期設定から始め、register で課題と判断を整理
|
|
|
27
27
|
- register のtypeと状態遷移は [登録簿運用ガイド](register-operation-guide.md) を参照してください。
|
|
28
28
|
- Scheduleの自動・手動実行は [Schedule実行運用ガイド](schedule-operation-guide.md)、agent設定は [exec設定ガイド](exec-config-guide.md) を参照してください。
|
|
29
29
|
|
|
30
|
-
各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo`
|
|
30
|
+
各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo` サブコマンドへ変換し、状態を変える操作は実行前に内容を提示して承認を求めます。オーケストレーターはターミナル(`npm run orch:<provider>`)だけでなく、VS Code の各種拡張機能(Copilot Chat、Claude Code、Codex)からも利用できます。導入先での設定と起動方法は [オーケストレーター運用ガイド](orchestrator-operation-guide.md)(VS Code からの利用は [VS Code から使う](orchestrator-operation-guide.md#22-vs-code-から使う) 節)を参照してください。`<project-id>` などのプレースホルダは実際の値に読み替えてください。
|
|
31
31
|
|
|
32
32
|
## 1. 10分で体験する — 仕様の判断台帳
|
|
33
33
|
|
|
@@ -336,6 +336,15 @@ npx specdojo config init
|
|
|
336
336
|
|
|
337
337
|
`specdojo config init` は `.specdojo/specdojo.config.json` が存在しない場合に雛形を作成し、既存ファイルは上書きしません。雛形は register だけを使える最小構成であり、project パスはリポジトリルートを基準とし、`run.worktree_base` はディレクトリ名から作る `../<リポジトリ名>-worktrees` を指します。例えば `app1-specdojo/` では `../app1-specdojo-worktrees` です。作成された設定を開き、対象プロジェクトの ID と各パスを実際の名前に合わせてください。catalog、schedule、exec へ進むときに追加するキーと既定値は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] で確認できます。
|
|
338
338
|
|
|
339
|
+
通常の `init` と `config init` は、markdownlint の設定がなければリポジトリ直下に
|
|
340
|
+
`.markdownlint.yaml` も作ります。日本語の長い行などを許容するため、MD013・MD024・MD033・MD036・MD041・MD060
|
|
341
|
+
を無効にし、ほかの記法検査は維持します。既存の設定は上書きしません。既存の利用リポジトリでも
|
|
342
|
+
`npx specdojo config init --dry-run` で確認してから `npx specdojo config init` を再実行すると、
|
|
343
|
+
不足する設定を追加できます。設定がないままでも、exec の result の commit 前検査は同じ基本規則を使います。
|
|
344
|
+
既存設定で MD013 が有効ならその指定を優先するため、長い行を許容する場合は利用側の設定で
|
|
345
|
+
`MD013: false` を指定してください。CLI2 と hook の設定の関係は
|
|
346
|
+
[[specdojo:command-reference|CLIコマンドリファレンス]] を参照してください。
|
|
347
|
+
|
|
339
348
|
プロダクト文書は `app1/docs/ja/product/`、プロジェクト文書は `app1-specdojo/docs/ja/projects/` に置きます。同梱の SpecDojo の型(Kata)は `app1-specdojo/docs/ja/specdojo/<種類>s/`、このリポジトリで新しく作る kata はその下の `<kata_authority>/` から解決します。現行実装では1つの項目で両リポジトリを自動統合できないため、プロダクト文書や実装も変更する項目は分けるか、人が統合を管理します。詳細は [ドキュメント構成ガイド](docs-structure-guide.md) の `別リポジトリ構成` を参照してください。
|
|
340
349
|
|
|
341
350
|
成果物と実装を常に同じ変更・履歴として扱う場合に限り、**同一リポジトリ構成**としてプロダクトリポジトリのルートで同じ初期化手順を実行できます。CLI は構成を強制しません。
|
|
@@ -363,8 +372,11 @@ npm install
|
|
|
363
372
|
markdownlint で検査します。対象 project の `project_register_path` 配下を変更した場合は
|
|
364
373
|
`register build`、`catalog_path` 配下を変更した場合は `catalog validate` も実行します。
|
|
365
374
|
`catalog_path` がない構成には catalog の検査を生成せず、時間のかかるテストも pre-commit には
|
|
366
|
-
|
|
367
|
-
`.
|
|
375
|
+
含めません。設定がなければ、同じ基本規則の `.markdownlintrc` と VS Code 向けの
|
|
376
|
+
`.markdownlint-cli2.yaml`、provider の agent 定義を検査から外す `.markdownlintignore` も生成します。
|
|
377
|
+
`init --lefthook` / `--slidev` もこの配置を使います。既存の `.markdownlint.yaml` などの設定と ignore は
|
|
378
|
+
`--force` を付けても保持します。CLI2 の overrides を使う場合は
|
|
379
|
+
[[specdojo:command-reference|CLIコマンドリファレンス]] の手順で既存設定を `.markdownlintrc` に移してください。
|
|
368
380
|
`lefthook.yml` と `tools/` の既存ファイルは `--force` なしでは上書きしません。
|
|
369
381
|
必要な npm script と devDependencies は書き込み前に表示し、同名の既存項目は `--force` を付けても
|
|
370
382
|
保持します。linked worktree または `node_modules` がない環境では installer が安全に skip するため、
|
|
@@ -554,7 +566,7 @@ risk は必要なら `exec run --register` で軽減策を実行できます。n
|
|
|
554
566
|
|
|
555
567
|
### 3.6. 成果物を作る・直す
|
|
556
568
|
|
|
557
|
-
**こんなとき:**
|
|
569
|
+
**こんなとき:** 1 文書を、利用できる kata の整備状況に合う進め方で作成・更新したいとき。
|
|
558
570
|
|
|
559
571
|
| `approach` | 選ぶ状況 |
|
|
560
572
|
| --------------- | ---------------------------------------------------------------- |
|
|
@@ -578,7 +590,23 @@ npx specdojo exec run \
|
|
|
578
590
|
--worktree
|
|
579
591
|
```
|
|
580
592
|
|
|
581
|
-
`recipe-guided
|
|
593
|
+
`recipe-guided`・`freeform`・`retrofit` を使う場合は、上の `--approach fully-guided` を選んだ値へ置き換えます。`--target` は成果物の doc id を 1 件指定します。カタログにある対象は従来どおりカタログの `done_criteria` と個票の完了条件を使います。
|
|
594
|
+
|
|
595
|
+
カタログがない場合、既存文書は文書索引からパスと frontmatter の `specdojo.rulebook` を辿れます。これから作る文書は、次のようにリポジトリ相対のパスと rulebook ID を個票に保存します。
|
|
596
|
+
|
|
597
|
+
```bash
|
|
598
|
+
npx specdojo register add \
|
|
599
|
+
--project <project-id> --type todo \
|
|
600
|
+
--title "文書を実践の型に沿って作る" --topic create-document \
|
|
601
|
+
--approach fully-guided --target <deliverable-doc-id> \
|
|
602
|
+
--target-path docs/ja/product/example.md \
|
|
603
|
+
--target-rulebook <kata-authority>:example-rulebook
|
|
604
|
+
npx specdojo exec plan --project <project-id> --register <PJR-ID>
|
|
605
|
+
```
|
|
606
|
+
|
|
607
|
+
`--target-rulebook` の rulebook と、そこから参照する必要な kata は先に用意します。`fully-guided` は `not-needed` と宣言された型を除く一式、`recipe-guided` は recipe が必要です。不足する型は起票時に名前を示して停止します。個票の「完了条件」を具体化してから実行してください。カタログなしの完了基準は個票の完了条件と rulebook です。`retrofit` では調べる実装のパスも個票に明記します。
|
|
608
|
+
|
|
609
|
+
パスと rulebook は `register update --target-path <path> --target-rulebook <doc-id>` で更新でき、それぞれ `-` で削除できます。既存文書のパスや `specdojo.rulebook` と指定が食い違う場合は停止します。カタログ設定済みで対象が未登録の場合は、この 2 つを明示したときだけ同じ解決を使います。
|
|
582
610
|
|
|
583
611
|
### 3.7. 成果物とkataを一組で作る
|
|
584
612
|
|
|
@@ -600,6 +628,10 @@ npx specdojo exec run \
|
|
|
600
628
|
--worktree
|
|
601
629
|
```
|
|
602
630
|
|
|
631
|
+
カタログなしの `bootstrap` では、上の起票に `--target-path docs/ja/product/example.md --target-rulebook <kata-authority>:example-rulebook` を追加し、設定ファイルに `kata_authority` を指定します。新しい rulebook ID が必要で、既存 ID は受け付けません。plan は `docs/ja/specdojo/<kind>s/<kata-authority>/example-<kind>.md` に未作成の kata を示し、成果物の `specdojo.rulebook` と rulebook の kata 参照を記入するよう指示します。
|
|
632
|
+
|
|
633
|
+
`finalize`・`bootstrap-finalize` は既存文書だけを対象にできます。カタログなしでは個票の完了条件をチェック表にし、人が成果物を確定します。`bootstrap-finalize` は frontmatter から辿る kata 一式も確定対象です。`cross-deliverable-dedup` は成果物群を扱うためカタログが必要です。
|
|
634
|
+
|
|
603
635
|
`bootstrap` は初期整備用です。既に信頼できる kata が揃っている成果物の通常改訂には `fully-guided` を使います。
|
|
604
636
|
|
|
605
637
|
### 3.8. kataを直す
|
|
@@ -774,16 +806,17 @@ npx specdojo register add \
|
|
|
774
806
|
|
|
775
807
|
どちらも別 project への起票では `--commit` が必須です。別リポジトリでは、相手に SpecDojo 0.4.2 以上と対象 project の統合ブランチが必要です。push は行わず、close などの状態遷移は対象 project の作業ツリーで行います。
|
|
776
808
|
|
|
777
|
-
### 3.14. issueからdecision、
|
|
809
|
+
### 3.14. issueからdecision、epic、成果物カタログ・Scheduleへ進む
|
|
778
810
|
|
|
779
|
-
|
|
811
|
+
プロジェクト立ち上げ時に、問題、判断、実施作業がまだ混在している場合は、次の順で具体化します。register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。
|
|
780
812
|
|
|
781
813
|
```text
|
|
782
814
|
issue(何が問題か)
|
|
783
815
|
-> decision(何を対象とするか)
|
|
784
|
-
->
|
|
785
|
-
->
|
|
786
|
-
-> schedule
|
|
816
|
+
-> epic(track の仕事を起票する)
|
|
817
|
+
-> 子 todo(成果物カタログや strategy を作成する)
|
|
818
|
+
-> schedule(成果物タスクの実行と進捗)
|
|
819
|
+
-> epic を完了する(人が判断)
|
|
787
820
|
```
|
|
788
821
|
|
|
789
822
|
```bash
|
|
@@ -801,22 +834,32 @@ npx specdojo register add \
|
|
|
801
834
|
--title "初期スコープと対象成果物を決定する" \
|
|
802
835
|
--topic decide-initial-scope
|
|
803
836
|
|
|
804
|
-
#
|
|
837
|
+
# チャット:「launch トラックの epic を起票して」
|
|
838
|
+
npx specdojo register add \
|
|
839
|
+
--project <project-id> \
|
|
840
|
+
--type epic \
|
|
841
|
+
--track launch \
|
|
842
|
+
--title "プロジェクト定義の仕様整備" \
|
|
843
|
+
--topic project-definition
|
|
844
|
+
|
|
845
|
+
# チャット:「epic から子 todo『成果物カタログを作成する』を起票して」
|
|
805
846
|
npx specdojo register add \
|
|
806
847
|
--project <project-id> \
|
|
807
848
|
--type todo \
|
|
808
|
-
--
|
|
849
|
+
--from <epic-id> \
|
|
809
850
|
--title "プロジェクト定義の成果物カタログを作成する" \
|
|
810
|
-
--topic create-project-definition-catalog
|
|
851
|
+
--topic create-project-definition-catalog \
|
|
852
|
+
--approach catalog-planning \
|
|
853
|
+
--target domain:project-definition
|
|
811
854
|
```
|
|
812
855
|
|
|
813
|
-
issue の調査結果を decision の選択肢へ、decision の結論を todo
|
|
856
|
+
issue の調査結果を decision の選択肢へ、decision の結論を track の `epic` とその子 todo へ引き継ぎます。decision は人が確定します。issue や子 todo は provider 未設定でも `exec plan --project <project-id> --register <PJR-ID>` で計画を確認でき、agent 設定後は `exec run --project <project-id> --register <PJR-ID> --worktree` で実行できます(`epic` 自体は実行対象外です)。
|
|
814
857
|
|
|
815
|
-
すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml`
|
|
858
|
+
すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml` を作成・検証した後に完了させます。todo の完了により `catalog_status` が `primary` と導出され、strategy 作成と Schedule への展開(`schedule build --track launch`)が可能になります。成果物タスクの途中の進捗は schedule の依存グラフで管理し、登録簿に個々の成果物タスクを二重管理しません。トラック完了時に人が `epic` を close します。
|
|
816
859
|
|
|
817
860
|
## 4. 発展: 成果物カタログからscheduleへ展開する
|
|
818
861
|
|
|
819
|
-
|
|
862
|
+
この経路では、epic の子 todo から成果物カタログ(`dct-<domain>.yaml`)とトラック戦略(`sch-strategy-<track>.yaml`)を作成して Schedule を生成し、依存関係に従ってタスクを実行します。
|
|
820
863
|
|
|
821
864
|
### 4.1. 成果物カタログを作成する
|
|
822
865
|
|