specdojo 0.9.0 → 0.9.2

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 (74) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -0
  2. package/CHANGELOG.md +36 -0
  3. package/README.md +4 -4
  4. package/dist/commands/agent.js +15 -24
  5. package/dist/commands/init.js +8 -5
  6. package/dist/commands/orchestrator.js +11 -88
  7. package/dist/dashboard/shared.js +2 -2
  8. package/dist/dashboard/timeline.js +2 -2
  9. package/dist/deliverable/trash.js +2 -1
  10. package/dist/devcontainer/command.js +1 -1
  11. package/dist/devcontainer/scaffold.js +6 -5
  12. package/dist/exec/agent-config.js +4 -0
  13. package/dist/exec/commands.js +54 -4
  14. package/dist/exec/executor-outcome-checks.js +104 -0
  15. package/dist/exec/migrate-records.js +3 -1
  16. package/dist/exec/opencode-permissions.js +117 -0
  17. package/dist/exec/parent-validation.js +66 -15
  18. package/dist/exec/pipeline-state.js +16 -0
  19. package/dist/exec/register-foreign-wait.js +1 -3
  20. package/dist/exec/register.js +4 -0
  21. package/dist/exec/repo-trace.js +2 -1
  22. package/dist/exec/run/agent-pipeline.js +44 -3
  23. package/dist/exec/run/agent.js +1 -1
  24. package/dist/exec/run/change-scope.js +2 -2
  25. package/dist/exec/run/in-place.js +1 -1
  26. package/dist/exec/run/register-command.js +9 -0
  27. package/dist/exec/run/register-core.js +2 -1
  28. package/dist/exec/run/register-resume.js +19 -2
  29. package/dist/exec/run/register-worktree.js +2 -1
  30. package/dist/exec/run/resume-notes.js +50 -0
  31. package/dist/exec/run/shared.js +5 -0
  32. package/dist/exec/shared.js +1 -1
  33. package/dist/exec/task-repos.js +25 -4
  34. package/dist/exec/validation-process-group.js +98 -0
  35. package/dist/exec/worktree-command.js +3 -1
  36. package/dist/grade/command-inspect.js +3 -1
  37. package/dist/grade/command-run.js +1 -0
  38. package/dist/grade/command-shared.js +10 -0
  39. package/dist/grade/run.js +58 -6
  40. package/dist/grade/targets.js +106 -0
  41. package/dist/register/create-commands.js +30 -3
  42. package/dist/register/events.js +1 -1
  43. package/dist/register/item.js +1 -0
  44. package/dist/register/maintenance-commands.js +3 -1
  45. package/dist/register/renumber.js +15 -4
  46. package/dist/register/section.js +114 -0
  47. package/dist/register/update.js +18 -0
  48. package/dist/shared/antigravity-block.js +24 -0
  49. package/dist/shared/plan-conventions.js +11 -0
  50. package/dist/shared/provider-scaffold.js +4 -0
  51. package/dist/shared/specdojo-config.js +5 -4
  52. package/dist/shared/text.js +8 -0
  53. package/dist/shared/where-alias.js +2 -2
  54. package/docs/ja/specdojo/guides/exec-config-guide.md +15 -12
  55. package/docs/ja/specdojo/guides/exec-operation-guide.md +21 -7
  56. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -4
  57. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  58. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  59. package/docs/ja/specdojo/guides/timeline-design-guide.md +1 -1
  60. package/docs/ja/specdojo/references/command-reference.md +76 -51
  61. package/docs/ja/specdojo/references/specdojo-config-reference.md +11 -9
  62. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +10 -42
  63. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +10 -50
  64. package/docs/ja/specdojo/samples/dec-sample.md +3 -30
  65. package/docs/ja/specdojo/samples/dss-sample.md +12 -12
  66. package/docs/ja/specdojo/samples/ntp-sample.md +3 -30
  67. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +18 -0
  68. package/docs/specdojo/schemas/v1/register-events.schema.yaml +1 -0
  69. package/package.json +1 -1
  70. package/templates/antigravity/orchestrator.md +7 -0
  71. package/templates/claude/agents/specdojo-orchestrator.md +7 -0
  72. package/templates/codex/agents/specdojo-orchestrator.toml +7 -0
  73. package/templates/codex/orchestrator.md +7 -0
  74. package/templates/opencode/agents/specdojo-orchestrator.md +7 -0
