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
|
@@ -422,7 +422,7 @@ Schedule設計の詳細は [Schedule設計ガイド](../guides/schedule-design-g
|
|
|
422
422
|
|
|
423
423
|
### 4.1. schedule strategy(決定論的な strategy 生成)
|
|
424
424
|
|
|
425
|
-
`schedule strategy generate` は、DCT、
|
|
425
|
+
`schedule strategy generate` は、DCT、epic、strategy の `approach_rules`、Kata の保存済み grade、標準 strategy profile から `sch-strategy-<track>.yaml` を生成します。範囲は既存 strategy の scope、対象 track の epic の `domains`、互換用 `tml-index.yaml` の順に解決します。先に strategy へ scope と成果物別 intent を宣言してください。
|
|
426
426
|
|
|
427
427
|
```bash
|
|
428
428
|
specdojo schedule strategy generate \
|
|
@@ -456,32 +456,17 @@ specdojo schedule strategy generate \
|
|
|
456
456
|
|
|
457
457
|
書き込み前に intent の網羅・重複、追加パラメータ、都度収集した facts、必要な grade、scope で選択した全 `kind: work` の網羅、`scope.catalogs[].local_ids` の実在、strategy schema、project ID、参照、milestone ID 重複、`schedule build --dry-run` 相当を検証します。catalog の `local_ids` を省略した場合は従来どおり対象 kind の全成果物、指定した場合はその部分集合だけを生成します。不足時は暫定値で進めず停止します。既存 strategy は `--force` なしで保護し、同一内容の再生成は `Unchanged` として書き込みません。生成後は `schedule build --track <track> --force`、`exec refresh` の順に既存コマンドを実行します。
|
|
458
458
|
|
|
459
|
-
## 5. timeline
|
|
459
|
+
## 5. timeline(非推奨)
|
|
460
460
|
|
|
461
|
-
`
|
|
461
|
+
`tml-index.yaml`・`timeline build`・`timeline_path` は非推奨です。全体計画は epic で管理し、`dashboard build` で `execution/generated/` に表とガント、未作成カタログを生成します。epic のない track は全体計画に出しません。期間と範囲の扱いは [[specdojo:register-operation-guide|登録簿運用ガイド]]、移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
|
|
462
462
|
|
|
463
|
-
| コマンド
|
|
464
|
-
|
|
|
465
|
-
| `
|
|
466
|
-
| `timeline
|
|
463
|
+
| コマンド | 用途 | 例 |
|
|
464
|
+
| ----------------- | ------------------------------------------------ | --------------------------------------------- |
|
|
465
|
+
| `dashboard build` | epic に基づく全体計画を含む dashboard を生成する | `specdojo dashboard build --project prj-0001` |
|
|
466
|
+
| `timeline build` | 警告付きで旧形式の計画を生成する | `specdojo timeline build --project prj-0001` |
|
|
467
|
+
| `timeline where` | 互換用 timeline の関連パスを表示する | `specdojo timeline where --project prj-0001` |
|
|
467
468
|
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
| オプション | 用途 |
|
|
471
|
-
| ----------- | ---------------------------------------- |
|
|
472
|
-
| `--dry-run` | 生成内容を標準出力へ表示し、書き込まない |
|
|
473
|
-
|
|
474
|
-
生成物は次の3つです。
|
|
475
|
-
|
|
476
|
-
| ファイル | 内容 |
|
|
477
|
-
| --------------------- | ------------------------------------------------------------------------ |
|
|
478
|
-
| `timeline-order.md` | `order` / `parallel_group` / `depends_on` から算出した着手 wave 一覧 |
|
|
479
|
-
| `catalog-scaffold.md` | `dct-<domain>.yaml` が未作成のドメインと `catalog scaffold` 実行コマンド |
|
|
480
|
-
| `timeline.json` | 後続コマンドが読む機械可読サマリー |
|
|
481
|
-
|
|
482
|
-
`depends_on` の未定義参照・循環、`depends_on` と `order` の矛盾、track id の重複を検出した場合は、生成物を書き込まずに終了コード 1 で停止します。`catalog_status` と実カタログの有無が食い違う場合は警告のみを出します。`project_register_path` がある場合、`catalog-planning` の todo を domain ごとに読み、`done` が一件でもあればその domain を `primary`、着手中(`in-progress` / `waiting` / `review`)なら `draft`、`open` だけなら `not_started` と導きます。`rejected` / `deferred` は導出から除外します。対象 todo がない domain は従来の手書き値を使います。複数 domain の track は全 domain が `primary` なら着手可能とし、一部だけ進んでいれば `draft` とします。手書きの値との差は警告し、`tml-index.yaml` は変更しません。todo を reopen した場合も次回 build で再計算します。`timeline.json` の `track_catalog_status` は導出後の track 別状態です。strategy 生成も同じ導出を使います。カタログの突き合わせはファイル名ではなく各 `dct-*.yaml` の `domain` 値で行うため、1 ドメインが複数ファイルに分割されていても検出できます。
|
|
483
|
-
|
|
484
|
-
`timeline_path` は未設定の場合、プロジェクト直下の `timeline` を既定とします。記述ルールは [タイムライン作成ルール](../rulebooks/tml-rulebook.md)、生成フローと運用タイミングは [Timeline設計ガイド](../guides/timeline-design-guide.md)、トラックの標準構成と実行順序は [トラック設計ガイド](../guides/track-design-guide.md) を参照します。
|
|
469
|
+
旧 `timeline build` は `--dry-run` で書き込まずに検証できます。epic の順序と範囲を反映しつつ、既存の strategy と `timeline_path`(既定 `timeline`)の `tml-index.yaml` を互換用に読み、`timeline/generated/` に `timeline-order.md`・`catalog-scaffold.md`・`timeline.json` を出力します。track 重複、依存の未定義参照・循環、`order` との矛盾はエラーです。`catalog-planning` の todo から作成状況を導出し、手書きの状態との不一致は警告します。epic のない project の dashboard は旧 timeline 表示を維持します。
|
|
485
470
|
|
|
486
471
|
## 6. register
|
|
487
472
|
|
|
@@ -512,6 +497,8 @@ specdojo schedule strategy generate \
|
|
|
512
497
|
| ---------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ |
|
|
513
498
|
| `--input <text>` | 個票の前提を記録(繰り返し可、update は一覧置換、`-` 単独で全削除) | `add` / `update` |
|
|
514
499
|
| `--track <track>` | epic が担う track(epic で必須、update で置換、削除不可) | `add` / `update` |
|
|
500
|
+
| `--domain <domain>` | epic の対象 domain(反復指定、update は一覧置換、`-` 単独で削除) | `add` / `update` |
|
|
501
|
+
| `--start-on <YYYY-MM-DD>` | epic の予定開始日(実在する暦日、`-` で省略・削除) | `add` / `update` |
|
|
515
502
|
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
|
|
516
503
|
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
|
|
517
504
|
| `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
|
|
@@ -539,6 +526,8 @@ specdojo schedule strategy generate \
|
|
|
539
526
|
|
|
540
527
|
`register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
|
|
541
528
|
|
|
529
|
+
`--start-on` は epic の `start_on` に予定開始日を記録します。epic 以外への指定や不正な日付は記帳前に拒否します。`update` で未指定なら保持し、`-` で削除します。`start_on` が `due_on` より後でも記録は保持しますが、`register build` は警告し、全体計画の期間を未定として扱います。開始日の優先順位は [[specdojo:register-operation-guide|登録簿運用ガイド]] を参照してください。
|
|
530
|
+
|
|
542
531
|
`register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
|
|
543
532
|
|
|
544
533
|
`--input <text>` は、対話で得た前提・制約・委任範囲を個票本文の `入力` 節へ指定順に記録します。`update` で未指定なら保持し、指定すれば一覧を置換します。追記するときは既存分も含めて再指定し、`--input -` 単独で全削除します。add での `-`、空文字、削除と他の値の混在は拒否します。既存個票に節がなければ更新時に追加します。event の `input` は変更前後の JSON 配列を保持し、空は `-` で表します。register から生成する plan は approach の有無によらず、入力がある場合だけ完了条件とは別の「個票の入力(前提)」へ載せます。
|
|
@@ -551,7 +540,14 @@ specdojo schedule strategy generate \
|
|
|
551
540
|
|
|
552
541
|
`sample-maintenance` は `type` を見ず、対象 `id` の末尾が `-sample` かどうかで判定します。利用者の authority の sample も同じ規則です。recipe・template・rulebook の maintenance は従来どおり `type` の一致を検証します。sample の `type` の規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を参照してください。
|
|
553
542
|
|
|
554
|
-
カタログなしで使える成果物の approach は `fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` です。`cross-deliverable-dedup` はカタログが必要です。
|
|
543
|
+
カタログなしで使える成果物の approach は `fully-guided`・`condense`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` です。`cross-deliverable-dedup` はカタログが必要です。
|
|
544
|
+
|
|
545
|
+
`condense` は既存成果物 1 件の冗長さを直す edit です。カタログなしでも索引と `specdojo.rulebook` から解決できます。未作成の文書は指定できません。記録形式と Kata の手入れへの振り分けは [[specdojo:plan-result-lifecycle-guide]] を参照してください。
|
|
546
|
+
|
|
547
|
+
```bash
|
|
548
|
+
specdojo register add --project prj-0001 --type todo --title "概要の冗長さを整理" --owner ARC --approach condense --target prj-0001:prj-overview
|
|
549
|
+
specdojo exec run --project prj-0001 --register <PJR-ID> --worktree
|
|
550
|
+
```
|
|
555
551
|
|
|
556
552
|
- 新規文書には `--target-path <リポジトリ相対パス>` と `--target-rulebook <rulebook-id>` を指定します。個票の `target_path` と `target_rulebook` に保存されます。既存文書は `--target` の ID を索引で引き、パスと `specdojo.rulebook` を使います。明示指定と既存文書が矛盾した場合は停止します。
|
|
557
553
|
- パスはリポジトリ外、外を指すシンボリックリンク、別の ID を持つ既存ファイルを受け付けません。更新時も同じ検証を行い、`--target-path -`・`--target-rulebook -` で各指定を削除できます。
|
|
@@ -561,7 +557,7 @@ specdojo schedule strategy generate \
|
|
|
561
557
|
- カタログなしの plan は、カタログの `done_criteria` がないことを明示し、個票の完了条件と rulebook を使います。`retrofit` の実装調査入力は個票にパスを明記します。
|
|
562
558
|
- カタログ設定済みで対象が未登録の場合、パスと rulebook を両方明示した場合だけカタログなしと同じ解決を使います。未指定なら従来のエラーで停止します。カタログにある対象ではカタログの宣言を優先します。
|
|
563
559
|
|
|
564
|
-
`register add --type epic --track <track>` は track ごとの仕事を起票します。type は `epic` / `todo` / `question` / `risk` / `issue` / `change-request` / `decision` / `note` です。epic は todo と同じ状態を使い、通常終端は `done`、例外終端は `rejected` / `deferred` です。track は Frontmatter の `track` に保存し、`update --track` で置換します。英小文字・数字・ハイフン(先頭は英小文字か数字)の識別子が必須で、削除やほかの type
|
|
560
|
+
`register add --type epic --track <track>` は track ごとの仕事を起票します。type は `epic` / `todo` / `question` / `risk` / `issue` / `change-request` / `decision` / `note` です。epic は todo と同じ状態を使い、通常終端は `done`、例外終端は `rejected` / `deferred` です。track は Frontmatter の `track` に保存し、`update --track` で置換します。英小文字・数字・ハイフン(先頭は英小文字か数字)の識別子が必須で、削除やほかの type への指定は拒否します。旧 timeline への登録は不要です。add・update・build は epic どうしの track 重複を拒否し、build は依存循環も検出します。任意の `domains` は反復可能な `--domain` で指定し、ほかの type への指定は拒否します。子 todo は `register add --type todo --from <epic-id>` で関連付けます。`register build` は `generated/pjr-epic-items.md` に epic ごとの直接の子項目と状態を表示し、別 project の子を project 修飾 ID で識別します。子のない epic も表示し、孫の再帰表示や epic の自動 close は行いません。完了は子項目と schedule を材料に人が判断します。
|
|
565
561
|
|
|
566
562
|
`item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
|
|
567
563
|
|
|
@@ -587,7 +583,7 @@ specdojo register add --project prj-0001 --type todo --from PJR-AB12 \
|
|
|
587
583
|
```
|
|
588
584
|
|
|
589
585
|
- `catalog-planning`: `catalog_path` が必要です。plan は既存カタログと DCT の kata・domain ごとの template を参照し、`catalog plan prompt` に沿った agent の判定、`catalog plan scaffold --from`、`catalog plan validate`、`catalog scaffold --plan`、`catalog validate` を完了条件として展開します。上流資料が不足する場合は `--input` で明示し、未確定事項を推測で補いません。
|
|
590
|
-
- `strategy-planning`: `catalog_path` と `schedule_path`
|
|
586
|
+
- `strategy-planning`: `catalog_path` と `schedule_path` が必要です。対象 track を担う epic が必要です。範囲は既存 strategy の scope、epic の `domains`、互換用 timeline の順に解決します。plan は既存カタログと Schedule の kata を参照し、`sch-strategy-<track>.yaml` の `scope.catalogs`・`approach_rules` の intent・担当の宣言、`schedule strategy generate`、`schedule build --track` の成功を完了条件として展開します。
|
|
591
587
|
- 対象はそれぞれ `domain:<id>` / `track:<id>` の 1 件です。ID は英小文字・数字・ハイフン、先頭は英小文字または数字、最大 63 文字です。個票の追加完了条件も plan に取り込みます。両 approach を schedule の成果物タスクへ指定することはできません。
|
|
592
588
|
|
|
593
589
|
`register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にし、対象は 1 件だけです。`rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` は `--target` に新しい kata ID、繰り返し可能な `--source` に手本を指定し、個票 Frontmatter の `sources` へ保存します。
|
|
@@ -620,34 +616,38 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
620
616
|
|
|
621
617
|
`exec` は schedule に基づいたタスクの実行、状態追跡、plan/result 生成、worktree 隔離実行を扱います。
|
|
622
618
|
|
|
623
|
-
| コマンド | 用途
|
|
624
|
-
| ---------------- |
|
|
625
|
-
| `exec where` | execution 関連パスを表示する
|
|
626
|
-
| `exec validate` | schedule
|
|
627
|
-
| `exec refresh` | state、Ready、CPM、gantt-chart を再計算する
|
|
628
|
-
| `exec scheduler` | 次のタスクを自動選択して claim する(`--dry-run` で選択のみ)
|
|
629
|
-
| `exec claim` | タスクを `doing` にする
|
|
630
|
-
| `exec complete` | タスクを `done` にする(actor の `doing` が1件なら `--task` 省略可)
|
|
631
|
-
| `exec reopen` | 誤って完了したタスクを `done` から `todo` に戻す
|
|
632
|
-
| `exec block` | タスクを `blocked` にする
|
|
633
|
-
| `exec unblock` | `blocked` を `doing` に戻す
|
|
634
|
-
| `exec release` | `doing` / `blocked` を `todo` に戻す
|
|
635
|
-
| `exec cancel` | `todo` を `cancelled` にする
|
|
636
|
-
| `exec note` | メモイベントを残す
|
|
637
|
-
| `exec link` | 外部参照イベントを残す
|
|
638
|
-
| `exec estimate` | 見積もりイベントを残す
|
|
639
|
-
| `exec run` | plan を生成してエージェントを実行する
|
|
640
|
-
| `exec handoff` | block された保護設定の提案差分を確認し、統合先へ適用して commit する
|
|
641
|
-
| `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する
|
|
642
|
-
| `exec cycle` | 延期 task 再開・doc-index 再構築・古い track の再生成・状態再計算・`--auto` loop を単一ロック内で順次実行する
|
|
643
|
-
| `exec slots` | 同じ project の exec run が共有する枠(`--join`・provider・親検証など)の上限と使用数を表示する
|
|
644
|
-
| `exec trial` | 同一planを複数agentで隔離試行し、比較・評価・採否を管理する
|
|
645
|
-
| `exec status` | 実行状態を表示する
|
|
646
|
-
| `exec scaffold` | 共通レビュー観点を継承するプロジェクト差分を生成する
|
|
647
|
-
| `exec plan` | plan だけを生成する
|
|
648
|
-
| `exec archive` | 完了済み plan
|
|
649
|
-
|
|
650
|
-
|
|
619
|
+
| コマンド | 用途 | 例 |
|
|
620
|
+
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
|
|
621
|
+
| `exec where` | execution 関連パスを表示する | `specdojo exec where --project prj-0001` |
|
|
622
|
+
| `exec validate` | schedule・event・実行記録の配置と lock の Git 除外を検証する(`--records-only` は配置のみ、`--schedule-only` は schedule・event のみ。併用不可) | `specdojo exec validate --project prj-0001` |
|
|
623
|
+
| `exec refresh` | state、Ready、CPM、gantt-chart を再計算する | `specdojo exec refresh --project prj-0001` |
|
|
624
|
+
| `exec scheduler` | 次のタスクを自動選択して claim する(`--dry-run` で選択のみ) | `specdojo exec scheduler --project prj-0001 --by agent-1` |
|
|
625
|
+
| `exec claim` | タスクを `doing` にする | `specdojo exec claim --project prj-0001 --task <task-id> --by agent-1` |
|
|
626
|
+
| `exec complete` | タスクを `done` にする(actor の `doing` が1件なら `--task` 省略可) | `specdojo exec complete --project prj-0001 --by agent-1` |
|
|
627
|
+
| `exec reopen` | 誤って完了したタスクを `done` から `todo` に戻す | `specdojo exec reopen --project prj-0001 --task <task-id> --by indie --msg "completion criteria unmet"` |
|
|
628
|
+
| `exec block` | タスクを `blocked` にする | `specdojo exec block --project prj-0001 --task <task-id> --by agent-1 --msg "waiting"` |
|
|
629
|
+
| `exec unblock` | `blocked` を `doing` に戻す | `specdojo exec unblock --project prj-0001 --task <task-id> --by agent-1 --msg "resume"` |
|
|
630
|
+
| `exec release` | `doing` / `blocked` を `todo` に戻す | `specdojo exec release --project prj-0001 --task <task-id> --by agent-1` |
|
|
631
|
+
| `exec cancel` | `todo` を `cancelled` にする | `specdojo exec cancel --project prj-0001 --task <task-id> --by agent-1 --msg "scope removed"` |
|
|
632
|
+
| `exec note` | メモイベントを残す | `specdojo exec note --project prj-0001 --task <task-id> --by agent-1 --msg "memo"` |
|
|
633
|
+
| `exec link` | 外部参照イベントを残す | `specdojo exec link --project prj-0001 --task <task-id> --by agent-1 --ref pr=https://example.com/pr/1` |
|
|
634
|
+
| `exec estimate` | 見積もりイベントを残す | `specdojo exec estimate --project prj-0001 --task <task-id> --by agent-1 --meta duration_days=1` |
|
|
635
|
+
| `exec run` | plan を生成してエージェントを実行する | `specdojo exec run --project prj-0001 --task <task-id>` |
|
|
636
|
+
| `exec handoff` | block された保護設定の提案差分を確認し、統合先へ適用して commit する | `specdojo exec handoff apply --project prj-0001 --register PJR-0012` |
|
|
637
|
+
| `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する | `specdojo exec resume --project prj-0001 --due` |
|
|
638
|
+
| `exec cycle` | 延期 task 再開・doc-index 再構築・古い track の再生成・状態再計算・`--auto` loop を単一ロック内で順次実行する | `specdojo exec cycle --project prj-0001 --loop` |
|
|
639
|
+
| `exec slots` | 同じ project の exec run が共有する枠(`--join`・provider・親検証など)の上限と使用数を表示する | `specdojo exec slots --project prj-0001` |
|
|
640
|
+
| `exec trial` | 同一planを複数agentで隔離試行し、比較・評価・採否を管理する | `specdojo exec trial run --project prj-0001 --plan <path> --agent agent-a agent-b` |
|
|
641
|
+
| `exec status` | 実行状態を表示する | `specdojo exec status --project prj-0001 --state blocked` |
|
|
642
|
+
| `exec scaffold` | 共通レビュー観点を継承するプロジェクト差分を生成する | `specdojo exec scaffold --project prj-0001` |
|
|
643
|
+
| `exec plan` | plan だけを生成する | `specdojo exec plan --project prj-0001 --task <task-id>` |
|
|
644
|
+
| `exec archive` | 完了済み plan を同じ run に保持する | `specdojo exec archive --project prj-0001 --task <task-id>` |
|
|
645
|
+
|
|
646
|
+
`exec validate` は、一部だけの run 記録を通常は `WARN:` で報告し、欠落だけなら終了コード 0 を返します。`--records-only` は同じ欠落を `ERROR:` と終了コード 1 にします。両モードとも、plan・result がそろい state・evidence のない evidence 導入前の run、state・evidence のみがあり同じ出どころ・項目の別 run に plan・result の対がある移行後の先行試行、旧 `exec/plans/`・`results/`・`evidence/` の記録はエラー・警告にしません。`execution/grade/generated/` と空の lock のディレクトリも配置の検査から外します。これら以外の配置違反、Git に無視されない lock、Git 確認失敗は通常時もエラーです。`--schedule-only` は従来どおり schedule・event だけを検査します。`--records-only --commit <rev>` は作業ツリーではなく `<rev>` の tree の記録を検査し、未 commit の run や空のディレクトリを対象にしません(pre-push の検査で使います)。
|
|
647
|
+
|
|
648
|
+
`exec migrate-records` は検査を通すためには不要です。移さない旧記録は、再開候補の自動探索、task ID からの plan・result の取得、dashboard の実行記録一覧・件数に含まれません。`register build` は旧記録を探索せず、個票の既存リンクを自動移行・補完しません。明示パスを読む経路などの条件と移行手順は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] の「既存記録の移行」を参照してください。
|
|
649
|
+
|
|
650
|
+
schedule の `exec resume --task <task-id> --resume-from executor` は、executor が `succeeded` で reporter が未完了、または統合段(commit・検査・merge)で止まった pipeline、あるいは approach の必須項目(`condense_records` など)を欠いた報告として runner が executor の段で止めた pipeline を、既存 worktree・変更・同じ run を引き継いで executor → reporter → 統合の順に再実行します。対象状態は reporter 段・統合段・executor 段の `blocked` または中断した `doing` で、executor の試行回数を増やし、`blocked` からの状態遷移は `unblock` イベントへ記録します。統合段から戻す場合は、executor を起動する前に統合先(project は root の現在ブランチ)を exec branch と worktree へ取り込みます。統合が成功済みの run、一部のリポジトリを統合済みの run、exec branch が merge 済みの run、worktree が merge の途中の run、executor 未成功、pipeline 以外、`executor` 以外の値は拒否します。`--task` は必須で、`--due` とは併用できません。worktree の `<execution_path>/runs/schedule/<task-id>/<run-id>/plan.md` を編集してから再開すると、その plan を使います。変更理由と再開の経緯を報告の `handoff` へ記載するよう plan に指示し、再開後の result の申し送りを確認してください。手順は [[specdojo:exec-operation-guide|exec運用ガイド]] の「blockedタスクの復帰」を参照してください。
|
|
651
651
|
|
|
652
652
|
`exec scaffold --project <project-id>` は、対象 project の `viewpoints_path` へ `extends: specdojo:pm-review-viewpoints` を持つ空の差分ファイルを生成します。共通正本は [[specdojo:pm-review-viewpoints|共通レビュー観点一覧]] であり、scaffold 時点の全量コピーは作りません。そのため、共通側の更新は次回の review plan 生成時に継承 project へ反映されます。既存ファイルは既定で保持し、`--force` の指定時だけ差分雛形で置き換えます。
|
|
653
653
|
|
|
@@ -804,7 +804,7 @@ register 実行の対応内容、状態追跡、commit の扱いは [登録簿
|
|
|
804
804
|
```bash
|
|
805
805
|
specdojo exec trial run \
|
|
806
806
|
--project prj-0001 \
|
|
807
|
-
--plan docs/ja/projects/prj-0001/execution/
|
|
807
|
+
--plan docs/ja/projects/prj-0001/execution/runs/schedule/<task-id>/<run-id>/plan.md \
|
|
808
808
|
--base <commit-before-completed-work> \
|
|
809
809
|
--agent agent-a agent-b \
|
|
810
810
|
--reporter-by reporter-a \
|
|
@@ -813,7 +813,7 @@ specdojo exec trial run \
|
|
|
813
813
|
# executorとreporterを組で比較する場合
|
|
814
814
|
specdojo exec trial run \
|
|
815
815
|
--project prj-0001 \
|
|
816
|
-
--plan docs/ja/projects/prj-0001/execution/
|
|
816
|
+
--plan docs/ja/projects/prj-0001/execution/runs/schedule/<task-id>/<run-id>/plan.md \
|
|
817
817
|
--base <commit-before-completed-work> \
|
|
818
818
|
--pair executor-a=reporter-a executor-b=reporter-b
|
|
819
819
|
|
|
@@ -844,7 +844,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
|
|
|
844
844
|
| `grade run` | 文書ごとに評価と反映を実行し、同じ run を再開する |
|
|
845
845
|
| `grade plan` | 1文書ごとに executor / reporter の評価 plan を保存する |
|
|
846
846
|
| `grade apply` | executor の申告を GradeSubmission へ機械変換して正本を反映する |
|
|
847
|
-
| `grade translation-plan` |
|
|
847
|
+
| `grade translation-plan` | 英語の正本の finding から日本語表示用の翻訳 plan を作る |
|
|
848
848
|
| `grade localize` | 訳文を件別検証し、合格した finding の `message_ja` を更新する |
|
|
849
849
|
| `grade validate` | サイドカーの内容ハッシュと finding 件数を検証する |
|
|
850
850
|
| `grade result` | 保存済み grade result を Markdown 文書のパスで表示する |
|
|
@@ -873,9 +873,13 @@ specdojo grade validate --target kata --project prj-0001
|
|
|
873
873
|
|
|
874
874
|
`grade run` の `--run-id` は必須です。選択文書と完了状況を `execution_path/grade/generated/runs/<run-id>/run.json` へ保存し、同じ引数での再実行では完了済み文書を再適用しません。選択は初回に固定するため、`--changed-only` で実行中に文書が選択から外れても再開できます。対象内容、観点、完了条件、突き合わせ先、引数が変わった場合や保存済み結果が置き換わった場合は、新しい run ID を使います。`--work-dir` で保存先を変更できます。`--limit` は初回の選択件数を制限します。
|
|
875
875
|
|
|
876
|
+
`--isolate-pipeline-state` は、文書別の再試行状態を共有の `<execution_path>/grade/pipeline/` から run 保存先の `pipeline/` へ分離します。`--work-dir` を併用すればその配下になります。再開判定では共有 state を使わず、連続失敗回数と再試行上限も run 内だけで管理し、共有 state の更新・削除は行いません。同じ引数と run ID なら失敗段から再開し、成功後は自分の state だけを削除します。Schedule の review 前の grade はこのオプションを常に指定し、他 run の checkpoint を失敗状態の更新で変更しません。分離した状態は `grade state --exhausted` や `grade list --incomplete` の共有状態一覧には含めません。正本の評価結果と完了条件詳細の保存先、および project 単位の grade 排他制御は変わりません。
|
|
877
|
+
|
|
876
878
|
`--by`(別名 `--stage-1-executor`)を省略すると、名簿の有効な review executor を既存の priority 規則で選びます。該当しなければ旧形式の review agent を選びます。別名で指定してもサイドカーの `graded_by` と run 記録には実体名を残します。`--exec-defaults` で起動設定を引き継げます。`--dry-run` は選択と actor を表示し、agent の起動とファイル更新を行いません。同一 project の grade 実行は排他制御します。
|
|
877
879
|
|
|
878
|
-
|
|
880
|
+
`--if-busy fail|wait` は同一 project の grade が実行中の場合の動作を指定します。省略時と `fail` は即時エラー、`wait` は既存 run の lock 解放を待って実行します。待機方針は同じ run ID の再開条件に含めません。Schedule の review 前の grade は `wait` を指定します。
|
|
881
|
+
|
|
882
|
+
ネイティブ経路は `--stages 1` と機械 reporter を扱います。`--reference` と `--embed-documents` は plan に反映し、`--kind` は kata の `rulebook` / `recipe` / `sample` / `template` / `all`(既定)を選びます。失敗した文書と理由は run 記録に残し、終了コード 1 を返します。`--max-stage-failures`(既定 3)に達するまでは未完了段を再開できます。`grade run` は翻訳の段を持ちません。finding は日本語の正本で書かれるため通常は翻訳が要らず、旧結果の英語の正本が再掲された場合だけ、必要に応じて `translation-plan` / `localize` で表示用の `message_ja` を作ります。開発用シェルの実験的な 3 段構成は CLI の対象外です。
|
|
879
883
|
|
|
880
884
|
宣言済み `project.repos` 配下の Markdown は、プロジェクトリポジトリから `../product/docs/document.md` のように指定できます。宣言外のリポジトリや symlink による範囲外への参照は拒否します。
|
|
881
885
|
|
|
@@ -914,11 +918,11 @@ specdojo grade validate --target kata --project prj-0001
|
|
|
914
918
|
|
|
915
919
|
成果物の plan は、成果物カタログの `done_criteria` を `DC-001` から順に列挙し、条件文、担当 Role code、viewpoint を executor へ渡します。executor は各条件を `satisfied` / `unsatisfied` として score とは独立に申告し、`grade apply` はその判定と不足理由を `[DONE_CRITERIA]` ブロックからそのまま GradeSubmission の `done_criteria` へ変換します。`grade apply --target deliverable` は過不足を検証し、grade result サイドカーの要約と `<execution_path>/grade/criteria/` の詳細 YAML を同時に更新します。詳細は成果物ごとに1ファイルで、再評価では同じファイルを上書きします。
|
|
916
920
|
|
|
917
|
-
再評価時は、grade result サイドカーの `findings[]` から `rule`、`severity`、`line`、`anchor
|
|
921
|
+
再評価時は、grade result サイドカーの `findings[]` から `rule`、`severity`、`line`、`anchor`、`message` を前回の指摘として plan へ含めます。`message` には表示用の `message_ja` があればそれを、なければ正本の `message` を示します。英語を正本にした旧記録は、日本語訳があれば日本語で示されます。agent は各指摘が現在も未解消かを確認し、未解消なら示された `message` を一字一句変えず(英語で示された場合も訳さず)、前回と同等以上の severity で今回の finding に含めます。`grade apply` は前回の正本 `message` と `message_ja` のどちらかに一致する finding を未解消と扱い、提出された severity が前回より軽ければ前回値へ戻し、対応する viewpoint level を severity 上限まで補正します。日本語で再掲された指摘はその日本語が新しい正本になり、英語の正本は再評価のたびに日本語へ移ります。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に引き下げの根拠を含めます。前回の観点割り当てに判定を引きずられないよう各 viewpoint を現在の根拠から独立に評価し、前回指摘にない問題も検出します。前回の level、score、verdict や解消履歴は plan に引き継ぎません。適用結果は最新サイドカーへ上書きされ、成果物本文は変更しません。
|
|
918
922
|
|
|
919
923
|
パス参照の executor は判定前に、plan が示す評価対象、すべての参考資料、選定された良い実例をファイル読み取りツールで全文読み、実行ログに各パスの読み取り操作を残します。埋め込みを使う executor は、plan に埋め込まれた同じ範囲だけを読みます。参考資料は成果物間整合、良い実例は章ごとの具体性・根拠の密度・過不足を比較する材料であり、どちらも評価対象にはしません。実例の表現や欠点を機械的に転用せず、rubric と viewpoint を最終的な判定基準にします。必要な資料を読み取れない場合は、内容を推測せず異常終了します。grade plan の Frontmatter と「このタスクで行うこと / 対象項目 / 進め方 / 完了手順 / 異常終了の条件」の章構成は exec plan に準拠します。
|
|
920
924
|
|
|
921
|
-
executor plan は JSON 契約を持ちません。各 viewpoint を `[VIEWPOINT <id>]` と `[END VIEWPOINT]` で囲み、`LEVEL: <0-4>` と、必要な `FINDING <severity> line=<line>: <message>`
|
|
925
|
+
executor plan は JSON 契約を持ちません。各 viewpoint を `[VIEWPOINT <id>]` と `[END VIEWPOINT]` で囲み、`LEVEL: <0-4>` と、必要な `FINDING <severity> line=<line>: <message>` を申告します。判定根拠と新しい finding の `message` は日本語で記述し、固有名詞・識別子・引用は原文を保ってよいとします。marker 間の根拠と検討過程は自由記述です。この軽量な申告形式により、JSON を安定して生成できない agent でも分析を完了できます。
|
|
922
926
|
|
|
923
927
|
`grade apply --analysis-from <executor-output>` を `--from` なしで実行すると、executor の最終応答の marker を解析して GradeSubmission を機械的に生成し、既存の GradeSubmission 検証を通してから反映します。LLM の reporter は起動しません。severity、line、message、done_criteria の status と reason は申告のまま写し、level だけは severity 上限を超える場合に下方向へ補正します。書き写しの誤りや JSON の構文破損は起こりません。`--submission-out <path>` を指定すると、生成した GradeSubmission をリポジトリ内のパスへ保存します(`--dry-run` では保存しません)。判定主体は executor なので、`--by <executor-nickname>` が `.specdojo/agent-members.yaml` に存在する nickname を検証してサイドカーの `graded_by` へ記録します。
|
|
924
928
|
|
|
@@ -934,6 +938,15 @@ finding の忠実性照合では、message に限り、Unicode の正準等価
|
|
|
934
938
|
|
|
935
939
|
複数対象は、生成された executor plan を順に処理し、executor 応答を保存して直ちに `grade apply --path <document> --analysis-from <executor-output>` 相当の処理で反映します。`grade run` がこの連携を担い、後続文書が失敗しても適用済みの grade を保持します。部品ごとに実行する場合は、`agent run` で起動した応答の保存と受け渡しを呼び出し側が担います。保存済み executor plan は `exec trial` などで同じ入力を複数 agent へ渡す用途にも利用できます。
|
|
936
940
|
|
|
941
|
+
finding の任意項目 `cause` は原因を表します。成果物の grade plan は、各 `FINDING` の直後に `CAUSE: <JSON>` を1行で申告させ、`grade apply` はその JSON を finding の `cause` へ保存します。Kata そのものの grade では申告しません。原因の共通定義は `src/shared/finding-cause.ts` の `FindingCause` と `docs/specdojo/schemas/v1/finding-cause.schema.yaml` であり、edit の記録でも再利用できます。
|
|
942
|
+
|
|
943
|
+
| 原因 | `cause` の形 | 判定根拠 |
|
|
944
|
+
| -------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------ |
|
|
945
|
+
| この文書 | `{"type":"document"}` | Kata の問題箇所を示せない場合も含む |
|
|
946
|
+
| Kata | `{"type":"kata","kind":"recipe","location":"## 2. 深掘りの問い、3行目の引用"}` | 宣言された Kata の見出し・行・引用で原因箇所を示せる場合だけ |
|
|
947
|
+
|
|
948
|
+
`kind` は `rulebook` / `recipe` / `sample` / `template` のいずれかで、`location` は空にできません。原因のない旧結果は `document` として扱います。原因は冗長さに限らず全観点で付け、score・verdict・severity による level 上限・前の指摘の引き継ぎ・日本語訳には影響しません。reporter 経由でも原因の追加・省略・変更を検査します。手入れの edit plan は、宣言された該当 Kata が原因の指摘を、成果物が評価後に変わっていない最新サイドカーから展開します。`fully-guided` の plan は原因を添えてすべての指摘を残します。運用は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照してください。
|
|
949
|
+
|
|
937
950
|
### 8.1. npm package で 1 文書を評価する
|
|
938
951
|
|
|
939
952
|
npm package の部品だけで 1 文書を評価する最小手順は、plan の生成、executor agent の実行、marker の反映です。先に `.specdojo/agent-members.yaml` と agent の実行設定を用意してください。`grade plan` の出力に表示された executor plan のパスを `<executor-plan.md>` に指定し、同じ executor nickname を `agent run` と `grade apply` の `--by` に渡します。
|
|
@@ -990,7 +1003,7 @@ tools/grade/run-per-document.sh --run-id 20260928-rubric-v2 --target deliverable
|
|
|
990
1003
|
|
|
991
1004
|
reporter の既定はすべての段で `machine` です。`machine` の段は reporter agent を起動せず、`grade apply --analysis-from <executor-output> --submission-out <grade-submission.json>` で executor の marker を変換して反映します。finding の severity が許す level 上限を executor の申告が超えた場合は、機械変換が level を上限まで下げ、補正前後を grade result の `level_corrections` に記録します。`grade apply` が応答を拒否した場合は、拒否された応答を `executor-output.rejected.txt`、理由を `apply-rejection.log` として段のディレクトリへ残し、executor を1回だけ再実行して変換し直します。`--stage-<n>-reporter <nickname>` で agent の nickname を指定した段だけ、従来どおり LLM reporter を起動して `--from` の忠実性照合を行い、拒否時は reporter を1回だけ再実行します。LLM reporter は書き写しの精度を比較する用途に限ります。
|
|
992
1005
|
|
|
993
|
-
正本の grade result を保存した後、script は `grade translation-plan` で英語 finding
|
|
1006
|
+
正本の grade result を保存した後、script は `grade translation-plan` で英語 finding の文だけからなる配列を作ります。finding は日本語の正本で書かれるため、英語 finding は旧結果から再掲された英語の正本などに限られます。0件なら翻訳の段(翻訳 agent と `grade localize`)を流しません。1件以上ある場合だけ既定の `gemma26-translator`(`--translation-by` で変更可)へ渡します。plan は、同じ件数・同じ順序の訳文だけの JSON 文字列配列を返し、元のインラインコードを一字一句変えず、元にないインラインコードやバッククォートを加えないよう求めます。インラインコード以外の英語の語句は、固有名詞・識別子を除いて日本語へ訳します。
|
|
994
1007
|
|
|
995
1008
|
`grade localize` は件数が一致しなければ全項目を不合格とします。件数が一致する場合は、各要素が空でない文字列であること、平仮名または片仮名を含むこと、元の文と訳文のインラインコードの多重集合が一致することを検証し、合格項目だけを `message_ja` へ反映します。元のインラインコードが欠けた項目は `missing-inline-code`、元にないインラインコードが増えた項目は `extra-inline-code` で不合格にします。必須の `--rejections-out <path>` には、不合格項目の 0 始まりの `translation_index`、finding ID、理由を JSON で出力します。script はこの index ごとに `grade translation-plan --translation-index <index>` と `grade localize --translation-index <index>` を使って1回だけ再翻訳し、再び不合格なら正本の `message` を表示用にも保存します。翻訳 agent や JSON の失敗も同じフォールバックに入り、翻訳段階は viewpoint、level、severity、line、score、verdict を変更しません。
|
|
996
1009
|
|
|
@@ -1066,7 +1079,7 @@ specdojo exec worktree prune --project prj-0001
|
|
|
1066
1079
|
| `watch` | ファイル変更を監視して対象 build を実行する | `specdojo watch --project prj-0001 --scope exec` |
|
|
1067
1080
|
| `build` | 全生成物または指定 scope を一括再生成する | `specdojo build --project prj-0001 --scope all` |
|
|
1068
1081
|
|
|
1069
|
-
`dashboard build --project <id>` は `execution/generated/dashboard.md
|
|
1082
|
+
`dashboard build --project <id>` は `execution/generated/dashboard.md`、全体計画ガントチャート SVG、未作成カタログを再生成します。ダッシュボードは人の対応が要るもの(review、判断待ち、waiting、human タスク)、おすすめの登録項目(先行項目充足済み上位 10 件)、実行中の epic(開始日・終了日・稼働日数、段ごとの進捗と次に流せるタスク)を先頭に表示し、終わった epic(開始日・終了日・稼働日数一覧)、routine 定義一覧、Grade 全体表、全体の集計(Schedule 進捗・登録簿集計・ガントチャート)を `::: details` で折りたたみ表示します。各項目には文書サイトで開ける相対リンクを付与し、項目がない章は「ありません」を表示します。
|
|
1070
1083
|
|
|
1071
1084
|
`--scope` は `exec`、`catalog`、`register`、`index`、`all` を指定します。
|
|
1072
1085
|
|
|
@@ -1112,7 +1125,7 @@ specdojo exec run --job job-grade-kata --project prj-0001 --input period=2026-W3
|
|
|
1112
1125
|
|
|
1113
1126
|
`action` は単一オブジェクト、または先頭から順に実行する1件以上の配列を受け付けます。単一オブジェクトの `action.kind`、配列の各要素の `kind` は `job` または `specdojo` を受け付けます。`job` は実行内容と入力検証を参照先の Job Definition に委ね、`exec run --job` 経由で実行ロックに従います。`specdojo` は `args` に書いた specdojo サブコマンド(例: `[dashboard, build]`)へ `--project` を付けて直接起動し、実行ロックを取りません(agent を呼ばない読み取り・派生生成専用。`exec` と `--project` は `args` に書けません)。`register` / `exec-auto` / `exec-resume` / `exec-cycle` の旧 kind は廃止済みです。定義ファイルの配置、`interval`または`trigger.cron`の書式、複数 action の失敗方針、due判定は [routine運用ガイド](../guides/routine-operation-guide.md) を参照します。
|
|
1114
1127
|
|
|
1115
|
-
各 routine
|
|
1128
|
+
各 routine の実行完了時には、端末側の `routine-state.json` の最新状態とは別に、同じ保存先の `routine-runs.jsonl` へ `routine_id`、`scheduled_for`、開始・終了時刻、結果、Job Run ID(`specdojo` action・無変更の Job では空)を1実行1行で追記します。この履歴が dashboard の「routine 実行状況(昨日・本日)」の正本です。保存先は `$XDG_STATE_HOME/specdojo/`(未設定時は `~/.local/state/specdojo/`)以下で、`routine where` から確認できます。旧 `generated/` のファイルは初回利用時にコピーし、新しい状態を優先します。Job Run のない失敗だけを `<execution-path>/routines/failures/` に保存して commit し、成功・skip は Git に残しません。成功した Job が何も変更しなかった場合も Run 記録を commit せず、端末側の `noop` 記録で冪等性と checkpoint を保ちます。
|
|
1116
1129
|
|
|
1117
1130
|
```bash
|
|
1118
1131
|
# due な routine をまとめて実行する(cron / CI から呼ぶ想定)
|
|
@@ -1174,6 +1187,8 @@ specdojo orchestrator night --project prj-0001 \
|
|
|
1174
1187
|
|
|
1175
1188
|
各 wave は worktree と post-review を必須にし、成功は close、未完了は `waiting` にします。`--max-items` は一晩の件数、`--parallel` は wave の同時数、`--max-consecutive-failures` は次の wave を止める閾値です。`--on-rate-limit fallback` では fallback executor の指定が必須です。失敗を含む朝報告を保存できた場合は部分成功を表す終了コード 2、コマンド自体の異常は 1 を返します。
|
|
1176
1189
|
|
|
1190
|
+
Job worktree 内から起動しても、子 run の worktree は主の作業ツリーから起動した場合と同じ場所へ作られます。子の plan・result・実行記録は Job のブランチへ統合されます。Job の worktree 再起動用の内部印と Git の repository 固有環境変数は子の処理へ引き継がれません。配置の指定方法は [[specdojo:exec-worktree-guide|exec worktree運用ガイド]] を参照してください。
|
|
1191
|
+
|
|
1177
1192
|
## 16. devcontainer
|
|
1178
1193
|
|
|
1179
1194
|
`devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
|
|
@@ -225,7 +225,7 @@ flowchart
|
|
|
225
225
|
| [業務データ辞書 / 概念データストア定義](../rulebooks/cdsd-rulebook.md) | Conceptual Data Store Definition | `cdsd-<term>` | 概念データストア(情報の保管場所)を一覧で定義する | データストア名、対応プロセス、内容、更新タイミング、粒度、主な用途 など |
|
|
226
226
|
| [業務データ辞書 / 保管場所定義](../rulebooks/sld-rulebook.md) | Storage Location Definition | `sld-<term>` | 業務対象となる物の物理的な保管場所を一覧で定義する | 保管場所名、保管対象、内容・目的、関連プロセス、管理頻度 など |
|
|
227
227
|
| [業務データ辞書 / ステータス定義](../rulebooks/stsd-rulebook.md) | Status Definition | `stsd-<term>` | 業務上のエンティティが取り得る状態と状態間の遷移を一文書で定義する | 対象、状態名、通称、意味、成立条件、管理場所、状態遷移図、イベント、遷移条件など |
|
|
228
|
-
| [業務データ辞書 /
|
|
228
|
+
| [業務データ辞書 / 分類一覧](../rulebooks/cdt-rulebook.md) | Code Table | `cdt-<term>` | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | 分類定義名、種別、分類名、説明など |
|
|
229
229
|
| [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) | Conceptual Class Diagram | `ccd-<term>` | 業務上のエンティティ関係を図で定義する | 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など |
|
|
230
230
|
|
|
231
231
|
#### 2.1.3. 業務モデル
|
|
@@ -244,6 +244,7 @@ flowchart
|
|
|
244
244
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
245
245
|
| --- | --- | --- | --- | --- |
|
|
246
246
|
| [画面仕様](../rulebooks/uis-rulebook.md) | UI Specification | `uis-<term>` | 業務ユーザー視点の画面の利用目的や表示項目、操作を定義する | 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など |
|
|
247
|
+
| [CLI仕様](../rulebooks/clis-rulebook.md) | CLI Specification | `clis-<term>` | 利用者視点での CLI コマンド群の利用目的や操作の流れ、出力・エラーを定義する | 概要、利用目的、操作の流れ、操作とコマンド参照、出力・生成ファイルの要点、終了コードとエラー表示・利用者の次の手 など |
|
|
247
248
|
| [帳票仕様](../rulebooks/bds-rulebook.md) | Business Document Specification | `bds-<term>` | 業務ユーザー視点の帳票の利用目的や表示項目を定義する | 帳票概要、利用目的、表示項目、出力タイミング など |
|
|
248
249
|
|
|
249
250
|
#### 2.1.5. システム化機能
|
|
@@ -251,8 +252,8 @@ flowchart
|
|
|
251
252
|
<!-- prettier-ignore -->
|
|
252
253
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
253
254
|
| --- | --- | --- | --- | --- |
|
|
254
|
-
| [システム化機能一覧 / 全体構成](../rulebooks/sf-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
|
|
255
|
-
| [
|
|
255
|
+
| [システム化機能一覧 / 全体構成](../rulebooks/sf-index-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
|
|
256
|
+
| [システム化機能(個別)](../rulebooks/sf-rulebook.md) | System Function | `sf-<term>` | 個別のシステム化機能の目的、業務プロセス・画面との対応、処理要件を定義する | 機能目的・概要、業務プロセス・画面との対応、入出力・前提条件、処理要件、非機能制約、操作手順・コマンド参照、検証観点 |
|
|
256
257
|
|
|
257
258
|
#### 2.1.6. 用語集
|
|
258
259
|
|
|
@@ -272,7 +273,7 @@ flowchart
|
|
|
272
273
|
| [外部API仕様](../rulebooks/ifx-api-rulebook.md) | External API Specification | `ifx-api-<term>.yaml` | 外部システムとのAPI連携をOpenAPI形式(YAML)で定義する | エンドポイント、HTTPメソッド、リクエスト/レスポンス、ステータスコード |
|
|
273
274
|
| [外部ファイル連携仕様](../rulebooks/ifx-file-rulebook.md) | External File Exchange Specification | `ifx-file-<term>.yaml` | 外部システムとのファイル連携をYAMLで定義する | ファイル形式、伝送方法、スケジュール、ファイル項目一覧 |
|
|
274
275
|
| [外部メッセージ仕様](../rulebooks/ifx-msg-rulebook.md) | External Message Specification | `ifx-msg-<term>.yaml` | 他システムとのイベント/キューのメッセージ連携をAsyncAPI + CloudEvents(YAML)で定義する | チャネル名、メッセージ構造、エンドポイント、プロトコル |
|
|
275
|
-
| [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する |
|
|
276
|
+
| [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する | コマンド名、正本参照、入出力ストリーム、入出力ファイル、副作用、終了コード、エラー処理 |
|
|
276
277
|
|
|
277
278
|
### 2.3. アーキテクチャ
|
|
278
279
|
|
|
@@ -301,6 +302,7 @@ flowchart
|
|
|
301
302
|
- **System Design Index**:設計のSSOT(OpenAPI / AsyncAPI / migration / job定義 / config schema 等)への導線
|
|
302
303
|
- **System Design Critical Flows**:事故や仕様誤解の原因になりやすい“重要フロー”だけを少数(最大5件)定義
|
|
303
304
|
- **System Design Cross-cutting Policy**:エラー・冪等・リトライ・監査・トレーシング等の横断ルール(実装の共通前提)
|
|
305
|
+
- **Design System Specification**:画面をまたぐ GUI のデザインの決まり。既存のトークンや部品の正本は参照する
|
|
304
306
|
|
|
305
307
|
#### 2.4.1. ドキュメント一覧と概要(最小構成)
|
|
306
308
|
|
|
@@ -310,6 +312,9 @@ flowchart
|
|
|
310
312
|
| 全体構成(リンク集) | System Design Index | `sysd-index` | システム設計のSSOTへの導線を1箇所に集約し、設計情報を迷子にしない | 内部API定義(OpenAPI等)/イベント定義(AsyncAPI等)/DBスキーマ(migration等)/バッチ定義(workflow/cron等)/設定スキーマ(config schema等)/コード配置規約(モジュール境界) |
|
|
311
313
|
| 重要フロー | System Design Critical Flows | `sysd-critical-flows` | “読まないと事故る”フローだけを可視化し、実装・テスト・運用の共通理解を作る | 最大5フロー(冪等/補償/非同期/順序/整合性/外部I/F障害など)について、境界・永続化点・再実行性・失敗時挙動を図または箇条書きで定義 |
|
|
312
314
|
| 横断ルール | System Design Cross-cutting Policy | `sysd-cross-cutting-policy` | 実装全体に影響する共通ルールをSSOT化し、各所の実装ブレを防ぐ | エラー形式/例外分類、タイムアウト・リトライ、冪等キー、トランザクション境界、ログ/監査ログ、トレーシング、セキュリティ(認証・認可の実装原則)、バージョニング、設定の上書き階層 |
|
|
315
|
+
| [[specdojo:dss-rulebook\|デザインシステム]] | Design System Specification | `dss-<term>`(既定: `dss-common`) | GUI の見た目と操作時の表現を揃え、操作性目標を満たす設計の決まりを定める | デザイントークン、部品の使い方、レイアウトの型、状態表示、アクセシビリティ、正本への参照、検証方法 |
|
|
316
|
+
|
|
317
|
+
DSS の成果物は `docs/ja/product/040-system-design/` へ置きます。画面ごとの目的・項目・操作・遷移は UIS、測れる操作性目標は NFR が持ちます。ワイヤーフレームは文書として保守せず、UIS と DSS から試作を作ってプロダクトのリポジトリに置きます。
|
|
313
318
|
|
|
314
319
|
> 補足:従来の「実装データフロー図/実装クラス図/DB論理・物理/実装画面仕様/内部I/F/バッチ設計/設定一覧」は、
|
|
315
320
|
> **“SSOTをコード(定義ファイル)に寄せる”** 方針により、個別ドキュメントとしては作りません。
|
|
@@ -201,7 +201,7 @@ docs/
|
|
|
201
201
|
│ │ │ ├── cdsd-sales-management.md # 概念データストア定義(例:販売管理)
|
|
202
202
|
│ │ │ ├── sld-sales-management.md # 保管場所定義(例:倉庫・店舗)
|
|
203
203
|
│ │ │ ├── stsd-product-lifecycle.md # ステータス定義(状態一覧・状態遷移図の例:商品ライフサイクル)
|
|
204
|
-
│ │ │ ├──
|
|
204
|
+
│ │ │ ├── cdt-product-category.md # 分類一覧(コード表の例:商品カテゴリ)
|
|
205
205
|
│ │ │ └── ccd-sales-management.md # 概念クラス図(例:販売管理)
|
|
206
206
|
│ │ ├── 030-business-model/ # 業務モデル
|
|
207
207
|
│ │ │ ├── bps-sales-order-flow.md # 業務プロセス仕様(例:受注フロー)
|
|
@@ -235,7 +235,8 @@ docs/
|
|
|
235
235
|
│ ├── 040-system-design/ # システム設計
|
|
236
236
|
│ │ ├── sysd-index.md # 全体構成(リンク集)
|
|
237
237
|
│ │ ├── sysd-critical-flows.md # 重要フロー
|
|
238
|
-
│ │
|
|
238
|
+
│ │ ├── sysd-cross-cutting-policy.md # 横断ルール
|
|
239
|
+
│ │ └── dss-common.md # GUI デザインシステム
|
|
239
240
|
│ │
|
|
240
241
|
│ ├── 050-business-acceptance-criteria/ # 業務受入条件
|
|
241
242
|
│ │ └── bac-sales-order.md # 業務受入条件(例:受注)
|
|
@@ -99,21 +99,23 @@ exec の result の commit 前検査にも、利用リポジトリに設定が
|
|
|
99
99
|
|
|
100
100
|
`projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
|
|
101
101
|
|
|
102
|
-
| キー | 既定値 | 主な役割
|
|
103
|
-
| ----------------------- | ---------------- |
|
|
104
|
-
| `base_path` | リポジトリルート | project 文書に共通するパス接頭辞
|
|
105
|
-
| `project_register_path` | なし | 個票、event、登録簿の配置先
|
|
106
|
-
| `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先
|
|
107
|
-
| `schedule_path` | `schedule` | strategy、track、Schedule の配置先
|
|
108
|
-
| `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先
|
|
109
|
-
| `timeline_path` | `timeline` |
|
|
110
|
-
| `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml`
|
|
111
|
-
| `roles_path` | なし | role 定義ファイルの配置先
|
|
112
|
-
| `viewpoints_path` | なし | review / grade 観点ファイルの配置先
|
|
113
|
-
| `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先
|
|
114
|
-
| `jobs_path` | なし | `job-*.yaml` の配置先
|
|
115
|
-
|
|
116
|
-
`schedule_path
|
|
102
|
+
| キー | 既定値 | 主な役割 | 必要とする主なコマンド |
|
|
103
|
+
| ----------------------- | ---------------- | -------------------------------------------------- | ------------------------------------------------------------ |
|
|
104
|
+
| `base_path` | リポジトリルート | project 文書に共通するパス接頭辞 | project に紐づく各コマンド |
|
|
105
|
+
| `project_register_path` | なし | 個票、event、登録簿の配置先 | `register *`、`exec plan/run --register` |
|
|
106
|
+
| `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先 | `catalog *`、`deliverable scaffold`、catalog を使う grade 等 |
|
|
107
|
+
| `schedule_path` | `schedule` | strategy、track、Schedule の配置先 | `schedule *`、schedule 対象の `exec *` |
|
|
108
|
+
| `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先 | `exec *`、`grade *`、`job *`、`dashboard build` |
|
|
109
|
+
| `timeline_path` | `timeline` | 非推奨。旧 timeline の互換読み込み・生成物の配置先 | 旧 `timeline *` と範囲解決の互換処理 |
|
|
110
|
+
| `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml` | actor 検証、owner 検証、合成名簿の project 側入力 |
|
|
111
|
+
| `roles_path` | なし | role 定義ファイルの配置先 | `schedule strategy generate`、owner を解決する `exec plan` |
|
|
112
|
+
| `viewpoints_path` | なし | review / grade 観点ファイルの配置先 | `grade *`、review plan、`exec scaffold --project` |
|
|
113
|
+
| `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先 | `routine *`、routine を集約する `dashboard build` |
|
|
114
|
+
| `jobs_path` | なし | `job-*.yaml` の配置先 | `job *`、`exec run --job` |
|
|
115
|
+
|
|
116
|
+
`schedule_path` と `execution_path` は解決時の既定値があります。ただし `schedule` コマンドや一括 `build` の対象判定ではキーの明示が必要なため、catalog から Schedule と exec へ進む構成では省略しないでください。
|
|
117
|
+
|
|
118
|
+
全体計画は `project_register_path` の epic を正本とし、`dashboard build` が `execution_path` 配下の `generated/` へ生成します。`timeline_path` の明示指定と旧 `tml-index.yaml` の読み込みは非推奨の警告を出します。未指定でも互換読み込み先は `timeline/` です。新規構成で `timeline_path` は不要です。移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
|
|
117
119
|
|
|
118
120
|
## 4. projectの非パスキー
|
|
119
121
|
|
|
@@ -342,7 +344,6 @@ agent 実行を使う場合は、この project オブジェクトとは別に
|
|
|
342
344
|
"catalog_path": "010-deliverables-catalog",
|
|
343
345
|
"schedule_path": "schedule",
|
|
344
346
|
"execution_path": "execution",
|
|
345
|
-
"timeline_path": "timeline",
|
|
346
347
|
"members_path": "030-project-management/pm-members.yaml",
|
|
347
348
|
"roles_path": "030-project-management/pm-roles.yaml",
|
|
348
349
|
"viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
|