specdojo 0.6.0 → 0.8.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 +3 -2
- package/CHANGELOG.md +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -25
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/register-resume.js +69 -42
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -32
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git.js +149 -15
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +146 -99
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +132 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +164 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -47,6 +47,8 @@ exec run --auto [--loop]
|
|
|
47
47
|
-> 失敗: result を blocked に更新 / block / worktree を保持
|
|
48
48
|
exec refresh
|
|
49
49
|
-> 次の Ready タスクを更新
|
|
50
|
+
run の終わり
|
|
51
|
+
-> runner が書いたイベントと run の記録を記帳の commit 1件にまとめる
|
|
50
52
|
```
|
|
51
53
|
|
|
52
54
|
`--loop --parallel <n>` では、最初に最大 `n` 件を起動した後、1件の agent が終了するたびに root 側の統合処理を終えて `exec refresh` を実行し、空いた枠へ次の Ready タスクを投入します。他の実行中 task の完了を待たないため、長時間 task と短時間 task が混在しても短時間 task の枠を継続利用できます。`--loop` を指定しない場合は、開始時に選択した最大 `n` 件だけを実行して終了します。
|
|
@@ -62,21 +64,34 @@ specdojo exec run --project <project-id> --auto --loop --parallel 5
|
|
|
62
64
|
|
|
63
65
|
# FIFO順で実行する
|
|
64
66
|
specdojo exec run --project <project-id> --auto --strategy fifo
|
|
67
|
+
|
|
68
|
+
# 指定した track だけから最大 3 件を選ぶ(実行前の確認)
|
|
69
|
+
specdojo exec run --project <project-id> --auto --track data-flow-uc-rewrite --parallel 3 --dry-run
|
|
70
|
+
|
|
71
|
+
# 同じ track の Ready がなくなるまで連続実行する
|
|
72
|
+
specdojo exec run --project <project-id> --auto --track data-flow-uc-rewrite --parallel 3 --loop
|
|
65
73
|
```
|
|
66
74
|
|
|
75
|
+
`--track <track>` は自動選択を 1 つの track に限定します。`sch-track-<track>.yaml`(または `.yml`)の track 名を大文字・小文字を区別して指定します。戦略による順序は維持され、準備や実行に失敗した後、`--loop` で枠を補充するときも、ほかの track は選びません。対象 track に Ready がなければ正常終了し、存在しない track は claim 前にエラーになります。`--track` は単一指定で `--auto` が必須です。省略時は従来どおり全 track から選びます。依存関係や Ready の計算は引き続きプロジェクト全体で行います。
|
|
76
|
+
|
|
67
77
|
### 1.2. auto実行中の注意点
|
|
68
78
|
|
|
69
|
-
`--auto` と `--loop` は root の現在ブランチへ task ごとの merge commit を繰り返します(checkpoint commit は exec branch 側に置き、root には plan / result / claim event
|
|
79
|
+
`--auto` と `--loop` は root の現在ブランチへ task ごとの merge commit を繰り返します(checkpoint commit は exec branch 側に置き、root には plan / result / claim event の複製が統合まで未commitのまま残ります。統合されずに残った複製は `実行記録の記帳` に従って run の終わりに commit します)。同じ作業ツリーで並行して手作業を行う場合は、次の安全ガードに注意します。
|
|
70
80
|
|
|
71
81
|
| 状況 | 挙動 |
|
|
72
82
|
| --------------------------------------------------------------------------- | ------------------------------------------------- |
|
|
73
|
-
| root index
|
|
83
|
+
| root index の stage 済み変更が checkpoint 対象と重複する | checkpoint 前に停止する |
|
|
84
|
+
| root index に stage 済み変更がある | merge 前に対象パスと解除手順を示して停止する |
|
|
74
85
|
| root の未commit変更(runner が置いた複製を除く)と merge 対象パスが重複する | merge 前に停止する |
|
|
75
86
|
| agent が失敗して `blocked` になる | worktree を保持し、auto の Ready 選択から除外する |
|
|
76
87
|
| プロセス中断で `doing` が残る | `exec resume` で再開する |
|
|
77
88
|
|
|
78
89
|
parallel 実行中でも、claim、checkpoint、merge、complete、`exec refresh` は runner が直列化します。agent プロセスだけを並列に走らせ、root 側の状態更新や Ready 再計算は1件ずつ処理します。
|
|
79
90
|
|
|
91
|
+
review plan の生成前に runner が実行する grade は、再試行状態を `<execution_path>/grade/generated/runs/<grade-run-id>/pipeline/` へ run ごとに保存します。grade の agent や応答の適用が失敗しても共有の `grade/pipeline/` は変えず、別 review の統合確認を妨げません。失敗内容は review plan に渡され、評価結果の鮮度に応じた review 判定に使います。正本の評価結果・完了条件詳細の checkpoint と統合前の変更検出は引き続き行います。
|
|
92
|
+
|
|
93
|
+
stage 済み変更による停止では、表示された worktree で対象を commit するか、各パスに `git restore --staged -- <path>` を実行してから `exec resume` します。後者はファイルの内容を残して stage だけを解除します。runner は別タスクや手作業の変更を自動で commit・unstage しません。
|
|
94
|
+
|
|
80
95
|
agent が成功した後、runner は commit / merge / worktree 削除へ進む前に、最新の event log から task state を再構築し、`exec complete` と同じ完了可否を検証します。task が `doing` でない場合や、実行 actor が claim actor と一致しない場合は統合を中止し、成果物を未統合のまま worktree に保持します。これにより、`exec resume --by` などで別 actor を指定しても、Schedule が `doing` のまま成果物だけが統合される状態を防ぎます。
|
|
81
96
|
|
|
82
97
|
auto 実行と並行して人が作業する場合は、別ブランチの worktree を作成して編集します。
|
|
@@ -85,6 +100,23 @@ auto 実行と並行して人が作業する場合は、別ブランチの workt
|
|
|
85
100
|
git worktree add ../specdojo-edit -b <edit-branch>
|
|
86
101
|
```
|
|
87
102
|
|
|
103
|
+
### 1.3. 実行記録の記帳
|
|
104
|
+
|
|
105
|
+
統合の merge commit に入るのは、その時点までのイベント(claim)と run の記録だけです。統合の後に書く complete、失敗・延期の block、再開の unblock・release・claim、保持した worktree に対応する root の plan / result の複製は、merge commit に入りません。runner は `exec run`(Schedule の `--auto` と `--task --worktree`)、`exec resume`、`exec cycle` の終わりに、これらを `exec(run): record execution events and run records` という記帳の commit 1件にまとめます。成功・失敗・延期・再開のどれで終わっても、作業ツリーに実行記録を残しません。
|
|
106
|
+
|
|
107
|
+
| 記帳の commit に入るもの | 条件 |
|
|
108
|
+
| ------------------------------- | ----------------------------------------------------------------------------------------- |
|
|
109
|
+
| `exec/events/*.json` | `by` が `.specdojo/agent-members.yaml` の agent(runner が書いたイベント) |
|
|
110
|
+
| `runs/schedule/<task-id>/` 配下 | 上のイベントの task の plan・result・evidence・pipeline-state・ログ(退避した試行を含む) |
|
|
111
|
+
| `plan-conventions/` 配下 | 上の run の記録を 1 件以上含む場合 |
|
|
112
|
+
|
|
113
|
+
- 対象は root の未 commit のファイルだけで、前の run で残った runner の記録も次の run の終わりに拾います。
|
|
114
|
+
- commit した後に `plan.md`・`result.md`・`evidence.json` がそろわない run(setup や executor の起動前に止まり plan だけを残した run など)は記帳せず、作業ツリーに残してディレクトリと次の操作を標準エラーに出力します。commit すると `exec validate --records-only` が欠落で失敗するためです。run を再開して記録をそろえるか、executor の起動前に止まった run ならディレクトリを消します。result.md を外して再試行するときも、HEAD に result.md がない run は丸ごと外します。
|
|
115
|
+
- 人が `exec claim`・`complete`・`block`・`release` などで書いたイベント(`by` が agent でないもの)と、human タスクの run の記録は、従来どおり記帳する人が commit します。
|
|
116
|
+
- commit は統合と同じ scheduler lock で直列化し、index.lock の競合は解放を待って再試行します(待ち時間は [exec 設定ガイド](exec-config-guide.md) の `run.git_index_lock_wait_seconds`)。pre-commit hook(整形・markdownlint・実行記録の認証情報検査)は通常どおり実行し、result.md の記法違反で拒否された場合は result.md を外して再試行します。
|
|
117
|
+
- それでも commit できない場合、run の終了コードは変えず、残ったファイルと次の操作を標準エラーに出力します。原因を直して commit するか、次の `exec run` / `exec resume` で記帳をやり直します。
|
|
118
|
+
- 保持した worktree を後で統合するとき、記帳済みの plan / result と exec branch 側で更新した同じファイルが競合した場合は、その task の run の記録に限って exec branch 側(最新の記録)で解決します。
|
|
119
|
+
|
|
88
120
|
## 2. 手動実行
|
|
89
121
|
|
|
90
122
|
自動実行がまとめて行う各段階を、人が確認しながら順に進める経路です。
|
|
@@ -139,9 +171,15 @@ plan を先に生成して内容を確認・編集してから実行できます
|
|
|
139
171
|
|
|
140
172
|
```bash
|
|
141
173
|
specdojo exec plan --project <project-id> --task <task-id>
|
|
142
|
-
specdojo exec run --project <project-id> --plan <execution-path>/
|
|
174
|
+
specdojo exec run --project <project-id> --plan <execution-path>/runs/schedule/<task-id>/<run-id>/plan.md
|
|
143
175
|
```
|
|
144
176
|
|
|
177
|
+
schedule のタスクから plan を生成するときは、Prettier による整形・ファイルへの書き込みより前に、phase の `description` を展開した plan 全体を markdownlint で検査します。箇条書きの前に空行がない場合(MD032)などは、タスク ID・plan のパス・生成内容の行番号・規則名を表示して停止し、既存の plan は上書きしません。表示する行番号は strategy YAML ではなく、整形前の plan に対する番号です。strategy の説明を修正し、`schedule build --track <track> --force` でトラックを更新してから plan を再生成してください。
|
|
178
|
+
|
|
179
|
+
検査には利用リポジトリの markdownlint を優先し、見つからなければ SpecDojo 側のインストールを使います。どちらにもない場合は生成を停止するため、利用リポジトリで `npm install --save-dev markdownlint-cli` を実行してください。規則はリポジトリ直下の `.markdownlint.jsonc` / `.markdownlint.json` / `.markdownlint.yaml` / `.markdownlint.yml`(この順で最初にあるもの)と、上位ディレクトリを含む `.markdownlintrc` を読み、`extends` も解決します。設定がない場合は SpecDojo の標準規則を使います。CLI2 固有の設定や hook の独自ルールはこの検査の対象外です。生成履歴が `.markdownlintignore` に含まれていても、生成時の検査は行います。
|
|
180
|
+
|
|
181
|
+
同じ検査は `exec run --auto` の plan 生成でも働き、`exec run --auto --dry-run` でも claim・checkpoint commit・agent 起動より前に Markdown の違反を検出できます。`exec run --task <task-id> --dry-run` のように plan を生成しない経路では検査しないため、事前確認には `exec plan --task <task-id>` を使ってください。
|
|
182
|
+
|
|
145
183
|
schedule に無い成果物を catalog から直接 plan 化する場合は `--deliverable <local_id>` を使います。
|
|
146
184
|
|
|
147
185
|
```bash
|
|
@@ -245,10 +245,10 @@ CLI の導入は
|
|
|
245
245
|
|
|
246
246
|
### 8.3. 成果物の作成を計画する
|
|
247
247
|
|
|
248
|
-
| 目的 | 参照先
|
|
249
|
-
| ------------------------------------------------------------------------------------------ |
|
|
250
|
-
|
|
|
251
|
-
| 成果物カタログから Schedule への流れを理解する、フェーズ・タスク・依存関係・反復を設計する | [Schedule設計ガイド](schedule-design-guide.md)
|
|
248
|
+
| 目的 | 参照先 |
|
|
249
|
+
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
|
|
250
|
+
| epic の依存・範囲・期間で全体計画を管理する | [[specdojo:register-operation-guide\|登録簿運用ガイド]] |
|
|
251
|
+
| 成果物カタログから Schedule への流れを理解する、フェーズ・タスク・依存関係・反復を設計する | [Schedule設計ガイド](schedule-design-guide.md) |
|
|
252
252
|
|
|
253
253
|
### 8.4. プロジェクトを実行・管理する
|
|
254
254
|
|
|
@@ -268,6 +268,7 @@ CLI の導入は
|
|
|
268
268
|
| worktreeを使って手動で隔離実行する | [exec worktree運用ガイド](exec-worktree-guide.md) |
|
|
269
269
|
| 対話でCLI操作を進める | [オーケストレーター運用ガイド](orchestrator-operation-guide.md) |
|
|
270
270
|
| 任意の Dev Container や常時稼働ホストで実行環境を分離する | [常時稼働ホスト運用ガイド](remote-host-development-guide.md) |
|
|
271
|
+
| プロジェクトを管理用の別リポジトリへ移す手順と安全確認を行う | [[specdojo:project-move-guide\|プロジェクト移行ガイド]] |
|
|
271
272
|
|
|
272
273
|
登録簿を agent 実行と並行して記帳する場合は、記帳コマンドの `--commit` が同じ project の `register lifecycle` 枠を使います。provider 設定を配布するときは `config scaffold` を使い、Antigravity の `--global` はすべてのリポジトリに効くため dry-run 後に適用します。Dev Container は必須ではなく、必要な場合だけ `devcontainer scaffold` で追加します。各操作の詳細は上表のガイドと [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
|
|
273
274
|
|
|
@@ -2,163 +2,46 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:timeline-design-guide
|
|
4
4
|
type: guide
|
|
5
|
-
status:
|
|
5
|
+
status: deprecated
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# Timeline
|
|
8
|
+
# Timeline から epic への移行ガイド
|
|
9
9
|
|
|
10
|
-
Timeline
|
|
10
|
+
Timeline to Epic Migration Guide
|
|
11
11
|
|
|
12
|
-
Timeline(`tml-index.yaml
|
|
12
|
+
Timeline(`tml-index.yaml`)は非推奨です。全体計画は epic を正本とし、`dashboard build` で生成します。
|
|
13
13
|
|
|
14
14
|
**対象読者**
|
|
15
15
|
|
|
16
|
-
-
|
|
16
|
+
- 旧 Timeline を運用しているプロジェクト管理者、担当者
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
-
|
|
20
|
+
- 全体計画を epic へ移す手順と旧形式の互換運用
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
flowchart LR
|
|
44
|
-
A["tml-index.yaml<br/>(人間が着手前に決める計画)"] -->|"timeline build"| B["timeline-order.md<br/>着手wave一覧"]
|
|
45
|
-
A -->|"timeline build"| C["catalog-scaffold.md<br/>未作成カタログと実行コマンド"]
|
|
46
|
-
A -->|"timeline build"| D["timeline.json<br/>機械可読サマリー"]
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### 2.1. 整合性検証
|
|
50
|
-
|
|
51
|
-
`timeline build` は生成前に `tracks[]` の整合性を検証し、次のいずれかを検出するとエラーで停止します(`--dry-run` でも同様に検証されます)。
|
|
52
|
-
|
|
53
|
-
| 検出する不整合 | 内容 |
|
|
54
|
-
| ------------------------- | --------------------------------------------------------------------- |
|
|
55
|
-
| track id の重複 | 同じ `track` 値が `tracks[]` に複数存在する |
|
|
56
|
-
| `depends_on` の未定義参照 | `depends_on` に挙げた track id が `tracks[]` に定義されていない |
|
|
57
|
-
| `order` との矛盾 | `depends_on` に挙げたトラックの `order` が、自分の `order` 以上である |
|
|
58
|
-
| 循環参照 | `depends_on` を辿ると自分自身に戻る |
|
|
59
|
-
|
|
60
|
-
次の状態は警告(生成は継続)として扱われます。
|
|
61
|
-
|
|
62
|
-
| 検出する警告 | 内容 |
|
|
63
|
-
| ------------------------------------------------------------------------------------- | -------------------------------------------- |
|
|
64
|
-
| `catalog_status: primary` なのに前提トラックが `primary` 未到達 | 依存先の準備が整う前に着手可能と宣言している |
|
|
65
|
-
| `catalog_status: not_started` なのに対象ドメインの `dct-<domain>.yaml` が既に存在 | Timeline側の状態更新が遅れている |
|
|
66
|
-
| `catalog_status` が `draft` 以上なのに対象ドメインの `dct-<domain>.yaml` が存在しない | Timeline側の状態更新が実態より先行している |
|
|
67
|
-
|
|
68
|
-
### 2.2. wave算出
|
|
69
|
-
|
|
70
|
-
`timeline build` は `order` を主キーにトラックを畳み込み、同じ `order` を持つトラックを 1 つの wave(着手単位)にまとめます。wave 内のトラックは並行して着手できる候補です。`parallel_group` は同じ wave 内でどのトラック同士が実際に並行してよいかを示すラベルであり、wave 算出そのものには使いません。
|
|
71
|
-
|
|
72
|
-
### 2.3. カタログ scaffold 対象の判定
|
|
73
|
-
|
|
74
|
-
トラックが対象とする各ドメインについて、既存の `dct-<domain>.yaml`(`dct-<domain>-<part>.yaml` の物理分割を含む)をファイル名ではなく各カタログの `domain` 値で突き合わせます。該当ドメインの成果物カタログが存在しない場合、`catalog-scaffold.md` へ生成先パスと `specdojo catalog scaffold --domain <domain>` の実行コマンドを列挙します。
|
|
75
|
-
|
|
76
|
-
### 2.4. Schedule着手可能トラックの判定
|
|
77
|
-
|
|
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
|
-
|
|
80
|
-
## 3. 運用タイミング
|
|
81
|
-
|
|
82
|
-
`timeline build` は一度だけ実行するコマンドではなく、トラックの定義や register の状態変化に合わせて再実行する運用コマンドです。register の `epic` 起票から、子 todo によるカタログ・strategy 作成、Schedule への展開、完了判断までの流れは次のとおりです。
|
|
83
|
-
|
|
84
|
-
```mermaid
|
|
85
|
-
flowchart TD
|
|
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
|
-
G -->|"なし"| A
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
代表的な更新契機は次のとおりです。
|
|
100
|
-
|
|
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` の手書き値は書き換えずに保持し、手書きの値と食い違うときは警告します。
|
|
111
|
-
|
|
112
|
-
### 3.1. 既にSchedule展開済みのトラックの扱い
|
|
113
|
-
|
|
114
|
-
`tml-index.yaml` の導入前から `sch-strategy-<track>.yaml` が存在し実行が始まっているトラックは、`catalog_status: primary` と `depends_on` をその実績に合わせて追認的に記載します。Timeline は実行結果を書き戻す文書ではないため([タイムライン作成ルール](../rulebooks/tml-rulebook.md) の禁止事項を参照)、進捗率や実際の着手日は書かず、順序判断の根拠は `note` に残します。この場合、`timeline build` を実行しても当該トラックの `catalog-scaffold.md` 対象は 0 件になりますが、まだ着手していない後続トラックの wave 算出・整合性検証には引き続き意味があります。
|
|
115
|
-
|
|
116
|
-
計画成果物をカタログと Schedule で管理する場合は、専用の `planning` トラックを最初の wave に置き、他トラックから依存させます。これにより、成果物カタログ索引、Timeline、Schedule 共通設定、着手済みトラックの assessment と strategy を、個別成果物トラックより先に整備できます。planning strategy 自身の循環回避は [Schedule設計ガイド](schedule-design-guide.md) の `Scheduleファイル` に従います。
|
|
117
|
-
|
|
118
|
-
### 3.2. 成果物インスタンス判定(`dct-plan-<domain>.yaml`)の位置づけ
|
|
119
|
-
|
|
120
|
-
`catalog-scaffold.md` が示すドメインは、テンプレートに何が必要かが決まっていても、そのドメインで実際に何件の成果物インスタンスが要るかまでは決まっていません。この判定を agent に任せ、結果を機械可読な `dct-plan-<domain>.yaml` として残します。責務は次のとおり分担します。
|
|
121
|
-
|
|
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` の値は保持・警告) |
|
|
128
|
-
|
|
129
|
-
- agent は成果物インスタンスの要否、placeholder 値、採用しない候補、未確定事項の整理だけを担当します。ID・パス・`groups`・`done_criteria` の組み立てと schema 適合はコード側の責務です。
|
|
130
|
-
- 判定は Timeline が着手対象として示したドメインに限定し、入力は data-flow を中心とした上流成果物と、既存カタログがある場合はその基準線に限定します。
|
|
131
|
-
- 判定計画が保存されても `catalog_status` は自動では変わりません。カタログ作成の todo(`catalog-planning`)を完了(`register close`)し、`timeline build` を再実行することで `catalog_status` が `primary` と導出されます。
|
|
132
|
-
- 再判定時は既存の判定計画を無条件に置き換えず、差分をレビューしてから `--force` で更新します。
|
|
133
|
-
- 判定後は `catalog scaffold --plan --dry-run --domain <domain>` で差分を確認し、問題がなければ `--plan` で生成します。物理分割 domain は同じ `domain` の全 template から分割 DCT をまとめて生成します。
|
|
134
|
-
- 生成成功後は生成 DCT を確認・検証した後にカタログ作成の todo を close し、`timeline build` を再実行して `primary` の導出を確定します。
|
|
135
|
-
|
|
136
|
-
### 3.3. Schedule strategy 生成への引き渡し
|
|
137
|
-
|
|
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 を生成します。
|
|
139
|
-
|
|
140
|
-
```text
|
|
141
|
-
tml-index.yaml + dct-*.yaml
|
|
142
|
-
-> sch-strategy-<track>.yaml に scope / approach_rules を宣言
|
|
143
|
-
-> schedule strategy generate --dry-run
|
|
144
|
-
-> sch-strategy-<track>.yaml
|
|
145
|
-
-> schedule build --track <track>
|
|
146
|
-
-> exec refresh
|
|
24
|
+
- [[specdojo:register-operation-guide|登録簿運用ガイド]]
|
|
25
|
+
- [[specdojo:pjr-rulebook|プロジェクト登録簿ルール]]
|
|
26
|
+
|
|
27
|
+
## 1. 移行手順
|
|
28
|
+
|
|
29
|
+
1. 全体計画に載せる track ごとに epic を 1 件起票します。未着手の計画も `open` の epic にします。epic のない古い track は全体計画に出しません。
|
|
30
|
+
2. 旧 `tracks[].domains` を各 epic の `domains` へ移します。範囲の一部だけを扱う場合は個票の範囲の章で境界を記し、strategy の `scope.catalogs[].local_ids` で限定します。
|
|
31
|
+
3. 旧 track 間の `depends_on` を見直し、必要な順序を epic 間の `depends_on` に記録します。`order` と `parallel_group` は移しません。`derived_from` は由来なので依存へ自動転記しません。
|
|
32
|
+
4. 予定開始日を `start_on`、期限を `due_on` に記録します。`register add` / `update` の `--start-on <YYYY-MM-DD>` で設定できます。着手・完了は register の操作で記録します。旧 `planned_start_date` やカタログの見積りから実績を作らないでください。日付が分からない期間は未定のまま表示されます。
|
|
33
|
+
5. `register build` で epic の track 重複・依存循環を検査し、`dashboard build` で `execution/generated/` の全体計画と未作成カタログを確認します。
|
|
34
|
+
6. カタログから旧 `tml-index` のエントリと不要な依存を外します。外せない依存は理由と次の対応を記録して保留します。既存ファイルは互換用に保持でき、削除は利用者が判断します。
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
specdojo register add --type epic --title "データモデルの整備" --topic data-model \
|
|
38
|
+
--track data-model --domain data-model --due 2026-11-30
|
|
39
|
+
# PJR-AB12 を作成した epic の ID に置き換える
|
|
40
|
+
specdojo register update --id PJR-AB12 --domain data-model
|
|
41
|
+
specdojo register build
|
|
42
|
+
specdojo dashboard build
|
|
147
43
|
```
|
|
148
44
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
具体的なコマンドと検証内容は [CLIコマンドリファレンス](../references/command-reference.md) の `catalog plan(成果物インスタンスの判定)`、記述ルールは [成果物カタログ(ドメイン別)作成ルール](../rulebooks/dct-rulebook.md) の `成果物カタログ判定計画(dct-plan-<domain>.yaml)` を参照します。
|
|
152
|
-
|
|
153
|
-
## 4. `track-design-guide.md` との関係
|
|
154
|
-
|
|
155
|
-
[トラック設計ガイド](track-design-guide.md) の `トラックの標準的な実行順序` は、進め方(アジャイル/ウォーターフォール)別の標準的な着手順序をプローズ(文章・表)で示します。`tml-index.yaml` は、プロジェクト固有の事情(並行化の可否、優先順位の入れ替え、対象外ドメインの除外)を踏まえてこのプローズを機械可読な `order` / `parallel_group` / `depends_on` へ落とし込んだものです。標準順序をそのまま採用する場合も、`tml-index.yaml` への記載は省略せず、`note` に「標準順序どおり」である旨を残します。
|
|
156
|
-
|
|
157
|
-
## 5. アンチパターン
|
|
45
|
+
## 2. 互換運用
|
|
158
46
|
|
|
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` を再実行する |
|
|
47
|
+
`tml-index.yaml`・`timeline build`・`timeline_path` は警告付きで互換を維持します。epic がある project の全体計画は epic だけから作り、epic のない project は旧 timeline 表示を維持します。strategy の範囲解決は既存 strategy の scope、epic の `domains`、旧 timeline の順です。移行後も既存 scope が優先されるため、範囲が変わる場合は scope も確認してください。旧コマンドの仕様は [[specdojo:command-reference|コマンドリファレンス]] を参照してください。
|