specdojo 0.4.7 → 0.6.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 +16 -9
- package/CHANGELOG.md +106 -0
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/init.js +4 -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/deliverable/deliverable.js +77 -4
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/core.js +3 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +49 -3
- package/dist/exec/plans-generation.js +48 -8
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +6 -2
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register.js +22 -1
- package/dist/exec/repo-integration-sync.js +11 -0
- package/dist/exec/repo-integration.js +58 -6
- package/dist/exec/repo-trace.js +19 -4
- package/dist/exec/results.js +11 -5
- package/dist/exec/run/register-command.js +16 -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 +33 -1
- package/dist/exec/run/register-worktree.js +52 -8
- package/dist/exec/run/schedule-prepare.js +7 -3
- package/dist/exec/strategy.js +4 -1
- package/dist/exec/task-repos.js +92 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree.js +3 -3
- package/dist/grade/apply.js +6 -2
- package/dist/grade/markdown.js +7 -2
- package/dist/grade/plan.js +6 -4
- package/dist/register/approach.js +19 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +8 -0
- package/dist/register/create-commands.js +86 -4
- package/dist/register/deliverable-target.js +24 -17
- 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 +9 -2
- package/dist/register/events.js +10 -0
- package/dist/register/external-project.js +6 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +71 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +7 -3
- package/dist/register/renumber.js +16 -4
- package/dist/register/update.js +6 -0
- package/dist/register/views.js +55 -4
- package/dist/schedule/approach.js +9 -0
- 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 +22 -2
- package/dist/shared/agent-types.js +7 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -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/specdojo-config.js +42 -4
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- 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 +3 -1
- package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +58 -16
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
- 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/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
- package/docs/ja/specdojo/references/command-reference.md +86 -15
- package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -8
- 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 +9 -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 +54 -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 +4 -1
- 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/dct-sample.yaml +5 -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 +44 -3
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- 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/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- 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/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 +21 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
- package/package.json +4 -3
- package/templates/antigravity/orchestrator.md +16 -9
- package/templates/claude/agents/specdojo-orchestrator.md +16 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
- package/templates/codex/orchestrator.md +16 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
- package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
|
@@ -101,6 +101,20 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
|
|
|
101
101
|
書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
|
|
102
102
|
`antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
|
|
103
103
|
|
|
104
|
+
通常の `init` と `config init` は、markdownlint の設定がなければリポジトリ直下に
|
|
105
|
+
`.markdownlint.yaml` を作成します。SpecDojo の文書規約に合わせて MD013(行長)、MD024(見出しの重複)、
|
|
106
|
+
MD033(HTML)、MD036(強調だけの行)、MD041(先頭の H1)、MD060(表の列幅)を無効にします。
|
|
107
|
+
それ以外は markdownlint の既定の規則を使います。既存の `.markdownlint.*`・`.markdownlintrc`・
|
|
108
|
+
`.markdownlint-cli2.*` は保持し、競合する設定は追加しません。`--dry-run` は設定を書き込みません。
|
|
109
|
+
`init --lefthook` / `--slidev` では、後述の `.markdownlintrc` と CLI2 設定の配置を使います。
|
|
110
|
+
|
|
111
|
+
既存リポジトリでは `specdojo config init --dry-run` を確認してから `specdojo config init` を再実行すると、
|
|
112
|
+
SpecDojo の設定ファイルが既にあっても markdownlint の不足設定を追加できます。既存の規則を変更する場合は
|
|
113
|
+
利用側で編集してください。特に MD013 が有効な場合、長い行を許容するには `MD013: false` を設定します。
|
|
114
|
+
exec の result の commit 前検査は markdownlint-cli が読む利用リポジトリの設定(親ディレクトリの
|
|
115
|
+
`.markdownlintrc` を含む)を優先し、設定がなければ上記の6規則だけをコマンド引数で無効にします。
|
|
116
|
+
フォールバック用ファイルは利用リポジトリに作りません。CLI2 専用設定はこの検査では読みません。
|
|
117
|
+
|
|
104
118
|
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
|
|
105
119
|
|
|
106
120
|
`antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
|
|
@@ -282,16 +296,19 @@ specdojo config scaffold --workspace --force
|
|
|
282
296
|
|
|
283
297
|
主要オプション:
|
|
284
298
|
|
|
285
|
-
| オプション
|
|
286
|
-
|
|
|
287
|
-
| `--size <size>`
|
|
288
|
-
| `--project-id <id>`
|
|
289
|
-
| `--domain <domain>`
|
|
290
|
-
| `--var <NAME=value>`
|
|
291
|
-
| `--plan`
|
|
292
|
-
| `--dry-run`
|
|
293
|
-
| `--dct <name>`
|
|
294
|
-
| `--
|
|
299
|
+
| オプション | 用途 |
|
|
300
|
+
| ------------------------------ | ---------------------------------------------------------------------------------- |
|
|
301
|
+
| `--size <size>` | `small` / `medium` / `large` の成果物セットを選ぶ |
|
|
302
|
+
| `--project-id <id>` | 生成ファイルに埋め込む project ID を上書きする |
|
|
303
|
+
| `--domain <domain>` | `catalog scaffold` の対象をtemplateの`domain`で絞る(反復・カンマ区切り) |
|
|
304
|
+
| `--var <NAME=value>` | `catalog scaffold` で`_NAME_` placeholderを置換する(反復可能) |
|
|
305
|
+
| `--plan` | 保存済みの `dct-plan-<domain>.yaml` から決定論的に生成する |
|
|
306
|
+
| `--dry-run` | `--plan` の生成結果と既存ファイルとの差分を、書き込まずに表示する |
|
|
307
|
+
| `--dct <name>` | `deliverable scaffold` の対象を特定の `dct-*.yaml` に絞る(後述) |
|
|
308
|
+
| `--target <doc-id>` | `deliverable scaffold` で特定の成果物 1 件だけを雛形にする(`--dct` との併用不可) |
|
|
309
|
+
| `--target-path <path>` | カタログにない成果物の配置パス(`--target` と `--target-rulebook` と併用) |
|
|
310
|
+
| `--target-rulebook <rulebook>` | カタログにない成果物の rulebook 文書 ID(`--target` と `--target-path` と併用) |
|
|
311
|
+
| `--force` | 既存ファイルを上書きする |
|
|
295
312
|
|
|
296
313
|
`catalog scaffold`は、`--domain`を省略すると従来どおりすべてのDCT templateを対象にします。指定した場合は、ファイル名ではなくtemplate内の`domain`が一致するものだけを生成します。存在しないdomainを指定した場合は、部分的な生成を行わずエラーで終了します。
|
|
297
314
|
|
|
@@ -316,6 +333,22 @@ specdojo deliverable scaffold --project prj-0001 --dct project-definition
|
|
|
316
333
|
specdojo deliverable scaffold --project prj-0001 --dct dct-project-definition.yaml,dct-project-management.yaml
|
|
317
334
|
```
|
|
318
335
|
|
|
336
|
+
`--target <doc-id>` で成果物を 1 件だけ指定して雛形を作成できます(`--dct` とは併用できません)。カタログに登録されている成果物は、カタログの配置・rulebook・template の情報から 1 件だけ雛形を生成します。
|
|
337
|
+
|
|
338
|
+
カタログにない成果物は `--target-path <path>` と `--target-rulebook <rulebook>` をあわせて指定することで雛形を作成できます。パスの検証(リポジトリの中か、ファイル名か、ほかの文書が使っていないか)は register の `--target-path` と同じ規則で行われます。
|
|
339
|
+
|
|
340
|
+
`--dry-run` を指定するとファイルへの書き込みを行わず、作成予定(`Would create: <path>`)のみを表示します。既存ファイルがある場合は、`--force` が指定されていない限りスキップされます。
|
|
341
|
+
|
|
342
|
+
```bash
|
|
343
|
+
# カタログにある成果物を 1 件だけ雛形にする
|
|
344
|
+
specdojo deliverable scaffold --project prj-0001 --target prj-charter
|
|
345
|
+
|
|
346
|
+
# カタログにない成果物を雛形にする
|
|
347
|
+
specdojo deliverable scaffold --project prj-0001 --target my-spec \
|
|
348
|
+
--target-path docs/ja/product/my-spec.md \
|
|
349
|
+
--target-rulebook specdojo:cdfd-rulebook
|
|
350
|
+
```
|
|
351
|
+
|
|
319
352
|
`deliverable scaffold` の生成方針と `specdojo build` に含めない理由は [遂行の技活用ガイド](../guides/waza-guide.md) の `deliverable scaffold の生成方針`、生成系動詞の使い分けは同ガイドの `生成系動詞の標準`、成果物カタログから Schedule への展開は [Schedule設計ガイド](../guides/schedule-design-guide.md) の `成果物カタログとの責務分担` を参照します。
|
|
320
353
|
|
|
321
354
|
### 3.1. catalog plan(成果物インスタンスの判定)
|
|
@@ -444,7 +477,7 @@ specdojo schedule strategy generate \
|
|
|
444
477
|
| `catalog-scaffold.md` | `dct-<domain>.yaml` が未作成のドメインと `catalog scaffold` 実行コマンド |
|
|
445
478
|
| `timeline.json` | 後続コマンドが読む機械可読サマリー |
|
|
446
479
|
|
|
447
|
-
`depends_on` の未定義参照・循環、`depends_on` と `order` の矛盾、track id の重複を検出した場合は、生成物を書き込まずに終了コード 1 で停止します。`catalog_status`
|
|
480
|
+
`depends_on` の未定義参照・循環、`depends_on` と `order` の矛盾、track id の重複を検出した場合は、生成物を書き込まずに終了コード 1 で停止します。`catalog_status` と実カタログの有無が食い違う場合は警告のみを出します。`project_register_path` がある場合、`catalog-planning` の todo を domain ごとに読み、`done` が一件でもあればその domain を `primary`、着手中(`in-progress` / `waiting` / `review`)なら `draft`、`open` だけなら `not_started` と導きます。`rejected` / `deferred` は導出から除外します。対象 todo がない domain は従来の手書き値を使います。複数 domain の track は全 domain が `primary` なら着手可能とし、一部だけ進んでいれば `draft` とします。手書きの値との差は警告し、`tml-index.yaml` は変更しません。todo を reopen した場合も次回 build で再計算します。`timeline.json` の `track_catalog_status` は導出後の track 別状態です。strategy 生成も同じ導出を使います。カタログの突き合わせはファイル名ではなく各 `dct-*.yaml` の `domain` 値で行うため、1 ドメインが複数ファイルに分割されていても検出できます。
|
|
448
481
|
|
|
449
482
|
`timeline_path` は未設定の場合、プロジェクト直下の `timeline` を既定とします。記述ルールは [タイムライン作成ルール](../rulebooks/tml-rulebook.md)、生成フローと運用タイミングは [Timeline設計ガイド](../guides/timeline-design-guide.md)、トラックの標準構成と実行順序は [トラック設計ガイド](../guides/track-design-guide.md) を参照します。
|
|
450
483
|
|
|
@@ -475,6 +508,8 @@ specdojo schedule strategy generate \
|
|
|
475
508
|
|
|
476
509
|
| オプション | 用途 | 対象 |
|
|
477
510
|
| ---------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ |
|
|
511
|
+
| `--input <text>` | 個票の前提を記録(繰り返し可、update は一覧置換、`-` 単独で全削除) | `add` / `update` |
|
|
512
|
+
| `--track <track>` | epic が担う track(epic で必須、update で置換、削除不可) | `add` / `update` |
|
|
478
513
|
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
|
|
479
514
|
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
|
|
480
515
|
| `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
|
|
@@ -483,10 +518,12 @@ specdojo schedule strategy generate \
|
|
|
483
518
|
| `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
|
|
484
519
|
| `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
|
|
485
520
|
| `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除) | `add` / `update` |
|
|
486
|
-
| `--target <
|
|
521
|
+
| `--target <target>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
487
522
|
| `--target-path <path>` | 成果物のリポジトリ相対パス(`update` は `-` で削除) | `add` / `update` |
|
|
488
523
|
| `--target-rulebook <doc-id>` | 成果物の rulebook ID(`update` は `-` で削除) | `add` / `update` |
|
|
489
524
|
| `--source <ref>` | kata authoring の手本を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
525
|
+
| `--commit-type <type>` | Conventional Commits の type を指定(`update` は `-` で削除) | `add` / `update` |
|
|
526
|
+
| `--commit-scope <scope>` | Conventional Commits の scope を指定(`update` は `-` で削除) | `add` / `update` |
|
|
490
527
|
| `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
|
|
491
528
|
| `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
|
|
492
529
|
| `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
|
|
@@ -502,8 +539,16 @@ specdojo schedule strategy generate \
|
|
|
502
539
|
|
|
503
540
|
`register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
|
|
504
541
|
|
|
542
|
+
`--input <text>` は、対話で得た前提・制約・委任範囲を個票本文の `入力` 節へ指定順に記録します。`update` で未指定なら保持し、指定すれば一覧を置換します。追記するときは既存分も含めて再指定し、`--input -` 単独で全削除します。add での `-`、空文字、削除と他の値の混在は拒否します。既存個票に節がなければ更新時に追加します。event の `input` は変更前後の JSON 配列を保持し、空は `-` で表します。register から生成する plan は approach の有無によらず、入力がある場合だけ完了条件とは別の「個票の入力(前提)」へ載せます。
|
|
543
|
+
|
|
544
|
+
`--commit-type <type>` と `--commit-scope <scope>` は、個票 Frontmatter の `commit_type` と `commit_scope` に Conventional Commits の type と scope を記録します。`update` では未指定なら保持し、`-` で削除します。`commit_type` に指定できる値は Conventional Commits の type(`feat`・`fix`・`docs`・`refactor`・`test`・`chore`・`perf`・`build`・`ci`・`style`・`revert`)です。`commit_scope` は英小文字・数字・ハイフン(`^[a-z0-9][a-z0-9-]*$`)を指定します。個票で `commit_type` を指定しなかった場合は、項目の type から既定の対応(`issue` は `fix`、`todo`・`change-request` は `feat`、`decision`・`note`・`question`・`risk` は `docs`、`epic` は `feat`、未知の type は `chore`)またはプロジェクト・リポジトリの設定により決定されます。
|
|
545
|
+
|
|
546
|
+
既定値は個票へ書き込まず、共通関数で利用時に解決します。優先順位と設定例は [[specdojo:specdojo-config-reference|設定リファレンス]] を参照してください。この段階では exec の commit メッセージやブランチ名には反映しません。
|
|
547
|
+
|
|
505
548
|
`--approach` を指定する場合、通常は `--target` が 1 件だけ必須です。成果物を作成・修正する approach の対象は、成果物カタログを優先して doc id を解決します。カタログがなくても、既存文書は文書索引と frontmatter から、新規文書は明示したパスと rulebook から解決できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。kata authoring は `--target` を新しい kata ID、`--source` を 0 件以上の読み取り専用の手本とします。互換性のため、2 個目以降の `--target` も `--source` と同じ手本として扱います。
|
|
506
549
|
|
|
550
|
+
`sample-maintenance` は `type` を見ず、対象 `id` の末尾が `-sample` かどうかで判定します。利用者の authority の sample も同じ規則です。recipe・template・rulebook の maintenance は従来どおり `type` の一致を検証します。sample の `type` の規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を参照してください。
|
|
551
|
+
|
|
507
552
|
カタログなしで使える成果物の approach は `fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` です。`cross-deliverable-dedup` はカタログが必要です。
|
|
508
553
|
|
|
509
554
|
- 新規文書には `--target-path <リポジトリ相対パス>` と `--target-rulebook <rulebook-id>` を指定します。個票の `target_path` と `target_rulebook` に保存されます。既存文書は `--target` の ID を索引で引き、パスと `specdojo.rulebook` を使います。明示指定と既存文書が矛盾した場合は停止します。
|
|
@@ -514,6 +559,8 @@ specdojo schedule strategy generate \
|
|
|
514
559
|
- カタログなしの plan は、カタログの `done_criteria` がないことを明示し、個票の完了条件と rulebook を使います。`retrofit` の実装調査入力は個票にパスを明記します。
|
|
515
560
|
- カタログ設定済みで対象が未登録の場合、パスと rulebook を両方明示した場合だけカタログなしと同じ解決を使います。未指定なら従来のエラーで停止します。カタログにある対象ではカタログの宣言を優先します。
|
|
516
561
|
|
|
562
|
+
`register add --type epic --track <track>` は track ごとの仕事を起票します。type は `epic` / `todo` / `question` / `risk` / `issue` / `change-request` / `decision` / `note` です。epic は todo と同じ状態を使い、通常終端は `done`、例外終端は `rejected` / `deferred` です。track は Frontmatter の `track` に保存し、`update --track` で置換します。英小文字・数字・ハイフン(先頭は英小文字か数字)の識別子が必須で、削除やほかの type への指定は拒否します。project の `timeline_path`(既定 `timeline`)に `tml-index.yaml` があるときは、add・update・build で track の定義を検証します。子 todo は `register add --type todo --from <epic-id>` で関連付けます。`register build` は `generated/pjr-epic-items.md` に epic ごとの直接の子項目と状態を表示し、別 project の子を project 修飾 ID で識別します。子のない epic も表示し、孫の再帰表示や epic の自動 close は行いません。完了は子項目と schedule を材料に人が判断します。
|
|
563
|
+
|
|
517
564
|
`item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
|
|
518
565
|
|
|
519
566
|
`--registered` / `--completed` にはタイムゾーン付きの RFC 3339 値(`2026-08-09T14:08:51Z` または `2026-08-09T23:08:51+09:00`)を指定し、保存時に UTC へ正規化します。タイムゾーンを含まない値は解釈が実行環境に依存するため受け付けません。期限(`--due`)は瞬間ではなく暦日のため `YYYY-MM-DD` のままです。
|
|
@@ -522,8 +569,25 @@ specdojo schedule strategy generate \
|
|
|
522
569
|
|
|
523
570
|
`register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照、未設定の project、存在しない項目は書き込み前に拒否します。別 project の項目は、その project の `integration_branch`(省略時は `project/<project-id>/develop`)の Git tree を読んで存在を確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
|
|
524
571
|
|
|
572
|
+
`register add` / `update` の `--depends-on <ID>` は、起票の由来を示す `derived_from` と区別して、先行項目を `depends_on` に記録します。反復指定で一覧を設定・置換し、`--depends-on -` 単独で削除します。書式と別 project の存在確認は `--from` と同じです。存在しない ID、自己参照、project 間を含む循環を記帳前と `register build` で拒否し、変更を event に記録します。実行はすべての先行項目が `done` / `decided` の場合だけ許可し、`rejected` / `deferred` では進めません。直接の `exec run --register` は未完了の先行 ID と状態を表示して停止し、routine の sweep(`--register-filter`)と夜間 queue は対象を飛ばして理由を出力します。夜間の理由は朝報告にも残し、状態を自動で `waiting` に変えません。スキップは件数上限に数えません。先行完了後の再選択は次回の実行で行います。`generated/pjr-index.md` の `depends_on` 列と、逆引きビュー `generated/pjr-dependent-items.md` で関係を確認できます。
|
|
573
|
+
|
|
525
574
|
`external_projects` に宣言した別名を `register add --project <別名> --commit` へ渡すと、相手のリポジトリの `node_modules/.bin/specdojo` を起動し、宣言した実 project ID で起票します。相手の登録簿の形式、名簿、`integration_branch`、commit は相手の CLI に任せ、呼び出し元は相手のファイルを直接変更しません。`--from <別名>:PJR-XXXX` は相手へ `<実 project ID>:PJR-XXXX` として渡すため、相手の CLI が存在を検証し、`derived_from` にも実 project ID が残ります。別 project への起票で `--source` を使う場合、相手の SpecDojo は 0.4.5 以上である必要があります。
|
|
526
575
|
|
|
576
|
+
カタログ・strategy を作る register 専用の approach は、文書 ID の代わりに作業単位を指定します。実行時の project を対象範囲とするため、未作成の文書や物理分割された domain も一つの todo で扱えます。`--source`・`--target-path`・`--target-rulebook` は使用しません。
|
|
577
|
+
|
|
578
|
+
```bash
|
|
579
|
+
specdojo register add --project prj-0001 --type todo --from PJR-AB12 \
|
|
580
|
+
--title "カタログを作る" --topic catalog-planning \
|
|
581
|
+
--approach catalog-planning --target domain:data-model
|
|
582
|
+
specdojo register add --project prj-0001 --type todo --from PJR-AB12 \
|
|
583
|
+
--title "strategy を作る" --topic strategy-planning \
|
|
584
|
+
--approach strategy-planning --target track:data-model
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
- `catalog-planning`: `catalog_path` が必要です。plan は既存カタログと DCT の kata・domain ごとの template を参照し、`catalog plan prompt` に沿った agent の判定、`catalog plan scaffold --from`、`catalog plan validate`、`catalog scaffold --plan`、`catalog validate` を完了条件として展開します。上流資料が不足する場合は `--input` で明示し、未確定事項を推測で補いません。
|
|
588
|
+
- `strategy-planning`: `catalog_path` と `schedule_path` が必要です。timeline がある場合は定義済み track に限定します。timeline がない場合は strategy の明示 scope を使います。plan は既存カタログと Schedule の kata を参照し、`sch-strategy-<track>.yaml` の `scope.catalogs`・`approach_rules` の intent・担当の宣言、`schedule strategy generate`、`schedule build --track` の成功を完了条件として展開します。
|
|
589
|
+
- 対象はそれぞれ `domain:<id>` / `track:<id>` の 1 件です。ID は英小文字・数字・ハイフン、先頭は英小文字または数字、最大 63 文字です。個票の追加完了条件も plan に取り込みます。両 approach を schedule の成果物タスクへ指定することはできません。
|
|
590
|
+
|
|
527
591
|
`register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にし、対象は 1 件だけです。`rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` は `--target` に新しい kata ID、繰り返し可能な `--source` に手本を指定し、個票 Frontmatter の `sources` へ保存します。
|
|
528
592
|
|
|
529
593
|
`--source` は次の順で解釈します。コロンの前が対象 project の `repos[].name` と一致すれば `<repo>:<path>`、一致せず値に `/` または拡張子があればプロジェクトリポジトリのパス、残りは文書索引で解決する doc id です。パスはファイル、ディレクトリ、glob を受け付けます。ディレクトリと glob はファイルへ展開し、重複を除いた合計が 100 件を超えると停止します。この上限は広すぎるパターンによる読み取り範囲と plan の肥大化を防ぐためです。プロダクトリポジトリの手本は plan に `$SPECDOJO_REPO_<NAME>/<path>` として載ります。カタログは必須ではなく、いずれの形も見つからなければ起票時と実行時に理由を示して停止します。
|
|
@@ -542,7 +606,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
542
606
|
|
|
543
607
|
`register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
|
|
544
608
|
|
|
545
|
-
`register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`sources`、`target_path`、`target_rulebook`、`derived_from` です。
|
|
609
|
+
`register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`sources`、`target_path`、`target_rulebook`、`derived_from`、`depends_on` です。
|
|
546
610
|
|
|
547
611
|
各書き込みコマンドは現在値を個票へ、event を項目別イベントファイルへ反映します。同じ現在値になる操作の再実行では event を追加しません。`register build` は個票とイベントファイルの対応、event の schema、ID 一意性、時刻順、直前イベント参照、状態連鎖、最新 event と現在値の一致を検証します。
|
|
548
612
|
|
|
@@ -611,6 +675,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
611
675
|
| `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
|
|
612
676
|
| `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
|
|
613
677
|
| `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
|
|
678
|
+
| `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
|
|
614
679
|
| `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
|
|
615
680
|
| `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
|
|
616
681
|
| `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
|
|
@@ -696,7 +761,11 @@ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --r
|
|
|
696
761
|
specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
|
|
697
762
|
```
|
|
698
763
|
|
|
699
|
-
`--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
|
|
764
|
+
`--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`epic` / `decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
|
|
765
|
+
|
|
766
|
+
`--branch <repo>=<name>` は、register の worktree モードでプロダクトの作業ブランチ名を上書きします。たとえば `specdojo exec run --project prj-0001 --register PJR-0012 --worktree --branch app1=feature/login` と指定します。複数のリポジトリにはオプションを繰り返します。宣言にないリポジトリ、同じリポジトリの重複、空の値、不正な Git ブランチ名は拒否します。別項目のブランチと重なると start 前に停止するため、topic を変えるかこの指定で解消します。自動の連番は付けません。SpecDojo の記帳用のブランチには適用しません。`--resume` では記録済みの名前を使うため指定の繰り返しは不要で、別名への変更は拒否します。
|
|
767
|
+
|
|
768
|
+
作業ブランチ名の既定値は `exec/{project}-{id}` です。`repos[].branch_template` に git-flow の `feature/{topic}`、GitHub flow の `{type}/{topic}` などを設定できます。統合の形は `repos[].integration_strategy` の `merge`(既定)・`ff`・`branch-only` で選びます。`ff` は早送りできるときだけ統合し、分岐していれば停止します。自動の rebase や同期 merge は行いません。
|
|
700
769
|
|
|
701
770
|
`--integration-branch <repo>=<branch>` は、register の worktree モードで、その run に限ってプロダクトリポジトリ `<repo>` の統合先を上書きします。複数リポジトリにはオプションを繰り返します。`<repo>` は `repos[].name` に宣言済みで、`<branch>` はそのリポジトリに存在する有効なローカルブランチでなければならず、リモートブランチの取得やローカルブランチの作成は行いません。同じ `<repo>` の重複、宣言にないリポジトリ、空の値は register の状態を変える前に拒否します。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定しない run の挙動は従来と変わりません。
|
|
702
771
|
|
|
@@ -749,7 +818,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
|
|
|
749
818
|
|
|
750
819
|
`--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
|
|
751
820
|
|
|
752
|
-
`pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
|
|
821
|
+
`pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`lint-mermaid`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
|
|
753
822
|
|
|
754
823
|
記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
|
|
755
824
|
|
|
@@ -757,6 +826,8 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
|
|
|
757
826
|
|
|
758
827
|
`grade` は kata(rulebook / recipe / sample / template)または成果物を、review と同じ共通 viewpoint・category rubric で継続評価します。agent に直接ファイル探索やスコア計算をさせず、plan 生成と反映を分離します。
|
|
759
828
|
|
|
829
|
+
評価結果の正本は YAML サイドカーに保存します。本リポジトリの文書は `<execution_path>/grade/results/<文書 ID>.yaml`、`project.repos` に宣言したリポジトリの文書は `<execution_path>/grade/results/<repo 名>/<文書 ID>.yaml` です。ファイル名では ID の `:` を `.` に置き換え、`<repo 名>` には `repos[].name`(`--source <repo>:<path>` と同じ名前)を使います。同じ ID の文書が別のリポジトリにあっても、保存先と前回結果の読み込みを分離します。`grade plan`、`apply`、`run` の再開、結果表示・検証・翻訳、dashboard はこの配置を使います。本リポジトリの既存結果は従来の場所で読み取れます。旧配置の直下に保存されたプロダクトリポジトリの結果は自動では流用せず、再評価してリポジトリ別の結果を作成します。
|
|
830
|
+
|
|
760
831
|
`grade run` は npm package から利用でき、`list` と同じ対象選択、文書ごとの plan 生成、agent 実行、marker の機械変換と `apply` を単段で実行します。成果物を `--target deliverable` で評価するには、対象 project に `catalog_path` を設定する必要があります。`viewpoints_path` 未設定時は同梱の `specdojo:pm-review-viewpoints` を使います。
|
|
761
832
|
|
|
762
833
|
| コマンド | 用途 |
|
|
@@ -29,6 +29,12 @@ SpecDojo Configuration Reference
|
|
|
29
29
|
|
|
30
30
|
`npx specdojo config init` は、register を開始できる次の最小構成を生成します。catalog や schedule の未使用キーは生成しません。
|
|
31
31
|
|
|
32
|
+
あわせて、markdownlint の設定がなければリポジトリ直下に `.markdownlint.yaml` を生成します。
|
|
33
|
+
MD013・MD024・MD033・MD036・MD041・MD060 を無効にし、日本語の長い行や SpecDojo の文書構成を許容します。
|
|
34
|
+
既存設定は上書きしません。既存リポジトリでは `config init --dry-run` で確認してから再実行すると追加できます。
|
|
35
|
+
exec の result の commit 前検査にも、利用リポジトリに設定がないときは同じ基本規則が適用されます。
|
|
36
|
+
設定の優先順位と hook / CLI2 の配置は [[specdojo:command-reference|CLIコマンドリファレンス]] を参照してください。
|
|
37
|
+
|
|
32
38
|
```json
|
|
33
39
|
{
|
|
34
40
|
"version": 1,
|
|
@@ -115,6 +121,7 @@ SpecDojo Configuration Reference
|
|
|
115
121
|
| -------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
116
122
|
| `integration_branch` | `project/<project-id>/develop` | 別 project の作業ツリーから `register add --project <project-id> --commit` で直接記帳する統合ブランチです。 |
|
|
117
123
|
| `project_context` | `["prj-overview"]` | edit / review plan へ常に渡す project 共通文書のローカル ID です。空配列 `[]` で無効化できます。`depends_on` や成果物の `based_on` は変更しません。 |
|
|
124
|
+
| `commit_types` | なし | 登録項目 type(`todo`・`issue` 等)から Conventional Commits type への対応マッピングです。 |
|
|
118
125
|
| `run` | `{}` | agent 実行、worktree、登録日の表示に関する project 単位の設定です。 |
|
|
119
126
|
| `repos` | なし | project のタスクが変更するプロダクトリポジトリの宣言です。詳細は「`repos`のキー」を参照してください。 |
|
|
120
127
|
|
|
@@ -182,15 +189,80 @@ project の `integration_branch` は、`repos[].integration_branch` とは別の
|
|
|
182
189
|
|
|
183
190
|
`projects.<project-id>.repos` は、プロジェクトリポジトリとは別のプロダクトリポジトリを配列で宣言します。プロジェクトリポジトリ自身は宣言しません。キーを省略した project(または空配列)は、従来どおりプロジェクトリポジトリ 1 つだけを扱います。
|
|
184
191
|
|
|
185
|
-
| キー
|
|
186
|
-
|
|
|
187
|
-
| `name`
|
|
188
|
-
| `path`
|
|
189
|
-
| `integration_branch`
|
|
190
|
-
| `
|
|
192
|
+
| キー | 必須 | 既定値 | 役割・利用箇所 |
|
|
193
|
+
| ------------------------- | ---- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
|
|
194
|
+
| `name` | 必須 | なし | `targets`・`paths` の接頭辞に使うリポジトリ名です。`[a-z0-9-]` だけを使い、project 内で一意です。`project` は予約名で使えません。 |
|
|
195
|
+
| `path` | 必須 | なし | リポジトリのルートです。SpecDojo ルートからの相対パスで書き、実在するディレクトリを指します。 |
|
|
196
|
+
| `integration_branch` | 任意 | そのリポジトリの現在のブランチ | exec が変更を統合する先のブランチです。exec branch もこのブランチの先端から作ります。 |
|
|
197
|
+
| `integration_strategy` | 任意 | `merge` | `merge` は merge commit、`ff` は早送りだけで統合します。`branch-only` は作業ブランチを保持してプロダクト側の PR レビューに渡します。 |
|
|
198
|
+
| `branch_template` | 任意 | `exec/{project}-{id}` | プロダクトの作業ブランチ名です。`{id}` または `{topic}` を含めます。 |
|
|
199
|
+
| `setup` | 任意 | 両方 `true` | worktree 作成時の準備の有無です。`install`(依存導入)と `build`(生成物の build)を真偽値で指定します。 |
|
|
200
|
+
| `commit_types` | 任意 | なし | このリポジトリ固有の登録項目 type から Conventional Commits type への対応マッピングです。project の指定より優先されます。 |
|
|
201
|
+
| `commit_subject_template` | 任意 | `exec(register {id}): {title}` | register の exec がプロダクトへ積む commit の 1 行目を指定します。 |
|
|
202
|
+
| `merge_message_template` | 任意 | `exec(register {id}): {title}` | register の exec がプロダクトへ積む merge commit のメッセージを指定します。改行で本文も指定できます。 |
|
|
191
203
|
|
|
192
204
|
register の worktree 実行では、`exec run --integration-branch <repo>=<branch>` により `integration_branch` を run ごとに上書きできます。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定方法、ローカルブランチの検査、並列実行と再開時の扱いは [[specdojo:command-reference]] を参照してください。
|
|
193
205
|
|
|
206
|
+
`commit_types` は項目の type ごとに既定の commit type を上書きします。値は個票の `commit_type` と同じ 11 種類(`feat`・`fix`・`docs`・`refactor`・`test`・`chore`・`perf`・`build`・`ci`・`style`・`revert`)です。空文字や一覧外の値は設定読み込み時にエラーになります。未指定のキーは「個票の `commit_type` → `repos[].commit_types` → `projects.<project-id>.commit_types` → 既定対応」の順に解決します。`commit_scope` は個票で指定した場合だけ使います。
|
|
207
|
+
|
|
208
|
+
既定対応は `issue` が `fix`、`todo`・`change-request`・`epic` が `feat`、`decision`・`note`・`question`・`risk` が `docs` です。未知の type は `chore` にフォールバックします。たとえば、project に `"commit_types": { "todo": "chore", "issue": "fix" }`、ドキュメント用の repo に `"commit_types": { "todo": "docs" }` を設定すると、その repo の todo は `docs`、他の repo の todo は `chore` になります。個票で `commit_type` を明示すれば、設定より優先されます。
|
|
209
|
+
|
|
210
|
+
`commit_subject_template` と `merge_message_template` はプロダクトリポジトリごとに独立して指定できます。設定がない場合は commit・merge とも従来の `exec(register <ID>): <タイトル>` を保ちます。SpecDojo の記録のリポジトリの start・review・wait・merge などの記帳には適用しません。
|
|
211
|
+
|
|
212
|
+
使える変数は次の 8 種類です。未知の変数、対応しない波括弧、空白だけのテンプレートは設定エラーです。値の中の波括弧は再展開しません。
|
|
213
|
+
|
|
214
|
+
| 変数 | 値 |
|
|
215
|
+
| ----------- | --------------------------------------------------------------------------------------- |
|
|
216
|
+
| `{id}` | 登録項目の ID(例: `PJR-AB12`) |
|
|
217
|
+
| `{project}` | project ID(例: `prj-0001`) |
|
|
218
|
+
| `{topic}` | 個票ファイル名 `pjr-ab12-<topic>.md` の topic 部分。個票パスがない場合は小文字の項目 ID |
|
|
219
|
+
| `{type}` | 個票・repo・project・既定対応の優先順で解決した commit type |
|
|
220
|
+
| `{scope}` | 個票の `commit_scope`。未指定なら空文字 |
|
|
221
|
+
| `{title}` | 改行などの空白を 1 つにまとめた項目のタイトル |
|
|
222
|
+
| `{branch}` | そのプロダクトの実際の作業ブランチ名 |
|
|
223
|
+
| `{target}` | run の上書きを含む、そのプロダクトの実際の統合先 |
|
|
224
|
+
|
|
225
|
+
commit/merge の scope が空のときは、テンプレートに書いた `({scope})` を括弧ごと取り除きます。たとえば `{type}({scope}): {title}` は `feat: 機能追加` になります。commit のテンプレートは空白と改行を 1 つの空白にまとめて 1 行にします。merge のテンプレートは本文の改行を保ちます。どちらも 1 行目は従来どおり最大 100 文字(超過時は末尾を `…` にして切り詰める)です。本文の末尾には設定にかかわらず `Refs: <project-id>:<ID>` を付けます。テンプレート自身に同じ `Refs:` 行があっても、末尾に 1 回だけ置きます。
|
|
226
|
+
|
|
227
|
+
git-flow で develop へローカル統合する場合の `repos` 要素の例です。作業ブランチは `feature/{topic}` とし、`ff` で早送りだけを許可する例です。`merge_message_template` は `integration_strategy` を `merge` にした場合に使います。
|
|
228
|
+
|
|
229
|
+
```json
|
|
230
|
+
{
|
|
231
|
+
"name": "app1",
|
|
232
|
+
"path": "../app1",
|
|
233
|
+
"integration_branch": "develop",
|
|
234
|
+
"branch_template": "feature/{topic}",
|
|
235
|
+
"integration_strategy": "ff",
|
|
236
|
+
"commit_subject_template": "{type}({scope}): {title}",
|
|
237
|
+
"merge_message_template": "Merge branch '{branch}' into {target}"
|
|
238
|
+
}
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
GitHub flow で作業ブランチを保持して PR レビューへ渡す場合の例です。`branch-only` では runner が merge commit を作らないため、`merge_message_template` は使いません。作業ブランチ名には項目の commit type と topic を使います。
|
|
242
|
+
|
|
243
|
+
```json
|
|
244
|
+
{
|
|
245
|
+
"name": "app1",
|
|
246
|
+
"path": "../app1",
|
|
247
|
+
"integration_branch": "main",
|
|
248
|
+
"integration_strategy": "branch-only",
|
|
249
|
+
"branch_template": "{type}/{topic}",
|
|
250
|
+
"commit_subject_template": "{type}: {title}"
|
|
251
|
+
}
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
`branch_template` の変数は上表の `{project}`・`{id}`・`{topic}`・`{type}`・`{scope}`・`{title}` の 6 個です。`{branch}`・`{target}` は使えません。`{id}` も `{topic}` も含まない値、未知の変数、不正な波括弧、空白や `..` など Git のブランチ名に使えない文字を含む値は設定エラーです。展開後の名前も開始時に Git で検証し、空の scope や空白を含む title で不正になった場合は停止します。名前の自動修正・連番付与は行いません。register 以外のタスクでは `{topic}` は task ID の小文字、`{title}` は task ID、`{type}` は `feat`、`{scope}` は空文字です。
|
|
255
|
+
|
|
256
|
+
名前の優先順位は、再開時の runner 記録 → `exec run --branch <repo>=<name>` → `branch_template` → 既定値です。別項目の記録や既存の管理外ブランチと名前が重なる場合は、register の start より前に停止し、topic の変更か `--branch` を案内します。同じ項目の再開では、設定や topic が変わっても記録された名前を使い、異なる `--branch` は拒否します。SpecDojo の記帳用リポジトリの `exec/{project}-{id}` は変更しません。
|
|
257
|
+
|
|
258
|
+
対応記録は各プロダクトの Git 共通管理ディレクトリの `specdojo/product-branches/` に置き、項目の修飾 ID・ブランチ名・開始 commit を保存します。全 worktree とプロジェクトで共有し、名前の予約は排他的に作成します。再開と片付けはこの記録を参照し、`exec/` 以外の名前でも動きます。旧 run の記録がない場合だけ、従来の名前を互換用に探索します。
|
|
259
|
+
|
|
260
|
+
`ff` は統合先を作業ブランチの先端へ進め、merge commit を作りません。統合先が作業ブランチの祖先でない場合は、どのリポジトリも統合する前に理由を示して停止します。統合直前にも祖先関係を確かめ、checkout されていない統合先は比較交換で更新します。再開時にも `ff` の worktree へ統合先を自動 merge せず、rebase もしません。利用者が履歴を整理してから同じ run を再開します。`merge` の既定動作は変わりません。
|
|
261
|
+
|
|
262
|
+
GitHub flow などで PR レビューを必須にするリポジトリには、`"integration_strategy": "branch-only"` を指定します。`integration_branch` は exec branch の作成元と、プロダクト側で PR を作る際の統合先の目安です。runner は統合先へ merge せず、push・PR 作成(`gh` を含む)も行いません。プロダクトの commit とプロジェクトの記帳が成功すると、プロジェクト側は通常どおり `review` へ進み、result に `branch-only`(未統合)、exec branch 名、trace key を残します。プロダクト側のレビューやリリースが完了したことは意味しません。
|
|
263
|
+
|
|
264
|
+
成功後は全 worktree を撤去し、`branch-only` の exec branch だけを残します。利用者はその branch を必要な承認のもと push し、プロダクト側の手順で PR を作成します。squash merge でも追跡できるよう、commit メッセージの `Refs: <project-id>:<item-id>` を保持してください。失敗時は worktree と branch を残して `--resume` で再開し、`branch-only` の worktree へ統合先を自動で取り込みません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除してから実行します。`exec worktree prune` は未統合の branch を削除しません。
|
|
265
|
+
|
|
194
266
|
```json
|
|
195
267
|
{
|
|
196
268
|
"base_path": "docs/ja/projects/prj-0001",
|
|
@@ -200,6 +272,7 @@ register の worktree 実行では、`exec run --integration-branch <repo>=<bran
|
|
|
200
272
|
"name": "app1",
|
|
201
273
|
"path": "../app1",
|
|
202
274
|
"integration_branch": "main",
|
|
275
|
+
"integration_strategy": "branch-only",
|
|
203
276
|
"setup": { "install": true, "build": false }
|
|
204
277
|
}
|
|
205
278
|
]
|
|
@@ -241,7 +314,7 @@ agent の起動コマンドには、provider ごとにプロダクト worktree
|
|
|
241
314
|
|
|
242
315
|
agent 実行の前後で行う保護設定(`package.json`、CI 設定など)と Git 状態(HEAD・ローカル設定)の検査は、プロダクト worktree にも同じ一覧で行います。evidence の変更ファイルは、プロダクト側を `<name>:<path>` で記録します。
|
|
243
316
|
|
|
244
|
-
プロダクトリポジトリの変更は、`exec run --worktree` の統合段で runner がリポジトリごとに commit
|
|
317
|
+
プロダクトリポジトリの変更は、`exec run --worktree` の統合段で runner がリポジトリごとに commit し、宣言順にプロダクトの設定方式を処理し、最後にプロジェクトを統合します。統合の順序、失敗時の部分状態、再開は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] の「複数リポジトリの worktree と統合順序」と「複数リポジトリの統合の失敗と再開」を参照してください。`exec worktree commit` はプロダクト側を統合しないため、プロダクト worktree に未 commit の変更か exec branch の commit が残るタスクは、プロジェクト側の commit の前に停止します。撤去は、全リポジトリの worktree が撤去できることを確かめてからまとめて行います。
|
|
245
318
|
|
|
246
319
|
exec worktree の中で設定を読む場合(agent が worktree で `specdojo` を実行する場合など)、`path` の代わりに同じタスクの `<worktree_base>/<task-id>/<name>/` へ解決します。
|
|
247
320
|
|
|
@@ -253,7 +326,7 @@ exec worktree の中で設定を読む場合(agent が worktree で `specdojo`
|
|
|
253
326
|
- `name` がいずれかの project ID と同じである。`<name>:<...>` が doc id とリポジトリのパスのどちらか区別できなくなるためです。
|
|
254
327
|
- `name` が予約名 `project` である。プロジェクトリポジトリの worktree のディレクトリ名と重なるためです。
|
|
255
328
|
- `path` が空、絶対パス、存在しない、またはディレクトリでない。
|
|
256
|
-
- 宣言に無いキーがある、`integration_branch` が空文字、`setup` の値が真偽値でない。
|
|
329
|
+
- 宣言に無いキーがある、`integration_branch` が空文字、`integration_strategy` が `merge` / `branch-only` / `ff` 以外、`setup` の値が真偽値でない。
|
|
257
330
|
|
|
258
331
|
設定の形は `docs/specdojo/schemas/v1/specdojo-config.schema.yaml` でも検証できます。リポジトリ名と project ID の重複と `path` の実在は schema で表せないため、CLI の読み込み時の検証が正本です。
|
|
259
332
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bac-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:bac-sample
|
|
@@ -49,7 +50,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
49
50
|
| ---- | ---- | ---- |
|
|
50
51
|
|
|
51
52
|
| id | 受入条件ID(`bac-...`) | ○ |
|
|
52
|
-
| type | `
|
|
53
|
+
| type | `requirement` 固定 | ○ |
|
|
53
54
|
| title | 受入条件名(例: 業務受入条件: 商品販売) | ○ |
|
|
54
55
|
| status | `draft`/`ready`/`deprecated` | ○ |
|
|
55
56
|
| part_of | 上位BAC ID(分割している場合) | 任意 |
|
|
@@ -149,7 +150,7 @@ Markdown で「受入対象」と「シナリオ」を記述します。
|
|
|
149
150
|
```markdown
|
|
150
151
|
---
|
|
151
152
|
id: bac-sale-checkout
|
|
152
|
-
type:
|
|
153
|
+
type: requirement
|
|
153
154
|
title: 業務受入条件: 商品販売
|
|
154
155
|
status: draft
|
|
155
156
|
part_of: []
|
|
@@ -196,7 +197,7 @@ supersedes: []
|
|
|
196
197
|
```markdown
|
|
197
198
|
---
|
|
198
199
|
id: bac-procurement-order-to-payment
|
|
199
|
-
type:
|
|
200
|
+
type: requirement
|
|
200
201
|
title: 業務受入条件: 仕入(発注〜入荷〜支払)
|
|
201
202
|
status: draft
|
|
202
203
|
part_of: []
|
|
@@ -285,7 +286,7 @@ supersedes: []
|
|
|
285
286
|
```markdown
|
|
286
287
|
---
|
|
287
288
|
id: bac-sale-payment-method
|
|
288
|
-
type:
|
|
289
|
+
type: requirement
|
|
289
290
|
title: 業務受入条件: 会計確定(支払方法の記録)
|
|
290
291
|
status: draft
|
|
291
292
|
part_of: []
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bdd-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: data
|
|
5
6
|
status: draft
|
|
6
7
|
target_format: yaml
|
|
7
8
|
recipe: not-needed
|
|
@@ -34,7 +35,7 @@ Business Data Dictionary (BDD) Documentation Rules
|
|
|
34
35
|
### 3.1. ID規約
|
|
35
36
|
|
|
36
37
|
- `id` は正規表現 `^bdd-[a-z0-9-]+$` に合致する一意IDを用いる。
|
|
37
|
-
- `type` は `
|
|
38
|
+
- `type` は `data` 固定とする。
|
|
38
39
|
- 置き換えがある場合は `supersedes` に旧IDを列挙する。
|
|
39
40
|
|
|
40
41
|
### 3.2. ファイル命名規約
|
|
@@ -50,7 +51,7 @@ Frontmatter と同等の以下の項目をYAMLドキュメントの先頭に必
|
|
|
50
51
|
| 項目 | 説明 | 必須 |
|
|
51
52
|
| ---------- | ---------------------------------------- | ---- |
|
|
52
53
|
| id | データ辞書ID(`bdd-...`) | ○ |
|
|
53
|
-
| type | `
|
|
54
|
+
| type | `data` 固定 | ○ |
|
|
54
55
|
| title | ドキュメント名。表示ページの見出しになる | ○ |
|
|
55
56
|
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
56
57
|
| rulebook | `specdojo:bdd-rulebook` 固定 | ○ |
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bds-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: ui
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:bds-sample
|
|
@@ -48,7 +49,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
48
49
|
| ---- | ------------------- | ---- |
|
|
49
50
|
| id | 帳票ID(`bds-...`) | ○ |
|
|
50
51
|
|
|
51
|
-
| type | `
|
|
52
|
+
| type | `ui` 固定 | ○ |
|
|
52
53
|
| title | 帳票名 | ○ |
|
|
53
54
|
|
|
54
55
|
| status | `draft`/`ready`/`deprecated` | ○ |
|
|
@@ -58,7 +59,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
58
59
|
### 4.1 ID規約
|
|
59
60
|
|
|
60
61
|
- BDS の `id` は正規表現 `^bds-[a-z0-9-]+$` に合致する一意IDを使用します。
|
|
61
|
-
- `type:
|
|
62
|
+
- `type: ui` は帳票の利用者向け仕様であることを示します。
|
|
62
63
|
|
|
63
64
|
## 5. 本文構成(標準テンプレ)
|
|
64
65
|
|
|
@@ -153,7 +154,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
153
154
|
```markdown
|
|
154
155
|
---
|
|
155
156
|
id: bds-daily-sales-summary
|
|
156
|
-
type:
|
|
157
|
+
type: ui
|
|
157
158
|
title: 日次売上サマリ
|
|
158
159
|
status: draft
|
|
159
160
|
part_of: []
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bes-index-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
target_format: markdown
|
|
7
8
|
recipe: undecided
|
|
@@ -43,13 +44,13 @@ Business Event Specification Index (BES Index) Documentation Rules
|
|
|
43
44
|
|
|
44
45
|
## 4. 推奨 Frontmatter 項目
|
|
45
46
|
|
|
46
|
-
| 項目 | 説明
|
|
47
|
-
| ------------ |
|
|
48
|
-
| `id` | ドキュメントID(例: `bes-index`)
|
|
49
|
-
| `type` | `
|
|
50
|
-
| `status` | `draft` / `ready` / `deprecated`
|
|
51
|
-
| `rulebook` | `specdojo:bes-index-rulebook`
|
|
52
|
-
| `supersedes` | 置き換え関係(古仕様→新仕様)
|
|
47
|
+
| 項目 | 説明 | 必須 |
|
|
48
|
+
| ------------ | --------------------------------- | ---- |
|
|
49
|
+
| `id` | ドキュメントID(例: `bes-index`) | ○ |
|
|
50
|
+
| `type` | `requirement` 固定 | ○ |
|
|
51
|
+
| `status` | `draft` / `ready` / `deprecated` | ○ |
|
|
52
|
+
| `rulebook` | `specdojo:bes-index-rulebook` | 任意 |
|
|
53
|
+
| `supersedes` | 置き換え関係(古仕様→新仕様) | 任意 |
|
|
53
54
|
|
|
54
55
|
## 5. 本文構成(標準テンプレ)
|
|
55
56
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bes-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:bes-sample
|
|
@@ -56,7 +57,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
56
57
|
| ---- | --------------------------------- | ---- |
|
|
57
58
|
| id | BES ID(例: `bes-sale-checkout`) | ○ |
|
|
58
59
|
|
|
59
|
-
| type | `
|
|
60
|
+
| type | `requirement` 固定 | ○ |
|
|
60
61
|
| title | 業務イベント名(例: 業務イベント: 会計確定(販売)) | ○ |
|
|
61
62
|
| status | `draft`/`ready`/`deprecated` | ○ |
|
|
62
63
|
| based_on | 根拠となる仕様ID(BEL/UIS/BPS 等) | 任意 |
|
|
@@ -65,7 +66,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
|
|
|
65
66
|
### 3.1 ID規約
|
|
66
67
|
|
|
67
68
|
- BES ID は `bes-...` の形式を推奨します(例: `bes-sale-checkout`)。
|
|
68
|
-
- `type:
|
|
69
|
+
- `type: requirement` は機能・業務イベントの要件であることを示します。
|
|
69
70
|
|
|
70
71
|
## 4. 本文テンプレ(最小)
|
|
71
72
|
|
|
@@ -97,7 +98,7 @@ BES の責務は次に **限定** し、各項目を見出しとしてこの順
|
|
|
97
98
|
---
|
|
98
99
|
|
|
99
100
|
id: bes-sale-checkout
|
|
100
|
-
type:
|
|
101
|
+
type: requirement
|
|
101
102
|
title: 業務イベント: 会計確定(販売)
|
|
102
103
|
status: draft
|
|
103
104
|
part_of: []
|