@@ -3,60 +3,20 @@ specdojo:
3
3
  id: specdojo:ntp-rulebook
4
4
  type: rulebook
5
5
  deliverable_type: test
6
- status: draft
6
+ status: deprecated
7
+ recipe: not-needed
7
8
  sample: specdojo:ntp-sample
9
+ template: not-needed
8
10
  ---
9
11
 
10
- # 移行テスト計画(リハーサル計画) 作成ルール
12
+ # 移行テスト計画(リハーサル計画) 作成ルール(非推奨)
11
13
 
12
- Migration Test Plan Documentation Rules
14
+ Deprecated Migration Test Plan Documentation Rules
13
15
 
14
- 本ドキュメントは、`移行テスト計画(リハーサル計画)` を一貫した粒度で作成するためのルールを定義する。
16
+ この rulebook は非推奨です。移行テスト計画(リハーサル計画)の作成ルールは後継の [[specdojo:mtp-rulebook|移行テスト計画 作成ルール]] へ統合しました。
15
17
 
16
- ## 1. 全体方針
18
+ ## 1. 移行方針
17
19
 
18
- - 目的: 移行リハーサルの実施計画を定義し、切替前に妥当性を検証する
19
- - 主な内容: テスト範囲、シナリオ、環境、判定基準、是正計画
20
- - 曖昧表現を避け、判定可能な記述にする。
21
-
22
- ## 2. 位置づけと用語定義(必要に応じて)
23
-
24
- - 上位方針・関連成果物との責務境界を明確化する。
25
- - 必要に応じて用語を定義し、命名ゆれを防ぐ。
26
-
27
- ## 3. ファイル命名・ID規則
28
-
29
- - 推奨ファイル名: `ntp`
30
- - ドキュメントID: `ntp-<term>` または用途に応じた識別子
31
-
32
- ## 4. 推奨 Frontmatter 項目
33
-
34
- | 項目 | 値 | 必須 |
35
- | -------- | -------------------------- | ---- |
36
- | id | 一意なID | ○ |
37
- | type | `test` 固定 | ○ |
38
- | status | draft / ready / deprecated | ○ |
39
- | rulebook | `ntp-rulebook` | 任意 |
40
-
41
- ## 5. 本文構成(標準テンプレ)
42
-
43
- | 章 | 必須 | 内容 |
44
- | ----------------- | ---- | ---------------------- |
45
- | 1. 目的と適用範囲 | ○ | 対象、目的、適用境界 |
46
- | 2. 入力情報 | ○ | 前提、参照元、制約 |
47
- | 3. 記述内容 | ○ | 主要項目、構成、記述順 |
48
- | 4. 検証観点 | ○ | 完了条件、確認観点 |
49
-
50
- | 5. 未解決事項 | 任意 | 課題、決定期限、担当 |
51
-
52
- ## 6. 記述ガイド
53
-
54
- - 事実と判断を分離し、根拠を併記する。
55
- - 表は列見出しを固定し、欠損値の扱いを明示する。
56
- - 章参照は章番号ではなく章タイトルで記述する。
57
-
58
- ## 7. 禁止事項
59
-
60
- - 実装依存の詳細を記載しない。
61
- - 判定不能な曖昧語を使わない。
62
- - 参照元不明の値を断定しない。
20
+ - 新しい `ntp-<term>` は作成せず、`mtp-index` または `mtp-<term>` にリハーサル計画・検証設計を記載します。
21
+ - 既存の移行テスト計画がある場合は、後継の `mtp` へ移行します。
22
+ - 参照元は ntp 参照を削除または更新し、統合先の `mtp` を参照します。
@@ -2,37 +2,10 @@
2
2
  specdojo:
3
3
  id: specdojo:dec-sample
