specdojo 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +40 -0
- package/README.md +2 -2
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +1 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +4 -3
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-generation.js +6 -2
- package/dist/exec/register-resume.js +28 -0
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +6 -0
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +42 -1
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/register/register.js +31 -23
- package/dist/shared/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
- package/docs/ja/specdojo/references/command-reference.md +69 -37
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +5 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
|
@@ -16,133 +16,170 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
# 概念データフロー図(ユースケース別): _USE_CASE_NAME_
|
|
18
18
|
|
|
19
|
-
_TODO_: 全体概要のケース `_CASE_ID_`
|
|
19
|
+
_TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースまたは系統を一文で示す。
|
|
20
20
|
|
|
21
21
|
## 1. 目的
|
|
22
22
|
|
|
23
|
-
_TODO_:
|
|
24
|
-
|
|
25
|
-
- _ROLE_ は、_TODO_: グループの通過順と責任境界を承認する。
|
|
26
|
-
- _ROLE_ は、_TODO_: 引き渡す情報と条件を後続設計へ利用する。
|
|
27
|
-
- _ROLE_ は、_TODO_: 引き渡しと戻り経路の重複・欠落を確認する。
|
|
23
|
+
_TODO_: その業務が何のためにあるか、どの出来事からどの成果までを成立させるかを 1〜2 文で書く。読み手の承認・設計・確認作業は書かない。
|
|
28
24
|
|
|
29
25
|
## 2. 適用範囲
|
|
30
26
|
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
- 終了条件: _END_CONDITION_。_TODO_: 最後のグループが成果を利用可能と判断できる条件を書く。
|
|
34
|
-
- 横断するプロセスグループ: _PROCESS_GROUP_NAME_ → _PROCESS_GROUP_NAME_。_TODO_: 正常系の通過順で二つ以上を書く。
|
|
35
|
-
- 組織境界: _TODO_: 引き渡し可否、戻し、再開を判断するロールと、対象範囲外の主体を書く。
|
|
36
|
-
- システム境界: _TODO_: 横断条件の判定と情報・物の引き渡しまでを対象とし、画面・保存方式などの実装詳細を対象外とする旨を書く。
|
|
37
|
-
- 対象外: グループ内部の領域・プロセス・主要例外・補助操作は各 `cdfd-_GROUP_`、状態の定義と遷移は STSD を正本とし、本書では再掲しない。
|
|
38
|
-
- 責任分担: _TODO_: 人間と AI Agent の責任分担を定める既存文書への参照を書く。参照先がない場合は、承認と最終判断を人間が担う原則を書く。
|
|
39
|
-
|
|
40
|
-
## 3. プロセス領域
|
|
41
|
-
|
|
42
|
-
ケース `_CASE_ID_` は _GROUP_COUNT_ のプロセスグループを正常系の順序で横断する。グループ名、含む領域、業務目的は全体概要を正本とし、本章では各グループがこのユースケースで担う役割を定める。
|
|
43
|
-
|
|
44
|
-
<!-- 正常系で通過するプロセスグループごとに 3.n の節を繰り返す。同じグループが再登場する場合は別の節とし、理由を書く。 -->
|
|
27
|
+
- **対象**: ケース `_CASE_ID_`「_USE_CASE_NAME_」の _START_EVENT_ から _END_EVENT_ まで、_TODO_: 参加単位と必要な組織・システム境界を 1 行で書く。
|
|
28
|
+
- **対象外**: _TODO_: rulebook の「描き方の選択」に従う対象外、補助操作・実装詳細、状態定義・遷移を委ねる STSD を 1 行で示し、共通の責任分担は全体概要を参照する。
|
|
45
29
|
|
|
46
|
-
|
|
30
|
+
<!-- based_on と本文では、有効な全体概要や後継文書を参照し、deprecated の文書は参照しない。既存文書は project 修飾 doc id の wikilink、未作成文書は ID のインラインコードにする。 -->
|
|
47
31
|
|
|
48
|
-
|
|
32
|
+
## 3. プロセス領域
|
|
49
33
|
|
|
50
|
-
|
|
51
|
-
- **主要出力**: _TODO_: 次段または終了側へ渡す情報・物を名詞で列挙する。
|
|
52
|
-
- **データストア**: _TODO_: 引き渡す情報または条件判定に使う「データストア」の名称を列挙する。
|
|
34
|
+
_TODO_: ケース `_CASE_ID_` の正常系の順序を示す。名称・領域分割は全体概要、役割は本章の表、受け渡しは図を正本とする。
|
|
53
35
|
|
|
54
|
-
|
|
55
|
-
| ---- | -------------------- | --------------- | ------------------------------ | -------------- |
|
|
56
|
-
| 1 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
|
|
36
|
+
<!-- rulebook の「描き方の選択」に従い、全体概要と同じグループ・区分ごとに節を置く。各節には役割表だけを置き、主要入力・主要出力の箇条書きは置かない。以下はグループ代表ノードの例。領域単位の場合は「含む領域」を「プロセス領域」にし、P-xx 領域名を書く。PDCA は必要な場合だけ独立した列で追加し、グループ・区分の列に入れない。 -->
|
|
57
37
|
|
|
58
|
-
### 3.
|
|
38
|
+
### 3.1. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
|
|
59
39
|
|
|
60
|
-
|
|
40
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
41
|
+
| ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
|
|
42
|
+
| 1 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
|
|
61
43
|
|
|
62
|
-
|
|
63
|
-
- **主要出力**: _TODO_
|
|
64
|
-
- **データストア**: _TODO_
|
|
44
|
+
### 3.2. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
|
|
65
45
|
|
|
66
|
-
| 順序 |
|
|
67
|
-
| ---- |
|
|
68
|
-
| 2 |
|
|
46
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
47
|
+
| ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
|
|
48
|
+
| 2 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
|
|
69
49
|
|
|
70
50
|
## 4. データストア
|
|
71
51
|
|
|
72
|
-
|
|
52
|
+
全体概要から、このケースで参照・更新する正本だけを同じ名称・区分で示す。
|
|
73
53
|
|
|
74
54
|
### 4.1. マスタ・構成データ
|
|
75
55
|
|
|
76
|
-
| データストア
|
|
77
|
-
|
|
|
78
|
-
|
|
|
56
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
57
|
+
| ------------------- | ----------------------------- | ------------ |
|
|
58
|
+
| _MASTER_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
|
|
79
59
|
|
|
80
60
|
### 4.2. トランザクションデータ
|
|
81
61
|
|
|
82
|
-
| データストア
|
|
83
|
-
|
|
|
84
|
-
|
|
|
62
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
63
|
+
| ------------------------ | ----------------------------- | ------------ |
|
|
64
|
+
| _TRANSACTION_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
|
|
85
65
|
|
|
86
|
-
<!--
|
|
66
|
+
<!-- 該当する行がない区分は節ごと削除する。図のデータストアと対応させ、新しい名称・区分を本書だけへ追加しない。 -->
|
|
87
67
|
|
|
88
68
|
## 5. 概念データフロー
|
|
89
69
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
70
|
+
### 5.1. _BUSINESS_FLOW_TITLE_
|
|
71
|
+
|
|
72
|
+
_TODO_: 図から読み取れる流れや関係を 1 文で書く。題は「起票から完了記録まで」のような業務の言葉にする。
|
|
73
|
+
|
|
74
|
+
<!-- 開始から終了まで上から下へ配置する。イベントは一ノード一出来事の短い文にし、長ければ原文を保って改行する。系統の入口は全体概要の表と同じ文言にし、複数の出来事は分ける。引き渡し条件のイベント・引き渡し ID・Orchestrator は置かない。以下は D2 の例。実際の記法・色は全体概要の凡例に合わせる。 -->
|
|
75
|
+
|
|
76
|
+
```d2
|
|
77
|
+
direction: down
|
|
78
|
+
|
|
79
|
+
classes: {
|
|
80
|
+
process: {
|
|
81
|
+
shape: rectangle
|
|
82
|
+
style: {
|
|
83
|
+
border-radius: 8
|
|
84
|
+
fill: "#e3f2fd"
|
|
85
|
+
stroke: "#1e88e5"
|
|
86
|
+
font-color: "#000000"
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
event: {
|
|
90
|
+
shape: hexagon
|
|
91
|
+
style: {
|
|
92
|
+
fill: "#fff3e0"
|
|
93
|
+
stroke: "#fb8c00"
|
|
94
|
+
font-color: "#000000"
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
store_master: {
|
|
98
|
+
shape: cylinder
|
|
99
|
+
style: {
|
|
100
|
+
fill: "#e8f5e9"
|
|
101
|
+
stroke: "#43a047"
|
|
102
|
+
font-color: "#000000"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
store_transaction: {
|
|
106
|
+
shape: cylinder
|
|
107
|
+
style: {
|
|
108
|
+
fill: "#c8e6c9"
|
|
109
|
+
stroke: "#2e7d32"
|
|
110
|
+
font-color: "#000000"
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
physical_store: {
|
|
114
|
+
shape: rectangle
|
|
115
|
+
style: {
|
|
116
|
+
border-radius: 20
|
|
117
|
+
fill: "#c8e6c9"
|
|
118
|
+
stroke: "#2e7d32"
|
|
119
|
+
font-color: "#000000"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
material_flow: {
|
|
123
|
+
style: {
|
|
124
|
+
stroke-width: 3
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
start: "_START_EVENT_" { class: event }
|
|
130
|
+
source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
|
|
131
|
+
target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
|
|
132
|
+
end: "_END_EVENT_" { class: event }
|
|
133
|
+
master_store: "_MASTER_STORE_NAME_" { class: store_master }
|
|
134
|
+
transaction_store: "_TRANSACTION_STORE_NAME_" { class: store_transaction }
|
|
135
|
+
|
|
136
|
+
start -> source: "起動条件"
|
|
137
|
+
master_store -> source: "_REFERENCE_INFORMATION_"
|
|
138
|
+
source -> target: "_TRANSFER_INFORMATION_"
|
|
139
|
+
target -> transaction_store: "_RESULT_INFORMATION_"
|
|
140
|
+
target -> end: "_COMPLETION_INFORMATION_"
|
|
118
141
|
```
|
|
119
142
|
|
|
120
|
-
_TODO_:
|
|
143
|
+
_TODO_: 全体概要の「凡例(本プロダクト共通)」を参照する短い注記と、使用線種・省略事項・図を分ける場合の共有ノードを書く。
|
|
144
|
+
|
|
145
|
+
<!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class を使う。不要なノード・線・classes は削除する。読みづらい場合は連続する業務の範囲で分割し、同じ名称・領域 ID のノードで接続を追えるようにする。引き渡し ID は作らない。 -->
|
|
121
146
|
|
|
122
|
-
<!--
|
|
147
|
+
<!-- 業務上重要な戻りがある場合だけ以下の節を使い、不要なら節ごと削除する。「引き渡し」「例外時の戻り先」の章や条件表は設けない。 -->
|
|
123
148
|
|
|
124
|
-
|
|
149
|
+
### 5.2. 例外時の戻り
|
|
125
150
|
|
|
126
|
-
|
|
127
|
-
| -------------- | -------------------- | -------------------- | --------------------- | ------------------- | ------------------ |
|
|
128
|
-
| `_HANDOFF_ID_` | _PROCESS_GROUP_NAME_ | _PROCESS_GROUP_NAME_ | _HANDOFF_INFORMATION_ | _HANDOFF_CONDITION_ | _RETURN_CONDITION_ |
|
|
151
|
+
_TODO_: 不足や不一致をどこへ返すか、図から読み取れることを 1 文で書く。
|
|
129
152
|
|
|
130
|
-
|
|
153
|
+
```d2
|
|
154
|
+
direction: down
|
|
131
155
|
|
|
132
|
-
|
|
156
|
+
classes: {
|
|
157
|
+
process: {
|
|
158
|
+
shape: rectangle
|
|
159
|
+
style: {
|
|
160
|
+
border-radius: 8
|
|
161
|
+
fill: "#e3f2fd"
|
|
162
|
+
stroke: "#1e88e5"
|
|
163
|
+
font-color: "#000000"
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
}
|
|
133
167
|
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
168
|
+
source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
|
|
169
|
+
target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
|
|
170
|
+
|
|
171
|
+
source <- target: "_RETURN_INFORMATION_"
|
|
172
|
+
source -> target: "_CORRECTED_INFORMATION_"
|
|
173
|
+
```
|
|
137
174
|
|
|
138
|
-
|
|
175
|
+
_TODO_: 全体概要の凡例を参照し、通常の図と共有する参加単位、省略事項、戻りが業務上重要な理由を短く注記する。
|
|
139
176
|
|
|
140
|
-
<!--
|
|
177
|
+
<!-- 戻りは補完・再判断を担う参加単位へ向け、返す情報と再提示する情報を名詞の線のラベルにする。条件イベントや内部の再試行手順は置かない。 -->
|
|
141
178
|
|
|
142
|
-
|
|
179
|
+
<!-- 未決事項がある場合だけ以下の章を使い、ない場合は章ごと削除する。 -->
|
|
143
180
|
|
|
144
|
-
|
|
145
|
-
| ------------------- | ------------------------ | --------------- | ----------------- |
|
|
146
|
-
| _UNDECIDED_: _TODO_ | `_CASE_ID_` / `_HANDOFF_ID_` | _DECISION_ROLE_ | _DECISION_TIMING_ |
|
|
181
|
+
## 6. 未決事項
|
|
147
182
|
|
|
148
|
-
|
|
183
|
+
| 論点 | 影響するケース・参加単位 | 決定者 | 決定時期 |
|
|
184
|
+
| ------------------- | ------------------------------------------- | --------------- | ----------------- |
|
|
185
|
+
| _UNDECIDED_: _TODO_ | `_CASE_ID_` / _PARTICIPANT_NAME_OR_AREA_ID_ | _DECISION_ROLE_ | _DECISION_TIMING_ |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
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",
|
|
@@ -71,6 +71,8 @@
|
|
|
71
71
|
"orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
72
72
|
"orch:flash": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
73
73
|
"orch:flash:work": "tools/worktree/open-agent-worktree.sh agy-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider antigravity -- --add-dir . --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
74
|
+
"orch:argon": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-4-argon-medium -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
75
|
+
"orch:argon:work": "tools/worktree/open-agent-worktree.sh argon-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider antigravity -- --add-dir . --model gemini-4-argon-medium -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
74
76
|
"orch:qwen": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent qwen-orchestrator",
|
|
75
77
|
"orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider opencode -- --agent qwen-orchestrator",
|
|
76
78
|
"orch:gemma": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent gemma-orchestrator",
|
|
@@ -94,6 +96,7 @@
|
|
|
94
96
|
"docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
|
|
95
97
|
"lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
|
|
96
98
|
"lint:mermaid": "node tools/lint-mermaid.mjs",
|
|
99
|
+
"lint:d2": "node tools/lint-d2.mjs",
|
|
97
100
|
"validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
|
|
98
101
|
"validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
|
|
99
102
|
"validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
|
|
@@ -102,7 +105,7 @@
|
|
|
102
105
|
"validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
|
|
103
106
|
"validate:catalog": "tsx src/specdojo.ts catalog validate",
|
|
104
107
|
"validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
|
|
105
|
-
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
108
|
+
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run lint:d2 && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
106
109
|
"check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
|
|
107
110
|
"dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
|
|
108
111
|
"dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
|
|
@@ -1,64 +1,37 @@
|
|
|
1
|
-
# Antigravity
|
|
1
|
+
# Antigravity CLI provider 設定
|
|
2
2
|
|
|
3
|
-
`npx specdojo config scaffold --provider antigravity`
|
|
3
|
+
`npx specdojo config scaffold --provider antigravity` の配布原本です。README と旧 `settings.global.json` はコピーされません。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
| 原本 | 配置先 |
|
|
6
|
+
| ----------------------------------------------------------------------------------------------------- | ------------------------ |
|
|
7
|
+
| `settings.edit.json` / `settings.review.json` / `settings.report.json` / `settings.orchestrator.json` | `.specdojo/antigravity/` |
|
|
8
|
+
| `orchestrator.md` / `exec-defaults-snippet.yaml` / `agent-members-snippet.yaml` | `.specdojo/antigravity/` |
|
|
6
9
|
|
|
7
|
-
|
|
8
|
-
| ---------------------------- | -------------------------------------------------- |
|
|
9
|
-
| `orchestrator.md` | `.specdojo/antigravity/orchestrator.md` |
|
|
10
|
-
| `exec-defaults-snippet.yaml` | `.specdojo/antigravity/exec-defaults-snippet.yaml` |
|
|
11
|
-
| `agent-members-snippet.yaml` | `.specdojo/antigravity/agent-members-snippet.yaml` |
|
|
12
|
-
|
|
13
|
-
`settings.global.json` はリポジトリへコピーされません。`--global` を明示した場合だけ、
|
|
14
|
-
権限ルールをユーザー設定へマージするための原本として使われます。
|
|
15
|
-
|
|
16
|
-
## ユーザー権限設定
|
|
17
|
-
|
|
18
|
-
まず dry-run で、`~/.gemini/antigravity-cli/settings.json` へ追加されるルールだけを差分表示します。
|
|
10
|
+
通常の導入ではグローバル設定を書き換えません。agy 1.4.12 以上と、同じ版の `specdojo` が PATH に必要です。
|
|
19
11
|
|
|
20
12
|
```sh
|
|
21
|
-
npx specdojo config scaffold --provider antigravity --
|
|
13
|
+
npx specdojo config scaffold --provider antigravity --dry-run
|
|
14
|
+
npx specdojo config scaffold --provider antigravity
|
|
22
15
|
```
|
|
23
16
|
|
|
24
|
-
|
|
17
|
+
provider / member のスニペットを設定へマージし、生成ファイルを commit します。command template は次の入口を使います。
|
|
25
18
|
|
|
26
|
-
```
|
|
27
|
-
|
|
19
|
+
```yaml
|
|
20
|
+
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
28
21
|
```
|
|
29
22
|
|
|
30
|
-
|
|
31
|
-
- `permissions.allow` / `deny` / `ask` の既存要素と、それ以外のユーザー設定を保持し、不足するルールだけを末尾へ追加します。
|
|
32
|
-
- 書き換え前のファイルは `settings.json.backup-<timestamp>` へ退避します。設定ファイルがまだ無い場合は新規作成し、バックアップは作りません。
|
|
33
|
-
- 既存 JSON や permission 配列の形式が不正な場合は、バックアップも書き込みも行わずエラーにします。
|
|
34
|
-
- `--force` はリポジトリ内の配布物だけに作用し、グローバル設定の既存項目を上書きしません。
|
|
35
|
-
|
|
36
|
-
権限原本は、必要な検証コマンドを allow し、`git push`、読み取りを含む全 `gh`、破壊的コマンド、秘密情報、親 runner・hook・CI・agent 設定を変更できるパスを deny します。`.specdojo/doc-index.json` のような既知の生成物は検証で更新できるよう、`.specdojo/` 全体ではなく設定ファイルと provider ディレクトリを個別に deny します。provider 非依存の実行後ガードも併用されます。
|
|
23
|
+
`mode` は edit / review / report です。起動処理が役割プロファイルと runner の宣言済み task worktree の絶対パスを単一の `--settings` JSON にまとめて渡し、保存しません。edit は通常成果物を編集し、秘密情報・保護設定を拒否します。review / report は全ファイルの書き込みと command / MCP を拒否します。検証は親 runner に委ねます。
|
|
37
24
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
Antigravity CLI(`agy`)はファイル定義の agent を持たないため、`--agent <name>` では起動できません。規範の本文を `-i` で渡します。
|
|
25
|
+
対話型は生成された `npm run orch:argon`(または `npm run orch:flash`)あるいは次の入口を使います。
|
|
41
26
|
|
|
42
27
|
```sh
|
|
43
|
-
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
`--add-dir "$(pwd)"` を付けないと、作業ディレクトリのファイルを読み書きできず、`AGENTS.md` と `.agents/rules/*.md` も読み込まれません。
|
|
47
|
-
|
|
48
|
-
`package.json` へ登録しておくと短く起動できます。
|
|
49
|
-
|
|
50
|
-
```json
|
|
51
|
-
{
|
|
52
|
-
"scripts": {
|
|
53
|
-
"orch:flash": "specdojo orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
|
|
54
|
-
}
|
|
55
|
-
}
|
|
28
|
+
specdojo orchestrator launch --provider antigravity -- --model gemini-4-argon-medium -i "$(cat .specdojo/antigravity/orchestrator.md)"
|
|
56
29
|
```
|
|
57
30
|
|
|
58
|
-
|
|
31
|
+
この入口は orchestrator プロファイルと選択 project の宣言済み repository を使い、cwd も `--add-dir` に加えます。保護設定の編集は利用者の承認に従い、秘密情報・Git metadata・push の制限は維持します。直接 `agy` を起動すると、この権限生成処理は適用されません。
|
|
59
32
|
|
|
60
|
-
|
|
33
|
+
既存利用者は command template と個別 command を上記へ移行し、`--dangerously-skip-permissions` を削除してください。既存 npm script は scaffold が上書きしないため、`orchestrator launch` 経由へ手動変更します。旧 `--global` は互換用途で残ります。既存ルールを自動で消さず、ユーザー設定をバックアップして自身の制限を役割プロファイルへ移してください。
|
|
61
34
|
|
|
62
|
-
|
|
35
|
+
`--settings` と既存グローバル・project 設定の配列マージは実機で未検証です。Claude と同等の隔離を確認したとは扱いません。仕様・移行・無害なファイルでの実機検証手順は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。実機の許可/拒否と、統合後の PJR-JSEY の証跡を記録してから運用へ適用します。
|
|
63
36
|
|
|
64
|
-
|
|
37
|
+
モデル ID は `agy models` で確認し、推論強度を含むため `--effort` と併用しません。認証は利用者が別途行い、設定や成果物に資格情報を書きません。
|
|
@@ -7,20 +7,19 @@
|
|
|
7
7
|
|
|
8
8
|
providers:
|
|
9
9
|
antigravity:
|
|
10
|
-
#
|
|
11
|
-
#
|
|
10
|
+
# pipeline の役割指示は plan、権限は agent launch の --role で分離する。
|
|
11
|
+
# -p はプロンプトを引数に取り stdin を読まないため、
|
|
12
12
|
# runner が stdin へ書く plan を "$(cat)" で引数に渡す(shell: true で実行される)。
|
|
13
13
|
# --sandbox は書き込み先を ~/.gemini 配下の scratch へ逃がすため、--add-dir で作業
|
|
14
14
|
# ディレクトリ(worktree)を明示して成果物へ書けるようにする(2026-09-21 実測)。
|
|
15
|
-
#
|
|
16
|
-
#
|
|
17
|
-
# deny rule も含めた承認境界を迂回するため使わない。
|
|
15
|
+
# agent launch が settings.{mode}.json と宣言済み worktree の保護ルールを一つの
|
|
16
|
+
# --settings JSON にまとめて渡す。グローバル設定への書き込みは不要。
|
|
18
17
|
# agy のモデル ID は推論強度を含む(gemini-3.8-flash-{high,medium,low} など)。--effort を
|
|
19
18
|
# 併用すると ID と食い違ったときに "invalid model selection" で起動に失敗するため、
|
|
20
19
|
# 強度はモデル ID だけで指定する(2026-09-21 実測: flash-high + --effort medium で失敗)。
|
|
21
20
|
# 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
|
|
22
21
|
# expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
|
|
23
|
-
command_template: '
|
|
22
|
+
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
24
23
|
# 従来の 1 段の名簿(model を持たない member)を使い続ける場合の補い方:
|
|
25
24
|
# command_params:
|
|
26
25
|
# by_proficiency:
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
{
|
|
2
|
+
"toolPermission": "request-review",
|
|
3
|
+
"permissions": {
|
|
4
|
+
"allow": [
|
|
5
|
+
"command(git status)",
|
|
6
|
+
"command(git diff)",
|
|
7
|
+
"command(git log)",
|
|
8
|
+
"command(git show)",
|
|
9
|
+
"command(npm run)",
|
|
10
|
+
"command(npm test)",
|
|
11
|
+
"command(npx prettier)",
|
|
12
|
+
"command(npx markdownlint)",
|
|
13
|
+
"command(specdojo catalog validate)"
|
|
14
|
+
],
|
|
15
|
+
"deny": [
|
|
16
|
+
"command(git add)",
|
|
17
|
+
"command(git commit)",
|
|
18
|
+
"command(git push)",
|
|
19
|
+
"command(gh)",
|
|
20
|
+
"command(/usr/bin/git push)",
|
|
21
|
+
"command(/usr/bin/gh)",
|
|
22
|
+
"command(/usr/local/bin/git push)",
|
|
23
|
+
"command(/usr/local/bin/gh)",
|
|
24
|
+
"command(git reset --hard)",
|
|
25
|
+
"command(rm -rf)",
|
|
26
|
+
"command(sudo)",
|
|
27
|
+
"read_file(.env)",
|
|
28
|
+
"read_file(secrets/)",
|
|
29
|
+
"write_file(.git/)",
|
|
30
|
+
"write_file(node_modules/)",
|
|
31
|
+
"write_file(.specdojo/specdojo.config.json)",
|
|
32
|
+
"write_file(.specdojo/exec-defaults.yaml)",
|
|
33
|
+
"write_file(.specdojo/index-config.yaml)",
|
|
34
|
+
"write_file(.specdojo/antigravity/)",
|
|
35
|
+
"write_file(.specdojo/claude/)",
|
|
36
|
+
"write_file(.specdojo/codex/)",
|
|
37
|
+
"write_file(.specdojo/copilot/)",
|
|
38
|
+
"write_file(.specdojo/opencode/)",
|
|
39
|
+
"write_file(.agents/rules/)",
|
|
40
|
+
"write_file(.agents/skills/)",
|
|
41
|
+
"write_file(.claude/)",
|
|
42
|
+
"write_file(.codex/)",
|
|
43
|
+
"write_file(.opencode/)",
|
|
44
|
+
"write_file(.github/agents/)",
|
|
45
|
+
"write_file(.github/workflows/)",
|
|
46
|
+
"write_file(.gitlab/ci/)",
|
|
47
|
+
"write_file(.circleci/)",
|
|
48
|
+
"write_file(.azure-pipelines/)",
|
|
49
|
+
"write_file(.jenkins/)",
|
|
50
|
+
"write_file(package.json)",
|
|
51
|
+
"write_file(AGENTS.md)",
|
|
52
|
+
"write_file(CLAUDE.md)",
|
|
53
|
+
"write_file(GEMINI.md)",
|
|
54
|
+
"write_file(lefthook.yml)",
|
|
55
|
+
"write_file(.lefthook.yml)",
|
|
56
|
+
"write_file(.gitlab-ci.yml)",
|
|
57
|
+
"write_file(.gitlab-ci.yaml)",
|
|
58
|
+
"write_file(azure-pipelines.yml)",
|
|
59
|
+
"write_file(azure-pipelines.yaml)",
|
|
60
|
+
"write_file(Jenkinsfile)",
|
|
61
|
+
"write_file(commitlint.config.js)",
|
|
62
|
+
"write_file(commitlint.config.cjs)",
|
|
63
|
+
"write_file(commitlint.config.mjs)",
|
|
64
|
+
"write_file(commitlint.config.ts)",
|
|
65
|
+
"write_file(.commitlintrc)",
|
|
66
|
+
"write_file(.commitlintrc.json)",
|
|
67
|
+
"write_file(.commitlintrc.yaml)",
|
|
68
|
+
"write_file(.commitlintrc.yml)",
|
|
69
|
+
"write_file(.specdojo/)",
|
|
70
|
+
"command(git config)"
|
|
71
|
+
]
|
|
72
|
+
}
|
|
73
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"toolPermission": "request-review",
|
|
3
|
+
"permissions": {
|
|
4
|
+
"allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
|
|
5
|
+
"deny": [
|
|
6
|
+
"read_file(.env)",
|
|
7
|
+
"read_file(secrets/)",
|
|
8
|
+
"write_file(.git/)",
|
|
9
|
+
"command(git push)",
|
|
10
|
+
"command(gh)",
|
|
11
|
+
"command(rm -rf)",
|
|
12
|
+
"command(sudo)"
|
|
13
|
+
]
|
|
14
|
+
}
|
|
15
|
+
}
|