specdojo 0.2.1 → 0.3.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.
Files changed (168) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +122 -1
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-handoff.js +336 -0
  15. package/dist/exec-parent-validation.js +317 -43
  16. package/dist/exec-pipeline-state.js +74 -9
  17. package/dist/exec-plans.js +115 -113
  18. package/dist/exec-protection-handoff.js +43 -2
  19. package/dist/exec-provider-scaffold.js +247 -15
  20. package/dist/exec-register-resume.js +65 -19
  21. package/dist/exec-register.js +9 -3
  22. package/dist/exec-repo-integration.js +811 -0
  23. package/dist/exec-repo-trace.js +182 -0
  24. package/dist/exec-reporter.js +613 -132
  25. package/dist/exec-results.js +81 -56
  26. package/dist/exec-run-lock.js +110 -107
  27. package/dist/exec-run.js +1585 -356
  28. package/dist/exec-shared.js +7 -0
  29. package/dist/exec-slot-lock.js +242 -0
  30. package/dist/exec-task-repos.js +415 -0
  31. package/dist/exec-trial.js +51 -25
  32. package/dist/exec-worktree-command.js +87 -43
  33. package/dist/exec-worktree-ops.js +502 -57
  34. package/dist/exec-worktree.js +114 -27
  35. package/dist/exec.js +13 -6
  36. package/dist/grade-result.js +128 -0
  37. package/dist/grade.js +809 -72
  38. package/dist/init-command.js +443 -0
  39. package/dist/job.js +160 -10
  40. package/dist/orchestrator.js +213 -0
  41. package/dist/register-event-merge.js +169 -0
  42. package/dist/register-item.js +7 -1
  43. package/dist/register.js +294 -86
  44. package/dist/review-grade.js +252 -0
  45. package/dist/review-plan.js +111 -1
  46. package/dist/review-types.js +40 -1
  47. package/dist/routine.js +72 -5
  48. package/dist/schedule-build.js +2 -2
  49. package/dist/schedule.js +17 -4
  50. package/dist/specdojo-config.js +465 -19
  51. package/dist/specdojo-gitignore.js +135 -0
  52. package/dist/specdojo.js +6 -0
  53. package/dist/viewpoint-document-kinds-check.js +128 -0
  54. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  55. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  56. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  57. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  58. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  59. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  60. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  62. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  63. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  65. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  67. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  68. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  69. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  70. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  71. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  72. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  73. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  74. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  75. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  76. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  77. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  78. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  79. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  80. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  81. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  82. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  83. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  84. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  85. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  86. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  87. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  88. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  89. package/docs/ja/specdojo/index.md +2 -2
  90. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  91. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  92. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  93. package/docs/ja/specdojo/references/command-reference.md +335 -92
  94. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  95. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  96. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  97. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  98. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  99. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  101. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  102. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  104. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  105. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  106. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  107. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  108. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  109. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  110. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  111. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  112. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  113. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  114. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  115. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  116. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  117. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  118. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  119. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  120. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  121. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  122. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  123. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  124. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  125. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  126. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  127. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  128. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  129. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  130. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  131. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  132. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  133. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  134. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  135. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  136. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  137. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  138. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  139. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  140. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  141. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  142. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  143. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  144. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  145. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  146. package/package.json +15 -9
  147. package/templates/antigravity/README.md +27 -2
  148. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  149. package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
  150. package/templates/antigravity/orchestrator.md +18 -7
  151. package/templates/antigravity/settings.global.json +55 -0
  152. package/templates/claude/agents/claude-executor.md +14 -0
  153. package/templates/claude/agents/claude-reporter.md +16 -0
  154. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  155. package/templates/claude/settings.edit.json +27 -1
  156. package/templates/codex/README.md +5 -4
  157. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  158. package/templates/codex/orchestrator.md +18 -7
  159. package/templates/copilot/README.md +7 -5
  160. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  161. package/templates/devcontainer/devcontainer.json +27 -0
  162. package/templates/devcontainer/emacs/init.el +88 -0
  163. package/templates/devcontainer/post-create.sh +62 -0
  164. package/templates/init-agent-members.yaml +200 -0
  165. package/templates/init-exec-defaults.yaml +72 -0
  166. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  167. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  168. 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 / reporter 実行、`grade apply --path --analysis-from` の逐次処理は `tools/grade/run-per-document.sh` が持ちます。定期 Job は `--stages 1` で codex 単段を選びます。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
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 と成果物の定期評価は、`codex-expert-executor` と `gemma-reporter` の単段で実行します。`job-grade-kata` と `job-grade-deliverable` は `tools/grade/run-per-document.sh --stages 1` を起動し、条件付きの後続段は持ちません。変更済み・未評価・段未完了を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`limit: 15` を入力します。
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` を入力します。
115
164
 
116
- 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
165
+ 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
117
166
 
118
167
  `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日6時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
