specdojo 0.4.6 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +14 -9
- package/CHANGELOG.md +62 -0
- package/dist/catalog/document-target.js +75 -0
- package/dist/commands/agent.js +2 -80
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/agent-config.js +28 -16
- package/dist/exec/agent-plan.js +108 -0
- package/dist/exec/commands.js +3 -3
- package/dist/exec/core.js +2 -0
- package/dist/exec/grade-checkpoint.js +12 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +7 -67
- package/dist/exec/plans-generation.js +28 -7
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/project.js +4 -1
- package/dist/exec/register.js +82 -6
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/lifecycle-commands.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +23 -0
- package/dist/exec/run/register-state.js +4 -1
- package/dist/exec/run/register-worktree.js +28 -1
- package/dist/exec/run/schedule-prepare.js +7 -1
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-command.js +8 -1
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree-ops-merge.js +40 -1
- package/dist/grade/apply.js +13 -7
- package/dist/grade/command-inspect.js +2 -1
- package/dist/grade/command-run.js +39 -0
- package/dist/grade/grade.js +3 -1
- package/dist/grade/markdown.js +11 -6
- package/dist/grade/pipeline-state.js +8 -6
- package/dist/grade/plan.js +14 -10
- package/dist/grade/run.js +307 -0
- package/dist/grade/target-discovery.js +1 -1
- package/dist/grade/targets.js +44 -22
- package/dist/register/approach.js +35 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +83 -5
- package/dist/register/deliverable-target.js +215 -0
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +8 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +18 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/review/grade.js +19 -17
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-plan.js +1 -0
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/provider-scaffold.js +5 -3
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/dist/specdojo.js +5 -1
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-config-guide.md +44 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +59 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
- package/docs/ja/specdojo/guides/review-guide.md +2 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +92 -29
- package/docs/ja/specdojo/references/specdojo-config-reference.md +49 -16
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +56 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +73 -4
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +21 -3
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/devcontainer.json +1 -0
- package/templates/init-agent-members.yaml +46 -3
- package/templates/opencode/README.md +118 -14
- package/templates/opencode/agents/specdojo-orchestrator.md +15 -10
- package/templates/opencode/opencode.json +25 -0
|
@@ -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 は省略すると自動採番されます。
|
|
@@ -127,20 +126,36 @@ SpecDojo 自身のリポジトリへ起票する場合も、同じように別
|
|
|
127
126
|
|
|
128
127
|
値の一覧と個票 frontmatter の定義は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) と `register-item-frontmatter.schema.yaml` を正本とします。各 type の意味と、迷ったときの判断基準は次のとおりです。
|
|
129
128
|
|
|
130
|
-
| type | 意味
|
|
131
|
-
| ---------------- |
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
134
|
-
| `
|
|
135
|
-
| `
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
138
|
-
| `
|
|
129
|
+
| type | 意味 | 迷ったとき |
|
|
130
|
+
| ---------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
131
|
+
| `epic` | track ごとの大きな仕事と着手・完了判断 | 具体的な作業は `--from` でつなぐ子 todo にする。epic 自体は実行しない |
|
|
132
|
+
| `todo` | 実施が決まっている作業 | 変更判断を伴うなら `change-request`、外部待ちは `todo`/`issue` に登録し `register wait` で `waiting` にする |
|
|
133
|
+
| `question` | 回答・確認が必要な事項 | 共有だけでよいなら `note`、選択肢を決める判断なら `decision` |
|
|
134
|
+
| `risk` | まだ顕在化していない懸念 | すでに発生している問題なら `issue` |
|
|
135
|
+
| `issue` | 顕在化している問題 | 未発生の懸念なら `risk` |
|
|
136
|
+
| `change-request` | 成果物・仕様・計画に対する変更の要望 | 実施が確定済みの作業なら `todo` |
|
|
137
|
+
| `decision` | 記録・追跡する意思決定 | 判断材料が足りず確認が先なら `question` |
|
|
138
|
+
| `note` | 共有・備忘のための記録 | 回答や結論が必要なら `question` |
|
|
139
139
|
|
|
140
140
|
外部の対応・提供物への依存(外部待ち)には専用 type を設けない。対応が必要なら `todo` / `issue` として登録し、外部待ちで止まっている状態は `register wait` の `waiting` ステータスで表す。計画上の前提・制約・依存関係は `prj-assumptions-constraints-dependencies` 成果物へ整理する。
|
|
141
141
|
|
|
142
142
|
type は派生ビューの生成と `exec run --register` の挙動(`agent実行・定期実行との連携` を参照)に影響するため、内容が変質した場合は `register update` で見直します。
|
|
143
143
|
|
|
144
|
+
### 1.4. track の仕事を epic と子 todo で管理する
|
|
145
|
+
|
|
146
|
+
epic は `track` を Frontmatter に持ち、子 todo と schedule の進捗を材料に、人が完了を判断します。`tml-index.yaml` がある場合は、定義済みの track だけを指定できます。timeline がない project でも track の識別子を保持できます。
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
specdojo register add --type epic --title "業務の仕様整備" --topic business-specs --track business
|
|
150
|
+
specdojo register add --type todo --title "カタログを作成する" --topic business-catalog --from PJR-AB12
|
|
151
|
+
specdojo register update --id PJR-AB12 --track business
|
|
152
|
+
specdojo register build
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
`PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。timeline の配置は project の `timeline_path` に従い、省略時は project 配下の `timeline/tml-index.yaml` を参照します。add・update・build で track を検証し、変更は event に記録します。
|
|
156
|
+
|
|
157
|
+
`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 と同じように使用できます。
|
|
158
|
+
|
|
144
159
|
## 2. 登録項目のライフサイクル
|
|
145
160
|
|
|
146
161
|
登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
|
|
@@ -303,6 +318,20 @@ specdojo register update \
|
|
|
303
318
|
|
|
304
319
|
### 2.4. 派生ビューの扱い
|
|
305
320
|
|
|
321
|
+
起票の由来は `derived_from`、実行前に完了しているべき先行項目は `depends_on` に記録します。由来だけでは実行順序を制限しません。
|
|
322
|
+
|
|
323
|
+
```bash
|
|
324
|
+
specdojo register add --type todo --title "後続の作業" --depends-on PJR-AB12 --depends-on prj-0002:PJR-CD34
|
|
325
|
+
specdojo register update --id PJR-EF56 --depends-on PJR-AB12
|
|
326
|
+
specdojo register update --id PJR-EF56 --depends-on -
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
`--depends-on` は反復指定でき、update では一覧を置換します。`-` 単独で削除し、変更は event に残ります。参照の書式と project 間の存在確認は `derived_from` と同じで、別 project は設定とローカル統合ブランチを必要とします。記帳前と `register build` で存在しない ID、自己参照、循環(project 間も含む)を拒否します。
|
|
330
|
+
|
|
331
|
+
先行項目がすべて `done` / `decided` になるまで、直接の `exec run --register` は先行 ID と状態を表示して停止します。`rejected` / `deferred` でも進めません。routine の sweep(`--register-filter`)は理由を出力して飛ばし、夜間 orchestrator はスキップ理由を朝報告にも記録します。スキップは件数上限を消費せず、個票を自動で `waiting` へ変更しません。同じ queue 内の先行項目を待って自動再選択はしないため、先行の完了後に次の sweep / 夜間実行で後続を選びます。
|
|
332
|
+
|
|
333
|
+
一覧の `depends_on` 列で先行項目を確認でき、`generated/pjr-dependent-items.md` では先行項目から後続項目を逆引きできます。
|
|
334
|
+
|
|
306
335
|
登録項目一覧と派生ビューは、個票を入力として `register build` で生成します。
|
|
307
336
|
|
|
308
337
|
```bash
|
|
@@ -415,7 +444,7 @@ specdojo exec run --project <project-id> --register PJR-0012 --in-place
|
|
|
415
444
|
specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree --parallel 2
|
|
416
445
|
```
|
|
417
446
|
|
|
418
|
-
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
|
|
447
|
+
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`epic` / `decision` / `note` は実行対象外です。
|
|
419
448
|
- 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
|
|
420
449
|
- todo 個票に `approach` と `targets` を指定した場合、成果物カタログの `done_criteria` や kata 参照を取り込んだ schedule と共通の plan が生成されます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
421
450
|
- 個票 Frontmatter の `targets` に宣言した変更対象文書は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。`targets` がない場合は finding を展開しません。「関連ドキュメント」は根拠や参考への導線であり、そこに wikilink があるだけでは解消対象になりません。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
|
|
@@ -449,7 +478,7 @@ specdojo register update --project <project-id> --id PJR-0012 \
|
|
|
449
478
|
--autopilot - --by <approver> --reason "夜間 queue から除外"
|
|
450
479
|
```
|
|
451
480
|
|
|
452
|
-
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
481
|
+
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。epic、decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
453
482
|
|
|
454
483
|
夜間実行は `specdojo orchestrator night` が担います。worktree 隔離、post-review、自動 close / `waiting` への復帰を必須とし、件数、並列数、連続失敗停止、rate limit 時の fallback をオプションで制限します。承認範囲外の操作が必要になった失敗は、元項目を `derived_from` に持つ issue として起票します。結果は `execution/reports/night-orchestrator/` の朝報告 1 文書へ集約します。
|
|
455
484
|
|
|
@@ -89,7 +89,7 @@ scaffold は、常時稼働ホストへの接続と tmux セッションの維
|
|
|
89
89
|
|
|
90
90
|
`devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
|
|
91
91
|
|
|
92
|
-
生成される `devcontainer.json` は `remoteEnv` で `/home/node/.local/bin`(利用者が別の場合は `/home/<remoteUser>/.local/bin`)を `PATH` の先頭に追加するため、コンテナ作成後に開く端末や VS Code のターミナルでも `~/.local/bin` に入った Claude Code などの CLI
|
|
92
|
+
生成される `devcontainer.json` は `remoteEnv` で `/home/node/.local/bin`(利用者が別の場合は `/home/<remoteUser>/.local/bin`)を `PATH` の先頭に追加するため、コンテナ作成後に開く端末や VS Code のターミナルでも `~/.local/bin` に入った Claude Code などの CLI がそのまま利用できます。また、`shutdownAction: "none"` を設定しているため、VS Code などのクライアントを切断したりウィンドウを閉じたりしてもコンテナが停止せず、tmux セッションやバックグラウンド処理を維持できます。
|
|
93
93
|
|
|
94
94
|
### 2.2. 生成した Dev Container をホストで実地確認する
|
|
95
95
|
|
|
@@ -225,6 +225,20 @@ v0.4.0 などで生成した Dev Container 環境では、`devcontainer.json`
|
|
|
225
225
|
|
|
226
226
|
コンテナ内の利用者が `node` 以外の場合は、`/home/<remoteUser>/.local/bin` に合わせてください。
|
|
227
227
|
|
|
228
|
+
### 6.4. クライアント切断時にコンテナが停止する
|
|
229
|
+
|
|
230
|
+
以前のバージョンで生成した Dev Container 環境では、`devcontainer.json` に `shutdownAction` が指定されていないため、VS Code などのクライアントを切断した際にコンテナが自動的に停止し、コンテナ内で実行中の tmux セッションやバックグラウンド処理が中断することがあります。
|
|
231
|
+
|
|
232
|
+
既存の環境を修正するには、`.devcontainer/devcontainer.json` に `"shutdownAction": "none"` を追加してください。
|
|
233
|
+
|
|
234
|
+
```json
|
|
235
|
+
"workspaceFolder": "/workspaces/<親名>/<リポジトリ名>",
|
|
236
|
+
"shutdownAction": "none",
|
|
237
|
+
"init": true,
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
設定の反映には Dev Container の再起動(VS Code で「Rebuild Container」または `devcontainer up`)を行ってください。なお、切断後もコンテナが停止しない実際の動作確認は、Docker daemon が稼働しているホスト環境(または Dev Container CLI が動作する実環境)で行う必要があります。
|
|
241
|
+
|
|
228
242
|
## 7. 運用上のセキュリティ
|
|
229
243
|
|
|
230
244
|
この構成は、常時稼働ホストを外部から到達可能にします。次を守ります。
|
|
@@ -237,11 +237,11 @@ edit plan で観点別の自己レビューを行わないのは、各観点を
|
|
|
237
237
|
|
|
238
238
|
`specdojo exec run` は、`mode: review` のタスクの plan を生成する前に、runner 自身が評価対象へ grade を実行します。executor(review を行う agent)には grade を実行させません。評価の独立性を保つためです。
|
|
239
239
|
|
|
240
|
-
この自動 grade
|
|
240
|
+
この自動 grade は同じ npm package の `grade run` を使います。開発用スクリプトの配置は不要です。選択した review agent の実体名と起動設定を引き継ぎ、対象 1 件の plan 生成・評価・サイドカー反映を実行します。成果物の grade には project の `catalog_path` が必要です。単独の実行や部品ごとの手順は [[specdojo:command-reference|CLI コマンドリファレンス]] を参照してください。
|
|
241
241
|
|
|
242
242
|
- 評価対象は成果物です。`approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、見直した実践の型そのものが評価対象になります(`--target kata`)。
|
|
243
243
|
- 評価対象の `content_hash` が既存の評価結果サイドカーの `content_hash` と一致する場合は、grade を再実行せず既存の評価結果を使います。どちらの場合も評価は 1 回です。
|
|
244
|
-
-
|
|
244
|
+
- grade は `grade run --path <対象文書>` で評価対象 1 件に絞って実行します。評価対象を解決できない場合と `--dry-run` の場合は実行しません。
|
|
245
245
|
- grade が失敗しても review は止めません。実行の結果と評価結果の鮮度を review plan に示し、review が verdict(`grade-stale` / `grade-unavailable` など)として記録します。
|
|
246
246
|
|
|
247
247
|
### 3.3. review plan の生成
|
|
@@ -205,6 +205,18 @@ flowchart LR
|
|
|
205
205
|
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
206
206
|
- 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
207
207
|
|
|
208
|
+
### 1.4. 成果物カタログなしで進める
|
|
209
|
+
|
|
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` です。既存文書と指定が矛盾した場合は停止します。
|
|
211
|
+
|
|
212
|
+
カタログの `done_criteria` はないため、個票の完了条件と rulebook を完了基準にします。`fully-guided` には `not-needed` を除く kata 一式、`recipe-guided` には recipe が必要で、不足すると起票時に停止します。`retrofit` では調べる実装のパスを個票に明記します。
|
|
213
|
+
|
|
214
|
+
`bootstrap` は kata の不足を許容し、パスと新規 rulebook ID、設定の `kata_authority` を必須とします。既存 rulebook は拒否します。rulebook ID の `-rulebook` より前の部分を共通の名前にして recipe・sample・template の ID を導出し、`docs/ja/specdojo/<kind>s/<kata_authority>/` の未作成候補を plan に載せます。作成した rulebook は成果物の `specdojo.rulebook` に記入します。
|
|
215
|
+
|
|
216
|
+
`finalize` と `bootstrap-finalize` の対象は既存文書だけです。個票の完了条件をチェック表にし、`finalize` は成果物、`bootstrap-finalize` は成果物と frontmatter から辿る kata 一式を人が確定します。
|
|
217
|
+
|
|
218
|
+
`cross-deliverable-dedup` はカタログの成果物群を対象にするため、引き続きカタログが必要です。カタログ設定済みの対象は従来の宣言を優先し、未登録の対象に限りパスと rulebook を両方明示した場合だけ上記の解決を使います。具体的な起票例は [[specdojo:quick-start-guide]]、オプションは [[specdojo:command-reference]] を参照してください。
|
|
219
|
+
|
|
208
220
|
## 2. 実践の型メンテナンスの進め方
|
|
209
221
|
|
|
210
222
|
`rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` は、通常の成果物作業とは参照の向きが逆になる進め方です。作成・更新かレビューかを `mode`(`edit` / `review`)で表す点は他の `approach` と同じです。
|
|
@@ -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)、
|
|
@@ -75,35 +75,39 @@ flowchart LR
|
|
|
75
75
|
|
|
76
76
|
### 2.4. Schedule着手可能トラックの判定
|
|
77
77
|
|
|
78
|
-
`
|
|
78
|
+
`timeline build` は `project_register_path` がある場合、`catalog-planning` の todo を domain ごとに読み、`done` が 1 件でもあればその domain を `primary` と導出します(対象 todo がない domain は手書き値を保持)。対象ドメインがすべて `primary` に達したトラックを `schedule_ready_tracks` として `timeline.json` へ列挙します。これは Schedule 展開(`schedule build --track <track>`)を開始してよいトラックの一覧です。
|
|
79
79
|
|
|
80
80
|
## 3. 運用タイミング
|
|
81
81
|
|
|
82
|
-
`timeline build`
|
|
82
|
+
`timeline build` は一度だけ実行するコマンドではなく、トラックの定義や register の状態変化に合わせて再実行する運用コマンドです。register の `epic` 起票から、子 todo によるカタログ・strategy 作成、Schedule への展開、完了判断までの流れは次のとおりです。
|
|
83
83
|
|
|
84
84
|
```mermaid
|
|
85
85
|
flowchart TD
|
|
86
|
-
A["人間がtml-index.yaml
|
|
87
|
-
B --> C
|
|
88
|
-
C
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
86
|
+
A["人間がtml-index.yamlを定義<br/>(トラック順序・並行可否・依存関係)"] --> B["specdojo timeline build"]
|
|
87
|
+
B --> C["register で track の epic を起票<br/>(register add --type epic --track <track>)"]
|
|
88
|
+
C --> D["子 todo で成果物カタログを作成<br/>(approach: catalog-planning)"]
|
|
89
|
+
D --> E["カタログ完成後、子 todo を close<br/>(register close --id <todo-id>)"]
|
|
90
|
+
E --> F["specdojo timeline build<br/>(register から catalog_status を導出)"]
|
|
91
|
+
F --> G{"schedule_ready_tracks に<br/>該当トラックがあるか"}
|
|
92
|
+
G -->|"あり"| H["子 todo で strategy を作成<br/>(approach: strategy-planning)"]
|
|
93
|
+
H --> I["specdojo schedule build --track <track><br/>(sch-track 生成・Schedule へ展開)"]
|
|
94
|
+
I --> J["schedule でタスクを実行<br/>(exec run --track / --auto)"]
|
|
95
|
+
J --> K["トラック完了後、epic を close<br/>(人が完了を判断)"]
|
|
96
96
|
G -->|"なし"| A
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
代表的な更新契機は次のとおりです。
|
|
100
100
|
|
|
101
|
-
| 更新契機
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
101
|
+
| 更新契機 | 実施すること |
|
|
102
|
+
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
|
|
103
|
+
| トラックの追加・順序計画 | `tml-index.yaml` にトラックを追加・更新し `timeline build` を実行する |
|
|
104
|
+
| track の epic 起票 | `register add --type epic --track <track>` で業務の起点となる epic を起票する |
|
|
105
|
+
| 成果物カタログの計画・作成 | epic の子 todo(`--approach catalog-planning --target domain:<domain>`)で判定・生成を進め、検証後に `register close` する |
|
|
106
|
+
| `catalog_status` の反映と着手可能判定 | `timeline build` を再実行する(register の todo 完了から `primary` が自動導出され、`schedule_ready_tracks` に反映される) |
|
|
107
|
+
| トラック戦略・Schedule の生成 | epic の子 todo(`--approach strategy-planning --target track:<track>`)で strategy 生成と `schedule build --track` を行う |
|
|
108
|
+
| Schedule の実行と epic の完了 | schedule でタスクを実行し、途中の進み具合を確認したうえで人が epic を `register close` する |
|
|
109
|
+
|
|
110
|
+
`timeline build` は register の個票から `catalog-planning` の todo を集めて `catalog_status` を導出します。カタログ作成の todo が `done` なら `primary`、着手中(`in-progress` / `waiting` / `review`)なら `draft`、`open` だけなら `not_started` と判定します。人間が書く計画である `tml-index.yaml` の手書き値は書き換えずに保持し、手書きの値と食い違うときは警告します。
|
|
107
111
|
|
|
108
112
|
### 3.1. 既にSchedule展開済みのトラックの扱い
|
|
109
113
|
|
|
@@ -115,23 +119,23 @@ flowchart TD
|
|
|
115
119
|
|
|
116
120
|
`catalog-scaffold.md` が示すドメインは、テンプレートに何が必要かが決まっていても、そのドメインで実際に何件の成果物インスタンスが要るかまでは決まっていません。この判定を agent に任せ、結果を機械可読な `dct-plan-<domain>.yaml` として残します。責務は次のとおり分担します。
|
|
117
121
|
|
|
118
|
-
| 段階 | 担当 | 出力
|
|
119
|
-
| ------------ | ----------------------------------- |
|
|
120
|
-
| 着手対象提示 | Timeline(`timeline build`) | `catalog-scaffold.md`(未作成カタログのドメイン一覧)
|
|
121
|
-
| 意味判断 | agent(`catalog plan`) | `dct-plan-<domain>.yaml`(インスタンス・根拠・未確定事項)
|
|
122
|
-
| 構造生成 | コード(`catalog scaffold --plan`) | `dct-<domain>.yaml`
|
|
123
|
-
| 状態更新 |
|
|
122
|
+
| 段階 | 担当 | 出力 |
|
|
123
|
+
| ------------ | ----------------------------------- | --------------------------------------------------------------------------------- |
|
|
124
|
+
| 着手対象提示 | Timeline(`timeline build`) | `catalog-scaffold.md`(未作成カタログのドメイン一覧) |
|
|
125
|
+
| 意味判断 | agent(`catalog plan`) | `dct-plan-<domain>.yaml`(インスタンス・根拠・未確定事項) |
|
|
126
|
+
| 構造生成 | コード(`catalog scaffold --plan`) | `dct-<domain>.yaml` |
|
|
127
|
+
| 状態更新 | register の todo 完了 | `timeline build` が導出する `catalog_status`(`tml-index.yaml` の値は保持・警告) |
|
|
124
128
|
|
|
125
129
|
- agent は成果物インスタンスの要否、placeholder 値、採用しない候補、未確定事項の整理だけを担当します。ID・パス・`groups`・`done_criteria` の組み立てと schema 適合はコード側の責務です。
|
|
126
130
|
- 判定は Timeline が着手対象として示したドメインに限定し、入力は data-flow を中心とした上流成果物と、既存カタログがある場合はその基準線に限定します。
|
|
127
|
-
- 判定計画が保存されても `catalog_status`
|
|
131
|
+
- 判定計画が保存されても `catalog_status` は自動では変わりません。カタログ作成の todo(`catalog-planning`)を完了(`register close`)し、`timeline build` を再実行することで `catalog_status` が `primary` と導出されます。
|
|
128
132
|
- 再判定時は既存の判定計画を無条件に置き換えず、差分をレビューしてから `--force` で更新します。
|
|
129
133
|
- 判定後は `catalog scaffold --plan --dry-run --domain <domain>` で差分を確認し、問題がなければ `--plan` で生成します。物理分割 domain は同じ `domain` の全 template から分割 DCT をまとめて生成します。
|
|
130
|
-
-
|
|
134
|
+
- 生成成功後は生成 DCT を確認・検証した後にカタログ作成の todo を close し、`timeline build` を再実行して `primary` の導出を確定します。
|
|
131
135
|
|
|
132
136
|
### 3.3. Schedule strategy 生成への引き渡し
|
|
133
137
|
|
|
134
|
-
|
|
138
|
+
カタログ作成の todo を完了した後は、Timeline の track と `domains` が新規 strategy の scope 解決に使われます。epic の子 todo(`--approach strategy-planning --target track:<track>`)で strategy に scope と成果物別 `approach_rules` を宣言した後、`schedule strategy generate` が facts と grade から approach を導出して標準 profile へ展開し、`schedule build --track <track>` で Schedule を生成します。
|
|
135
139
|
|
|
136
140
|
```text
|
|
137
141
|
tml-index.yaml + dct-*.yaml
|
|
@@ -152,9 +156,9 @@ tml-index.yaml + dct-*.yaml
|
|
|
152
156
|
|
|
153
157
|
## 5. アンチパターン
|
|
154
158
|
|
|
155
|
-
| アンチパターン | 問題
|
|
156
|
-
| ----------------------------------------------------------------- |
|
|
157
|
-
|
|
|
158
|
-
| `parallel_group` を安易に共通ラベルへ寄せる | 実際には並行させてはいけないトラックまで並行候補に見えてしまう
|
|
159
|
-
| Timeline に実行実績(完了日・進捗率)を書き戻す | 計画と実績の区別がつかなくなり、`sch-milestones.yaml` と情報が二重化する
|
|
160
|
-
| `timeline build` の生成物(`timeline-order.md` 等)を直接編集する | 次回 `timeline build` 実行時に上書きされ、編集内容が失われる
|
|
159
|
+
| アンチパターン | 問題 | 対策 |
|
|
160
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
161
|
+
| カタログ作成の todo を close しないまま放置する | `timeline build` が `catalog_status` を `primary` と導出できず、着手可能判定が進まない | カタログ完成と検証後に `register close` で todo を完了させ、`timeline build` で最新状態を導出する |
|
|
162
|
+
| `parallel_group` を安易に共通ラベルへ寄せる | 実際には並行させてはいけないトラックまで並行候補に見えてしまう | 並行させてよい理由が同じトラックだけを同じ `parallel_group` にする([タイムライン作成ルール](../rulebooks/tml-rulebook.md) の `order` と `parallel_group`) |
|
|
163
|
+
| Timeline に実行実績(完了日・進捗率)を書き戻す | 計画と実績の区別がつかなくなり、`sch-milestones.yaml` と情報が二重化する | 実績は `sch-milestones.yaml` と `generated/` に任せ、Timeline は計画のみを保持する |
|
|
164
|
+
| `timeline build` の生成物(`timeline-order.md` 等)を直接編集する | 次回 `timeline build` 実行時に上書きされ、編集内容が失われる | 変更したい内容は `tml-index.yaml` に反映してから `timeline build` を再実行する |
|