specdojo 0.8.0 → 0.9.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 +4 -1
- package/CHANGELOG.md +64 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +4 -1
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +9 -1
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +9 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:job-sequence-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: draft
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 順次実行 Job の例
|
|
9
|
+
|
|
10
|
+
Sequential Job Guide
|
|
11
|
+
|
|
12
|
+
止まった Schedule task の再開 → track の auto ループ → 次の register 項目 → grade → docs build を、runner が順に実行する例です。`docs/ja/specdojo/samples/job-sequence.yaml` を project の `jobs_path` へコピーして使います。値制約と記録形式は [[specdojo:job-definition-standard|Job 定義標準]] を参照してください。
|
|
13
|
+
|
|
14
|
+
**対象読者**
|
|
15
|
+
|
|
16
|
+
- exec・grade・検査を夜間などにまとめて順次実行する開発者、運用者
|
|
17
|
+
|
|
18
|
+
**この文書で分かること**
|
|
19
|
+
|
|
20
|
+
- 順次実行 Job の定義例、手動・routine / cron からの起動、結果確認と再試行
|
|
21
|
+
|
|
22
|
+
**次に読む文書**
|
|
23
|
+
|
|
24
|
+
- [[specdojo:job-definition-standard|Job 定義標準]]
|
|
25
|
+
- [[specdojo:routine-operation-guide|routine 運用ガイド]]
|
|
26
|
+
|
|
27
|
+
## 1. 手動実行
|
|
28
|
+
|
|
29
|
+
入力の task ID・track・個票・評価対象を、実在する対象へ置き換えます。`schedule_state` は `execution_path` の `generated/state.json` を指し、段の末尾の `exec refresh` で最新状態を生成します。例は SpecDojo 本体の `docs:build` を呼ぶため、別の repository では導入済みの検査へ差し替えます。
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
specdojo job validate --project prj-0001
|
|
33
|
+
specdojo exec run --project prj-0001 --job job-sequence \
|
|
34
|
+
--input resume_task=T-EXAMPLE-document-020 track=example \
|
|
35
|
+
track_end_task=T-EXAMPLE-document-090 \
|
|
36
|
+
schedule_state=docs/ja/projects/prj-0001/execution/generated/state.json \
|
|
37
|
+
register_item=PJR-XXXX \
|
|
38
|
+
register_ticket=docs/ja/projects/prj-0001/controls/project-register/pjr-xxxx-example.md \
|
|
39
|
+
grade_path=docs/ja/product/example.md --dry-run
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
dry-run で解決済みの段・状態参照先を確かめ、実行時は `--dry-run` を外します。resume と auto は refresh 後の task 状態、register は個票の状態を終了コードに加えて確認します。grade は選択した文書の pipeline が完了しなければ非 0 で終了するため、その終了コードを使います。grade の失敗後も build を試す `on_failure: continue` を例示していますが、Run 全体は失敗のままです。
|
|
43
|
+
|
|
44
|
+
## 2. routine と cron
|
|
45
|
+
|
|
46
|
+
同じ Job を routine の `action` で参照します。`rtn-sequence.yaml` を `routines_path` に置き、入力は手動例と同様に対象へ合わせます。運用前に実行対象と agent 設定を確認してください。
|
|
47
|
+
|
|
48
|
+
```yaml
|
|
49
|
+
id: rtn-sequence
|
|
50
|
+
name: 夜間の順次実行
|
|
51
|
+
enabled: true
|
|
52
|
+
trigger:
|
|
53
|
+
cron: "0 1 * * *"
|
|
54
|
+
timezone: Asia/Tokyo
|
|
55
|
+
action:
|
|
56
|
+
kind: job
|
|
57
|
+
job: job-sequence
|
|
58
|
+
inputs:
|
|
59
|
+
resume_task: T-EXAMPLE-document-020
|
|
60
|
+
track: example
|
|
61
|
+
track_end_task: T-EXAMPLE-document-090
|
|
62
|
+
schedule_state: docs/ja/projects/prj-0001/execution/generated/state.json
|
|
63
|
+
register_item: PJR-XXXX
|
|
64
|
+
register_ticket: docs/ja/projects/prj-0001/controls/project-register/pjr-xxxx-example.md
|
|
65
|
+
grade_path: docs/ja/product/example.md
|
|
66
|
+
policy:
|
|
67
|
+
missed_run: latest
|
|
68
|
+
overlap: skip
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
cron は repository に移動して `routine run --due` を起動するだけです。たとえば5分ごとに `cd /path/to/repository && specdojo routine run --project prj-0001 --due` を呼びます。runner 自身が待機・各段の起動・完了判定を行うので、Claude Code・Codex・Antigravity の会話機能には依存しません。
|
|
72
|
+
|
|
73
|
+
## 3. 結果と再試行
|
|
74
|
+
|
|
75
|
+
Job Run JSON の `attempts[].steps` で成功・失敗・延期、終了コード、理由、各 command evidence 参照を確認します。project lock を取得するまでの上限は定義の3600秒です。grade 独自の lock も `--if-busy wait` で待ちます。grade 段の `timeout_seconds: 7200` は待機と処理を含む実行時間の上限で、超過するとプロセスを停止して延期にします。次回は同じ `job_run_id` による grade の再開を使います。
|
|
76
|
+
|
|
77
|
+
同じ `--scheduled-at` と入力で再実行すると、失敗した Run の次 attempt で先頭から実行します。完了済み Run の同じ実行枠は重複実行しません。新しい `--scheduled-at` は新規 Run になるため、停止した task の再開条件を確認して入力を変えます。routine 自体の失敗・延期履歴と実行枠の扱いは [[specdojo:routine-operation-guide|routine 運用ガイド]] に従います。
|
|
@@ -675,7 +675,7 @@ npx specdojo catalog validate --project prj-0001
|
|
|
675
675
|
npx specdojo deliverable scaffold --project prj-0001
|
|
676
676
|
|
|
677
677
|
# カタログの Markdown 派生ビューをビルド
|
|
678
|
-
npx specdojo
|
|
678
|
+
npx specdojo build --only catalog --project prj-0001
|
|
679
679
|
```
|
|
680
680
|
|
|
681
681
|
</details>
|
|
@@ -735,7 +735,7 @@ npx specdojo schedule strategy generate \
|
|
|
735
735
|
```chat
|
|
736
736
|
あなた: スケジュールを生成して、今すぐ着手できるタスクを確認したいです。
|
|
737
737
|
|
|
738
|
-
オーケストレーター: track launch の内容と出力先(`schedule_path` の既定は docs/ja/projects/prj-0001/schedule)を確認しました。schedule
|
|
738
|
+
オーケストレーター: track launch の内容と出力先(`schedule_path` の既定は docs/ja/projects/prj-0001/schedule)を確認しました。build --only schedule と exec refresh を実行してよろしいですか?
|
|
739
739
|
|
|
740
740
|
あなた: はい、実行してください。
|
|
741
741
|
|
|
@@ -755,7 +755,7 @@ npx specdojo schedule strategy generate \
|
|
|
755
755
|
|
|
756
756
|
```bash
|
|
757
757
|
# スケジュールのビルド
|
|
758
|
-
npx specdojo
|
|
758
|
+
npx specdojo build --only schedule --project prj-0001 --track launch --force
|
|
759
759
|
|
|
760
760
|
# Ready タスクと CPM の更新
|
|
761
761
|
npx specdojo exec refresh --project prj-0001
|
|
@@ -267,7 +267,7 @@ specdojo register close \
|
|
|
267
267
|
--commit
|
|
268
268
|
```
|
|
269
269
|
|
|
270
|
-
`--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>`
|
|
270
|
+
`--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>` で上書きできます。`-m` を繰り返すと、`git commit -m` と同じく 1 つ目を件名、2 つ目以降を本文の段落にします。commit に失敗した場合は、記帳済みで未 commit のファイルを示して終了コード 1 で終わります。`--dry-run` と同時に指定した場合は表示だけを行い、枠の取得と commit は行いません。
|
|
271
271
|
|
|
272
272
|
ほかのファイルがすでに stage されていても、初回 commit と hook 整形後の amend は対象パスだけを記録し、既存の staged 変更を保持します。実行中に別タスクの exec event が増えても対象へ取り込みません。stage 後の検査や commit・amend が失敗した場合、または `SIGINT`・`SIGTERM`・`SIGHUP` で中断された場合は、そのコマンドが stage した対象だけを unstage し、作業ツリーの本文を残します。Git の実行中に届いた中断は Git が戻ってから処理します。初回 commit 後の失敗・中断では commit が残るため、本文と HEAD の差分を確認してから再実行してください。
|
|
273
273
|
|
|
@@ -13,7 +13,7 @@ Routine Operation Guide
|
|
|
13
13
|
|
|
14
14
|
routineは、既存の未完了Schedule/Register項目を探索するほか、再利用可能なJob Definitionから期間・revisionごとのJob Runを生成できます。週報や変更文書の翻訳は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
|
|
15
15
|
|
|
16
|
-
継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine
|
|
16
|
+
継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。Job の `task.command` は選択条件ごとの `grade list` の和集合を Run ごとに固定し、各文書の executor 実行と marker の機械変換・反映を `grade run` に任せます(PJR-R7BQ)。`grade run` は単段で評価します。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
|
|
17
17
|
|
|
18
18
|
v0.3.0 の公開物における grade は試験的な機能です。利用者は `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、定期実行や通しの pipeline は自分で組み合わせます。成果物の grade には project の `catalog_path` が必要です。1 文書の最小手順は [CLI コマンドリファレンス](../references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
|
|
19
19
|
|
|
@@ -32,6 +32,8 @@ v0.3.0 の公開物における grade は試験的な機能です。利用者は
|
|
|
32
32
|
|
|
33
33
|
## 1. routineの定義
|
|
34
34
|
|
|
35
|
+
resume → auto → register → grade → build のように前段の完了を待つ流れは、command Job の `task.steps` に定義し、routine からその Job を1回呼びます。各段の失敗方針・状態判定・有限の lock 待機は runner が処理するため、agent の会話再開機能を必要としません。設定例と cron 起動は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照してください。
|
|
36
|
+
|
|
35
37
|
`routine` は `rtn-*.yaml` の定義に基づき、Schedule の依存グラフとは独立にタスクを定期実行します。CLI は常駐しません。外部スケジューラ(cron / CI の scheduled workflow)から `routine run --due` を冪等に呼び出す前提です。
|
|
36
38
|
|
|
37
39
|
定義は `.specdojo/specdojo.config.json` の `routines_path` 配下に `rtn-<slug>.yaml` として置き、`id` はファイル名と一致させます。
|
|
@@ -162,9 +164,9 @@ Job Definition を持たないため、Job Run と evidence は作られませ
|
|
|
162
164
|
|
|
163
165
|
### 1.2. grade の単段評価
|
|
164
166
|
|
|
165
|
-
Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の marker から機械的に生成します。executor は判定根拠と finding を日本語で書き、その文が正本になります。正本の grade result を保存した後、旧結果から再掲された英語の正本など英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。0件なら翻訳の段を流しません。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable`
|
|
167
|
+
Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の marker から機械的に生成します。executor は判定根拠と finding を日本語で書き、その文が正本になります。正本の grade result を保存した後、旧結果から再掲された英語の正本など英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。0件なら翻訳の段を流しません。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は `grade run` を起動し、条件付きの後続段は持ちません。`job-grade-kata` は `--reference-per-kind` で各文書を同じ種別の `prj-overview` 文書と比較します。`grade run` は翻訳の段を持たないため、上記の英語 finding の翻訳は定期 Job では流れません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
|
|
166
168
|
|
|
167
|
-
成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job
|
|
169
|
+
成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は `grade run --target deliverable` を実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
|
|
168
170
|
|
|
169
171
|
`rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日5時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
|
|
170
172
|
|
|
@@ -200,7 +202,7 @@ Job Definition は script を `if` の条件として起動し、終了コード
|
|
|
200
202
|
|
|
201
203
|
実行履歴は同じ保存先の `routine-runs.jsonl` へ1実行1行で追記します。各行は `routine_id`、`scheduled_for`、`started_at`、`completed_at`、`result`、`job_run_ids` を持ち、`docs/specdojo/schemas/v1/routine-run.schema.yaml` に従います。最新状態は due 判定、追記履歴は dashboard の日別実績表示に使います。
|
|
202
204
|
|
|
203
|
-
保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`routine
|
|
205
|
+
保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`where routine` で実際のパスを確認できます。初回の `routine list`・通常実行・dashboard 集計時に旧 `generated/` の状態と履歴をコピーし、新しいファイルがあれば上書きしません。旧ファイルは復旧用に残しますが以後は参照しません。移行前に旧版の routine プロセスを停止してください。別端末へ状態を引き継ぐ場合はこの保存先を別途コピーします。
|
|
204
206
|
|
|
205
207
|
routine 自身が Git に残すのは、結果が `failure` かつ関連 Job Run ID が空の実行だけです。`<execution-path>/routines/failures/<routine-id>/<UUID>.json` に履歴と同じ項目と `run_id` を書き、理由を伏せ字処理したうえで、そのファイルだけを commit します。Job Run があればその記録を診断に使います。成功・skip・無変更の履歴は端末側にだけ保存し、dashboard も同じ状態・履歴を参照します。lock は文書ツリー外にあり、`.gitignore` の追加設定は不要です。
|
|
206
208
|
|
|
@@ -242,13 +244,16 @@ specdojo routine run --project <project-id> --id rtn-daily-register-sweep
|
|
|
242
244
|
specdojo routine run --project <project-id> --due --dry-run
|
|
243
245
|
```
|
|
244
246
|
|
|
245
|
-
各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine
|
|
247
|
+
各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次の `routine run --due` に委ねます。
|
|
246
248
|
|
|
247
249
|
```text
|
|
248
250
|
[routine] skipped rtn-daily-register-sweep: job action skipped
|
|
251
|
+
[routine] rtn-daily-register-sweep: busy skip 1/24, retried on the next routine run --due
|
|
249
252
|
```
|
|
250
253
|
|
|
251
|
-
|
|
254
|
+
別の run の lock による skip(busy)は済んだ回として扱いません。cron の routine は `missed_run` が `latest` または `all`(省略時を含む)なら `last_scheduled_for` を進めず、空いた次の `routine run --due` でその回を流し直します。`latest` で新しい回が既に来ていれば新しい回だけを流します。`all` で同じ実行内に後の回が残っていても、busy の回より後は流さず次に回します。interval の routine は `busy_skip_count` が正の間、interval の経過を待たずに次の回で due になります。続いた busy skip が 24 回(毎時の `routine run --due` でおよそ 1 日)を超えたら、その回を済んだ回として扱い、`last_reason` と履歴の `reason` に上限到達を残します。`missed_run: skip` の cron、Job precondition の skip、失敗の回は従来どおり流し直しません。履歴の各行には skip の内訳を `skip_reason`(`busy` / `precondition`)で、流し直し待ちを `retry_pending: true` で残し、`routine status` で状態と直近の履歴を確認できます。
|
|
255
|
+
|
|
256
|
+
`routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。内訳は `routine-state.json` の `last_skip_reason` に残ります。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
|
|
252
257
|
|
|
253
258
|
### 2.1. devcontainerでのcron設定
|
|
254
259
|
|
|
@@ -148,14 +148,15 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
|
|
|
148
148
|
|
|
149
149
|
`sch-strategy-<track>.yaml`(生成入力)から `sch-track-<track>.yaml`(生成物)への展開では、タスク単位で確定する実行情報だけを展開します。
|
|
150
150
|
|
|
151
|
-
| 展開する情報 | 理由
|
|
152
|
-
| ------------------ |
|
|
153
|
-
| `name` | 実行者が作業を識別するために必要
|
|
154
|
-
| `description` | エージェント・人間が実行時に参照するフェーズ指示
|
|
155
|
-
| `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す
|
|
156
|
-
| `owner` | 誰が実行するかを決定するために必要
|
|
157
|
-
| `duration_days` | CPM 計算に必要
|
|
158
|
-
| `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する
|
|
151
|
+
| 展開する情報 | 理由 |
|
|
152
|
+
| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
|
|
153
|
+
| `name` | 実行者が作業を識別するために必要 |
|
|
154
|
+
| `description` | エージェント・人間が実行時に参照するフェーズ指示 |
|
|
155
|
+
| `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
|
|
156
|
+
| `owner` | 誰が実行するかを決定するために必要 |
|
|
157
|
+
| `duration_days` | CPM 計算に必要 |
|
|
158
|
+
| `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
|
|
159
|
+
| `agent` | phase の `agent` と `owner_rules[].phase_overrides[].agent` を解決した指名。plan だけで実行者を確かめられるようにする |
|
|
159
160
|
|
|
160
161
|
トラック全体に共通する生成ルールや設計意図は strategy に留めます。
|
|
161
162
|
|
|
@@ -166,6 +167,8 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
|
|
|
166
167
|
| `cross_domain_dependencies` | 依存関係の設計意図。トラックには解決済み `depends_on` として反映 |
|
|
167
168
|
| `phase_gates`・`group_milestones` | 生成ロジック。トラックにはマイルストーンとして展開済み |
|
|
168
169
|
|
|
170
|
+
`agent` もトラックへ展開しますが、実行時の解決は strategy を正とし、トラックの値では上書きしません。指名を変えるときは strategy を直し、`schedule build --track <track> --force` で作り直します。トラックを直接直すと、`exec validate` と `exec run --auto` が strategy から作り直した結果との違いを警告します。
|
|
171
|
+
|
|
169
172
|
`description` をトラックへ展開するのは、エージェントや人間が plan ファイルだけを読んで実行できるようにするためです。strategy を参照させる方式は plan 生成時にファイルが 2 つ必要になり、自己完結性が損なわれます。
|
|
170
173
|
|
|
171
174
|
反復タスクには、実行時にタスク ID の文字列解析へ依存しないよう、生成元を表す `phase_set`・`phase_id`・`phase_suffix` と、該当する `cycle`・`iteration` を展開します。
|
|
@@ -276,14 +279,14 @@ phase_sets:
|
|
|
276
279
|
proficiency: expert
|
|
277
280
|
```
|
|
278
281
|
|
|
279
|
-
| フィールド | 用途
|
|
280
|
-
| -------------- |
|
|
281
|
-
| `execution` | `agent` または `human`。省略時は `agent`
|
|
282
|
-
| `mode` | `edit` または `review`。省略時は `edit`
|
|
283
|
-
| `approach` | plan テンプレートの進め方を選ぶ
|
|
284
|
-
| `capabilities` | 必要なツールや能力を示す
|
|
285
|
-
| `proficiency` |
|
|
286
|
-
| `agent` | executor / reporter を nickname で指名する
|
|
282
|
+
| フィールド | 用途 |
|
|
283
|
+
| -------------- | ------------------------------------------------------------------- |
|
|
284
|
+
| `execution` | `agent` または `human`。省略時は `agent` |
|
|
285
|
+
| `mode` | `edit` または `review`。省略時は `edit` |
|
|
286
|
+
| `approach` | plan テンプレートの進め方を選ぶ |
|
|
287
|
+
| `capabilities` | 必要なツールや能力を示す |
|
|
288
|
+
| `proficiency` | 必要な習熟度を示す。`frontier` は明示要求時だけ自動選択の候補になる |
|
|
289
|
+
| `agent` | executor / reporter を nickname で指名する |
|
|
287
290
|
|
|
288
291
|
`approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。エージェント選択の詳細は [exec設定ガイド](exec-config-guide.md) を参照します。
|
|
289
292
|
|
|
@@ -320,7 +323,7 @@ phase_sets:
|
|
|
320
323
|
- pipeline を指定した phase は agent 実行専用です。`execution: human` と併用できません。
|
|
321
324
|
- `mode` と `approach` は phase 全体へ適用し、各 stage の agent 選択要件は stage 内の `capabilities` と `proficiency` で定義します。
|
|
322
325
|
- 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に `.specdojo/agent-members.yaml` の nickname を指定します。
|
|
323
|
-
- `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、phase の `agent`、stage の `capabilities` / `proficiency`
|
|
326
|
+
- `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、成果物単位に指名を上書きする `owner_rules[].phase_overrides[].agent`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。ready の作り直し・タスクの表示・実行のどれでも同じ順で、strategy を持つトラックでは、トラックへ展開した `agent` を使いません(トラックへ展開する情報を参照)。
|
|
324
327
|
- by-name の agent が rate limit になった場合は別 agent へ自動フォールバックせず、タスクを待機状態にします。再開時も同じ agent を使い、緊急の差し替えだけを CLI の stage override で行います。
|
|
325
328
|
- 登録簿の項目(`exec run --register`)は per-item のパイプライン宣言を持たないため、`agent_pipeline` の YAML 定義は使いません。代わりに `--executor-by <nickname>` と `--reporter-by <nickname>` を両方指定すると、同じ executor/reporter 2段階(evidence の受け渡し・result 描画を含む)で実行します。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `exec run` を参照します。
|
|
326
329
|
|
|
@@ -41,6 +41,8 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
41
41
|
| 定期実行定義 | `rtn-*.yaml` | `routine` |
|
|
42
42
|
| ドキュメントIDインデックス | `.specdojo/doc-index.json` | `index` |
|
|
43
43
|
|
|
44
|
+
保存先を確認するときは `specdojo where <種類> --project <id>` を使います。種類は `exec`・`catalog`・`schedule`・`timeline`・`job`・`routine` です。たとえば `specdojo where exec --project prj-0001` で実行記録の保存先を確認できます。旧 `<種類> where` は1版の移行期間後に削除するため、新しい構文へ置き換えてください。
|
|
45
|
+
|
|
44
46
|
### 1.1. 技の名前
|
|
45
47
|
|
|
46
48
|
主要な CLI 機能には、Spec道(仕様道)の道場で使う技の名前を付けています。
|
|
@@ -58,15 +60,17 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
58
60
|
|
|
59
61
|
生成や実行を伴うコマンドは、出力の性質と副作用に応じて次の動詞を使います。
|
|
60
62
|
|
|
61
|
-
| 動詞 | 用途 | 再実行と上書きの原則 | 代表例
|
|
62
|
-
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
|
|
63
|
-
| `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold`
|
|
64
|
-
| `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `
|
|
65
|
-
| `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh`
|
|
66
|
-
| `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run`
|
|
63
|
+
| 動詞 | 用途 | 再実行と上書きの原則 | 代表例 |
|
|
64
|
+
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------- |
|
|
65
|
+
| `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold` |
|
|
66
|
+
| `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `build`、`build --only catalog`、`build --only schedule` |
|
|
67
|
+
| `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh` |
|
|
68
|
+
| `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run` |
|
|
67
69
|
|
|
68
70
|
`scaffold` と `build` の違いは、生成後のファイルを人が正本として編集するか、入力から再生成できる派生物かです。`refresh` は build 可能な一般成果物ではなく、イベントを反映して時点ごとに変わる実行状態に限定します。`run` はファイル生成そのものではなく、処理の遂行を表します。
|
|
69
71
|
|
|
72
|
+
区分を絞る場合は `build --only <区分>` を使います。対応する区分・オプションと内部互換用の旧入口は [[specdojo:command-reference|CLIコマンドリファレンス]] の「watch / build」を参照してください。
|
|
73
|
+
|
|
70
74
|
## 2. 標準ディレクトリ構成
|
|
71
75
|
|
|
72
76
|
プロジェクト文書は `docs/ja/projects/<project-id>/` 配下に置きます。代表的な構成は次のとおりです。
|
|
@@ -188,10 +192,10 @@ specdojo catalog validate --project prj-0001
|
|
|
188
192
|
|
|
189
193
|
# 3.1 カタログが指す成果物ファイル本体を一括生成する
|
|
190
194
|
specdojo deliverable scaffold --project prj-0001
|
|
191
|
-
specdojo
|
|
195
|
+
specdojo build --only catalog --project prj-0001
|
|
192
196
|
|
|
193
197
|
# 4. sch-strategy-launch.yaml を用意し、track schedule を生成する
|
|
194
|
-
specdojo
|
|
198
|
+
specdojo build --only schedule --project prj-0001 --track launch --force
|
|
195
199
|
|
|
196
200
|
# 5. 実行状態、Ready、CPMを生成する
|
|
197
201
|
specdojo exec refresh --project prj-0001
|
|
@@ -11,84 +11,101 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
Business Acceptance Criteria Writing Recipe
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
業務仕様から利用者が受け入れられる状態を取り出し、前提・行為・結果・証跡へ具体化する作り方を示す。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
- 業務仕様の判断とシナリオ ID、確認する証跡を結ぶ。根拠がない期待値は新たに決めず、判断依頼として残す。
|
|
18
|
+
- 業務受入条件は、上位の目的から誰の困りごとを解くか(Why)を引き継ぎ、業務が成立した状態(What)を決め、そこへ至る前提と業務行為(How)を逆算する。期待結果は根拠・シナリオ ID・証跡でたどれるようにする(Trace)。
|
|
19
|
+
- 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
|
|
21
20
|
|
|
22
21
|
## 2. 作成前に集める情報
|
|
23
22
|
|
|
24
|
-
| 項目 |
|
|
25
|
-
| -------------- |
|
|
26
|
-
| 利用者と価値 |
|
|
27
|
-
| 業務の境界 |
|
|
28
|
-
|
|
|
29
|
-
| 前提 |
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
| 改訂時の影響 | 根拠の変更・廃止はどのシナリオへ及ぶか。旧 ID や期待値を参照する仕様・設計・テストはどれか |
|
|
23
|
+
| 項目 | 集める情報 | 取り出し元 |
|
|
24
|
+
| -------------- | -------------------------------------------------- | ---------------------------- |
|
|
25
|
+
| 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか | プロジェクトの受入条件 |
|
|
26
|
+
| 業務の境界 | 何が起点で、どの記録や引き継ぎまでで終わるか | 業務プロセス仕様 |
|
|
27
|
+
| 確定済みの判断 | 不足・拒否・途中変更をどう扱うと決まっているか | 業務プロセス仕様、業務ルール |
|
|
28
|
+
| 前提 | 必要な状態・入力・権限と、不足すると止まること | 業務プロセス仕様 |
|
|
29
|
+
| 確認者と証跡 | 誰がいつ何を照合して合否を決め、誰が合意するか | 業務担当者の代表への確認 |
|
|
30
|
+
| 未決の論点 | 期待値を決める材料がない場面と、受入を止めるか否か | 確認の過程のメモ |
|
|
33
31
|
|
|
34
32
|
## 3. 全体の作成手順
|
|
35
33
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
41
|
-
6.
|
|
34
|
+
1. 概要の受入対象と価値を最初に書く。業務の終わりが決まらないと、シナリオの範囲が決まらない。
|
|
35
|
+
2. 正常完了のシナリオを一つ書く。終了状態を先に決め、開始状態と業務行為を逆算する。
|
|
36
|
+
3. 期待結果ごとに、誰がいつどの記録で確かめるかを書く。
|
|
37
|
+
4. 不足・拒否・途中変更・再開で結果が変わる場面を足す。
|
|
38
|
+
5. 根拠で期待値を決められない場面をメモ / 将来課題へ移す。
|
|
39
|
+
6. 最後に価値とシナリオ ID の対応を見直す。書いた後のほうが、確認漏れの価値に気づきやすい。
|
|
42
40
|
|
|
43
41
|
## 4. 各章の書き方
|
|
44
42
|
|
|
45
43
|
### 4.1. 概要
|
|
46
44
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
-
|
|
45
|
+
問い:
|
|
46
|
+
|
|
47
|
+
- この受入に合格すると、誰が次にどの業務を進められるか。
|
|
48
|
+
- 隣の業務の判断まで引き受けていないか。
|
|
49
|
+
|
|
50
|
+
コツ:
|
|
51
|
+
|
|
52
|
+
- 画面名から書くと、手段が受入対象になりやすい。困りごとを一つ選び、開始点と終了点を先に決める。
|
|
53
|
+
- 上位の目的や受入条件の本文は、写さず参照に置き換える。
|
|
50
54
|
|
|
51
55
|
### 4.2. 受入条件
|
|
52
56
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
-
|
|
57
|
+
問い:
|
|
58
|
+
|
|
59
|
+
- その前提でその行為を行うと、何が変わり、何が変わらないか。
|
|
60
|
+
- 別の人も同じ証跡から合否を判断できるか。
|
|
61
|
+
|
|
62
|
+
コツ:
|
|
63
|
+
|
|
64
|
+
- 業務担当者に「確定したと誰がどの記録で分かるか」を聞くと、操作の列挙から観測できる結果へ移れる。
|
|
65
|
+
- 数値には単位と確認時点を付ける。
|
|
56
66
|
|
|
57
67
|
### 4.3. メモ / 将来課題
|
|
58
68
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
-
|
|
69
|
+
問い:
|
|
70
|
+
|
|
71
|
+
- どのシナリオの期待値が未確定で、誰の判断があれば再開できるか。
|
|
72
|
+
- その論点は現行の受入を止めるか、将来の拡張か。
|
|
73
|
+
|
|
74
|
+
コツ:
|
|
75
|
+
|
|
76
|
+
- 既定値で期待結果を埋めたくなったら、論点として残す。
|
|
77
|
+
- 受入を止める論点は、当面どの経路を保留するかを聞いて書く。
|
|
62
78
|
|
|
63
79
|
## 5. 深掘り手順
|
|
64
80
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
81
|
+
内容が浅いときは、次の順で対応のない主張を探す。
|
|
82
|
+
|
|
83
|
+
1. 概要の価値からシナリオをたどり、確認されない価値と、根拠に結び付かないシナリオを探す。
|
|
84
|
+
2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。
|
|
85
|
+
3. 途中で入力や対象が変わる場面を置き、前の記録を使えるかを確かめる。
|
|
86
|
+
4. 停止後に次の担当が受け取る情報をたどり、再開に要る状態と証跡を特定する。
|
|
69
87
|
|
|
70
88
|
## 6. 良い例 / 悪い例
|
|
71
89
|
|
|
72
|
-
| 観点
|
|
73
|
-
|
|
|
74
|
-
|
|
|
75
|
-
|
|
|
76
|
-
|
|
|
77
|
-
|
|
|
90
|
+
| 観点 | 良い例 | 悪い例 |
|
|
91
|
+
| -------- | ---------------------------------------------------- | ------------------------------ |
|
|
92
|
+
| 受入対象 | 家族が店番しても販売と在庫を記録して引き継げる | 販売画面を作る |
|
|
93
|
+
| 根拠 | 業務仕様で決まった入力不足の扱いをシナリオで確かめる | 書き手が不足時の既定値を決める |
|
|
94
|
+
| 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する |
|
|
95
|
+
| 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する |
|
|
96
|
+
| 判定 | 数量 2 の販売の確定後、在庫が 5 から 3 へ減ると照合 | 在庫が正しい |
|
|
97
|
+
| 未決 | 記録不能時の販売継続は未決とし、その経路の受入を保留 | 例外は後で追加 |
|
|
78
98
|
|
|
79
99
|
## 7. レビュー観点
|
|
80
100
|
|
|
81
|
-
| 観点 |
|
|
82
|
-
| ---------- |
|
|
83
|
-
| 業務価値 |
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
| 責務境界 | 新しい承認規則や実装方式を受入条件の中で決めていないか |
|
|
87
|
-
| 合意と継承 | BA の整理した範囲を QE が検証へ、ARC が設計へ引き継げるか。PO が判断する合意対象と PM が追跡する残作業を特定できるか |
|
|
101
|
+
| 観点 | 確認内容 |
|
|
102
|
+
| ---------- | ------------------------------------------------------ |
|
|
103
|
+
| 業務価値 | 各シナリオの必要性を利用者の困りごとから説明できるか |
|
|
104
|
+
| 例外と継承 | 止める判断と、次の担当の行為を区別できるか |
|
|
105
|
+
| 責務境界 | 新しい判断規則や実装方式を受入条件の中で決めていないか |
|
|
88
106
|
|
|
89
107
|
## 8. 仕上げチェック
|
|
90
108
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
- 条件を合意できる状態と試行済みの合格実績を区別し、準備作業や未決事項を解消済みとして扱っていない。
|
|
109
|
+
- 概要の各価値がシナリオ ID で確認され、各シナリオが根拠へたどれる。
|
|
110
|
+
- 未決の値を確定済みの期待結果へ混ぜていない。
|
|
111
|
+
- 条件を合意できる状態と、受入を試行して合格した実績を区別している。
|