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
|
@@ -35,8 +35,8 @@ Register Operation Guide
|
|
|
35
35
|
- 個票の Frontmatter は現在値、`events/pjr-XXXX.yaml` は変更履歴の正本です。Git は両者の保存・配布・レビューを担いますが、コミット粒度を業務イベントの粒度として扱いません。
|
|
36
36
|
- 文書 ID `<project-id>:pjr-index` の解決先は `project-register/generated/pjr-index.md` です。`controls/**/generated/` はdoc-indexの限定的な走査対象であり、一覧自身を `[[id]]` で参照できます。
|
|
37
37
|
- 一覧と、状態別・優先度別・担当者別などの派生ビューは `generated/` 配下に生成される派生物であり、直接編集しません。
|
|
38
|
-
- 立ち上げ時は、未整理の問題・判断を `issue` / `question` / `decision`
|
|
39
|
-
-
|
|
38
|
+
- 立ち上げ時は、未整理の問題・判断を `issue` / `question` / `decision` で記録し、track ごとの `epic` を起票して子 todo でカタログや strategy を作成できます。
|
|
39
|
+
- register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。成果物タスクの進捗は schedule の依存グラフで管理し、個々の成果物タスクを登録簿に二重管理しません。進行中に発生した計画外の単発対応・調査・判断は、引き続き登録簿で追跡します([exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け` を参照してください)。
|
|
40
40
|
|
|
41
41
|
関連ドキュメントの関係は次のとおりです。
|
|
42
42
|
|
|
@@ -72,8 +72,7 @@ specdojo register scaffold --project <project-id>
|
|
|
72
72
|
|
|
73
73
|
逆に、次の事項は登録しません。
|
|
74
74
|
|
|
75
|
-
-
|
|
76
|
-
- 成果物カタログへ定義し、Scheduleへ展開済みの作業(立ち上げ時の個票は結論を残して完了する)
|
|
75
|
+
- schedule に展開された個々の成果物タスク(途中の進み具合は schedule で管理し、登録簿には二重管理しない。track 全体の着手承認と完了判断は `epic` で管理する)
|
|
77
76
|
- その場で完了し、後から追跡する必要がないもの
|
|
78
77
|
|
|
79
78
|
登録は `register add` で行います。ID は省略すると自動採番されます。
|
|
@@ -115,6 +114,19 @@ SpecDojo 自身のリポジトリへ起票する場合も、同じように別
|
|
|
115
114
|
|
|
116
115
|
タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID を変更できます。成果物や kata(実践の型)を作成・修正する todo では、`--approach <approach> --target <doc-id>` を指定して進め方と対象を宣言できます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
117
116
|
|
|
117
|
+
対話で確かめた前提・制約・調査を任せる範囲は、`--input <text>` を繰り返して個票本文の `入力` 節へ記録します。完了条件は別に記載します。
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
specdojo register add --project prj-0001 --type todo \
|
|
121
|
+
--title "技術案を作る" --topic technology-proposal \
|
|
122
|
+
--input "対象は社内向けの利用者100名" \
|
|
123
|
+
--input "認証方式の調査と選定を任せる"
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
`register update --input` は入力一覧を置き換えます。追記したい場合も既存分を含めてすべて指定し、全削除は `--input -` 単独で行います。未指定なら保持し、空文字や削除と他の入力の混在は拒否します。節のない既存個票には更新時に節を追加します。変更は event の `input` に変更前後の JSON 配列(未入力は `-`)で残ります。同じ値への再更新は event を増やしません。
|
|
127
|
+
|
|
128
|
+
register 経由の plan では、approach がある成果物の plan と approach がない edit / investigate plan のどちらにも、入力がある場合だけ「個票の入力(前提)」が載ります。前提を読む範囲と完了を判定する条件を区別できます。
|
|
129
|
+
|
|
118
130
|
`--priority` は次の目安で付けます(省略時は `medium`)。
|
|
119
131
|
|
|
120
132
|
| priority | 目安 |
|
|
@@ -127,20 +139,36 @@ SpecDojo 自身のリポジトリへ起票する場合も、同じように別
|
|
|
127
139
|
|
|
128
140
|
値の一覧と個票 frontmatter の定義は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) と `register-item-frontmatter.schema.yaml` を正本とします。各 type の意味と、迷ったときの判断基準は次のとおりです。
|
|
129
141
|
|
|
130
|
-
| type | 意味
|
|
131
|
-
| ---------------- |
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
134
|
-
| `
|
|
135
|
-
| `
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
138
|
-
| `
|
|
142
|
+
| type | 意味 | 迷ったとき |
|
|
143
|
+
| ---------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
144
|
+
| `epic` | track ごとの大きな仕事と着手・完了判断 | 具体的な作業は `--from` でつなぐ子 todo にする。epic 自体は実行しない |
|
|
145
|
+
| `todo` | 実施が決まっている作業 | 変更判断を伴うなら `change-request`、外部待ちは `todo`/`issue` に登録し `register wait` で `waiting` にする |
|
|
146
|
+
| `question` | 回答・確認が必要な事項 | 共有だけでよいなら `note`、選択肢を決める判断なら `decision` |
|
|
147
|
+
| `risk` | まだ顕在化していない懸念 | すでに発生している問題なら `issue` |
|
|
148
|
+
| `issue` | 顕在化している問題 | 未発生の懸念なら `risk` |
|
|
149
|
+
| `change-request` | 成果物・仕様・計画に対する変更の要望 | 実施が確定済みの作業なら `todo` |
|
|
150
|
+
| `decision` | 記録・追跡する意思決定 | 判断材料が足りず確認が先なら `question` |
|
|
151
|
+
| `note` | 共有・備忘のための記録 | 回答や結論が必要なら `question` |
|
|
139
152
|
|
|
140
153
|
外部の対応・提供物への依存(外部待ち)には専用 type を設けない。対応が必要なら `todo` / `issue` として登録し、外部待ちで止まっている状態は `register wait` の `waiting` ステータスで表す。計画上の前提・制約・依存関係は `prj-assumptions-constraints-dependencies` 成果物へ整理する。
|
|
141
154
|
|
|
142
155
|
type は派生ビューの生成と `exec run --register` の挙動(`agent実行・定期実行との連携` を参照)に影響するため、内容が変質した場合は `register update` で見直します。
|
|
143
156
|
|
|
157
|
+
### 1.4. track の仕事を epic と子 todo で管理する
|
|
158
|
+
|
|
159
|
+
epic は `track` を Frontmatter に持ち、子 todo と schedule の進捗を材料に、人が完了を判断します。`tml-index.yaml` がある場合は、定義済みの track だけを指定できます。timeline がない project でも track の識別子を保持できます。
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
specdojo register add --type epic --title "業務の仕様整備" --topic business-specs --track business
|
|
163
|
+
specdojo register add --type todo --title "カタログを作成する" --topic business-catalog --from PJR-AB12
|
|
164
|
+
specdojo register update --id PJR-AB12 --track business
|
|
165
|
+
specdojo register build
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
`PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。timeline の配置は project の `timeline_path` に従い、省略時は project 配下の `timeline/tml-index.yaml` を参照します。add・update・build で track を検証し、変更は event に記録します。
|
|
169
|
+
|
|
170
|
+
`register build` は `generated/pjr-epic-items.md` に、epic ごとの直接の子項目とその type・現在の状態を表示します。別 project の子も project 修飾 ID で表示し、子がない epic も残します。孫は再帰的に表示しません。子の状態から epic を自動 close せず、完了基準を満たしたことを人が確認して `register close --id <epic-id> --conclusion "判断の根拠"` で `done` にします。`reject` / `defer` / `reopen` も todo と同じように使用できます。
|
|
171
|
+
|
|
144
172
|
## 2. 登録項目のライフサイクル
|
|
145
173
|
|
|
146
174
|
登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
|
|
@@ -303,6 +331,20 @@ specdojo register update \
|
|
|
303
331
|
|
|
304
332
|
### 2.4. 派生ビューの扱い
|
|
305
333
|
|
|
334
|
+
起票の由来は `derived_from`、実行前に完了しているべき先行項目は `depends_on` に記録します。由来だけでは実行順序を制限しません。
|
|
335
|
+
|
|
336
|
+
```bash
|
|
337
|
+
specdojo register add --type todo --title "後続の作業" --depends-on PJR-AB12 --depends-on prj-0002:PJR-CD34
|
|
338
|
+
specdojo register update --id PJR-EF56 --depends-on PJR-AB12
|
|
339
|
+
specdojo register update --id PJR-EF56 --depends-on -
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
`--depends-on` は反復指定でき、update では一覧を置換します。`-` 単独で削除し、変更は event に残ります。参照の書式と project 間の存在確認は `derived_from` と同じで、別 project は設定とローカル統合ブランチを必要とします。記帳前と `register build` で存在しない ID、自己参照、循環(project 間も含む)を拒否します。
|
|
343
|
+
|
|
344
|
+
先行項目がすべて `done` / `decided` になるまで、直接の `exec run --register` は先行 ID と状態を表示して停止します。`rejected` / `deferred` でも進めません。routine の sweep(`--register-filter`)は理由を出力して飛ばし、夜間 orchestrator はスキップ理由を朝報告にも記録します。スキップは件数上限を消費せず、個票を自動で `waiting` へ変更しません。同じ queue 内の先行項目を待って自動再選択はしないため、先行の完了後に次の sweep / 夜間実行で後続を選びます。
|
|
345
|
+
|
|
346
|
+
一覧の `depends_on` 列で先行項目を確認でき、`generated/pjr-dependent-items.md` では先行項目から後続項目を逆引きできます。
|
|
347
|
+
|
|
306
348
|
登録項目一覧と派生ビューは、個票を入力として `register build` で生成します。
|
|
307
349
|
|
|
308
350
|
```bash
|
|
@@ -358,7 +400,7 @@ specdojo register history --project <project-id> --since 2026-08-01 --json
|
|
|
358
400
|
```
|
|
359
401
|
|
|
360
402
|
- `register add`、状態遷移、`register update`、`register renumber` は、現在値を個票へ、event を項目別イベントファイルへ書き込みます。`--by` と `--reason` を指定すると actor と理由を明示できます。記帳と再生成を `register lifecycle` 枠の内側で commit まで完了させる場合は `--commit` を付けます。
|
|
361
|
-
-
|
|
403
|
+
- 入力は一覧に出なくても `input` の変更として event に記録します。それ以外の一覧の列に現れない変更(対応結果本文の追記、個票 `status` の昇格など)は event になりません。個票の全差分が必要な場合は `git log -p` を使います。
|
|
362
404
|
- `--status-only` は追加・削除・状態遷移だけを残し、変更内容も遷移に関わる項目(`status` / `type` / `completed` / `conclusion`)へ絞ります。
|
|
363
405
|
- `renumber` による ID 付け替えは、`id` の変更を含む `updated` イベントとして現れます。
|
|
364
406
|
- 複数の遷移を1コミットへまとめたり squash したりしても、項目別イベントファイルに残る各 event の発生日時・actor・変更内容は失われません。`register start` を含む遷移時の commit policy は別の運用判断です。
|
|
@@ -415,7 +457,7 @@ specdojo exec run --project <project-id> --register PJR-0012 --in-place
|
|
|
415
457
|
specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree --parallel 2
|
|
416
458
|
```
|
|
417
459
|
|
|
418
|
-
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
|
|
460
|
+
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`epic` / `decision` / `note` は実行対象外です。
|
|
419
461
|
- 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
|
|
420
462
|
- todo 個票に `approach` と `targets` を指定した場合、成果物カタログの `done_criteria` や kata 参照を取り込んだ schedule と共通の plan が生成されます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
421
463
|
- 個票 Frontmatter の `targets` に宣言した変更対象文書は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。`targets` がない場合は finding を展開しません。「関連ドキュメント」は根拠や参考への導線であり、そこに wikilink があるだけでは解消対象になりません。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
|
|
@@ -449,7 +491,7 @@ specdojo register update --project <project-id> --id PJR-0012 \
|
|
|
449
491
|
--autopilot - --by <approver> --reason "夜間 queue から除外"
|
|
450
492
|
```
|
|
451
493
|
|
|
452
|
-
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
494
|
+
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。epic、decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
453
495
|
|
|
454
496
|
夜間実行は `specdojo orchestrator night` が担います。worktree 隔離、post-review、自動 close / `waiting` への復帰を必須とし、件数、並列数、連続失敗停止、rate limit 時の fallback をオプションで制限します。承認範囲外の操作が必要になった失敗は、元項目を `derived_from` に持つ issue として起票します。結果は `execution/reports/night-orchestrator/` の朝報告 1 文書へ集約します。
|
|
455
497
|
|
|
@@ -84,7 +84,7 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
|
|
|
84
84
|
|
|
85
85
|
scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
|
|
86
86
|
|
|
87
|
-
- `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x
|
|
87
|
+
- `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。ラベル(`devcontainer.local_folder`)が一致するコンテナだけを探して接続し、停止していれば `devcontainer up` で起動してからコンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
|
|
88
88
|
- `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。`RemoteCommand` では端末の `PATH` の設定が読み込まれないため、接続元から `ssh <host> 'command -v devcontainer'` を実行して Dev Container CLI が見つかるか確かめられます。
|
|
89
89
|
|
|
90
90
|
`devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
|
|
@@ -19,7 +19,7 @@ SpecDojo は道場のメタファーとして、進め方(`approach`)を「R
|
|
|
19
19
|
|
|
20
20
|
**この文書で分かること**
|
|
21
21
|
|
|
22
|
-
- `approach`
|
|
22
|
+
- `approach` の選び方と一覧、`draft` と `fully-guided` の使い分け、文脈の置き場所の使い分け、参照の共通原則、実践の型メンテナンスの進め方、review への適用
|
|
23
23
|
|
|
24
24
|
**次に読む文書**
|
|
25
25
|
|
|
@@ -42,17 +42,21 @@ SpecDojo は道場のメタファーとして、進め方(`approach`)を「R
|
|
|
42
42
|
|
|
43
43
|
### 1.1. approach の選び方
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
進め方は、まずタスクの目的で分かれ、文脈で任された範囲を調べて下書きする場合は `draft`、既存成果物を磨き込む場合は `fully-guided` を選びます。その他の成果物作成・更新では実践の型の整備状況でさらに分かれます。`fully-guided` / `recipe-guided` / `freeform` は実践の型をどこまで基準にするかを表します。`retrofit` は実装先行時の現在動作調査、`bootstrap` / `cross-deliverable-dedup`・各 `*-authoring`・各 `*-maintenance`・`finalize` 系は、それぞれの目的に応じて選ぶ進め方です。
|
|
46
46
|
|
|
47
47
|
```mermaid
|
|
48
48
|
flowchart TD
|
|
49
49
|
P{"タスクの目的"}
|
|
50
|
-
P -->|"
|
|
51
|
-
|
|
50
|
+
P -->|"任された文脈を調べて下書きする"| DR["draft"]
|
|
51
|
+
SC["雛形 → 人が文脈を記入"] --> DR
|
|
52
|
+
DR --> FG["fully-guided<br/>既存成果物を磨き込む"]
|
|
53
|
+
P -->|"既存成果物を磨き込む"| FG
|
|
54
|
+
P -->|"その他の成果物作成・更新"| M{"実践の型の整備状況"}
|
|
55
|
+
M -->|"必要な型が揃い信頼できる"| FG
|
|
52
56
|
M -->|"recipe のみ使える"| RG["recipe-guided"]
|
|
53
57
|
M -->|"実践の型に頼れない"| FF["freeform"]
|
|
54
|
-
FG -->
|
|
55
|
-
RG --> W
|
|
58
|
+
FG --> RV["レビュー → finalize(人が確定)"]
|
|
59
|
+
RG --> W["雛形から開始 → 内容を記述 → レビュー"]
|
|
56
60
|
FF --> W
|
|
57
61
|
P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
|
|
58
62
|
P -->|"成果物と実践の型を新規に一括整備"| BS["bootstrap"]
|
|
@@ -62,7 +66,7 @@ flowchart TD
|
|
|
62
66
|
P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
|
|
63
67
|
```
|
|
64
68
|
|
|
65
|
-
|
|
69
|
+
`draft` は文脈で任された調査・下書きのための段であり、型の件数からは自動選択しません。整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
|
|
66
70
|
|
|
67
71
|
### 1.2. approach 一覧
|
|
68
72
|
|
|
@@ -70,9 +74,9 @@ flowchart TD
|
|
|
70
74
|
|
|
71
75
|
#### 1.2.1. 成果物の作成・更新
|
|
72
76
|
|
|
73
|
-
|
|
77
|
+
`draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
|
|
74
78
|
|
|
75
|
-
|
|
79
|
+
`draft` を除く三つの流は、型との関係を表す守破離に対応します。「守」は型をそのまま守り、「破」は型を基準にしながら工夫し、「離」は型から離れて完了条件と根拠から組み立てます。守破離は品質の序列ではなく、タスクの目的と実践の型の整備状況に応じて進め方を選ぶための名前です。
|
|
76
80
|
|
|
77
81
|
```mermaid
|
|
78
82
|
flowchart LR
|
|
@@ -83,18 +87,103 @@ flowchart LR
|
|
|
83
87
|
CTX["類似成果物・<br/>プロジェクト文脈"]
|
|
84
88
|
D["成果物"]
|
|
85
89
|
|
|
86
|
-
RB -->|fully-guided| D
|
|
87
|
-
RC -->|fully-guided / recipe-guided| D
|
|
88
|
-
SP -->|fully-guided| D
|
|
89
|
-
TP -->|
|
|
90
|
+
RB -->|draft / fully-guided| D
|
|
91
|
+
RC -->|draft / fully-guided / recipe-guided| D
|
|
92
|
+
SP -->|draft / fully-guided| D
|
|
93
|
+
TP -->|draft| D
|
|
94
|
+
CTX -->|draft| D
|
|
95
|
+
EXT["外部の情報(出典つき)"] -->|draft:任された範囲| D
|
|
90
96
|
CTX -->|freeform| D
|
|
91
97
|
```
|
|
92
98
|
|
|
93
|
-
| `approach` | 流の名前 | 参照方針と進め方
|
|
94
|
-
| --------------- | -------- |
|
|
95
|
-
| `
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
99
|
+
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
100
|
+
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
101
|
+
| `draft` | 下書き | 文脈で任された範囲を調べて下書きする。型・依存成果物・`based_on`・`project_context`・個票の `入力`・カタログの `brief`・成果物内の文脈・出典つき外部情報を参照する。選定値を提案として示し、出典と選定理由を result に残す | `xep-draft-template.md`(edit) |
|
|
102
|
+
| `fully-guided` | 守 | 既存成果物の磨き込み専用。宣言された rulebook / recipe / sample、`depends_on`、`based_on`、`project_context`、個票の `入力`、カタログの `brief` だけを参照する。template は読み込まない | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
103
|
+
| `recipe-guided` | 破 | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
104
|
+
| `freeform` | 離 | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
105
|
+
|
|
106
|
+
##### draft と fully-guided の使い分け
|
|
107
|
+
|
|
108
|
+
`draft` と `fully-guided` は、未作成または下書き段階の成果物を段階的に仕上げるために組み合わせて使います。
|
|
109
|
+
|
|
110
|
+
| 観点 | `draft`(下書き) | `fully-guided`(磨き込み) |
|
|
111
|
+
| ----------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
|
|
112
|
+
| 目的 | 文脈で任された調査・技術選定を行い、下書きを作成する | 既存の草案を実践の型に適合させ、構造・用語・整合性を磨き込む |
|
|
113
|
+
| 根拠のない具体化 | **任された範囲に限り解除**。外部情報(Web や公式資料)を調べて値を決めてよい | **厳格に禁止**。宣言された文書で裏付けが取れる範囲のみ修正・補完する |
|
|
114
|
+
| 外部調査・選定 | 行う。選定した値は成果物内で「提案」として示し、出典と選定理由を result に残す | 行わない。新たな外部探索や独自選定はせず、既存記述を整理する |
|
|
115
|
+
| template の参照 | 参照する(雛形から章構成や初期記述を起こす) | 参照しない(既に草案があるため型のみ参照) |
|
|
116
|
+
| 文脈の目印 `_CONTEXT_:` | 指示を本文へ反映したら目印を削除し、元の指示と選定内容を result に写す | 反映・削除しない。残存している指示は未決論点(_TODO_)として result に残す |
|
|
117
|
+
| 主な適用タイミング | 成果物の新規作成時、技術スタックや方式の調査・選定を agent に委任する段 | `draft` による草案作成後、または既存成果物の改訂・品質向上を行う段 |
|
|
118
|
+
|
|
119
|
+
##### 文脈の置き場所の使い分け
|
|
120
|
+
|
|
121
|
+
文脈(前提・制約・調査委任の指示)を agent に渡す場所には、成果物内の `_CONTEXT_:`、個票の `入力`(`--input`)、カタログの `brief` の 3 つがあります。それぞれの特徴と適した用途に応じて使い分けます。
|
|
122
|
+
|
|
123
|
+
| 置き場所 | 指定方法 | 特徴と適した用途 | ライフサイクル・反映先 |
|
|
124
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
125
|
+
| 成果物内の `_CONTEXT_:` | 成果物の対象段落の先頭に `_CONTEXT_:` と記述(文書全体なら先頭章、特定項目なら該当見出し直下) | 特定の章や構成に局所化した指示、雛形を確認しながらその場で書き込みたい前提・調査指示 | `draft` が本文反映後に削除して result に記録。`finalize` 時や `status: ready` で残っていれば lint で error |
|
|
126
|
+
| 個票の `入力`(`--input`) | `register add` / `register update` の `--input <text>` で指定 | オーケストレーターや人との対話から得た前提、単発の制約、調査・選定の委任範囲。成果物ファイルを開かずに起票時に渡したい文脈 | 個票の「入力」節に記録され、register 経由の plan に前提として展開される |
|
|
127
|
+
| カタログの `brief` | カタログ(`dct-*.yaml`)の成果物定義に `brief: \|` で記述 | プロジェクトや成果物群全体で継続して渡したい共通前提(採用技術スタック、基盤条件など)。複数成果物で YAML アンカー(`&anchor` / `*anchor`)による共有が可能 | カタログに保持され、schedule と register の両経路の plan に一貫して前提として展開される |
|
|
128
|
+
|
|
129
|
+
##### 文脈を渡して作成する具体例(TSD の技術選定)
|
|
130
|
+
|
|
131
|
+
たとえば、技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して作成する場合、文脈の置き場所によって次のように渡します。
|
|
132
|
+
|
|
133
|
+
- **カタログの `brief` で渡す場合(プロジェクト共通の前提)**:
|
|
134
|
+
Web サイト構築プロジェクトで、サイト全体の技術方針として静的サイト構成を採用することがあらかじめ決まっている場合、カタログの成果物エントリに `brief` として定義します。
|
|
135
|
+
|
|
136
|
+
```yaml
|
|
137
|
+
specdojo:
|
|
138
|
+
id: prj-0001:cxd-specdojo
|
|
139
|
+
# ...
|
|
140
|
+
deliverables:
|
|
141
|
+
- id: tsd-frontend-site
|
|
142
|
+
name: "フロントエンド技術スタック詳細定義"
|
|
143
|
+
rulebook: specdojo:tsd-rulebook
|
|
144
|
+
brief: |
|
|
145
|
+
静的サイト構成を採用する。主流の技術スタック(Astro 等)を基本とし、ビルド性能と拡張性を重視する。
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
- **個票の `入力`(`--input`)で渡す場合(対話からの委任指示)**:
|
|
149
|
+
対話を通じて「静的サイトで主流の技術スタックを調べて下書きしてほしい」と決まった場合、成果物ファイルを開かずに起票コマンドで前提を渡します。
|
|
150
|
+
|
|
151
|
+
```bash
|
|
152
|
+
specdojo register add \
|
|
153
|
+
--project prj-0001 \
|
|
154
|
+
--type todo \
|
|
155
|
+
--title "フロントエンドTSDの下書き" \
|
|
156
|
+
--approach draft \
|
|
157
|
+
--target prj-0001:tsd-frontend-site \
|
|
158
|
+
--input "静的サイトで主流の技術スタック(Astro 等)を調査し、選定理由と構成を下書きする"
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
- **成果物内の `_CONTEXT_:` で渡す場合(章ごとの局所的な指示)**:
|
|
162
|
+
まず `deliverable scaffold` で成果物の雛形を作成します。カタログにある成果物は `--target` で 1 件だけ指定して作成でき、カタログにない成果物は `--target-path` と `--target-rulebook` を添えて作成します(template のない rulebook でも `deliverable_type` を引き継いだ最小雛形が生成されます)。
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
# カタログにある成果物を 1 件だけ指定して作成する場合
|
|
166
|
+
specdojo deliverable scaffold \
|
|
167
|
+
--project prj-0001 \
|
|
168
|
+
--target prj-0001:tsd-frontend-site
|
|
169
|
+
|
|
170
|
+
# カタログにない成果物を雛形にする場合
|
|
171
|
+
specdojo deliverable scaffold \
|
|
172
|
+
--project prj-0001 \
|
|
173
|
+
--target prj-0001:tsd-custom-tool \
|
|
174
|
+
--target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
|
|
175
|
+
--target-rulebook specdojo:tsd-rulebook
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
雛形を作成した後、特定の章(「採用技術・設定」章など)に直接指示を置きたい場合に記述します。
|
|
179
|
+
|
|
180
|
+
```markdown
|
|
181
|
+
## 4. 採用技術・設定
|
|
182
|
+
|
|
183
|
+
_CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、選定したフレームワークやライブラリの採用値・選定理由・反映方法を提案として表にまとめてください。
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
`draft` はこの指示を読んで外部情報を調査し、選定値を「提案」として記述した上で `_CONTEXT_:` を削除し、result に出典・選定理由と元の指示を記録します。続く `fully-guided` が、その草案を tsd の型に合わせて磨き込みます。
|
|
98
187
|
|
|
99
188
|
#### 1.2.2. 初期整備・実装反映・横断整理
|
|
100
189
|
|
|
@@ -198,16 +287,17 @@ flowchart LR
|
|
|
198
287
|
|
|
199
288
|
`approach` にかかわらず適用する原則です。
|
|
200
289
|
|
|
201
|
-
- 矛盾時の優先: `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
202
|
-
- 参照範囲: `fully-guided` / `recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
290
|
+
- 矛盾時の優先: `draft` / `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
291
|
+
- 参照範囲: `fully-guided` は宣言された文書だけを参照します。対象成果物、rulebook / 併せて適用する rulebook / recipe / sample、`depends_on` 成果物、対象成果物 frontmatter の `based_on`、`project_context`、個票の `入力`、カタログの `brief` を含み、未宣言の文書や外部の情報は探索しません。`入力` と `brief` は未指定なら plan に載りません。`draft` はこれらに template・成果物内の文脈・任された調査に必要な出典つき外部情報を加えます。`recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
203
292
|
- 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
|
|
204
|
-
- 根拠のない具体化の禁止: `freeform`
|
|
293
|
+
- 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
|
|
205
294
|
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
206
295
|
- 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
296
|
+
- 前提・概要・判定基準の使い分け: カタログの `overview`(成果物の目的を1文で表す概要)、`brief`(成果物の外から継続して渡す技術スタックや制約などの前提)、`done_criteria`(成果物が満たすべき検証可能な完了条件)を明確に区別します。`brief` は schedule / register 両経路の plan に前提として展開され、未指定なら plan に載りません。複数の成果物で前提を共有する場合は YAML アンカー(`&anchor` / `*anchor`)を活用できます。前提を完了条件に混同せず、検証可能な基準だけを `done_criteria` に記載します。
|
|
207
297
|
|
|
208
298
|
### 1.4. 成果物カタログなしで進める
|
|
209
299
|
|
|
210
|
-
register からの `fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
|
|
300
|
+
register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
|
|
211
301
|
|
|
212
302
|
カタログの `done_criteria` はないため、個票の完了条件と rulebook を完了基準にします。`fully-guided` には `not-needed` を除く kata 一式、`recipe-guided` には recipe が必要で、不足すると起票時に停止します。`retrofit` では調べる実装のパスを個票に明記します。
|
|
213
303
|
|
|
@@ -240,7 +330,8 @@ review でも「整備状況に応じた進め方(approach)」を使いま
|
|
|
240
330
|
|
|
241
331
|
通常の成果物編集では観点別の自己レビューを行わず、`done_criteria` を「完了の狙い」として扱います。多観点での品質評価と証跡は grade が担い、独立した review は grade 結果を事実としてタスクの完了可否を判断します。以下の `approach` ごとの参照方針は、編集時の記述と review の照合範囲に適用します。
|
|
242
332
|
|
|
243
|
-
- `
|
|
333
|
+
- `draft`: 文脈で任された範囲の下書き、提案の表示、出典と選定理由・元の指示の記録をタスクの完了条件と照合します。
|
|
334
|
+
- `fully-guided`: 宣言された参照と、edit plan に展開された既存成果物の磨き込み範囲を照合します。品質上の適合性は grade 結果を使い、review が新しい level や finding を付けません。
|
|
244
335
|
- `recipe-guided`: recipe と edit plan に限定して作業範囲を照合し、rulebook / sample / template を新たな判定基準として持ち込みません。
|
|
245
336
|
- `freeform`: カタログの `done_criteria`、対応 schema、edit plan が示した既存の類似成果物やプロジェクト文脈を、完了条件の照合資料として使います。
|
|
246
337
|
- `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`: 「実践の型メンテナンスの進め方」に従い、対象の実践の型と edit plan の完了条件を照合します。実践の型そのものの品質評価は、review 前段の kata grade を使います。
|
|
@@ -358,21 +358,48 @@ phase や owner rule に書く `approach` は、タスクの目的と実践の
|
|
|
358
358
|
|
|
359
359
|
| 段階 | 正本・担当 | 出力 |
|
|
360
360
|
| -------- | -------------------------------------- | ------------------------------------------------------------ |
|
|
361
|
-
| 目的宣言 | strategy の `approach_rules` |
|
|
361
|
+
| 目的宣言 | strategy の `approach_rules` | 8 種の `intent` と必要な target / scope |
|
|
362
362
|
| 品質評価 | `specdojo grade` | grade result サイドカーの保存済み `verdict` |
|
|
363
363
|
| 事実収集 | コード | 実在、要否宣言、参照切れ、実装エビデンス |
|
|
364
364
|
| 規則適用 | コード(`schedule strategy generate`) | 成果物ごとの approach |
|
|
365
365
|
| 構造生成 | コード(`schedule strategy generate`) | scope・profile・owner・gate・依存・milestone を持つ strategy |
|
|
366
366
|
|
|
367
|
-
- `TaskIntent`
|
|
367
|
+
- `TaskIntent` 8 種は `author-deliverable`、`draft-with-context`、`bootstrap-kata-set`、`reflect-implementation`、`deduplicate-across-deliverables`、`improve-kata`、`confirm-deliverable`、`confirm-with-kata-set` です。同じ track や owner rule 内でも成果物ごとに別の rule へ分けられます。
|
|
368
368
|
- `author-deliverable` は grade が `pass` の Kata を利用可能とし、`fully-guided` / `recipe-guided` / `freeform` を導出します。他の intent は目的別の `bootstrap` / `retrofit` / 横断整理 / maintenance / finalize 系へ一意に写像します。
|
|
369
369
|
- `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
|
|
370
370
|
- intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
|
|
371
|
-
- 標準 profile は `bootstrap`、`retrofit`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
|
|
371
|
+
- 標準 profile は `bootstrap`、`retrofit`、`draft`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
|
|
372
372
|
- owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
|
|
373
373
|
- generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
|
|
374
374
|
|
|
375
|
-
コマンドの使い方は [CLIコマンドリファレンス]
|
|
375
|
+
コマンドの使い方は [[specdojo:command-reference|CLIコマンドリファレンス]] の `schedule strategy(決定論的な strategy 生成)`、`approach` ごとの進め方は [[specdojo:ryu-guide|実践の進め方ガイド]] を参照します。
|
|
376
|
+
|
|
377
|
+
### 3.6. 人の文脈から始める `draft` profile
|
|
378
|
+
|
|
379
|
+
人が前提や調査の委任範囲を雛形へ書いてから agent に下書きを任せたい場合は、`strategy-planning` の作業で対象成果物に `intent: draft-with-context` を宣言します。必要な Kata の保存済み grade がすべて `pass` なら `draft` profile を生成します。`not-needed` の型は不要として扱い、grade 不明・型の不足があれば生成を停止します。
|
|
380
|
+
|
|
381
|
+
```yaml
|
|
382
|
+
approach_rules:
|
|
383
|
+
- local_ids: [prj-overview]
|
|
384
|
+
intent: draft-with-context
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
| 段 | phase set | suffix | execution | mode | approach |
|
|
388
|
+
| ------------------ | --------------- | ------ | --------- | -------- | -------------- |
|
|
389
|
+
| 雛形作成・文脈記入 | `context-pass` | `010` | `human` | `edit` | `draft` |
|
|
390
|
+
| 下書き | `guided-pass` | `020` | `agent` | `edit` | `draft` |
|
|
391
|
+
| 磨き込み | `refine-pass` | `070` | `agent` | `edit` | `fully-guided` |
|
|
392
|
+
| 完成版レビュー | `review-pass` | `090` | `agent` | `review` | `fully-guided` |
|
|
393
|
+
| 確定 | `finalize-pass` | `140` | `human` | `edit` | `finalize` |
|
|
394
|
+
|
|
395
|
+
雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
|
|
396
|
+
|
|
397
|
+
1. `specdojo exec claim --project <project-id> --task <context-task-id> --by <human>` で着手します。既存の human タスクと同じく plan は生成せず、claim が作成した result に作業案内と記録欄を持ちます。
|
|
398
|
+
2. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成します。既存成果物は上書きせず、`--force` は指定しません。
|
|
399
|
+
3. 対象本文の `_CONTEXT_:` に固定前提・制約・調査や選定を任せる範囲を書きます。例: `_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。` 記法は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従います。
|
|
400
|
+
4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・review を行い、最後に人が finalize を claim / complete して確定します。
|
|
401
|
+
|
|
402
|
+
文脈の記入を待つ必要がない場合は従来の `author-deliverable` を使います。必要な型がそろった場合の `fully-guided` profile も、草案作成の `guided-pass` は `approach: draft` です。文脈や成果物が未作成でも template を骨組みにして根拠のある範囲を下書きします。文脈が無いことを調査・選定の委任とは解釈せず、未委任の判断は保留します。既存 strategy の段定義を更新するには `schedule strategy generate --force` の差分を確認して適用し、構造が変わる場合は `schedule build --force`、続いて `exec refresh` を実行します。
|
|
376
403
|
|
|
377
404
|
## 4. タスク設計の品質
|
|
378
405
|
|
|
@@ -144,30 +144,30 @@ SpecDojo では、成果物と、それを作るための型(Kata)を分け
|
|
|
144
144
|
|
|
145
145
|
## 5. プロジェクトの基本的な流れ
|
|
146
146
|
|
|
147
|
-
プロジェクトでは、最初からすべての成果物を作るのではなく、未整理の課題と判断を register
|
|
147
|
+
プロジェクトでは、最初からすべての成果物を作るのではなく、未整理の課題と判断を register で記録し、目的とスコープを明らかにしてから、トラックごとの `epic` を起点として必要な成果物を実行可能な単位へ展開します。
|
|
148
148
|
|
|
149
149
|
```mermaid
|
|
150
150
|
flowchart LR
|
|
151
151
|
A["register<br/>issue・questionを記録"]
|
|
152
152
|
B["decision<br/>目的・スコープを決定"]
|
|
153
|
-
C["
|
|
154
|
-
D["
|
|
155
|
-
E["
|
|
156
|
-
F["
|
|
153
|
+
C["epicを起票<br/>trackごとの仕事を管理"]
|
|
154
|
+
D["子todoからカタログ・strategy作成"]
|
|
155
|
+
E["Scheduleへ展開・実行"]
|
|
156
|
+
F["レビュー・確定・epic完了"]
|
|
157
157
|
|
|
158
158
|
A --> B --> C --> D --> E --> F
|
|
159
|
-
|
|
159
|
+
E -->|修正・次の反復| E
|
|
160
160
|
```
|
|
161
161
|
|
|
162
162
|
代表的な進め方は次のとおりです。
|
|
163
163
|
|
|
164
164
|
1. 未整理の問題、確認事項、判断事項があれば register に `issue` / `question` / `decision` として記録します。
|
|
165
165
|
2. 調査と判断を行い、プロジェクトの背景、目的、スコープ、成功条件、対象成果物を明らかにします。
|
|
166
|
-
3.
|
|
167
|
-
4.
|
|
168
|
-
5.
|
|
166
|
+
3. 業務の起点として track ごとに `epic` を起票し、その子 todo(`catalog-planning`)で成果物カタログを作成・検証して完了します。
|
|
167
|
+
4. カタログ作成 todo の完了から `catalog_status` が導出され、後続の子 todo(`strategy-planning`)で strategy を作成して Schedule に展開します。
|
|
168
|
+
5. 人またはエージェントが schedule の依存グラフに従って成果物を作成・更新します。途中の進み具合は schedule が持ちます。
|
|
169
169
|
6. 機械検証に加え、grade で成果物の品質を評価します。review は grade の結果を事実として受け取り、変更内容・実行記録・完了条件を照合してタスクの完了可否を判断します。
|
|
170
|
-
7. human が review result
|
|
170
|
+
7. human が review result と成果物を確認して最終承認と `ready` への確定を行い、トラック全体の成果を確認して人が `epic` を close します。
|
|
171
171
|
|
|
172
172
|
トラックの構成と実行順序は
|
|
173
173
|
[トラック設計ガイド](track-design-guide.md)、
|
|
@@ -181,15 +181,15 @@ flowchart LR
|
|
|
181
181
|
|
|
182
182
|
`SpecDojoとは` で挙げた3つの要素のうち、成果物と型で「何を・どう作るか」を定めた後、それを計画・実行・追跡・機械検証して最後まで通すのが **技(Waza)** です。技は、横軸を PDCA、縦軸を回し方(register / schedule / routine + Job)とする次のマトリクスで整理できます。
|
|
183
183
|
|
|
184
|
-
| 回し方
|
|
185
|
-
|
|
|
186
|
-
| register
|
|
187
|
-
| schedule
|
|
188
|
-
| routine + Job
|
|
184
|
+
| 回し方 | P(記す・計画する) | D(形にする) | C(評価する) | A(確定して次へ) |
|
|
185
|
+
| ------------------------------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
186
|
+
| register(親: 起点・承認・完了) | 起票し、完了条件を書く。track ごとに epic を起票し子 todo でカタログ・strategy を計画する | `exec run --register` で executor が実行する | reporter が result を書いて review へ進め、人が確かめる | runner が commit・統合する。close するか、reopen・change-request で直す(epic は人が判断) |
|
|
187
|
+
| schedule(子: 途中の進捗・依存実行) | 成果物カタログから Schedule へ展開する | `exec run --track` / `--auto` で実行する | grade(評定)と review | 統合して `ready` へ確定する。直して次の反復へ |
|
|
188
|
+
| routine + Job | Job に「何を・誰が確かめるか(`task.review`)」を、routine に「いつ」を書く | `routine run --due` が Job Run を作り、worktree で実行して runner が commit する | Job で指名した review agent が review し、verdict を出す | verdict に従って統合し、成功したときだけ checkpoint を進める |
|
|
189
189
|
|
|
190
190
|
A 列はいずれも、runner が確定して commit し、次の周回の起点にする点でそろっています。C 列は、誰が確かめるかの違いとして読めます。どの行でも、タスクの流(`approach`)が型をどこまで基準にするかを決めます。
|
|
191
191
|
|
|
192
|
-
|
|
192
|
+
register が業務の起点・着手承認・完了判断を持ち、途中の進み具合は schedule が持ちます。両者は親子の階層関係として連携し、成果物カタログの成果物をトラック・実行フェーズ(またはパス)・タスクへ展開し、plan の生成、実行、result の記録という流れで作業状態と結果を記録します。成果物カタログ・Schedule・実行管理(dct/sch/exec)の詳細な関係と図解は [ドキュメント構成ガイド](docs-structure-guide.md) の `成果物カタログ・Schedule・実行管理の関係` を参照してください。
|
|
193
193
|
|
|
194
194
|
成果物カタログと Schedule の関係、タスク設計は
|
|
195
195
|
[Schedule設計ガイド](schedule-design-guide.md)、
|