specdojo 0.7.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 +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- 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/scaffold.js +18 -0
- 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/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 +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -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 +55 -56
- 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 +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -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 +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -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 +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- 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 +43 -9
- 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 +142 -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/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -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 +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- 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 +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- 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 +27 -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 +92 -155
- 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-uc-recipe.md +36 -24
- 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 +79 -64
- 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-uc-rulebook.md +56 -35
- 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-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- 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-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- 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 +53 -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/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- 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/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -55,7 +55,8 @@ flowchart TD
|
|
|
55
55
|
M -->|"必要な型が揃い信頼できる"| FG
|
|
56
56
|
M -->|"recipe のみ使える"| RG["recipe-guided"]
|
|
57
57
|
M -->|"実践の型に頼れない"| FF["freeform"]
|
|
58
|
-
FG --> RV["レビュー → finalize(人が確定)"]
|
|
58
|
+
FG --> CN["condense<br/>1 文書の冗長さを整理"] --> RV["レビュー → finalize(人が確定)"]
|
|
59
|
+
P -->|"1 文書の冗長さを整理"| CN
|
|
59
60
|
RG --> W["雛形から開始 → 内容を記述 → レビュー"]
|
|
60
61
|
FF --> W
|
|
61
62
|
P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
|
|
@@ -66,7 +67,7 @@ flowchart TD
|
|
|
66
67
|
P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
|
|
67
68
|
```
|
|
68
69
|
|
|
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` です。
|
|
70
|
+
`draft` は文脈で任された調査・下書きのための段であり、型の件数からは自動選択しません。整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `condense` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
|
|
70
71
|
|
|
71
72
|
### 1.2. approach 一覧
|
|
72
73
|
|
|
@@ -74,7 +75,7 @@ flowchart TD
|
|
|
74
75
|
|
|
75
76
|
#### 1.2.1. 成果物の作成・更新
|
|
76
77
|
|
|
77
|
-
`draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
|
|
78
|
+
`draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `condense` → review → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
|
|
78
79
|
|
|
79
80
|
`draft` を除く三つの流は、型との関係を表す守破離に対応します。「守」は型をそのまま守り、「破」は型を基準にしながら工夫し、「離」は型から離れて完了条件と根拠から組み立てます。守破離は品質の序列ではなく、タスクの目的と実践の型の整備状況に応じて進め方を選ぶための名前です。
|
|
80
81
|
|
|
@@ -99,7 +100,7 @@ flowchart LR
|
|
|
99
100
|
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
100
101
|
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
101
102
|
| `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`
|
|
103
|
+
| `fully-guided` | 守 | 既存成果物の磨き込み専用。宣言された rulebook / recipe / sample、`depends_on`、`based_on`、`project_context`、個票の `入力`、カタログの `brief` を参照する。edit では `evidence_refs` も読む。template は読み込まない | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
103
104
|
| `recipe-guided` | 破 | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
104
105
|
| `freeform` | 離 | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
105
106
|
|
|
@@ -205,11 +206,12 @@ flowchart LR
|
|
|
205
206
|
S --> DD --> C
|
|
206
207
|
```
|
|
207
208
|
|
|
208
|
-
| `approach` | 流の名前
|
|
209
|
-
| ------------------------- |
|
|
210
|
-
| `bootstrap` | 型起こし
|
|
211
|
-
| `retrofit` | 見取り
|
|
212
|
-
| `
|
|
209
|
+
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
210
|
+
| ------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
211
|
+
| `bootstrap` | 型起こし | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
|
|
212
|
+
| `retrofit` | 見取り | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
|
|
213
|
+
| `condense` | 冗長さの整理 | 1 文書内の冗長さを削る・まとめる・参照に置き換える。意味と判断に要る情報を保ち、新しい内容を足さない。磨き込みの後・review の前に置き、修正・保持の箇所と原因を result に記録する | `xep-condense-template.md` / `xer-condense-template.md` |
|
|
214
|
+
| `cross-deliverable-dedup` | 型寄せ | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
|
|
213
215
|
|
|
214
216
|
`retrofit` では、実装を現在動作(AS-IS)の根拠、既存成果物・決定記録・プロジェクトコンテキストを意図された仕様の根拠、`done_criteria` を成果物が満たすべき目的として扱います。三者が一致すれば成果物へ反映し、実装が意図された仕様と異なる場合は実装へ無条件に合わせず、乖離と修正対象候補を result に記録します。実装から確認できない目的・業務判断・将来方針は推測しません。
|
|
215
217
|
|
|
@@ -287,17 +289,19 @@ flowchart LR
|
|
|
287
289
|
|
|
288
290
|
`approach` にかかわらず適用する原則です。
|
|
289
291
|
|
|
290
|
-
-
|
|
292
|
+
- 書き方の矛盾時の優先: `draft` / `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
291
293
|
- 参照範囲: `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` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
294
|
+
- edit の実装の根拠: `draft` / `fully-guided` / `recipe-guided` は、plan に展開されたカタログの `evidence_refs` も読み取り専用で参照します。`recipe-guided` では個票の `入力` も参照します。実装は現在動作の事実、rulebook(`recipe-guided` では recipe)は書き方、`depends_on` と個票の `入力` は意図された仕様の根拠です。承認根拠のない乖離は意図された仕様を保持して result に記録し、実装から業務判断や将来方針を推測しません。実装の根拠は `targets`・変更許可範囲・commit 対象に含めません。`evidence_refs` 未指定やカタログなしだけでは異常終了しません。
|
|
295
|
+
- edit の未作成の依存: 上記 3 approach の plan は、未作成の `depends_on` を wikilink ではなくインラインコードと「未作成」で示します。未作成だけでは止めず、内容を推測せず _TODO_ / _ASSUMPTION_ と不足する根拠・次のアクションを残します。review や `condense` など他 approach の参照方針は変わりません。
|
|
292
296
|
- 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
|
|
293
|
-
- 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
|
|
297
|
+
- 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` と上記 3 approach の edit では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
|
|
294
298
|
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
295
299
|
- 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
296
300
|
- 前提・概要・判定基準の使い分け: カタログの `overview`(成果物の目的を1文で表す概要)、`brief`(成果物の外から継続して渡す技術スタックや制約などの前提)、`done_criteria`(成果物が満たすべき検証可能な完了条件)を明確に区別します。`brief` は schedule / register 両経路の plan に前提として展開され、未指定なら plan に載りません。複数の成果物で前提を共有する場合は YAML アンカー(`&anchor` / `*anchor`)を活用できます。前提を完了条件に混同せず、検証可能な基準だけを `done_criteria` に記載します。
|
|
297
301
|
|
|
298
302
|
### 1.4. 成果物カタログなしで進める
|
|
299
303
|
|
|
300
|
-
register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata
|
|
304
|
+
register からの `draft`・`fully-guided`・`condense`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。`condense` は既存成果物に限ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
|
|
301
305
|
|
|
302
306
|
カタログの `done_criteria` はないため、個票の完了条件と rulebook を完了基準にします。`fully-guided` には `not-needed` を除く kata 一式、`recipe-guided` には recipe が必要で、不足すると起票時に停止します。`retrofit` では調べる実装のパスを個票に明記します。
|
|
303
307
|
|
|
@@ -313,6 +317,12 @@ register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`re
|
|
|
313
317
|
|
|
314
318
|
メンテナンスのタスクでは、対象の実践の型を「見直す対象」として扱い、複数の成果物・review result・対象領域の慣行を根拠に、次の観点で妥当性を見直します。対象の実践の型に finding がある場合は、finding の message と同じ viewpoint の判定根拠から指摘の根拠となる規範を特定し、紐づく rulebook / recipe / sample / template や執筆標準も必要な根拠として読みます。たとえば rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として照合します。
|
|
315
319
|
|
|
320
|
+
成果物の grade は、すべての観点の finding に原因 `cause` を付けます。原因は `document`、または Kata の種類と箇所を持つ `kata` です。Kata の箇所を根拠として示せない場合と、原因を持たない旧結果は `document` として扱います。Kata そのものの grade には原因を付けません。項目の形は [[specdojo:command-reference]] の grade の説明を参照してください。
|
|
321
|
+
|
|
322
|
+
手入れの edit plan は、対象 Kata 自身の指摘に加え、「成果物から届いた Kata が原因の finding」節に、その Kata を rulebook 宣言から辿れる成果物の指摘を取り込みます。対象の種類と一致する原因だけを選び、現在の成果物全体のハッシュと一致する最新サイドカーから、成果物・行・観点・内容・Kata の箇所を1件ずつ載せます。`document` の指摘と、成果物が評価後に変わった古い指摘は取り込みません。`fully-guided` の磨き込み plan は、その成果物のすべての指摘を原因付きで載せます。Kata が原因でも成果物側の修正は必要です。
|
|
323
|
+
|
|
324
|
+
同じ節には、宣言済みの Kata が原因の `condense` の記録も取り込みます。成果物ごとに最新の完了済み result を選び、空の記録で古い記録が復活しないようにします。出どころを `source=grade` / `source=condense` で区別し、condense は result ID と修正前の場所・種類・直し方・理由・Kata の箇所を示します。`document` の記録は取り込みません。記録形式は [[specdojo:plan-result-lifecycle-guide]] を参照してください。
|
|
325
|
+
|
|
316
326
|
| `approach` | 見直す対象 | 主な見直し観点 |
|
|
317
327
|
| ---------------------- | ---------- | ---------------------------------------------------------------- |
|
|
318
328
|
| `rulebook-maintenance` | rulebook | 章構成、必須項目、禁止事項、判定基準 |
|
|
@@ -322,7 +332,7 @@ register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`re
|
|
|
322
332
|
|
|
323
333
|
根拠の種別を一律に必須化せず、finding ごとに指摘の解消を判定できる資料を使います。成果物または review result がないことだけを理由に根拠不足とは判定しません。finding の message と判定根拠、対象の実践の型から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても修正内容を確定できない場合に限り、根拠不足として見送ります。見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result に記録します。
|
|
324
334
|
|
|
325
|
-
|
|
335
|
+
`schedule strategy generate` は `bootstrap-kata-set` の初期整備後と、`improve-kata` の `kata_target: rulebook` に、rulebook → recipe → sample → template の見直し段を生成します。`not-needed` の型は省略します。他の型を直接指定した `improve-kata` はその型だけが対象です。手で strategy を組む場合は、`approach: rulebook-maintenance` のように対象を指定した phase / phase_set を記述します([[specdojo:schedule-design-guide|Schedule設計ガイド]])。
|
|
326
336
|
|
|
327
337
|
## 3. review への適用
|
|
328
338
|
|
|
@@ -332,8 +332,9 @@ phase_sets:
|
|
|
332
332
|
2. `retrofit` edit: DCT の `evidence_refs` から各成果物を新設・補正する。
|
|
333
333
|
3. `cross-deliverable-dedup`: 必要な場合だけ、成果物間の正本選択と重複整理を行う。
|
|
334
334
|
4. `fully-guided`: 整備済みの実践の型に沿って内容を磨き込む。
|
|
335
|
-
5. `
|
|
336
|
-
6. `
|
|
335
|
+
5. `condense`: 意味と判断に要る情報を保ち、1 文書内の冗長さを整理して記録する。
|
|
336
|
+
6. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
|
|
337
|
+
7. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
|
|
337
338
|
|
|
338
339
|
`retrofit` を使う成果物には、事前に DCT の `evidence_refs` を宣言します。実装エビデンスは Schedule の依存関係ではなく調査入力であるため、`depends_on` や `targets` へ複製しません。
|
|
339
340
|
|
|
@@ -369,6 +370,7 @@ phase や owner rule に書く `approach` は、タスクの目的と実践の
|
|
|
369
370
|
- `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
|
|
370
371
|
- intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
|
|
371
372
|
- 標準 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` で分けます。
|
|
373
|
+
- `bootstrap-kata-set` は初期整備の後、rulebook → recipe → sample → template の見直しを経て、磨き込み・冗長整理・実装照合レビュー・確定へ進みます。`improve-kata` の `kata_target: rulebook` も同じ順で型一式を同期してからレビュー・確定へ進みます。recipe / sample / template を直接指定した場合は、その型だけを見直します。生成時に `not-needed` の段は省略し、実行までに不要と判断された段は変更せず理由を result に残します。型の整備段には Rulebook 記述標準、完成例の厚さ、詳細の正本参照の方針も含めます。
|
|
372
374
|
- owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
|
|
373
375
|
- generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
|
|
374
376
|
|
|
@@ -389,15 +391,16 @@ approach_rules:
|
|
|
389
391
|
| 雛形作成・文脈記入 | `context-pass` | `010` | `human` | `edit` | `draft` |
|
|
390
392
|
| 下書き | `guided-pass` | `020` | `agent` | `edit` | `draft` |
|
|
391
393
|
| 磨き込み | `refine-pass` | `070` | `agent` | `edit` | `fully-guided` |
|
|
394
|
+
| 冗長さの整理 | `condense-pass` | `080` | `agent` | `edit` | `condense` |
|
|
392
395
|
| 完成版レビュー | `review-pass` | `090` | `agent` | `review` | `fully-guided` |
|
|
393
396
|
| 確定 | `finalize-pass` | `140` | `human` | `edit` | `finalize` |
|
|
394
397
|
|
|
395
|
-
雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft
|
|
398
|
+
雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。`condense-pass` の executor / reporter はともに `normal` です。`refine-pass` を含むすべての標準 profile に、磨き込みの後・review の前の段として生成します。既存 strategy は自動更新しません。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
|
|
396
399
|
|
|
397
400
|
1. `specdojo exec claim --project <project-id> --task <context-task-id> --by <human>` で着手します。既存の human タスクと同じく plan は生成せず、claim が作成した result に作業案内と記録欄を持ちます。
|
|
398
401
|
2. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成します。既存成果物は上書きせず、`--force` は指定しません。
|
|
399
402
|
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 して確定します。
|
|
403
|
+
4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・condense・review を行い、最後に人が finalize を claim / complete して確定します。
|
|
401
404
|
|
|
402
405
|
文脈の記入を待つ必要がない場合は従来の `author-deliverable` を使います。必要な型がそろった場合の `fully-guided` profile も、草案作成の `guided-pass` は `approach: draft` です。文脈や成果物が未作成でも template を骨組みにして根拠のある範囲を下書きします。文脈が無いことを調査・選定の委任とは解釈せず、未委任の判断は保留します。既存 strategy の段定義を更新するには `schedule strategy generate --force` の差分を確認して適用し、構造が変わる場合は `schedule build --force`、続いて `exec refresh` を実行します。
|
|
403
406
|
|
|
@@ -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` 件だけを実行して終了します。
|
|
@@ -74,17 +76,22 @@ specdojo exec run --project <project-id> --auto --track data-flow-uc-rewrite --p
|
|
|
74
76
|
|
|
75
77
|
### 1.2. auto実行中の注意点
|
|
76
78
|
|
|
77
|
-
`--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 します)。同じ作業ツリーで並行して手作業を行う場合は、次の安全ガードに注意します。
|
|
78
80
|
|
|
79
81
|
| 状況 | 挙動 |
|
|
80
82
|
| --------------------------------------------------------------------------- | ------------------------------------------------- |
|
|
81
|
-
| root index
|
|
83
|
+
| root index の stage 済み変更が checkpoint 対象と重複する | checkpoint 前に停止する |
|
|
84
|
+
| root index に stage 済み変更がある | merge 前に対象パスと解除手順を示して停止する |
|
|
82
85
|
| root の未commit変更(runner が置いた複製を除く)と merge 対象パスが重複する | merge 前に停止する |
|
|
83
86
|
| agent が失敗して `blocked` になる | worktree を保持し、auto の Ready 選択から除外する |
|
|
84
87
|
| プロセス中断で `doing` が残る | `exec resume` で再開する |
|
|
85
88
|
|
|
86
89
|
parallel 実行中でも、claim、checkpoint、merge、complete、`exec refresh` は runner が直列化します。agent プロセスだけを並列に走らせ、root 側の状態更新や Ready 再計算は1件ずつ処理します。
|
|
87
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
|
+
|
|
88
95
|
agent が成功した後、runner は commit / merge / worktree 削除へ進む前に、最新の event log から task state を再構築し、`exec complete` と同じ完了可否を検証します。task が `doing` でない場合や、実行 actor が claim actor と一致しない場合は統合を中止し、成果物を未統合のまま worktree に保持します。これにより、`exec resume --by` などで別 actor を指定しても、Schedule が `doing` のまま成果物だけが統合される状態を防ぎます。
|
|
89
96
|
|
|
90
97
|
auto 実行と並行して人が作業する場合は、別ブランチの worktree を作成して編集します。
|
|
@@ -93,6 +100,23 @@ auto 実行と並行して人が作業する場合は、別ブランチの workt
|
|
|
93
100
|
git worktree add ../specdojo-edit -b <edit-branch>
|
|
94
101
|
```
|
|
95
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
|
+
|
|
96
120
|
## 2. 手動実行
|
|
97
121
|
|
|
98
122
|
自動実行がまとめて行う各段階を、人が確認しながら順に進める経路です。
|
|
@@ -147,7 +171,7 @@ plan を先に生成して内容を確認・編集してから実行できます
|
|
|
147
171
|
|
|
148
172
|
```bash
|
|
149
173
|
specdojo exec plan --project <project-id> --task <task-id>
|
|
150
|
-
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
|
|
151
175
|
```
|
|
152
176
|
|
|
153
177
|
schedule のタスクから plan を生成するときは、Prettier による整形・ファイルへの書き込みより前に、phase の `description` を展開した plan 全体を markdownlint で検査します。箇条書きの前に空行がない場合(MD032)などは、タスク ID・plan のパス・生成内容の行番号・規則名を表示して停止し、既存の plan は上書きしません。表示する行番号は strategy YAML ではなく、整形前の plan に対する番号です。strategy の説明を修正し、`schedule build --track <track> --force` でトラックを更新してから plan を再生成してください。
|
|
@@ -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|コマンドリファレンス]] を参照してください。
|