specdojo 0.2.1 → 0.3.1
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 +165 -0
- package/CHANGELOG.md +298 -0
- package/README.md +92 -42
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/catalog-build-references.js +144 -0
- package/dist/catalog-build-render.js +144 -0
- package/dist/catalog-build.js +13 -290
- package/dist/catalog-generate.js +6 -9
- package/dist/catalog-plan-generate.js +2 -2
- package/dist/catalog-plan.js +6 -6
- package/dist/catalog-scaffold.js +4 -4
- package/dist/catalog.js +2 -2
- package/dist/dashboard-exec-records.js +105 -0
- package/dist/dashboard-routines.js +255 -0
- package/dist/dashboard-shared.js +14 -0
- package/dist/dashboard-timeline.js +175 -0
- package/dist/dashboard.js +31 -444
- package/dist/deliverable-trash.js +3 -3
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/doc-index.js +3 -3
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-commands.js +557 -0
- package/dist/exec-core.js +457 -0
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans-core.js +693 -0
- package/dist/exec-plans-generation.js +206 -0
- package/dist/exec-plans-storage.js +131 -0
- package/dist/exec-plans.js +3 -1016
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration-git.js +23 -0
- package/dist/exec-repo-integration-sync.js +264 -0
- package/dist/exec-repo-integration.js +534 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter-output.js +206 -0
- package/dist/exec-reporter.js +525 -248
- package/dist/exec-results.js +103 -71
- package/dist/exec-run-agent-pipeline.js +256 -0
- package/dist/exec-run-agent.js +531 -0
- package/dist/exec-run-in-place.js +541 -0
- package/dist/exec-run-job.js +717 -0
- package/dist/exec-run-lifecycle-commands.js +522 -0
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run-mode-shared.js +140 -0
- package/dist/exec-run-register-command.js +244 -0
- package/dist/exec-run-register-core.js +386 -0
- package/dist/exec-run-register-mode.js +206 -0
- package/dist/exec-run-register-resume.js +393 -0
- package/dist/exec-run-register-state.js +322 -0
- package/dist/exec-run-register-worktree.js +509 -0
- package/dist/exec-run-schedule-mode.js +294 -0
- package/dist/exec-run-schedule-prepare.js +353 -0
- package/dist/exec-run-schedule-task.js +572 -0
- package/dist/exec-run-shared.js +399 -0
- package/dist/exec-run.js +11 -4953
- package/dist/exec-shared.js +9 -2
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial-commands.js +558 -0
- package/dist/exec-trial-core.js +371 -0
- package/dist/exec-trial.js +2 -895
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops-commit.js +707 -0
- package/dist/exec-worktree-ops-lifecycle.js +292 -0
- package/dist/exec-worktree-ops-merge.js +303 -0
- package/dist/exec-worktree-ops.js +3 -847
- package/dist/exec-worktree.js +146 -31
- package/dist/exec.js +2 -999
- package/dist/frontmatter-namespace.js +2 -2
- package/dist/grade-apply.js +734 -0
- package/dist/grade-command-apply.js +250 -0
- package/dist/grade-command-inspect.js +138 -0
- package/dist/grade-command-plan.js +101 -0
- package/dist/grade-command-shared.js +68 -0
- package/dist/grade-core.js +307 -0
- package/dist/grade-markdown.js +274 -0
- package/dist/grade-pipeline-state.js +184 -0
- package/dist/grade-plan.js +507 -0
- package/dist/grade-result.js +133 -5
- package/dist/grade-target-discovery.js +265 -0
- package/dist/grade-targets.js +432 -0
- package/dist/grade.js +14 -2451
- package/dist/init-command.js +443 -0
- package/dist/job-definition.js +670 -0
- package/dist/job.js +64 -578
- package/dist/kata-command.js +2 -2
- package/dist/orchestrator.js +213 -0
- package/dist/register-command-types.js +1 -0
- package/dist/register-core.js +363 -0
- package/dist/register-create-commands.js +245 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-events.js +4 -4
- package/dist/register-item.js +13 -7
- package/dist/register-maintenance-commands.js +187 -0
- package/dist/register-migration.js +268 -0
- package/dist/register-renumber.js +314 -0
- package/dist/register-transition-commands.js +248 -0
- package/dist/register-update.js +230 -0
- package/dist/register-views.js +256 -0
- package/dist/register.js +175 -1975
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +114 -4
- package/dist/review-types.js +40 -1
- package/dist/routine-definition.js +401 -0
- package/dist/routine.js +73 -402
- package/dist/schedule-approach.js +2 -2
- package/dist/schedule-build.js +2 -2
- package/dist/schedule-strategy-generate-document.js +273 -0
- package/dist/schedule-strategy-generate-scope.js +199 -0
- package/dist/schedule-strategy-generate.js +9 -473
- package/dist/schedule.js +19 -6
- package/dist/specdojo-config.js +465 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/dist/yaml-pages.js +4 -4
- package/dist/yaml.js +28 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +335 -92
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +17 -12
- package/templates/antigravity/README.md +29 -4
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
- package/templates/antigravity/orchestrator.md +18 -7
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +18 -7
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
- package/templates/codex/orchestrator.md +18 -7
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +74 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
|
@@ -13,7 +13,9 @@ 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 で定期起動します。文書の選択、各文書の executor
|
|
16
|
+
継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。文書の選択、各文書の executor 実行、executor の marker を GradeSubmission へ機械変換する `grade apply --path --analysis-from` の逐次処理は `tools/grade/run-per-document.sh` が持ちます。このスクリプトと、このスクリプトを前提とする定期 Job は SpecDojo 本体リポジトリの開発用であり、スクリプトは npm package に含まれません。定期 Job は `--stages 1` で codex 単段を選びます。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
|
|
17
|
+
|
|
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-文書を評価する)を参照してください。
|
|
17
19
|
|
|
18
20
|
**対象読者**
|
|
19
21
|
|
|
@@ -49,6 +51,53 @@ action:
|
|
|
49
51
|
limit: "3"
|
|
50
52
|
```
|
|
51
53
|
|
|
54
|
+
### Job Run 出力の commit と review
|
|
55
|
+
|
|
56
|
+
統合前レビューが必要かどうかは Job の出力の性質で決まるため、routine ではなく Job Definition の `task.review` で宣言します([[specdojo:job-definition-standard]] の `統合前 review の宣言と review agent の規約`)。review executor と reporter も `task.review.agent` に nickname で指名します。routine は時刻条件のトリガー層であり、Job に書いた宣言と指名は、同じ Job を `exec run --job` で手動実行した場合にも同じように効きます。
|
|
57
|
+
|
|
58
|
+
```yaml
|
|
59
|
+
# job-*.yaml
|
|
60
|
+
task:
|
|
61
|
+
# mode や command などは省略
|
|
62
|
+
review:
|
|
63
|
+
agent:
|
|
64
|
+
executor: claude-expert-review-executor
|
|
65
|
+
reporter: claude-reporter
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
review agent は、`exec run` の `--review-by` / `--reporter-by`、Job の `task.review.agent`、自動選択の順に解決します。routine から CLI の指定は渡さないため、routine 起動では Job の指名か自動選択になります。解決結果は `specdojo exec run --job <job-id> --dry-run` の `review executor` / `review reporter` の行で、解決元とともに確認できます。
|
|
69
|
+
|
|
70
|
+
action の `commit: true` は互換として残しています。`task.review` を宣言していない Job でも `commit: true` なら同じ流れで実行しますが、新しい routine では推奨しません。Job が `task.review` を宣言している場合は Job を優先し、`commit` を省略しても、`false` を指定しても review を経て統合します。
|
|
71
|
+
|
|
72
|
+
統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
|
|
73
|
+
|
|
74
|
+
出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合だけ、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
|
|
75
|
+
|
|
76
|
+
#### waiting Run の確認・統合・破棄
|
|
77
|
+
|
|
78
|
+
`[routine-job] waiting` が出た Run は、表示された worktree と `exec/<project-id>-<run-id>` branch を確認します。
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
git -C <worktree> status --short
|
|
82
|
+
git -C <worktree> log --oneline --decorate -3
|
|
83
|
+
git diff <integration-branch>...exec/<project-id>-<run-id>
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
人が review result と差分を確認し、統合すると決めた場合は、統合先 branch の checkout で未 commit 変更との重複がないことを確認してから `--no-ff` で統合します。統合後は worktree を撤去し、merge 済み branch を削除します。
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
git merge --no-ff exec/<project-id>-<run-id>
|
|
90
|
+
git worktree remove <worktree>
|
|
91
|
+
git branch -d exec/<project-id>-<run-id>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
破棄すると決めた場合は、review result と Job Run evidence を先に確認します。未統合の記録も不要であることを確認したうえで worktree を強制撤去し、branch を削除します。この操作は未統合 commit を失うため、人が明示的に判断した場合だけ行います。
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
git worktree remove --force <worktree>
|
|
98
|
+
git branch -D exec/<project-id>-<run-id>
|
|
99
|
+
```
|
|
100
|
+
|
|
52
101
|
### 1.1. 複数 action の順次実行
|
|
53
102
|
|
|
54
103
|
通常は `action` に1つの Job を指定します。複数の独立した委譲単位を同じ実行機会で順序保証したい場合は、`action` に1件以上の配列を指定します。各要素は `kind: job` と参照する Job、入力を持ちます。
|
|
@@ -111,21 +160,37 @@ Job Definition を持たないため、実行記録は `generated/routine-runs.j
|
|
|
111
160
|
|
|
112
161
|
### 1.2. grade の単段評価
|
|
113
162
|
|
|
114
|
-
Kata
|
|
163
|
+
Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の英語 marker から機械的に生成します。正本の grade result を保存した後、英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は本体リポジトリにだけある `tools/grade/run-per-document.sh --stages 1` を起動し、条件付きの後続段は持ちません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
|
|
164
|
+
|
|
165
|
+
成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
|
|
115
166
|
|
|
116
|
-
|
|
167
|
+
`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 実行との競合を避けます。
|
|
168
|
+
|
|
169
|
+
`changed_only: true` は、本文の変更に加えて、観点定義の `comparison_sources` で宣言した突き合わせ先(成果物カタログの自身の項目、依存先、Schedule、メンバー定義、ロール定義、RACI、組織定義)の変更も検出します。検出範囲と検出しない変更は `command-reference.md` の `grade` の説明に従います。突き合わせ先の記録(`source_hashes`)を持たない既存の評価は一度だけ変更扱いになるため、導入直後は `rtn-grade-deliverable-recheck` の選択が上限の10件に張り付きます。2026-09-27 時点の成果物 46 件がすべて該当し、約5日で記録が揃います。その後は突き合わせ先を変更した日だけ、その突き合わせ先を持つ成果物が選ばれます。現在の宣言では Kata に適用される観点は突き合わせ先を持たないため、`rtn-grade-recheck` の選択は変わりません。
|
|
170
|
+
|
|
171
|
+
全件再評価の定期経路は持ちません。`rtn-grade-kata` は `enabled: false` のままとし、突き合わせ先の変更による評価の陳腐化は上記の `changed_only` で解消します。観点定義の変更など `changed_only` と `rubric_outdated` のどちらも検出しない変更を反映する場合は、SpecDojo 本体リポジトリでのみ `tools/grade/run-per-document.sh` を選択条件なしで手動実行します。npm package の利用者はこのスクリプトを使えません。全件は成果物 46 件、Kata 262 件で、Job の件数上限を外すと1回で308文書を評価します。
|
|
172
|
+
|
|
173
|
+
`rubric_outdated: true` は、grade result サイドカーの `rubric` が現在の `grade_rubric.id` と異なる文書、または `rubric` の記録がない文書を選びます(`grade list --rubric-outdated`)。ルーブリックを改めたとき(PJR-K351 の `grade-rubric-v2` など)、旧版の結果は score を新版と比べられないため評価し直します。全件を一度に評価し直すと agent の利用上限に達するため、両 routine の既存の件数上限(Kata 15 件、成果物 10 件)の範囲で、夜間の余った利用枠を使って少しずつ進めます。辞書順で上限までを選ぶため、変更済みや未評価の文書と同じ枠を分け合います。評価者は各 Job 定義の既定(`codex-expert-executor`)のままとし、手動で評価し直した結果の評価者はそのまま残します。評価し直した文書は `rubric` が現在の版になり、次回以降は選ばれません。
|
|
174
|
+
|
|
175
|
+
旧 rubric の結果が残る件数は、次のコマンドの出力行数で数えます。0件になれば、評価し直しは完了です。2026-09-28 の導入時点では、Kata 232 件(rulebook 99、recipe 11、sample 87、template 35)と成果物 19 件が残っていました。1日あたり Kata 15 件、成果物 10 件を上限に進めると、Kata は約16日、成果物は約2日で揃います(ほかの選択条件と枠を分け合う日は延びます)。
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
npx tsx src/specdojo.ts grade list --target kata --project prj-0001 --rubric-outdated | wc -l
|
|
179
|
+
npx tsx src/specdojo.ts grade list --target deliverable --project prj-0001 --rubric-outdated | wc -l
|
|
180
|
+
```
|
|
117
181
|
|
|
118
|
-
`
|
|
182
|
+
両 routine では、Job の `task.precondition` が `grade list` を使って script の selection-v5 と同じ変更済み・未評価・再試行可能な段未完了・旧 rubric の和集合、辞書順、対象種別、件数上限を先に評価します。連続失敗上限に達した文書は `grade state --exhausted` で同じ和集合に加えてから件数上限を適用し、処理対象からは外して report-only 対象にします。処理対象も report-only 対象も0件なら Job Run、plan、result、evidence を作らず、command と analysis reporter も起動しません。routine はこの結果を `skipped` として受け取り、`routine-state.json` の `last_run` / `last_result` と、cron の場合は `last_scheduled_for` を更新します。
|
|
119
183
|
|
|
120
|
-
|
|
184
|
+
| 段 | agent | 対象と役割 |
|
|
185
|
+
| ------ | ----------------------------------- | ------------------------------------------------------------ |
|
|
186
|
+
| 判定 | `codex-expert-executor` / `machine` | 対象文書を英語で評価し、正本の判定を確定する |
|
|
187
|
+
| 表示化 | `gemma26-translator` | finding の英語原文だけを日本語へ翻訳し、表示文として付加する |
|
|
121
188
|
|
|
122
|
-
|
|
123
|
-
| --- | ------------------------------------------ | ------------------------------------------ |
|
|
124
|
-
| 1 | `codex-expert-executor` / `gemma-reporter` | 対象文書をリファレンスなしで評価し確定する |
|
|
189
|
+
Job runnerは、この入口をmaterialize済みの引数で1回起動し、コマンド、終了コード、stdout/stderrをevidenceへ記録します。コマンドが成功した場合だけanalysis reporterが、未完了の段、失敗の切り分け、verdict と score の偏りを判断します。executor、reporter(既定は機械変換の `machine`)、対象種別、件数上限はscriptの引数またはJobの`inputs`から解決します。
|
|
125
190
|
|
|
126
|
-
Job
|
|
191
|
+
scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。保存済み state の `stage_total` が現在の構成と異なる場合は、古い grade の日時にかかわらず完了扱いへ移行せず、state を削除して1段目から再評価します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
|
|
127
192
|
|
|
128
|
-
|
|
193
|
+
Job Definition は script を `if` の条件として起動し、非0の終了コードを保存してそのまま Job runner へ返します。これにより、後続の `results.tsv` 表示が rate limit や中断の終了コードを0へ上書きしません。script が正常終了した場合だけ `grade pipeline complete:` と `results.tsv` が command evidence に揃い、analysis reporter が起動します。
|
|
129
194
|
|
|
130
195
|
## 2. due判定と実行
|
|
131
196
|
|
|
@@ -71,6 +71,8 @@ flowchart TD
|
|
|
71
71
|
|
|
72
72
|
実践の型をどこまで作成・更新の基準にするかを切り替える進め方です。
|
|
73
73
|
|
|
74
|
+
この三つの流は、型との関係を表す守破離に対応します。「守」は型をそのまま守り、「破」は型を基準にしながら工夫し、「離」は型から離れて完了条件と根拠から組み立てます。守破離は品質の序列ではなく、タスクの目的と実践の型の整備状況に応じて進め方を選ぶための名前です。
|
|
75
|
+
|
|
74
76
|
```mermaid
|
|
75
77
|
flowchart LR
|
|
76
78
|
RB["rulebook<br/>構造・必須事項・禁止事項"]
|
|
@@ -87,11 +89,11 @@ flowchart LR
|
|
|
87
89
|
CTX -->|freeform| D
|
|
88
90
|
```
|
|
89
91
|
|
|
90
|
-
| `approach` | 参照方針と進め方 | 対応テンプレート |
|
|
91
|
-
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
92
|
-
| `fully-guided` | 必要と宣言された rulebook / recipe / sample / template をそれぞれの役割に沿って使う。利用する template があればそこから開始し、rulebook と矛盾する場合は rulebook を正とする | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
93
|
-
| `recipe-guided` | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
94
|
-
| `freeform` | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
92
|
+
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
93
|
+
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
94
|
+
| `fully-guided` | 守 | 必要と宣言された rulebook / recipe / sample / template をそれぞれの役割に沿って使う。利用する template があればそこから開始し、rulebook と矛盾する場合は rulebook を正とする | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
95
|
+
| `recipe-guided` | 破 | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
96
|
+
| `freeform` | 離 | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
95
97
|
|
|
96
98
|
#### 1.2.2. 初期整備・実装反映・横断整理
|
|
97
99
|
|
|
@@ -113,11 +115,11 @@ flowchart LR
|
|
|
113
115
|
S --> DD --> C
|
|
114
116
|
```
|
|
115
117
|
|
|
116
|
-
| `approach` | 参照方針と進め方 | 対応テンプレート |
|
|
117
|
-
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
118
|
-
| `bootstrap` | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
|
|
119
|
-
| `retrofit` | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
|
|
120
|
-
| `cross-deliverable-dedup` | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
|
|
118
|
+
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
119
|
+
| ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
120
|
+
| `bootstrap` | 型起こし | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
|
|
121
|
+
| `retrofit` | 見取り | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
|
|
122
|
+
| `cross-deliverable-dedup` | 型寄せ | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
|
|
121
123
|
|
|
122
124
|
`retrofit` では、実装を現在動作(AS-IS)の根拠、既存成果物・決定記録・プロジェクトコンテキストを意図された仕様の根拠、`done_criteria` を成果物が満たすべき目的として扱います。三者が一致すれば成果物へ反映し、実装が意図された仕様と異なる場合は実装へ無条件に合わせず、乖離と修正対象候補を result に記録します。実装から確認できない目的・業務判断・将来方針は推測しません。
|
|
123
125
|
|
|
@@ -139,12 +141,12 @@ flowchart LR
|
|
|
139
141
|
E -->|template-maintenance| TP
|
|
140
142
|
```
|
|
141
143
|
|
|
142
|
-
| `approach` | 見直す対象 | 対応テンプレート |
|
|
143
|
-
| ---------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
144
|
-
| `rulebook-maintenance` | rulebook | [edit](../exec-templates/xep-rulebook-maintenance-template.md) / [review](../exec-templates/xrp-rulebook-maintenance-template.md) |
|
|
145
|
-
| `recipe-maintenance` | recipe | [edit](../exec-templates/xep-recipe-maintenance-template.md) / [review](../exec-templates/xrp-recipe-maintenance-template.md) |
|
|
146
|
-
| `sample-maintenance` | sample | [edit](../exec-templates/xep-sample-maintenance-template.md) / [review](../exec-templates/xrp-sample-maintenance-template.md) |
|
|
147
|
-
| `template-maintenance` | template | [edit](../exec-templates/xep-template-maintenance-template.md) / [review](../exec-templates/xrp-template-maintenance-template.md) |
|
|
144
|
+
| `approach` | 流の名前 | 見直す対象 | 対応テンプレート |
|
|
145
|
+
| ---------------------- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
146
|
+
| `rulebook-maintenance` | 手入れ | rulebook | [edit](../exec-templates/xep-rulebook-maintenance-template.md) / [review](../exec-templates/xrp-rulebook-maintenance-template.md) |
|
|
147
|
+
| `recipe-maintenance` | 手入れ | recipe | [edit](../exec-templates/xep-recipe-maintenance-template.md) / [review](../exec-templates/xrp-recipe-maintenance-template.md) |
|
|
148
|
+
| `sample-maintenance` | 手入れ | sample | [edit](../exec-templates/xep-sample-maintenance-template.md) / [review](../exec-templates/xrp-sample-maintenance-template.md) |
|
|
149
|
+
| `template-maintenance` | 手入れ | template | [edit](../exec-templates/xep-template-maintenance-template.md) / [review](../exec-templates/xrp-template-maintenance-template.md) |
|
|
148
150
|
|
|
149
151
|
rulebook frontmatter で `not-needed` と宣言された型はメンテナンス対象ではなく、strategy へ対応する `*-maintenance` フェーズを生成しません。作成が必要になった場合は、先に要否判断の根拠と rulebook frontmatter の宣言を更新します。
|
|
150
152
|
|
|
@@ -169,10 +171,10 @@ flowchart LR
|
|
|
169
171
|
K --> BF --> AR
|
|
170
172
|
```
|
|
171
173
|
|
|
172
|
-
| `approach` | 確定対象と進め方 | 対応テンプレート |
|
|
173
|
-
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
|
|
174
|
-
| `finalize` | human が `done_criteria` を確認し、必要なら最小限の修正を加え、成果物のみを `ready` へ昇格する | [result](../exec-templates/xer-human-finalize-template.md) |
|
|
175
|
-
| `bootstrap-finalize` | `bootstrap` と対になり、human が成果物と rulebook / recipe / sample / template をまとめて確認し、それぞれを `ready` へ昇格する | [result](../exec-templates/xer-human-bootstrap-finalize-template.md) |
|
|
174
|
+
| `approach` | 流の名前 | 確定対象と進め方 | 対応テンプレート |
|
|
175
|
+
| -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
|
|
176
|
+
| `finalize` | 免許 | human が `done_criteria` を確認し、必要なら最小限の修正を加え、成果物のみを `ready` へ昇格する | [result](../exec-templates/xer-human-finalize-template.md) |
|
|
177
|
+
| `bootstrap-finalize` | 皆伝 | `bootstrap` と対になり、human が成果物と rulebook / recipe / sample / template をまとめて確認し、それぞれを `ready` へ昇格する | [result](../exec-templates/xer-human-bootstrap-finalize-template.md) |
|
|
176
178
|
|
|
177
179
|
`approach` を指定しない場合は、存在するすべての実践の型をそれぞれの役割に沿って活用します。schedule で `approach` をどこで設定し `exec refresh` でどう解決するかは [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
|
|
178
180
|
|
|
@@ -185,9 +187,9 @@ flowchart LR
|
|
|
185
187
|
- 矛盾時の優先: `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
186
188
|
- 参照範囲: `fully-guided` / `recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
187
189
|
- 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
|
|
188
|
-
- 根拠のない具体化の禁止: `freeform` を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。裏付けの無い箇所は _TODO_ / _ASSUMPTION_
|
|
190
|
+
- 根拠のない具体化の禁止: `freeform` を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
|
|
189
191
|
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
190
|
-
- 判定基準の優先: `done_criteria`
|
|
192
|
+
- 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
191
193
|
|
|
192
194
|
## 2. 実践の型メンテナンスの進め方
|
|
193
195
|
|
|
@@ -208,21 +210,21 @@ flowchart LR
|
|
|
208
210
|
|
|
209
211
|
## 3. review への適用
|
|
210
212
|
|
|
211
|
-
review でも「整備状況に応じた進め方(approach
|
|
213
|
+
review でも「整備状況に応じた進め方(approach)」を使います。ただし、review は grade が行った成果物の品質評価を繰り返しません。approach は、変更内容・plan・実行記録・完了条件を照合するときに参照する文書の範囲として、次のように読み替えます。
|
|
212
214
|
|
|
213
|
-
通常の成果物編集では観点別の自己レビューを行わず、`done_criteria`
|
|
215
|
+
通常の成果物編集では観点別の自己レビューを行わず、`done_criteria` を「完了の狙い」として扱います。多観点での品質評価と証跡は grade が担い、独立した review は grade 結果を事実としてタスクの完了可否を判断します。以下の `approach` ごとの参照方針は、編集時の記述と review の照合範囲に適用します。
|
|
214
216
|
|
|
215
|
-
- `fully-guided`: rulebook
|
|
216
|
-
- `recipe-guided`: recipe
|
|
217
|
-
- `freeform`: カタログの `done_criteria`、対応 schema
|
|
218
|
-
- `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`:
|
|
219
|
-
- `approach`
|
|
217
|
+
- `fully-guided`: rulebook / recipe / sample / template と、そこから edit plan に展開された作業範囲を照合します。品質上の適合性は grade 結果を使い、review が新しい level や finding を付けません。
|
|
218
|
+
- `recipe-guided`: recipe と edit plan に限定して作業範囲を照合し、rulebook / sample / template を新たな判定基準として持ち込みません。
|
|
219
|
+
- `freeform`: カタログの `done_criteria`、対応 schema、edit plan が示した既存の類似成果物やプロジェクト文脈を、完了条件の照合資料として使います。
|
|
220
|
+
- `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`: 「実践の型メンテナンスの進め方」に従い、対象の実践の型と edit plan の完了条件を照合します。実践の型そのものの品質評価は、review 前段の kata grade を使います。
|
|
221
|
+
- `approach` に関わらず、判断根拠は対象成果物・実践の型・plan・実行記録を実際に読んで得た具体的な観察に限ります。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて根拠として扱いません。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先して未充足事項・改善指示に記録します。
|
|
220
222
|
- 判断の根拠をレビュー結果に残します。
|
|
221
223
|
|
|
222
224
|
## 4. 関連ドキュメント
|
|
223
225
|
|
|
224
226
|
- [実践の型活用ガイド](kata-guide.md): rulebook / recipe / sample / template それぞれの役割と使い分け
|
|
225
|
-
- [
|
|
227
|
+
- [型の構成ガイド](practice-system-composition-guide.md): 実践の型を含む型(Kata)の種別と役割
|
|
226
228
|
- [Schedule設計ガイド](schedule-design-guide.md): `approach` をタスクに設定し schedule で実行する方法
|
|
227
229
|
- [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md): `exec plan` / `exec run` による plan・result の生成・命名・再実行
|
|
228
230
|
- [exec運用ガイド](exec-operation-guide.md): exec plan を使った実行フロー
|
|
@@ -37,7 +37,7 @@ Schedule は「いつ、どの順序で、誰が実行するか」を定義す
|
|
|
37
37
|
| ---------------- | ------------------------------ |
|
|
38
38
|
| WHAT / DONE | 成果物カタログ(`dct-*.yaml`) |
|
|
39
39
|
| WHEN / ORDER | Schedule(`sch-*.yaml`) |
|
|
40
|
-
| エージェント定義 |
|
|
40
|
+
| エージェント定義 | `.specdojo/agent-members.yaml` |
|
|
41
41
|
| 実行共通設定 | `.specdojo/exec-defaults.yaml` |
|
|
42
42
|
|
|
43
43
|
#### 1.1.1. 成果物カタログとの責務分担
|
|
@@ -319,7 +319,7 @@ phase_sets:
|
|
|
319
319
|
- `agent_pipeline` は phase 単位の任意設定です。省略した phase は従来の単一 agent フローのまま動作します。
|
|
320
320
|
- pipeline を指定した phase は agent 実行専用です。`execution: human` と併用できません。
|
|
321
321
|
- `mode` と `approach` は phase 全体へ適用し、各 stage の agent 選択要件は stage 内の `capabilities` と `proficiency` で定義します。
|
|
322
|
-
- 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に
|
|
322
|
+
- 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に `.specdojo/agent-members.yaml` の nickname を指定します。
|
|
323
323
|
- `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。`owner_rules[].phase_overrides[].agent` では成果物単位に指名を上書きできます。
|
|
324
324
|
- by-name の agent が rate limit になった場合は別 agent へ自動フォールバックせず、タスクを待機状態にします。再開時も同じ agent を使い、緊急の差し替えだけを CLI の stage override で行います。
|
|
325
325
|
- 登録簿の項目(`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` を参照します。
|
|
@@ -419,11 +419,11 @@ Slack が `0` の Task はクリティカルパスに乗ります。これらの
|
|
|
419
419
|
|
|
420
420
|
### 4.4. Anti-patterns
|
|
421
421
|
|
|
422
|
-
| Anti-pattern | 問題
|
|
423
|
-
| ---------------------------------- |
|
|
424
|
-
| 巨大 Task(1日以上) | 一度のエージェント実行で完了しにくい
|
|
425
|
-
| 過剰依存チェーン | Ready タスクが少なくなり並列性が落ちる
|
|
426
|
-
| `duration_days: 0` の Task | ゼロ期間は Milestone を使う
|
|
427
|
-
| `depends_on` の省略 | 前提なしでも `[]` と明示する
|
|
428
|
-
| 成果物パスを Schedule に直接書く | パスは成果物カタログが管理する
|
|
429
|
-
| `sch-strategy` に agent 個体を書く | strategy は作業要件を持ち、agent 個体は
|
|
422
|
+
| Anti-pattern | 問題 |
|
|
423
|
+
| ---------------------------------- | --------------------------------------------------------------------------------- |
|
|
424
|
+
| 巨大 Task(1日以上) | 一度のエージェント実行で完了しにくい |
|
|
425
|
+
| 過剰依存チェーン | Ready タスクが少なくなり並列性が落ちる |
|
|
426
|
+
| `duration_days: 0` の Task | ゼロ期間は Milestone を使う |
|
|
427
|
+
| `depends_on` の省略 | 前提なしでも `[]` と明示する |
|
|
428
|
+
| 成果物パスを Schedule に直接書く | パスは成果物カタログが管理する |
|
|
429
|
+
| `sch-strategy` に agent 個体を書く | strategy は作業要件を持ち、agent 個体は `.specdojo/agent-members.yaml` に集約する |
|
|
@@ -14,7 +14,7 @@ specdojo:
|
|
|
14
14
|
|
|
15
15
|
Overview Guide
|
|
16
16
|
|
|
17
|
-
SpecDojo
|
|
17
|
+
SpecDojo の目的、成果物・型(Kata)・技(Waza)と流(Ryu)の関係、プロジェクトの進め方、技による実行管理を一つの流れとして説明します。
|
|
18
18
|
SpecDojo に関わるすべての読者の入口となる文書であり、個別の規約や操作の詳細は関連 guide、standard、rulebook に委ねます。
|
|
19
19
|
|
|
20
20
|
**対象読者**
|
|
@@ -23,7 +23,7 @@ SpecDojo に関わるすべての読者の入口となる文書であり、個
|
|
|
23
23
|
|
|
24
24
|
**この文書で分かること**
|
|
25
25
|
|
|
26
|
-
- SpecDojo
|
|
26
|
+
- SpecDojo の目的、基本となる考え方、成果物・型・技・流の関係、プロジェクトの進め方、成果物から実行管理への展開の関係
|
|
27
27
|
|
|
28
28
|
**次に読む文書**
|
|
29
29
|
|
|
@@ -32,18 +32,25 @@ SpecDojo に関わるすべての読者の入口となる文書であり、個
|
|
|
32
32
|
|
|
33
33
|
## 1. SpecDojoとは
|
|
34
34
|
|
|
35
|
-
SpecDojo
|
|
35
|
+
SpecDojo は、仕様道(Spec-Dō)の道場です。
|
|
36
36
|
|
|
37
37
|
プロダクトの構築・改修に必要な情報を、単発の説明資料ではなく、相互に参照できる構造化された成果物として管理します。
|
|
38
38
|
人が内容と判断理由を理解でき、AI とツールが成果物を作成・検証・更新できる状態を目指します。
|
|
39
|
+
仕様駆動開発のツールに対しては、その上流で仕様と設計の体系を担います。
|
|
40
|
+
|
|
41
|
+
**記して、形にして、磨き続ける。**
|
|
39
42
|
|
|
40
43
|
SpecDojo が提供するものは、大きく次の三つです。
|
|
41
44
|
|
|
42
|
-
| 要素 | 役割
|
|
43
|
-
| ---------- |
|
|
44
|
-
|
|
|
45
|
-
|
|
|
46
|
-
|
|
|
45
|
+
| 要素 | 問い | 役割 |
|
|
46
|
+
| ---------- | ---------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
47
|
+
| 成果物 | 何を作るか | プロジェクトとプロダクトに必要な成果物を成果物カタログで整理する |
|
|
48
|
+
| 型(Kata) | どう作るか | rulebook / recipe / sample / template と、それを支える文書で、成果物を作るための方針、規約、手順、具体例、雛形を提供する |
|
|
49
|
+
| 技(Waza) | どう回すか | register / schedule / routine + Job と CLI で、記帳・実戦・評定・講評を回し、成果物の計画、実行、状態管理、機械検証を進める |
|
|
50
|
+
|
|
51
|
+
流(Ryu、`approach`)は、成果物・型・技をつなぐ属性です。タスクごとに「型をどこまで基準にして技を使うか」を表し、技の使い方の種類ではありません。値は型の整備状況と grade の結果から、strategy とコードが導き出します。詳細は [実践の進め方ガイド](ryu-guide.md) を参照してください。
|
|
52
|
+
|
|
53
|
+
技は、横軸を PDCA、縦軸を回し方(register / schedule / routine + Job)とするマトリクスで整理できます。詳細は `成果物から実行管理への展開` を参照してください。
|
|
47
54
|
|
|
48
55
|
SpecDojo は開発プロセスそのものを一律に固定するものではありません。
|
|
49
56
|
プロジェクトの目的や規模に応じて必要な成果物を選び、それらの根拠、依存関係、完了条件を明らかにするための枠組みです。
|
|
@@ -53,11 +60,13 @@ SpecDojo は開発プロセスそのものを一律に固定するものでは
|
|
|
53
60
|
SpecDojo では、文書をプロジェクトを定義・実行・検証するための成果物として扱います。
|
|
54
61
|
基本方針は次の3つです。「コードと同じ規律で管理し、型に沿って作成し、人と AI の双方が読める」ドキュメンテーションを目指します。
|
|
55
62
|
|
|
56
|
-
| 基本方針 | 概要
|
|
57
|
-
| ----------------------------- |
|
|
58
|
-
| Docs as Code | 正本を Git に置き、構造化・単一正本・生成・機械検証・ID とトレーサビリティで、コードと同じ規律で管理する
|
|
59
|
-
| Kata・Waza・Ryu(型・技・流) | 成果物の作り方を Kata(rulebook / recipe / sample / template)として整え、Waza(`specdojo` CLI
|
|
60
|
-
| Human & AI Readability | 人が判断理由を理解でき、AI とツールが解析・生成・検証できる構造にする
|
|
63
|
+
| 基本方針 | 概要 |
|
|
64
|
+
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
65
|
+
| Docs as Code | 正本を Git に置き、構造化・単一正本・生成・機械検証・ID とトレーサビリティで、コードと同じ規律で管理する |
|
|
66
|
+
| Kata・Waza・Ryu(型・技・流) | 成果物の作り方を Kata(rulebook / recipe / sample / template)として整え、Waza(`specdojo` CLI)で回し、Ryu(`approach`)でタスクごとに型をどこまで基準にするかを表す |
|
|
67
|
+
| Human & AI Readability | 人が判断理由を理解でき、AI とツールが解析・生成・検証できる構造にする |
|
|
68
|
+
|
|
69
|
+
Waza(技)のうち、`register` を「記帳」、`exec` を「実戦」、`grade` を「評定」、`review` を「講評」と呼びます。これらは表示と文書で使う名前であり、CLI のコマンド名は変わりません。Ryu(流)の名前と `approach` の対応は [実践の進め方ガイド](ryu-guide.md) を参照してください。
|
|
61
70
|
|
|
62
71
|
SpecDojo の文書は、説明・判断・方針を記述する Markdown と、人が管理する構造化データを記述する YAML、ツール連携・実行記録・生成物を記述する JSON を使い分けます。
|
|
63
72
|
文書やデータを識別・管理できるように、形式に応じたメタデータを埋め込みます。
|
|
@@ -95,7 +104,7 @@ flowchart TB
|
|
|
95
104
|
|
|
96
105
|
プロダクトドキュメントはプロダクトの現在像、プロジェクトドキュメントは個別の構築・改修における目的、変更、実行、判断を表します。
|
|
97
106
|
|
|
98
|
-
利用プロジェクトの既定は
|
|
107
|
+
利用プロジェクトの既定は **別リポジトリ構成**です。プロダクト文書は実装と同じプロダクトリポジトリ `app1/` に置きます。登録簿・計画・実行記録などのプロジェクト文書と SpecDojo の型(Kata)は、プロジェクトリポジトリ `app1-specdojo/` に置き、記帳 commit をプロダクトの履歴から分離します。1つのプロジェクトリポジトリには複数のプロジェクトを格納できます。成果物と実装が常に同じ変更として動く場合に限り、**同一リポジトリ構成**を選びます。
|
|
99
108
|
|
|
100
109
|
| 分類 | 表すもの | ライフサイクル |
|
|
101
110
|
| ------------------------ | -------------------------------------------- | -------------------------------------- |
|
|
@@ -106,10 +115,10 @@ flowchart TB
|
|
|
106
115
|
[ドキュメント構成ガイド](docs-structure-guide.md)
|
|
107
116
|
を参照してください。
|
|
108
117
|
|
|
109
|
-
## 4.
|
|
118
|
+
## 4. 型の役割
|
|
110
119
|
|
|
111
|
-
SpecDojo
|
|
112
|
-
|
|
120
|
+
SpecDojo では、成果物と、それを作るための型(Kata)を分けて管理します。
|
|
121
|
+
型は、成果物の作り方を支える次の8種類の文書として具体化されます。
|
|
113
122
|
|
|
114
123
|
| 種別 | 答える問い | 使い方 |
|
|
115
124
|
| ---------- | ---------------------------------------- | ---------------------------------------------- |
|
|
@@ -124,7 +133,7 @@ SpecDojo では、成果物と、それを作るための実践体系を分け
|
|
|
124
133
|
|
|
125
134
|
これらは同じ内容を再掲するものではなく、それぞれ異なる問いに答えます。
|
|
126
135
|
上表は概要です。各種別の役割、種別間の関係、成果物への紐付け方(rulebook フィールドや frontmatter による解決の仕組み)の正本は
|
|
127
|
-
[
|
|
136
|
+
[型の構成ガイド](practice-system-composition-guide.md)
|
|
128
137
|
です。
|
|
129
138
|
|
|
130
139
|
このうち exec plan が成果物の作成・レビュー時に参照するのは、rulebook / recipe / sample / template の4種です。この4種を **実践の型** と呼びます。philosophy / standard は全体に効く前提・共通規約として常に踏まえ、guide / reference は個別成果物に紐づかない横断文書として理解と参照に使います。実践の型を `approach` に応じてどこまで参照するかは
|
|
@@ -157,7 +166,8 @@ flowchart LR
|
|
|
157
166
|
3. 決定した成果物カタログの作成を `todo` として追跡し、成果物の配置、依存関係、完了条件を `dct-<domain>.yaml` に定義します。
|
|
158
167
|
4. カタログ作成の `todo` を完了し、以後の計画済み作業を Schedule に展開します。
|
|
159
168
|
5. 人またはエージェントが成果物を作成・更新します。
|
|
160
|
-
6.
|
|
169
|
+
6. 機械検証に加え、grade で成果物の品質を評価します。review は grade の結果を事実として受け取り、変更内容・実行記録・完了条件を照合してタスクの完了可否を判断します。
|
|
170
|
+
7. human が review result と成果物を確認し、最終承認と `ready` への確定を行います。
|
|
161
171
|
|
|
162
172
|
トラックの構成と実行順序は
|
|
163
173
|
[トラック設計ガイド](track-design-guide.md)、
|
|
@@ -169,7 +179,17 @@ flowchart LR
|
|
|
169
179
|
|
|
170
180
|
## 6. 成果物から実行管理への展開
|
|
171
181
|
|
|
172
|
-
|
|
182
|
+
`SpecDojoとは` で挙げた3つの要素のうち、成果物と型で「何を・どう作るか」を定めた後、それを計画・実行・追跡・機械検証して最後まで通すのが **技(Waza)** です。技は、横軸を PDCA、縦軸を回し方(register / schedule / routine + Job)とする次のマトリクスで整理できます。
|
|
183
|
+
|
|
184
|
+
| 回し方 | P(記す・計画する) | D(形にする) | C(評価する) | A(確定して次へ) |
|
|
185
|
+
| ------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------- |
|
|
186
|
+
| register | 起票し、完了条件を書く | `exec run --register` で executor が実行する | reporter が result を書いて review へ進め、人が確かめる | runner が commit・統合する。close するか、reopen・change-request で直す |
|
|
187
|
+
| schedule | 成果物カタログから Schedule へ展開する | `exec run --track` / `--auto` で実行する | grade(評定)と review | 統合して `ready` へ確定する。直して次の反復へ |
|
|
188
|
+
| routine + Job | Job に「何を・誰が確かめるか(`task.review`)」を、routine に「いつ」を書く | `routine run --due` が Job Run を作り、worktree で実行して runner が commit する | Job で指名した review agent が review し、verdict を出す | verdict に従って統合し、成功したときだけ checkpoint を進める |
|
|
189
|
+
|
|
190
|
+
A 列はいずれも、runner が確定して commit し、次の周回の起点にする点でそろっています。C 列は、誰が確かめるかの違いとして読めます。どの行でも、タスクの流(`approach`)が型をどこまで基準にするかを決めます。
|
|
191
|
+
|
|
192
|
+
SpecDojo CLI は、成果物カタログの成果物をトラック・実行フェーズ(またはパス)・タスクへ展開し、plan の生成、実行、result の記録という流れで作業状態と結果を記録します。成果物カタログ・Schedule・実行管理(dct/sch/exec)の詳細な関係と図解は [ドキュメント構成ガイド](docs-structure-guide.md) の `成果物カタログ・Schedule・実行管理の関係` を参照してください。
|
|
173
193
|
|
|
174
194
|
成果物カタログと Schedule の関係、タスク設計は
|
|
175
195
|
[Schedule設計ガイド](schedule-design-guide.md)、
|
|
@@ -189,12 +209,13 @@ CLI の導入は
|
|
|
189
209
|
|
|
190
210
|
主となる成果物作成フローのほかに、継続的なプロジェクト運営を支える機能があります。
|
|
191
211
|
|
|
192
|
-
| 機能 | 用途
|
|
193
|
-
| ------------------ |
|
|
194
|
-
|
|
|
195
|
-
|
|
|
196
|
-
|
|
|
197
|
-
|
|
|
212
|
+
| 機能 | 用途 | 参照先 |
|
|
213
|
+
| ------------------ | -------------------------------------------------------------------- | ------------------------------------------------ |
|
|
214
|
+
| grade / review | 成果物の品質評価と、タスクの完了可否の判断を分けて記録する | [レビュー](review-guide.md) |
|
|
215
|
+
| プロジェクト登録簿 | 立ち上げ時の課題・判断と、進行中の計画外事項を管理する | [登録簿運用](register-operation-guide.md) |
|
|
216
|
+
| routine | 変更済み・未評価・旧 rubric の文書など、時刻条件のある作業を実行する | [routine運用](routine-operation-guide.md) |
|
|
217
|
+
| branch / worktree | プロジェクトやタスクの変更を分離して安全に統合する | [ブランチワークフロー](branch-workflow-guide.md) |
|
|
218
|
+
| exec設定 | エージェント、実行要件、権限、共通ポリシーを設定する | [exec設定](exec-config-guide.md) |
|
|
198
219
|
|
|
199
220
|
これらはすべてのプロジェクトで一度に導入する必要はありません。register は未整理事項がある立ち上げ時にも使用し、合意済みの計画作業へ移った後は、必要になった管理機能を段階的に利用します。
|
|
200
221
|
|
|
@@ -206,13 +227,13 @@ CLI の導入は
|
|
|
206
227
|
|
|
207
228
|
本節の philosophy 2件は、作業を始める前に通読する必要はありません。文書体系を設計・保守するときや、記述の粒度・責務の判断に迷ったときに読めば足ります。
|
|
208
229
|
|
|
209
|
-
| 目的
|
|
210
|
-
|
|
|
211
|
-
| SpecDojoの基本方針と設計理由を知る
|
|
212
|
-
| 要求・要件・仕様・設計・実装の違いを知る
|
|
213
|
-
| 文書の分類、ライフサイクル、配置を理解する
|
|
214
|
-
| ファイル単位のディレクトリ配置を引く
|
|
215
|
-
|
|
|
230
|
+
| 目的 | 参照先 |
|
|
231
|
+
| ------------------------------------------ | --------------------------------------------------------------------------------- |
|
|
232
|
+
| SpecDojoの基本方針と設計理由を知る | [SpecDojo の考え方](../philosophy/specdojo-philosophy.md) |
|
|
233
|
+
| 要求・要件・仕様・設計・実装の違いを知る | [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) |
|
|
234
|
+
| 文書の分類、ライフサイクル、配置を理解する | [ドキュメント構成ガイド](docs-structure-guide.md) |
|
|
235
|
+
| ファイル単位のディレクトリ配置を引く | [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) |
|
|
236
|
+
| 型の種別・役割・成果物との関係を理解する | [型の構成ガイド](practice-system-composition-guide.md) |
|
|
216
237
|
|
|
217
238
|
### 8.2. 作成する成果物を決める
|
|
218
239
|
|
|
@@ -238,6 +259,7 @@ CLI の導入は
|
|
|
238
259
|
| コマンドとオプションを調べる | [CLIコマンドリファレンス](../references/command-reference.md) |
|
|
239
260
|
| 実行経路(schedule / register / routine)を使い分け、中断・再実行を扱う | [exec運用ガイド](exec-operation-guide.md) |
|
|
240
261
|
| scheduleタスクを自動・手動で実行する | [Schedule実行運用ガイド](schedule-operation-guide.md) |
|
|
262
|
+
| grade と review の役割、判定語彙、評価結果の読み方を理解する | [レビューガイド](review-guide.md) |
|
|
241
263
|
| 定期実行する | [routine運用ガイド](routine-operation-guide.md) |
|
|
242
264
|
| 課題、リスク、変更要求、意思決定を管理する | [登録簿運用ガイド](register-operation-guide.md) |
|
|
243
265
|
| エージェント、権限、exec の共通設定を変更する | [exec設定ガイド](exec-config-guide.md) |
|
|
@@ -245,6 +267,9 @@ CLI の導入は
|
|
|
245
267
|
| projectとtaskのブランチを運用する | [ブランチワークフローガイド](branch-workflow-guide.md) |
|
|
246
268
|
| worktreeを使って手動で隔離実行する | [exec worktree運用ガイド](exec-worktree-guide.md) |
|
|
247
269
|
| 対話でCLI操作を進める | [オーケストレーター運用ガイド](orchestrator-operation-guide.md) |
|
|
270
|
+
| 任意の Dev Container や常時稼働ホストで実行環境を分離する | [常時稼働ホスト運用ガイド](remote-host-development-guide.md) |
|
|
271
|
+
|
|
272
|
+
登録簿を agent 実行と並行して記帳する場合は、記帳コマンドの `--commit` が同じ project の `register lifecycle` 枠を使います。provider 設定を配布するときは `config scaffold` を使い、Antigravity の `--global` はすべてのリポジトリに効くため dry-run 後に適用します。Dev Container は必須ではなく、必要な場合だけ `devcontainer scaffold` で追加します。各操作の詳細は上表のガイドと [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
|
|
248
273
|
|
|
249
274
|
### 8.5. 成果物を確定・編集する
|
|
250
275
|
|
|
@@ -89,7 +89,7 @@ flowchart TD
|
|
|
89
89
|
### 3.1. agentに成果物を量産させる
|
|
90
90
|
|
|
91
91
|
- ゴール: 計画済みタスクを agent に実行させ、レビューへ回す。
|
|
92
|
-
- 進め方:
|
|
92
|
+
- 進め方: `.specdojo/agent-members.yaml` の agent と `.specdojo/exec-defaults.yaml` を用意し、`execution: agent` のフェーズで schedule を組む。`exec run --auto` で Ready 順に実行する。参照の深さは `approach` で切り替える。
|
|
93
93
|
- 主に使う文書: [exec設定ガイド](exec-config-guide.md)、[Schedule実行運用ガイド](schedule-operation-guide.md)、[実践の進め方ガイド](ryu-guide.md)。
|
|
94
94
|
|
|
95
95
|
### 3.2. worktreeで隔離実行する
|
|
@@ -108,8 +108,8 @@ flowchart TD
|
|
|
108
108
|
|
|
109
109
|
### 4.1. レビューを回して成果物をreadyにする
|
|
110
110
|
|
|
111
|
-
- ゴール:
|
|
112
|
-
- 進め方:
|
|
111
|
+
- ゴール: grade の品質評価とタスクの完了判断を分け、確認済みの成果物を `ready` へ確定する。
|
|
112
|
+
- 進め方: grade が観点ごとの品質を評価し、`mode: review` のタスクはその結果を事実として変更内容・実行記録・完了条件を照合する。`ready` への昇格は human が finalize タスクで行う。
|
|
113
113
|
- 主に使う文書: [レビューガイド](review-guide.md)、[exec運用ガイド](exec-operation-guide.md) の `humanタスクの実行`。
|
|
114
114
|
|
|
115
115
|
### 4.2. 計画外の単発対応・調査を管理する
|
|
@@ -41,7 +41,20 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
41
41
|
| 定期実行定義 | `rtn-*.yaml` | `routine` |
|
|
42
42
|
| ドキュメントIDインデックス | `.specdojo/doc-index.json` | `index` |
|
|
43
43
|
|
|
44
|
-
### 1.1.
|
|
44
|
+
### 1.1. 技の名前
|
|
45
|
+
|
|
46
|
+
主要な CLI 機能には、仕様道(Spec-Dō)の道場で使う技の名前を付けています。
|
|
47
|
+
|
|
48
|
+
| 技の名前 | CLI の機能 | 役割 |
|
|
49
|
+
| -------- | ---------- | ---------------------------------------------------------------------------------- |
|
|
50
|
+
| 記帳 | `register` | 起票から状態の遷移・決定・完了までを記録し続ける。最初の `register add` は「起票」 |
|
|
51
|
+
| 実戦 | `exec` | 型に沿って実際の成果物を作る |
|
|
52
|
+
| 評定 | `grade` | 型に照らして品質を 0〜4 で評価する |
|
|
53
|
+
| 講評 | `review` | 評定を入力に、タスクの完了を判断する |
|
|
54
|
+
|
|
55
|
+
技の名前は表示と文書で使う呼び方です。CLI のコマンド名、オプション、設定のキーは変更しません。
|
|
56
|
+
|
|
57
|
+
### 1.2. 生成系動詞の標準
|
|
45
58
|
|
|
46
59
|
生成や実行を伴うコマンドは、出力の性質と副作用に応じて次の動詞を使います。
|
|
47
60
|
|
|
@@ -183,7 +196,7 @@ specdojo schedule build --project prj-0001 --track launch --force
|
|
|
183
196
|
# 5. 実行状態、Ready、CPMを生成する
|
|
184
197
|
specdojo exec refresh --project prj-0001
|
|
185
198
|
|
|
186
|
-
# 6.
|
|
199
|
+
# 6. `.specdojo/agent-members.yaml` と provider 設定を用意して Readyタスクを実行する
|
|
187
200
|
specdojo exec run --project prj-0001 --auto --parallel 5
|
|
188
201
|
```
|
|
189
202
|
|