4
4
  type: project
5
- status: draft
5
+ status: deprecated
6
6
  rulebook: specdojo:dec-rulebook
7
7
  ---
8
8
 
9
- # 決定記録 サンプル
9
+ # 決定記録 サンプル(非推奨)
10
10
 
11
- ## 1. 背景
12
-
13
- - 管理画面の認証方式として、セッション認証を継続するかトークン認証へ切り替えるかを判断する必要がある。
14
- - 既存運用では監査ログ要件が強く、失効制御と運用負荷の両立が課題になっている。
15
-
16
- ## 2. 検討した選択肢
17
-
18
- | 選択肢 | 概要 | 利点 | 懸念 |
19
- | ------ | --------------------------------------------- | ------------------------ | ------------------------ |
20
- | A | 既存セッション認証を継続 | 変更コストが低い | 外部連携時の拡張性が低い |
21
- | B | JWT ベースへ全面移行 | 拡張性が高い | 失効制御の運用が重い |
22
- | C | 管理画面はセッション、外部公開 API はトークン | 境界に応じた最適化が可能 | 方式が 2 系統になる |
23
-
24
- ## 3. 決定内容
25
-
26
- - 選択肢 C を採択する。
27
-
28
- ## 4. 採択理由
29
-
30
- - 品質: 管理画面の監査性を維持しつつ、外部連携の拡張性を確保できる。
31
- - コスト: 既存機能への影響を最小化し、段階的移行が可能である。
32
- - 運用性: 失効制御の運用範囲を API 側に限定できる。
33
-
34
- ## 5. 影響範囲
35
-
36
- - 仕様: 外部 IF 仕様書にトークン認証要件を追加する。
37
- - 実装: API ゲートウェイに認証ミドルウェアを追加する。
38
- - 運用: トークン失効手順と監査ログ確認手順を運用手順書へ追記する。
11
+ この sample は非推奨です。決定記録の完成例・管理はプロジェクト登録簿の decision([[specdojo:pjr-rulebook|プロジェクト登録簿作成ルール]])を参照してください。
@@ -143,24 +143,24 @@ primary・danger の文字リンクと枠は surface 上で用いる。ホバー
143
143
 
144
144
  ### 8.2. 検証の節目と基準版の採用
145
145
 
146
- | 順序・節目 | 完了条件・証跡 | 確認責任 |
147
- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
148
- | 1. 試作確認 | DEV が作った試作に UIS の全操作と DSS の型を対応付け、ARC が対象幅・拡大時の表示結果と入力文書・試作の版を記録する | ARC |
149
- | 2. 規則検証 | QE が前節のトークン・部品・状態・アクセシビリティの適合結果を `stc-store-gui` に記録し、不適合の修正と再確認を終える | QE |
150
- | 3. 利用者評価 | 店主代表・利用者代表が要件の条件で操作し、QE が測定結果、BA が受入条件との照合を `sac-usability` に記録する | QE・BA |
151
- | 4. 実装への採用 | PO が前の三段階の証跡、未解決事項・仮定、残余リスクを確認し、基準版の commit と採否・理由を `<project-id>:dec-<nnnn>-dss-baseline` に記録する。未達の必須条件があれば差し戻す | PO |
146
+ | 順序・節目 | 完了条件・証跡 | 確認責任 |
147
+ | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
148
+ | 1. 試作確認 | DEV が作った試作に UIS の全操作と DSS の型を対応付け、ARC が対象幅・拡大時の表示結果と入力文書・試作の版を記録する | ARC |
149
+ | 2. 規則検証 | QE が前節のトークン・部品・状態・アクセシビリティの適合結果を `stc-store-gui` に記録し、不適合の修正と再確認を終える | QE |
150
+ | 3. 利用者評価 | 店主代表・利用者代表が要件の条件で操作し、QE が測定結果、BA が受入条件との照合を `sac-usability` に記録する | QE・BA |
151
+ | 4. 実装への採用 | PO が前の三段階の証跡、未解決事項・仮定、残余リスクを確認し、基準版の commit と採否・理由を利用先のプロジェクト登録簿の decision(個票)に記録する。未達の必須条件があれば差し戻す | PO |
152
152
 