119
168
 
120
- 両 routine では、Job の `task.precondition` が `grade list` を使って script の selection-v4 と同じ変更済み・未評価・再試行可能な段未完了の和集合、辞書順、対象種別、件数上限を先に評価します。連続失敗上限に達した文書は `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` を更新します。
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
+ ```
181
+
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` を更新します。
183
+
184
+ | 段 | agent | 対象と役割 |
185
+ | ------ | ----------------------------------- | ------------------------------------------------------------ |
186
+ | 判定 | `codex-expert-executor` / `machine` | 対象文書を英語で評価し、正本の判定を確定する |
187
+ | 表示化 | `gemma26-translator` | finding の英語原文だけを日本語へ翻訳し、表示文として付加する |
121
188
 
122
- | 段 | executor / reporter | 対象と役割 |
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 runnerは、この入口をmaterialize済みの引数で1回起動し、コマンド、終了コード、stdout/stderrをevidenceへ記録します。コマンドが成功した場合だけanalysis reporterが、未完了の段、失敗の切り分け、verdict と score の偏りを判断します。executor、reporter、対象種別、件数上限はscriptの引数またはJobの`inputs`から解決します。
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
- scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。3段構成から単段へ切り替えた時点で、現在本文に対して有効な `stage_total: 3` の state が残っている場合は、既存評価を完了済みとみなして state を削除します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
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_ として論点を残します。review では、対象成果物中の具体的記述が参照範囲の文書で裏付けられているかを確認し、裏付けが確認できない場合は unclear として findings に残します。
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` やレビュー観点(`RVP-NNN`)が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
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` を「完了の狙い」として扱います。多観点での判定と証跡は独立したレビューが担います。以下の `approach` ごとの参照方針は、編集時の記述とレビューの双方に適用します。
215
+ 通常の成果物編集では観点別の自己レビューを行わず、`done_criteria` を「完了の狙い」として扱います。多観点での品質評価と証跡は grade が担い、独立した review は grade 結果を事実としてタスクの完了可否を判断します。以下の `approach` ごとの参照方針は、編集時の記述と review の照合範囲に適用します。
214
216
 
215
- - `fully-guided`: rulebook の必須要素・禁止事項、recipe の問いとレビュー観点、sample の粒度・文体との整合を確認します。template がある場合は、章構成が雛形と整合しているか、プレースホルダが残っていないかを確認します。あわせて、成果物中の具体的な実装事実(ファイルパス・コマンド・設定値など)が参照範囲の文書で裏付けられているかを確認し、裏付けが無ければ unclear とします。
216
- - `recipe-guided`: recipe の問いとレビュー観点に照らして確認し、rulebook / sample / template の構造・文体は基準にしません。
217
- - `freeform`: カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に、目的達成・構造・粒度・既存慣行との整合を確認します。
218
- - `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`: 「実践の型メンテナンスの進め方」に従い、対象の実践の型が見直しに値するかという向きで確認観点を読み替えます。
219
- - `approach` に関わらず、evidence・notes は対象成果物・実践の型を実際に読んで得た具体的な観察に限ります。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱いません。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先し findings に記録します。
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
- - [実践体系構成ガイド](practice-system-composition-guide.md): 実践の型を含む実践体系の種別と役割
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
- | エージェント定義 | `pm-members.yaml` |
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` に `pm-members.yaml` の nickname を指定します。
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 個体は `pm-members.yaml` に集約する |
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` に集約する |
@@ -37,7 +37,7 @@ exec refresh
37
37
  -> ready.json に Ready タスクを出力
