specdojo 0.4.2 → 0.4.3
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/CHANGELOG.md +17 -0
- package/dist/catalog/build.js +7 -7
- package/dist/catalog/generate.js +27 -12
- package/dist/commands/init.js +10 -7
- package/dist/commands/orchestrator.js +9 -2
- package/dist/devcontainer/command.js +1 -1
- package/dist/devcontainer/scaffold.js +24 -9
- package/dist/exec/core.js +4 -0
- package/dist/exec/plans-core.js +10 -1
- package/dist/exec/plans-generation.js +13 -0
- package/dist/exec/plans-storage.js +4 -0
- package/dist/exec/register.js +64 -6
- package/dist/exec/results.js +5 -1
- package/dist/exec/strategy.js +4 -0
- package/dist/kata/authoring.js +100 -0
- package/dist/kata/command.js +52 -2
- package/dist/kata/kata.js +54 -11
- package/dist/register/approach.js +29 -1
- package/dist/register/create-commands.js +9 -0
- package/dist/register/cross-project.js +9 -2
- package/dist/register/external-project.js +136 -0
- package/dist/schedule/strategy-profiles.js +3 -0
- package/dist/shared/agent-types.js +4 -0
- package/dist/shared/provider-scaffold.js +3 -3
- package/dist/shared/specdojo-config.js +109 -2
- package/docs/ja/specdojo/exec-templates/xep-recipe-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-template-authoring-template.md +45 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +32 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +1 -1
- package/docs/ja/specdojo/guides/exec-config-guide.md +13 -6
- package/docs/ja/specdojo/guides/kata-guide.md +4 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +352 -68
- package/docs/ja/specdojo/guides/register-operation-guide.md +18 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +18 -4
- package/docs/ja/specdojo/guides/use-case-guide.md +2 -2
- package/docs/ja/specdojo/references/command-reference.md +39 -20
- package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +10 -10
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +13 -13
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +4 -4
- package/docs/ja/specdojo/standards/template-authoring-standard.md +4 -4
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +6 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +6 -6
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -4
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +29 -0
- package/package.json +2 -2
- package/templates/antigravity/README.md +1 -1
- package/templates/antigravity/settings.global.json +5 -0
- package/templates/claude/README.md +11 -8
- package/templates/claude/settings.edit.json +10 -1
- package/templates/claude/settings.orchestrator.json +90 -0
- package/templates/claude/settings.report.json +14 -1
- package/templates/claude/settings.review.json +13 -1
- package/templates/codex/README.md +7 -5
- package/templates/codex/rules/specdojo.rules +48 -0
- package/templates/devcontainer/devcontainer.json +1 -4
- package/templates/opencode/README.md +2 -1
- package/templates/opencode/agents/opencode-executor.md +2 -0
- package/templates/opencode/agents/opencode-review-executor.md +2 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +59 -5
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -338,6 +338,38 @@ npx specdojo-docs-site build .
|
|
|
338
338
|
|
|
339
339
|
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリに存在しない package 同梱の kata・guide・reference を、gitignore 済みの `specdojo-kata-staging/` へ一時的に複製して `/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先するため、サイト表示のために `kata install --all` を実行する必要はありません。
|
|
340
340
|
|
|
341
|
+
### 6.1. Mermaid 図を組み立てる
|
|
342
|
+
|
|
343
|
+
docs-site の Mermaid 12 は、既定のレイアウトに ELK を使います。ELK は複雑な図でも要素を層に分け、辺を直角に配線するため、通常は図ごとのレイアウト指定を加えません。既存の図が `config` で `dagre` を指定している場合は、その図の意図を優先します。`elk.stress` など ELK の別方式は要素が重なることがあるため使いません。
|
|
344
|
+
|
|
345
|
+
1 つの図の辺が 20 本前後を超える場合は、目的ごとに図を分けるか、`subgraph` で関係のまとまりを示します。中心の要素に周囲から矢印を集める図は、`architecture` 図を使うと辺ごとに接続面を指定できます。`T` は上、`B` は下、`L` は左、`R` は右です。
|
|
346
|
+
|
|
347
|
+
```mermaid
|
|
348
|
+
architecture-beta
|
|
349
|
+
service top(cloud)[上]
|
|
350
|
+
service bottom(database)[下]
|
|
351
|
+
service left(internet)[左]
|
|
352
|
+
service right(disk)[右]
|
|
353
|
+
service center(server)[中心]
|
|
354
|
+
|
|
355
|
+
top:B --> T:center
|
|
356
|
+
bottom:T --> B:center
|
|
357
|
+
left:R --> L:center
|
|
358
|
+
right:L --> R:center
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
Mermaid 12.0.0 の `architecture` 図では、辺にラベルを付けられません。関係の名前を示す場合はノード名へ含めるか、辺ラベルを使える `flowchart` で描きます。`architecture` 図の組み込みアイコンは `cloud`・`database`・`disk`・`internet`・`server` です。それ以外の Iconify アイコンは表示側でアイコンパックの登録が必要なため、登録していない環境では使いません。
|
|
362
|
+
|
|
363
|
+
要素を格子状に並べる図には `block` 図を使えます。要素が詰まりやすいため、空けたい 1 列には `space`、複数列には `space:<列数>` を置きます。
|
|
364
|
+
|
|
365
|
+
```mermaid
|
|
366
|
+
block
|
|
367
|
+
columns 3
|
|
368
|
+
a["A"] space b["B"]
|
|
369
|
+
space center["中心"] space
|
|
370
|
+
c["C"] space d["D"]
|
|
371
|
+
```
|
|
372
|
+
|
|
341
373
|
サイト上の情報量を抑えるため、ナビゲーションと検索には次の範囲を使います。
|
|
342
374
|
|
|
343
375
|
- `/ja/specdojo/` では SpecDojo 文書、`/ja/projects/<project-id>/` では対象 project の文書をサイドバーに表示します。
|
|
@@ -381,7 +381,7 @@ VS Code でプロジェクトリポジトリとプロダクトリポジトリを
|
|
|
381
381
|
|
|
382
382
|
プロダクト文書は実装と同期して改訂するため、`app1/docs/ja/product/` に置きます。README、ソースコードから生成する API リファレンス、パッケージ利用者向けの手順など、コードと同じ revision で読む付属文書も `app1/` に置きます。
|
|
383
383
|
|
|
384
|
-
`app1-specdojo/` には `docs/ja/projects
|
|
384
|
+
`app1-specdojo/` には `docs/ja/projects/`、`docs/ja/specdojo/`、`docs/ja/kata/` を置きます。順に、プロジェクト固有の目的・判断・計画・実行記録、SpecDojo が配布する型、利用者がリポジトリ単位の authority で新しく作る rulebook / recipe / sample / template です。この境界により、プロダクトの内容と同じ revision が必要な文書は `app1/`、SpecDojo の記帳と再利用可能な型は `app1-specdojo/` の履歴に残ります。
|
|
385
385
|
|
|
386
386
|
プロダクト文書の catalog `base_path` を別リポジトリへ解決する機能と、[[prj-0001:pjr-xkks-grade-sidecar|PJR-XKKS grade result のサイドカー化]] で定める成果物へ書き込まない grade 運用は、プロダクト文書を成果物として管理する場合の前提です。exec はプロダクト文書をファイルとして変更・統合できますが、catalog・grade・doc index の対象にはしません。
|
|
387
387
|
|
|
@@ -87,6 +87,8 @@ phase_sets:
|
|
|
87
87
|
|
|
88
88
|
`approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。
|
|
89
89
|
|
|
90
|
+
`*-authoring` は register の `--target` 順序で新規 kata ID と手本を表すため、Schedule の phase では使用できません。strategy に指定すると plan 生成時に停止します。
|
|
91
|
+
|
|
90
92
|
pipeline では `agent_pipeline.stages` を `executor`、`reporter` の順に定義します。各 stage は `stage_role` と任意の `capabilities` / `proficiency` を持ちます。特定 member を使う phase は、これと併せて `agent.executor` / `agent.reporter` を指定します。pipeline の構造例は [Schedule設計ガイド](schedule-design-guide.md) の `executor / reporter pipeline` を参照してください。
|
|
91
93
|
|
|
92
94
|
解決順序は `--executor-by` / `--reporter-by`、phase の `agent`、`capabilities` / `proficiency` / `priority` による自動選択です。CLI は緊急の差し替えに使います。指定した member は対応する `stage_role` を持つ必要があり、`schedule build` が phase の nickname と role を検証します。従来の単一 agent タスクでは stage override を使用できません。
|
|
@@ -534,12 +536,12 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
534
536
|
|
|
535
537
|
agent が exec 実行時に読み込む provider 固有の設定(agent 定義・permission 設定)は、npm package 内の `templates/<provider>/` を配布原本とし、利用プロジェクトへコピーして使います。worktree 実行はコミット済み内容から worktree を作るため、コピーした設定は必ずコミットします。
|
|
536
538
|
|
|
537
|
-
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
539
|
+
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
538
540
|
|
|
539
541
|
| provider | 配布内容 | 配置先 |
|
|
540
542
|
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
541
|
-
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.review.json` / `settings.report.json`
|
|
542
|
-
| codex | `agents/*.toml`(親 Codex が spawn する subagent
|
|
543
|
+
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
|
|
544
|
+
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
|
|
543
545
|
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義) | `.opencode/agents/` |
|
|
544
546
|
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
|
|
545
547
|
| antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
|
|
@@ -552,6 +554,8 @@ Claude member の `mode` はこの `{mode}` を権限プロファイル名へ展
|
|
|
552
554
|
|
|
553
555
|
`settings.edit.json` は、利用者のリポジトリ固有の構成(ルート直下の成果物や `app/`・`lib/` など)にも対応できるよう、既定でリポジトリ全体への Edit を許可します。一方、agent の権限や親 runner・hook・CI の実行内容を変更できる `.specdojo/`、agent 設定、CI 設定、ルート直下の `package.json` などは deny します。deny の範囲は runner の agent-config-write 検査と同じ保護対象を unit test で照合し、Claude Code の事前拒否と runner の事後検査を重ねます。
|
|
554
556
|
|
|
557
|
+
`settings.orchestrator.json` は `init` と `config scaffold` が追加する `orch:opus`・`orch:sonnet` 専用です。対話型オーケストレーターは利用者の承認を得て保護設定も変更するため、`settings.edit.json` のパス deny を引き継ぎません。代わりに `git push` と GitHub CLI の書き込み操作を deny し、PR・workflow run・release などの読み取りコマンドだけを allow します。
|
|
558
|
+
|
|
555
559
|
### 7.1. scaffold コマンド
|
|
556
560
|
|
|
557
561
|
この配置は、初期設定の導線にある `config scaffold` の `--provider <name>` オプションで自動化します。
|
|
@@ -622,9 +626,9 @@ provider によらず、exec の実行構造そのものが次の境界を提供
|
|
|
622
626
|
|
|
623
627
|
### 8.2. provider 別の権限設定
|
|
624
628
|
|
|
625
|
-
**claude** は `provider 設定の配布と scaffold`
|
|
629
|
+
**claude** は `provider 設定の配布と scaffold` のとおり、pipeline のロール別 `--settings` でパス単位に制限します。executor・review executor・reporter は `git push` と全 `gh` を deny します。対話型オーケストレーターの npm script は専用の `settings.orchestrator.json` を読み込み、保護設定を含む編集を妨げず、`git push` と `gh` の書き込みだけを deny して読み取りを allow します。`--permission-mode bypassPermissions` は使わず、`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します。
|
|
626
630
|
|
|
627
|
-
**antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny
|
|
631
|
+
**antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny には、`git push`、全 `gh`、Git の変更操作・破壊的 command・秘密情報・固定保護設定へのアクセスを入れます。`--dangerously-skip-permissions` は使いません。CLI の permission に加えて、実行後の provider 非依存ガードでも保護設定の変更を block します。
|
|
628
632
|
|
|
629
633
|
**codex** はパス単位の permission 機構を持たず、sandbox(`read-only` / `workspace-write` / `danger-full-access`)の粒度で制御します。review でも result の記入が必要なため `read-only` にはできず、edit / review とも `workspace-write` を使います。command template には次を明示します。
|
|
630
634
|
|
|
@@ -642,6 +646,7 @@ providers:
|
|
|
642
646
|
- `-c sandbox_workspace_write.network_access=false`: sandbox 内からの直接のネットワークアクセスを遮断します。デフォルトでも無効ですが、設定変更で意図せず解放されないよう command に固定します。`web_search` はモデル側ツールとして sandbox の外で動作するため、この設定の影響を受けません。
|
|
643
647
|
- `--ephemeral`: セッションを永続化せず、実行間の文脈持ち越しを防ぎます。
|
|
644
648
|
- `.codex/config.toml` は対話セッション用のデフォルト(`approval_policy = "on-request"` 等)であり、無人実行の権限は command template の `-c` 上書きを正とします。claude の `settings.local.json`(対話用)と `--settings`(無人実行用)の分担に対応します。
|
|
649
|
+
- scaffold は `.codex/rules/specdojo.rules` も配置し、`git push` と全 `gh` を `forbidden` にします。無人実行では network 無効化と重ね、対話セッションでも共有された GitHub 認証を agent が使わない境界にします。project-local rule は信頼済み project で読み込まれます。
|
|
645
650
|
|
|
646
651
|
**opencode** は agent 定義(`.opencode/agents/*.md`)の frontmatter `permission` を正とします。claude の settings と同等以上の粒度(パス単位の `edit`、コマンドパターン単位の `bash`)を持つため、両 agent とも許可リスト方式で定義します。
|
|
647
652
|
|
|
@@ -651,7 +656,9 @@ providers:
|
|
|
651
656
|
| opencode-review-executor | 全面 deny(成果物・result のいずれも変更しない) | 読み取り系・検証系の許可リスト。他は deny |
|
|
652
657
|
| opencode-reporter | 全面 deny(result への反映は runner が行う) | 全面 deny |
|
|
653
658
|
|
|
654
|
-
`bash` を deny 基点の許可リストにするのは、`git add` / `git commit` を含む任意コマンドを塞ぐためで、denylist(`git push`
|
|
659
|
+
`bash` を deny 基点の許可リストにするのは、`git add` / `git commit` を含む任意コマンドを塞ぐためで、denylist(`git push` などの列挙)では不十分です。executor・review executor は、将来の許可リスト追加で意図せず開かないよう `git push` と全 `gh` を末尾でも明示 deny します。対話型オーケストレーターは agent 定義ごとに権限を分離できるため、`edit` をリポジトリ全体で allow し、PR・workflow run・release などの読み取りだけを allow します。`gh api` と書き込みサブコマンドは明示 deny し、それ以外は先頭の deny により拒否されます。
|
|
660
|
+
|
|
661
|
+
Codex の project-local rule と Antigravity の global settings は役割共通であり、同じリポジトリまたは利用者の orchestrator だけを例外にできません。この 2 provider は全 agent の `gh` 全面拒否を維持します。Claude と OpenCode は orchestrator 専用設定を持てるため読み取りだけを許可し、pipeline executor・reporter は全 `gh` を拒否します。
|
|
655
662
|
|
|
656
663
|
**copilot**(GitHub Copilot CLI)は command のフラグで権限を制御します。deny は allow より常に優先され、`--allow-all-tools` すら上書きできます。`.specdojo/agent-members.yaml` には copilot member を `disabled: true` で定義し、起動コマンドは `providers.copilot.command_template` に定義します。有効化する際も次の構成を維持します。
|
|
657
664
|
|
|
@@ -65,6 +65,10 @@ template は、記述する部分を _TODO_ などのプレースホルダとし
|
|
|
65
65
|
|
|
66
66
|
要否は初回の `bootstrap` で判断します。`undecided` の型は、必要なら項目を省略したうえで必要な型を成果物と一緒に整備し、不要なら `not-needed` へ更新します。既存の型を廃止する、または `not-needed` を必要へ変更する場合は、成果物の実績・繰り返し発生したレビュー指摘・schema の表現範囲を根拠として rulebook frontmatter の宣言も同時に更新します。
|
|
67
67
|
|
|
68
|
+
成果物と型を一組で初めて作るときは `bootstrap` を使います。成果物がすでにあり、そこから再利用可能な型だけを新しく起こすとき、または手本なしで型だけを作るときは `rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` を使います。authoring では手本の成果物本文を変更せず、該当参照が `undecided` または未記入の場合だけ新しい kata ID へ更新します。
|
|
69
|
+
|
|
70
|
+
利用者が作る kata はリポジトリ単位の `kata_authority` を使い、`docs/ja/kata/{rulebooks,recipes,samples,templates}/` に置きます。`specdojo:` は SpecDojo 本体専用であり、利用者リポジトリでは新規作成できません。これにより、同じリポジトリの複数 project で型を共有しながら、将来追加される同名の同梱 kata と衝突しません。
|
|
71
|
+
|
|
68
72
|
`kind: generated` の成果物には実践の型を適用しません。成果物ごとの型宣言は置かず、`kind` から非適用を導出します。rulebook を持たない成果物は成果物カタログの `rulebook: not-needed` で表します。
|
|
69
73
|
|
|
70
74
|
## 3. 進め方(approach)との参照分担
|