153
153
  実装への採用は上記の順で判断する。試作用の実装は採用の承認を意味しない。PM は各節目の結果と未完了項目を利用先の登録簿・進捗記録へ関連付ける。
154
154
 
155
155
  ### 8.3. 変更・不適合・例外
156
156
 
157
- | 区分 | 報告先・記録内容 | 責任と次の処理 |
158
- | ---------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
159
- | 検証不適合 | 利用先のプロジェクト登録簿の issue に規則 ID、再現条件、試験結果を記録 | QE が報告し、DEV が修正、QE が再確認する。PM が完了まで追跡する |
160
- | 規則変更 | 同登録簿の todo に対象トークン・規則、理由、影響する部品・画面・検証を記録 | ARC が評価する。操作の意味や回復操作が変わる場合は BA が UIS も更新する。基準版の再採用は PO が判断する |
161
- | 例外判断 | `<project-id>:dec-<nnnn>-dss-exception` に対象規則、理由、適用画面、影響、検証結果、期限を記録 | PO が採用前に承認または却下を判断し、PM が判断記録を維持する |
157
+ | 区分 | 報告先・記録内容 | 責任と次の処理 |
158
+ | ---------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
159
+ | 検証不適合 | 利用先のプロジェクト登録簿の issue に規則 ID、再現条件、試験結果を記録 | QE が報告し、DEV が修正、QE が再確認する。PM が完了まで追跡する |
160
+ | 規則変更 | 同登録簿の todo に対象トークン・規則、理由、影響する部品・画面・検証を記録 | ARC が評価する。操作の意味や回復操作が変わる場合は BA が UIS も更新する。基準版の再採用は PO が判断する |
161
+ | 例外判断 | 同登録簿の decision に対象規則、理由、適用画面、影響、検証結果、期限を記録 | PO が採用前に承認または却下を判断し、PM が判断記録を維持する |
162
162
 
163
- 現在の例外はなし。基準版・例外の記録先 ID は利用先で作る想定で、`<project-id>` は利用先のプロジェクト ID、`<nnnn>` は [[specdojo:dec-rulebook|決定記録作成ルール]] に従う 4 桁連番とする。PM は規則 ID から判断記録と元の登録項目へ相互参照を置き、承認・却下・失効の状態を追跡する。却下された案は適用せず、期限切れの例外は元の規則へ戻すか、期限前に再検証して PO の再判断を受ける。
163
+ 現在の例外はなし。基準版・例外の記録先は利用先のプロジェクト登録簿([[specdojo:pjr-rulebook|プロジェクト登録簿作成ルール]])の decision(個票)とする。PM は規則 ID から判断記録(個票)と元の登録項目へ相互参照を置き、承認・却下・失効の状態を追跡する。却下された案は適用せず、期限切れの例外は元の規則へ戻すか、期限前に再検証して PO の再判断を受ける。
164
164
 
165
165
  ### 8.4. 関連文書への導線
166
166
 
@@ -2,37 +2,10 @@
2
2
  specdojo:
3
3
  id: specdojo:ntp-sample
4
4
  type: test
5
- status: draft
5
+ status: deprecated
6
6
  rulebook: specdojo:ntp-rulebook
7
7
  ---
8
8
 
9
- # 移行テスト計画(リハーサル計画) サンプル
9
+ # 移行テスト計画(リハーサル計画) サンプル(非推奨)
10
10
 