38
38
  exec run --auto [--loop]
39
39
  -> Ready タスクを選択
40
- -> phase 要件と pm-members.yaml から agent を解決
40
+ -> phase 要件と .specdojo/agent-members.yaml から agent を解決
41
41
  -> plan / result を生成
42
42
  -> claim
43
43
  -> task worktree を作成
@@ -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
- | 遂行体系 | register / schedule / routine と CLI で、成果物の計画、実行、状態管理、機械検証を進める |
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)で遂行し、Ryu(`approach`)で型をどこまで基準にするかを選ぶ |
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
- 利用プロジェクトの既定は Detached Unit です。プロダクト文書は実装と同じ `app1/`、プロジェクト文書と SpecDojo の実践体系・実行記録は `app1-specdojo/` に置き、記帳 commit をプロダクトの履歴から分離します。成果物と実装が常に同じ変更として動く場合に限り、同一リポジトリの Attached Unit を選びます。
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
- 実践体系は、成果物の作り方を支える次の8種類の文書として具体化されます。
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
- [実践体系構成ガイド](practice-system-composition-guide.md)
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
- 第1章で挙げた3つの体系のうち、成果物体系と実践体系で「何を・どう作るか」を定めた後、それを計画・実行・追跡・機械検証して最後まで通すのが **遂行体系** です。SpecDojo CLI は、成果物カタログの成果物をトラック・実行フェーズ(またはパス)・タスクへ展開し、plan の生成、実行、result の記録という流れで作業状態と結果を記録します。成果物カタログ・Schedule・実行管理(dct/sch/exec)の詳細な関係と図解は [ドキュメント構成ガイド](docs-structure-guide.md) の6章を参照してください。
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
- | プロジェクト登録簿 | 立ち上げ時の課題・判断と、進行中の計画外事項を管理する | [登録簿運用](register-operation-guide.md) |
195
- | routine | 時刻条件のある定期作業を実行する | [routine運用](routine-operation-guide.md) |
196
- | branch / worktree | プロジェクトやタスクの変更を分離して安全に統合する | [ブランチワークフロー](branch-workflow-guide.md) |
197
- | exec設定 | エージェント、実行要件、権限、共通ポリシーを設定する | [exec設定](exec-config-guide.md) |
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の基本方針と設計理由を知る | [SpecDojo の考え方](../philosophy/specdojo-philosophy.md) |
212
- | 要求・要件・仕様・設計・実装の違いを知る | [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) |
213
- | 文書の分類、ライフサイクル、配置を理解する | [ドキュメント構成ガイド](docs-structure-guide.md) |
214
- | ファイル単位のディレクトリ配置を引く | [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) |
215
- | 実践体系の種別・役割・成果物との関係を理解する | [実践体系構成ガイド](practice-system-composition-guide.md) |
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
- - 進め方: `pm-members.yaml` の agent と `.specdojo/exec-defaults.yaml` を用意し、`execution: agent` のフェーズで schedule を組む。`exec run --auto` で Ready 順に実行する。参照の深さは `approach` で切り替える。
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
- - ゴール: 観点別レビューで完全性・整合性・妥当性を確認し、成果物を `ready` へ確定する。
112
- - 進め方: `mode: review` のタスクで review plan / result を回し、指摘を扱う。`ready` への昇格は human が finalize タスクで行う。
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. pm-members.yaml と provider 設定を用意して Readyタスクを実行する
199
+ # 6. `.specdojo/agent-members.yaml` と provider 設定を用意して Readyタスクを実行する
187
200
  specdojo exec run --project prj-0001 --auto --parallel 5
188
201
  ```
189
202
 
@@ -1,6 +1,6 @@
1
- # SpecDojo 実践体系
1
+ # SpecDojo 型(Kata)
2
2
 
3
- SpecDojo が提供する実践体系の入口です。ここには成果物そのものではなく、成果物を作成・検証・更新するための文書を置きます。
3
+ SpecDojo が提供する型(Kata)の入口です。ここには成果物そのものではなく、成果物を作成・検証・更新するための文書を置きます。
4
4
 
5
5
  ## 1. 最初に読む文書
6
6