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
|
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
|
|
|
10
10
|
|
|
11
11
|
- `name`: _DELIVERABLE_NAME_
|
|
12
12
|
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
|
|
14
|
+
- 個票の `入力`: _REGISTER_INPUT_
|
|
15
|
+
- カタログの `brief`: _DELIVERABLE_BRIEF_
|
|
13
16
|
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
17
|
- `path`: `_DELIVERABLE_PATH_`
|
|
15
18
|
- `rulebook`: `_RULEBOOK_REF_`(`_MISSING_` は `undecided`、`not-needed`、または未整備)
|
|
@@ -43,20 +46,20 @@ _DONE_CRITERIA_ROWS_
|
|
|
43
46
|
|
|
44
47
|
## 5. 進め方
|
|
45
48
|
|
|
46
|
-
fully-guided
|
|
49
|
+
fully-guided のタスクは、宣言された文書だけを参照し、rulebook / recipe / sample に沿って既存成果物を磨き込むことを求めた。下書きや調査による新しい値の選定は draft の役割である。磨き込みでは template を読み込まない。rulebook の必須要素・禁止事項、recipe の問い、sample の形式との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
47
50
|
|
|
48
51
|
参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備):
|
|
49
52
|
|
|
50
53
|
- rulebook: `_RULEBOOK_REF_`
|
|
51
54
|
- recipe: `_RECIPE_REF_`
|
|
52
55
|
- sample: `_SAMPLE_REF_`
|
|
53
|
-
-
|
|
56
|
+
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
54
57
|
|
|
55
|
-
1.
|
|
58
|
+
1. フェーズ説明と完了条件が求めた磨き込みが、対象成果物に行われたかを確認する。
|
|
56
59
|
2. 実践の型の欠落(`_MISSING_`)や内容の薄さがある場合は、実行記録にその扱いが残っているかを確認する。実践の型そのものの整備が必要な場合は、改善指示に残す。
|
|
57
60
|
3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook の必須要素の欠落や禁止事項への抵触など、完了条件に直結する finding は完了を妨げる。
|
|
58
61
|
|
|
59
|
-
|
|
62
|
+
確認に用いてよい文書は、宣言された文書だけに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief`、実行記録である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。
|
|
60
63
|
|
|
61
64
|
本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
62
65
|
|
|
@@ -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 するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
|
|
@@ -334,6 +334,8 @@ routing:
|
|
|
334
334
|
|
|
335
335
|
`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)は、executor が残した ESLint・frontmatter・Markdown の lint エラーを agent の段階で検出します。指定しない場合、これらのエラーは統合後の `npm run check` まで持ち越されます(PJR-K1Z5)。
|
|
336
336
|
|
|
337
|
+
`lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
|
|
338
|
+
|
|
337
339
|
`build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
|
|
338
340
|
|
|
339
341
|
`specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
|
|
@@ -555,7 +557,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
555
557
|
- 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
|
|
556
558
|
- evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
|
|
557
559
|
- executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
|
|
558
|
-
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
560
|
+
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
559
561
|
- executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
|
|
560
562
|
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
|
|
561
563
|
- `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
|
|
@@ -17,7 +17,7 @@ Exec Operation Guide
|
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
- 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata
|
|
20
|
+
- 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順、文脈を渡して段階的に作成する流れ
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
@@ -43,25 +43,26 @@ exec が扱う関心事、タスクの出どころによる実行経路の選び
|
|
|
43
43
|
|
|
44
44
|
### 1.2. 実行経路の使い分け
|
|
45
45
|
|
|
46
|
-
agent
|
|
46
|
+
agent にタスクを実行させる経路には、業務の起点・着手承認・完了判断を担う register と、成果物カタログに基づく途中の進み具合を担う schedule があります。両者は同格の 2 経路ではなく、register を親、schedule を子とする階層関係にあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(register の項目 / schedule のタスク)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
|
|
47
47
|
|
|
48
|
-
| 観点 |
|
|
49
|
-
| ------------ |
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
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
|
|
|
@@ -652,7 +653,7 @@ specdojo:
|
|
|
652
653
|
#### 4.3.1. 成果物を対象にする場合
|
|
653
654
|
|
|
654
655
|
- **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
|
|
655
|
-
- **進め方(`approach`)**: 成果物を作成・修正する進め方(`fully-guided
|
|
656
|
+
- **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
|
|
656
657
|
|
|
657
658
|
#### 4.3.2. kata(実践の型)を対象にする場合
|
|
658
659
|
|
|
@@ -710,3 +711,97 @@ specdojo register close \
|
|
|
710
711
|
--id <PJR-ID> \
|
|
711
712
|
--conclusion "設定ガイドを改訂し検証を通過"
|
|
712
713
|
```
|
|
714
|
+
|
|
715
|
+
### 4.7. 文脈を渡して段階的に作成する手順
|
|
716
|
+
|
|
717
|
+
成果物をゼロから作成する場合や、技術スタックの選定などの調査を伴う場合は、成果物の雛形作成から文脈の記入、下書き(`draft`)、磨き込み(`fully-guided`)、人間の確定(`finalize`)へと段階的に個票を分けて進めます。
|
|
718
|
+
|
|
719
|
+
#### 4.7.1. 5つの段階と役割分担
|
|
720
|
+
|
|
721
|
+
成果物作成の流れは、次の 5 段階で役割を分担します。
|
|
722
|
+
|
|
723
|
+
| 段階 | 実行主体 | approach | 役割と進め方 |
|
|
724
|
+
| ----------------------- | -------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
725
|
+
| 1. 雛形作成(scaffold) | CLI / 人 | - | `deliverable scaffold` で成果物のファイル雛形を生成する |
|
|
726
|
+
| 2. 文脈の記入 | 人 | - | 成果物内に `_CONTEXT_:` を記入、または個票の `入力`(`--input`)で前提・制約・調査委任の指示を渡す |
|
|
727
|
+
| 3. 下書き(draft) | agent | `draft` | 文脈で任された範囲を調査・選定して下書きする。選定値を提案として示し、出典と選定理由を result に記録する。反映した `_CONTEXT_:` は削除して result に写す |
|
|
728
|
+
| 4. 磨き込み(refine) | agent | `fully-guided` | 既存成果物を実践の型(rulebook / recipe / sample)に照らして構造・用語・整合性を磨き込む(磨き込み専用)。新たな調査や外部情報の追加は行わない |
|
|
729
|
+
| 5. 確定(finalize) | 人 | `finalize` | `done_criteria` や未反映の文脈指示(`_CONTEXT_:` の残り)がないことを確認し、成果物の `status` を `ready` へ昇格する |
|
|
730
|
+
|
|
731
|
+
#### 4.7.2. 個票の分割と `depends_on` による連携
|
|
732
|
+
|
|
733
|
+
この流れをプロジェクト登録簿(register)で進める場合は、`draft`、`fully-guided`、`finalize` の各段階を個票(`todo`)として起票し、`depends_on` で先行タスクに依存させて順に実行します。
|
|
734
|
+
|
|
735
|
+
たとえば、フロントエンドの技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して段階的に作成する場合の手順は次のとおりです。
|
|
736
|
+
|
|
737
|
+
```bash
|
|
738
|
+
# 1. 雛形を作成する
|
|
739
|
+
# カタログにある成果物を 1 件だけ指定して作成する場合:
|
|
740
|
+
specdojo deliverable scaffold \
|
|
741
|
+
--project prj-0001 \
|
|
742
|
+
--target prj-0001:tsd-frontend-site
|
|
743
|
+
|
|
744
|
+
# カタログにない成果物を雛形にする場合は --target-path と --target-rulebook を指定する:
|
|
745
|
+
specdojo deliverable scaffold \
|
|
746
|
+
--project prj-0001 \
|
|
747
|
+
--target prj-0001:tsd-custom-tool \
|
|
748
|
+
--target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
|
|
749
|
+
--target-rulebook specdojo:tsd-rulebook
|
|
750
|
+
```
|
|
751
|
+
|
|
752
|
+
`deliverable scaffold` は `--target <doc-id>` で成果物を 1 つだけ指定して雛形を作成できます。カタログにない成果物は、`--target-path` と `--target-rulebook` を添えて作成します(PJR-S23T)。また、`specdojo:tsd-rulebook` のように template を持たない(`template: not-needed` と宣言された)rulebook であっても、最小構成の雛形(frontmatter、見出し、本文の `_TODO_`)が生成されます。その際、雛形 frontmatter の `type` は rulebook の `deliverable_type`(TSD の場合は `architecture`)が自動設定されるため(未宣言なら `project`)、`docs-lint` の `frontmatter-deliverable-type` 検証をそのまま通過できます(PJR-YKYK)。
|
|
753
|
+
|
|
754
|
+
```bash
|
|
755
|
+
# 2. 成果物に文脈を記入する(または個票の --input で渡す)
|
|
756
|
+
# 生成された docs/.../tsd-frontend-site.md の先頭章などに次のように記入する:
|
|
757
|
+
# _CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、採用理由・全体構成・導入手順を下書きしてください。
|
|
758
|
+
|
|
759
|
+
# 3. 下書き(draft)の個票を起票する(対話から得た前提は --input でも渡せる)
|
|
760
|
+
specdojo register add \
|
|
761
|
+
--project prj-0001 \
|
|
762
|
+
--type todo \
|
|
763
|
+
--title "フロントエンドTSDの下書き(draft)" \
|
|
764
|
+
--topic tsd-frontend-draft \
|
|
765
|
+
--difficulty medium \
|
|
766
|
+
--approach draft \
|
|
767
|
+
--target prj-0001:tsd-frontend-site \
|
|
768
|
+
--input "静的サイトで主流の技術スタック(Astro 等)を調査して選定する" \
|
|
769
|
+
--owner DEV
|
|
770
|
+
|
|
771
|
+
# 4. 磨き込み(fully-guided)の個票を起票し、draft 個票に依存させる
|
|
772
|
+
specdojo register add \
|
|
773
|
+
--project prj-0001 \
|
|
774
|
+
--type todo \
|
|
775
|
+
--title "フロントエンドTSDの磨き込み(fully-guided)" \
|
|
776
|
+
--topic tsd-frontend-refine \
|
|
777
|
+
--difficulty medium \
|
|
778
|
+
--approach fully-guided \
|
|
779
|
+
--target prj-0001:tsd-frontend-site \
|
|
780
|
+
--depends-on <DRAFT-PJR-ID> \
|
|
781
|
+
--owner DEV
|
|
782
|
+
|
|
783
|
+
# 5. 確定(finalize)の個票を起票し、fully-guided 個票に依存させる
|
|
784
|
+
specdojo register add \
|
|
785
|
+
--project prj-0001 \
|
|
786
|
+
--type todo \
|
|
787
|
+
--title "フロントエンドTSDの確定(finalize)" \
|
|
788
|
+
--topic tsd-frontend-finalize \
|
|
789
|
+
--difficulty easy \
|
|
790
|
+
--approach finalize \
|
|
791
|
+
--target prj-0001:tsd-frontend-site \
|
|
792
|
+
--depends-on <REFINE-PJR-ID> \
|
|
793
|
+
--owner PO
|
|
794
|
+
```
|
|
795
|
+
|
|
796
|
+
#### 4.7.3. 順次実行と引き継ぎ
|
|
797
|
+
|
|
798
|
+
起票した個票は、`depends_on` の順序に従って実行します。
|
|
799
|
+
|
|
800
|
+
1. **下書き(draft)の実行**:
|
|
801
|
+
`exec run --register <DRAFT-PJR-ID> --worktree` を実行します。agent は成果物内の `_CONTEXT_:` や個票の `入力` を読み取り、技術スタックを調べて下書きします。反映した `_CONTEXT_:` は削除され、元の指示と選定理由は draft の result に記録されます。実行完了後に内容を確認し、`register close` します。
|
|
802
|
+
2. **磨き込み(fully-guided)の実行**:
|
|
803
|
+
draft が完了したら、後続の `exec run --register <REFINE-PJR-ID> --worktree` を実行します。agent は draft で作成された草案を rulebook や recipe に適合するように磨き込みます。この段では外部調査を行わず、既存の草案の構造・記述を整理します。実行完了後に内容を確認し、`register close` します。
|
|
804
|
+
3. **人間による確定(finalize)**:
|
|
805
|
+
人が成果物を確認し、`done_criteria` を満たしていること、未反映の `_CONTEXT_:` が残っていないことをチェックします。問題がなければ `status` を `ready` へ昇格し、個票を close します。
|
|
806
|
+
|
|
807
|
+
夜間や自動でまとめて実行する場合は、本ガイドの「2. 実行の列の組み方」と同様に、これらを 1 本の列に並べて順に流します。先行タスクが成功して統合されることで、後続タスクがその成果物を引き継いで実行されます。
|
|
@@ -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
|
オーケストレーターは「提案 → 承認 → 実行」を基本とします。
|
|
@@ -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 するため、
|
|
@@ -794,16 +806,17 @@ npx specdojo register add \
|
|
|
794
806
|
|
|
795
807
|
どちらも別 project への起票では `--commit` が必須です。別リポジトリでは、相手に SpecDojo 0.4.2 以上と対象 project の統合ブランチが必要です。push は行わず、close などの状態遷移は対象 project の作業ツリーで行います。
|
|
796
808
|
|
|
797
|
-
### 3.14. issueからdecision、
|
|
809
|
+
### 3.14. issueからdecision、epic、成果物カタログ・Scheduleへ進む
|
|
798
810
|
|
|
799
|
-
|
|
811
|
+
プロジェクト立ち上げ時に、問題、判断、実施作業がまだ混在している場合は、次の順で具体化します。register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。
|
|
800
812
|
|
|
801
813
|
```text
|
|
802
814
|
issue(何が問題か)
|
|
803
815
|
-> decision(何を対象とするか)
|
|
804
|
-
->
|
|
805
|
-
->
|
|
806
|
-
-> schedule
|
|
816
|
+
-> epic(track の仕事を起票する)
|
|
817
|
+
-> 子 todo(成果物カタログや strategy を作成する)
|
|
818
|
+
-> schedule(成果物タスクの実行と進捗)
|
|
819
|
+
-> epic を完了する(人が判断)
|
|
807
820
|
```
|
|
808
821
|
|
|
809
822
|
```bash
|
|
@@ -821,22 +834,32 @@ npx specdojo register add \
|
|
|
821
834
|
--title "初期スコープと対象成果物を決定する" \
|
|
822
835
|
--topic decide-initial-scope
|
|
823
836
|
|
|
824
|
-
#
|
|
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『成果物カタログを作成する』を起票して」
|
|
825
846
|
npx specdojo register add \
|
|
826
847
|
--project <project-id> \
|
|
827
848
|
--type todo \
|
|
828
|
-
--
|
|
849
|
+
--from <epic-id> \
|
|
829
850
|
--title "プロジェクト定義の成果物カタログを作成する" \
|
|
830
|
-
--topic create-project-definition-catalog
|
|
851
|
+
--topic create-project-definition-catalog \
|
|
852
|
+
--approach catalog-planning \
|
|
853
|
+
--target domain:project-definition
|
|
831
854
|
```
|
|
832
855
|
|
|
833
|
-
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` 自体は実行対象外です)。
|
|
834
857
|
|
|
835
|
-
すべての登録項目には 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 します。
|
|
836
859
|
|
|
837
860
|
## 4. 発展: 成果物カタログからscheduleへ展開する
|
|
838
861
|
|
|
839
|
-
|
|
862
|
+
この経路では、epic の子 todo から成果物カタログ(`dct-<domain>.yaml`)とトラック戦略(`sch-strategy-<track>.yaml`)を作成して Schedule を生成し、依存関係に従ってタスクを実行します。
|
|
840
863
|
|
|
841
864
|
### 4.1. 成果物カタログを作成する
|
|
842
865
|
|