11
- ## 1. 目的と適用範囲
12
-
13
- 本書は、移行リハーサルの実施計画を定義し、切替前に妥当性を検証するための最小サンプルである。
14
-
15
- ## 2. 入力情報
16
-
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/ntp-rulebook.md`
20
-
21
- ## 3. 記述内容
22
-
23
- - 主な内容: テスト範囲、シナリオ、環境、判定基準、是正計画
24
- - 必須観点: 対象、条件、判定基準、責任者
25
-
26
- ## 4. 最小記述例
27
-
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ---------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | 移行テスト計画(リハーサル計画) | 最小サンプル |
31
- | 目的 | 移行リハーサルの実施計画を定義し、切替前に妥当性を検証する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | テスト範囲、シナリオ、環境、判定基準、是正計画 | 要点のみ記載 |
33
-
34
- ## 5. 未解決事項
35
-
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
11
+ この sample は非推奨です。移行テスト計画(リハーサル計画)の完成例は [[specdojo:mtp-sample|移行テスト計画 サンプル]] を参照してください。
@@ -28,6 +28,24 @@ properties:
28
28
  additionalProperties:
29
29
  type: string
30
30
  minLength: 1
31
+ # Instructions added to the plan by `exec run --resume --resume-from executor --resume-note`.
32
+ # One entry per resume; later resumes carry the earlier entries over.
33
+ resume_notes:
34
+ type: array
35
+ items:
36
+ type: object
37
+ additionalProperties: false
38
+ required: [at, notes]
39
+ properties:
40
+ at:
41
+ type: string
42
+ format: date-time
43
+ notes:
44
+ type: array
45
+ minItems: 1
46
+ items:
47
+ type: string
48
+ minLength: 1
31
49
  stages:
32
50
  type: object
33
51
  additionalProperties: false
@@ -60,6 +60,7 @@ $defs:
60
60
  type: string
61
61
  enum:
62
62
  - id
63
+ - section
63
64
  - status
64
65
  - title
65
66
  - description
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.9.0",
3
+ "version": "0.9.2",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -147,6 +147,8 @@ npx specdojo kata eject --id <id> # 上書きしたいものだけ複
147
147
 
148
148
  利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
149
149
 
150
+ 型を整える schedule では、review の段とは別に、型そのもの(rulebook と sample の組)を grade して確かめる。
151
+
150
152
  ## タスク実行
151
153
 
152
154
  ```bash
@@ -162,15 +164,20 @@ npx specdojo exec validate --project <project-id>
162
164
 
163
165
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
164
166
 
167
+ 人の確定のタスクも claim と complete で記録し、確定したら成果物の `status` を ready に上げる。直すために確定を開き直すときは、`exec reopen` してから直す。
168
+
165
169
  ## 実行の運び方
166
170
 
167
171
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
168
172
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
173
+ - 裏で完了を待つときは、ログの文字列ではなく、終了コードや lock のファイルで判定する。ログを grep で読む場合はバイナリとして扱われないようにする。
169
174
  - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
170
175
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
171
176
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
172
177
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
173
178
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
179
+ - 実行中の run が残した状態のファイルを、自分の commit に混ぜない。
180
+ - strategy の YAML を道具で書き直したときは、`task_suffix` などの文字列が数値に変わっていないかを schema の検査で確かめる。
174
181
  - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
175
182
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
176
183
 
@@ -154,6 +154,8 @@ npx specdojo kata eject --id <id> # 上書きしたいものだけ複
154
154
 
155
155
  利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
156
156
 
157
+ 型を整える schedule では、review の段とは別に、型そのもの(rulebook と sample の組)を grade して確かめる。
158
+
157
159
  ## タスク実行
158
160
 
159
161
  ```bash
@@ -169,15 +171,20 @@ npx specdojo exec validate --project <project-id>
169
171
 
170
172
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
171
173
 
174
+ 人の確定のタスクも claim と complete で記録し、確定したら成果物の `status` を ready に上げる。直すために確定を開き直すときは、`exec reopen` してから直す。
175
+
172
176
  ## 実行の運び方
173
177
 
174
178
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
175
179
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
180
+ - 裏で完了を待つときは、ログの文字列ではなく、終了コードや lock のファイルで判定する。ログを grep で読む場合はバイナリとして扱われないようにする。
176
181
  - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
177
182
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
178
183
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
179
184
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
180
185
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
186
+ - 実行中の run が残した状態のファイルを、自分の commit に混ぜない。
187
+ - strategy の YAML を道具で書き直したときは、`task_suffix` などの文字列が数値に変わっていないかを schema の検査で確かめる。
181
188
  - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
182
189
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
183
190
 
@@ -154,6 +154,8 @@ npx specdojo kata eject --id <id> # 上書きしたいものだけ複
154
154
 
155
155
  利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
156
156
 
157
+ 型を整える schedule では、review の段とは別に、型そのもの(rulebook と sample の組)を grade して確かめる。
158
+
157
159
  ## タスク実行
158
160
 
159
161
  ```bash
@@ -169,15 +171,20 @@ npx specdojo exec validate --project <project-id>
169
171
 
170
172
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
171
173
 
174
+ 人の確定のタスクも claim と complete で記録し、確定したら成果物の `status` を ready に上げる。直すために確定を開き直すときは、`exec reopen` してから直す。
175
+
172
176
  ## 実行の運び方
173
177
 
174
178
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
175
179
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
180
+ - 裏で完了を待つときは、ログの文字列ではなく、終了コードや lock のファイルで判定する。ログを grep で読む場合はバイナリとして扱われないようにする。
176
181
  - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
177
182
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
178
183
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
179
184
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
180
185
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
186
+ - 実行中の run が残した状態のファイルを、自分の commit に混ぜない。
187
+ - strategy の YAML を道具で書き直したときは、`task_suffix` などの文字列が数値に変わっていないかを schema の検査で確かめる。
181
188
  - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
182
189
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
183
190
 
@@ -147,6 +147,8 @@ npx specdojo kata eject --id <id> # 上書きしたいものだけ複
147
147
 
148
148
  利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
149
149
 
150
+ 型を整える schedule では、review の段とは別に、型そのもの(rulebook と sample の組)を grade して確かめる。
151
+
150
152
  ## タスク実行
151
153
 
152
154
  ```bash
@@ -162,15 +164,20 @@ npx specdojo exec validate --project <project-id>
162
164
 
163
165
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
164
166
 
167
+ 人の確定のタスクも claim と complete で記録し、確定したら成果物の `status` を ready に上げる。直すために確定を開き直すときは、`exec reopen` してから直す。
168
+
165
169
  ## 実行の運び方
166
170
 
167
171
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
168
172
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
173
+ - 裏で完了を待つときは、ログの文字列ではなく、終了コードや lock のファイルで判定する。ログを grep で読む場合はバイナリとして扱われないようにする。
169
174
  - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
170
175
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
171
176
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
172
177
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
173
178
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
179
+ - 実行中の run が残した状態のファイルを、自分の commit に混ぜない。
180
+ - strategy の YAML を道具で書き直したときは、`task_suffix` などの文字列が数値に変わっていないかを schema の検査で確かめる。
174
181
  - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
175
182
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
176
183
 
@@ -248,6 +248,8 @@ npx specdojo kata eject --id <id> # 上書きしたいものだけ複
248
248
 
249
249
  利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
250
250
 
251
+ 型を整える schedule では、review の段とは別に、型そのもの(rulebook と sample の組)を grade して確かめる。
252
+
251
253
  ## タスク実行
252
254
 
253
255
  ```bash
@@ -263,15 +265,20 @@ npx specdojo exec validate --project <project-id>
263
265
 
264
266
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
265
267
 
268
+ 人の確定のタスクも claim と complete で記録し、確定したら成果物の `status` を ready に上げる。直すために確定を開き直すときは、`exec reopen` してから直す。
269
+
266
270
  ## 実行の運び方
267
271
 
268
272
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
269
273
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
274
+ - 裏で完了を待つときは、ログの文字列ではなく、終了コードや lock のファイルで判定する。ログを grep で読む場合はバイナリとして扱われないようにする。
270
275
  - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
271
276
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
272
277
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
273
278
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
274
279
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
280
+ - 実行中の run が残した状態のファイルを、自分の commit に混ぜない。
281
+ - strategy の YAML を道具で書き直したときは、`task_suffix` などの文字列が数値に変わっていないかを schema の検査で確かめる。
275
282
  - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
276
283
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
277
284