specdojo 0.5.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/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +100 -0
- package/README.md +2 -2
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +2 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/deliverable/deliverable.js +77 -4
- 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/core.js +1 -0
- package/dist/exec/parent-validation.js +14 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-core.js +46 -1
- package/dist/exec/plans-generation.js +45 -5
- package/dist/exec/plans-planning.js +1 -1
- package/dist/exec/plans-storage.js +1 -0
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register-resume.js +28 -0
- package/dist/exec/register.js +6 -0
- package/dist/exec/repo-integration-sync.js +4 -2
- package/dist/exec/repo-integration.js +41 -4
- package/dist/exec/repo-trace.js +2 -0
- package/dist/exec/results.js +9 -5
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +22 -0
- package/dist/exec/run/register-resume.js +11 -1
- package/dist/exec/run/register-worktree.js +29 -8
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +49 -4
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/strategy.js +2 -1
- package/dist/exec/task-repos.js +78 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/exec/worktree.js +3 -3
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +54 -2
- package/dist/register/deliverable-target.js +24 -17
- package/dist/register/event-merge.js +4 -0
- package/dist/register/events.js +6 -0
- package/dist/register/external-project.js +2 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +61 -0
- package/dist/register/register.js +33 -25
- package/dist/register/renumber.js +4 -0
- package/dist/register/update.js +6 -0
- package/dist/schedule/approach.js +9 -0
- package/dist/schedule/strategy-profiles.js +22 -2
- package/dist/shared/agent-types.js +4 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -0
- package/dist/shared/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-config.js +35 -4
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
- 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 +16 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-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/recipes/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
- package/docs/ja/specdojo/references/command-reference.md +111 -46
- package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
- 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/rulebooks/dct-rulebook.md +8 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
- 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/samples/dct-sample.yaml +5 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
- package/package.json +6 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +2 -0
- 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/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
- 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
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -22,7 +22,13 @@ specdojo:
|
|
|
22
22
|
|
|
23
23
|
_TODO_: すでに顕在化している問題、発生日、影響を記載する。
|
|
24
24
|
|
|
25
|
-
## 2.
|
|
25
|
+
## 2. 入力
|
|
26
|
+
|
|
27
|
+
<!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
|
|
28
|
+
|
|
29
|
+
-
|
|
30
|
+
|
|
31
|
+
## 3. 影響範囲
|
|
26
32
|
|
|
27
33
|
| 観点 | 影響 |
|
|
28
34
|
| ------------ | ------ |
|
|
@@ -32,7 +38,7 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
|
|
|
32
38
|
| 品質 | _TODO_ |
|
|
33
39
|
| 関係者 | _TODO_ |
|
|
34
40
|
|
|
35
|
-
##
|
|
41
|
+
## 4. 対応方針
|
|
36
42
|
|
|
37
43
|
| 項目 | 内容 |
|
|
38
44
|
| -------- | ------ |
|
|
@@ -41,10 +47,10 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
|
|
|
41
47
|
| 依存事項 | _TODO_ |
|
|
42
48
|
| 完了条件 | _TODO_ |
|
|
43
49
|
|
|
44
|
-
##
|
|
50
|
+
## 5. 対応結果
|
|
45
51
|
|
|
46
52
|
_TODO_: 解決内容、確認結果、再発防止策を記載する。未解決の場合は `-` とする。
|
|
47
53
|
|
|
48
|
-
##
|
|
54
|
+
## 6. 関連ドキュメント
|
|
49
55
|
|
|
50
56
|
- _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
|
|
@@ -22,21 +22,27 @@ specdojo:
|
|
|
22
22
|
|
|
23
23
|
_TODO_: 確認したい論点を、回答者が判断できる粒度で記載する。
|
|
24
24
|
|
|
25
|
-
## 2.
|
|
25
|
+
## 2. 入力
|
|
26
|
+
|
|
27
|
+
<!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
|
|
28
|
+
|
|
29
|
+
-
|
|
30
|
+
|
|
31
|
+
## 3. 背景
|
|
26
32
|
|
|
27
33
|
_TODO_: この確認が必要になった背景、前提、制約を記載する。
|
|
28
34
|
|
|
29
|
-
##
|
|
35
|
+
## 4. 回答候補
|
|
30
36
|
|
|
31
37
|
| 候補 | 内容 | 利点 | 懸念 |
|
|
32
38
|
| ---- | ------ | ------ | ------ |
|
|
33
39
|
| A | _TODO_ | _TODO_ | _TODO_ |
|
|
34
40
|
|
|
35
|
-
##
|
|
41
|
+
## 5. 回答・結論
|
|
36
42
|
|
|
37
43
|
_TODO_: 回答または採択した方針を記載する。未回答の場合は `-` とする。
|
|
38
44
|
|
|
39
|
-
##
|
|
45
|
+
## 6. 承認
|
|
40
46
|
|
|
41
47
|
| 項目 | 内容 |
|
|
42
48
|
| -------- | ------ |
|
|
@@ -48,6 +54,6 @@ _TODO_: 回答または採択した方針を記載する。未回答の場合は
|
|
|
48
54
|
- 承認方式は既定で `commit`(`register close` により `decided` へ遷移)を用いる。
|
|
49
55
|
- 回答が不可逆・高リスク・framework schema 破壊的変更を伴う場合は `PR` 方式で承認し、証跡に PR URL と merge SHA を記載する。
|
|
50
56
|
|
|
51
|
-
##
|
|
57
|
+
## 7. 関連ドキュメント
|
|
52
58
|
|
|
53
59
|
- _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
|
|
@@ -22,7 +22,13 @@ specdojo:
|
|
|
22
22
|
|
|
23
23
|
_TODO_: 将来発生し得る不確実な事象と、その原因を記載する。
|
|
24
24
|
|
|
25
|
-
## 2.
|
|
25
|
+
## 2. 入力
|
|
26
|
+
|
|
27
|
+
<!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
|
|
28
|
+
|
|
29
|
+
-
|
|
30
|
+
|
|
31
|
+
## 3. 影響評価
|
|
26
32
|
|
|
27
33
|
| 項目 | 評価 |
|
|
28
34
|
| -------- | ------------------- |
|
|
@@ -31,7 +37,7 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
|
|
|
31
37
|
| 影響範囲 | _TODO_ |
|
|
32
38
|
| 兆候 | _TODO_ |
|
|
33
39
|
|
|
34
|
-
##
|
|
40
|
+
## 4. 対応方針
|
|
35
41
|
|
|
36
42
|
| 項目 | 内容 |
|
|
37
43
|
| ------------------ | ------------------------- |
|
|
@@ -40,10 +46,10 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
|
|
|
40
46
|
| トリガー | _TODO_ |
|
|
41
47
|
| エスカレーション先 | _TODO_ |
|
|
42
48
|
|
|
43
|
-
##
|
|
49
|
+
## 5. モニタリング
|
|
44
50
|
|
|
45
51
|
_TODO_: 監視周期、確認方法、状態更新の条件を記載する。
|
|
46
52
|
|
|
47
|
-
##
|
|
53
|
+
## 6. 関連ドキュメント
|
|
48
54
|
|
|
49
55
|
- _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
|
|
@@ -22,20 +22,26 @@ specdojo:
|
|
|
22
22
|
|
|
23
23
|
_TODO_: 実施すべき作業と、その作業が必要になった理由を 1〜3 文で記載する。
|
|
24
24
|
|
|
25
|
-
## 2.
|
|
25
|
+
## 2. 入力
|
|
26
|
+
|
|
27
|
+
<!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
|
|
28
|
+
|
|
29
|
+
-
|
|
30
|
+
|
|
31
|
+
## 3. 完了条件
|
|
26
32
|
|
|
27
33
|
- _TODO_: 完了と判断できる具体的な条件を記載する。
|
|
28
34
|
|
|
29
|
-
##
|
|
35
|
+
## 4. 作業内容
|
|
30
36
|
|
|
31
37
|
| No | 作業 | 担当 | 状態 | メモ |
|
|
32
38
|
| --- | ------ | ------ | ---- | ---- |
|
|
33
39
|
| 1 | _TODO_ | _TODO_ | open | - |
|
|
34
40
|
|
|
35
|
-
##
|
|
41
|
+
## 5. 対応結果
|
|
36
42
|
|
|
37
43
|
_TODO_: 完了時に、実施内容・成果物・残課題を記載する。未完了の場合は `-` とする。
|
|
38
44
|
|
|
39
|
-
##
|
|
45
|
+
## 6. 関連ドキュメント
|
|
40
46
|
|
|
41
47
|
- _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
|
|
@@ -300,6 +300,15 @@ $defs:
|
|
|
300
300
|
minLength: 1
|
|
301
301
|
description: "One-sentence description of the deliverable's purpose."
|
|
302
302
|
|
|
303
|
+
brief:
|
|
304
|
+
type: string
|
|
305
|
+
minLength: 1
|
|
306
|
+
description: >
|
|
307
|
+
Optional assumptions or context passed continuously from outside the deliverable
|
|
308
|
+
(e.g., tech stack, architecture constraints, baseline policies).
|
|
309
|
+
Populates the plan's brief field for schedule and register paths.
|
|
310
|
+
Multiple deliverables may share a brief via YAML anchors (&anchor / *anchor).
|
|
311
|
+
|
|
303
312
|
path:
|
|
304
313
|
type: string
|
|
305
314
|
pattern: "^[^\\s]+$"
|
|
@@ -48,6 +48,7 @@ $defs:
|
|
|
48
48
|
type: string
|
|
49
49
|
enum:
|
|
50
50
|
[
|
|
51
|
+
"draft",
|
|
51
52
|
"fully-guided",
|
|
52
53
|
"recipe-guided",
|
|
53
54
|
"freeform",
|
|
@@ -69,7 +70,7 @@ $defs:
|
|
|
69
70
|
]
|
|
70
71
|
description: >
|
|
71
72
|
How the task is carried out. catalog-planning and strategy-planning create a catalog
|
|
72
|
-
or schedule strategy from register-only domain:<id> / track:<id> targets. fully-guided/recipe-guided/freeform describe how strictly
|
|
73
|
+
or schedule strategy from register-only domain:<id> / track:<id> targets. draft researches and drafts within delegated context; fully-guided refines existing deliverables using declared references. fully-guided/recipe-guided/freeform describe how strictly
|
|
73
74
|
the agent follows reference materials (rulebook/recipe/sample/template) when working on
|
|
74
75
|
a deliverable. bootstrap authors the deliverable and its full reference set
|
|
75
76
|
(rulebook/recipe/sample/template) together in one task as a mutually consistent whole;
|
|
@@ -99,6 +99,7 @@ properties:
|
|
|
99
99
|
approach:
|
|
100
100
|
enum:
|
|
101
101
|
[
|
|
102
|
+
draft,
|
|
102
103
|
fully-guided,
|
|
103
104
|
recipe-guided,
|
|
104
105
|
freeform,
|
|
@@ -262,6 +263,18 @@ properties:
|
|
|
262
263
|
Human approval that the item's stated completion conditions may be executed by the
|
|
263
264
|
night orchestrator. Omit the key to keep the item out of the approved queue.
|
|
264
265
|
|
|
266
|
+
commit_type:
|
|
267
|
+
$ref: "#/$defs/CommitType"
|
|
268
|
+
description: >
|
|
269
|
+
Conventional Commits type for commits generated from this item.
|
|
270
|
+
Omit the key to derive it from item_type and configuration.
|
|
271
|
+
|
|
272
|
+
commit_scope:
|
|
273
|
+
$ref: "#/$defs/CommitScope"
|
|
274
|
+
description: >
|
|
275
|
+
Conventional Commits scope for commits generated from this item.
|
|
276
|
+
Omit the key when no scope applies.
|
|
277
|
+
|
|
265
278
|
approach:
|
|
266
279
|
$ref: "#/$defs/Approach"
|
|
267
280
|
description: >
|
|
@@ -368,6 +381,7 @@ $defs:
|
|
|
368
381
|
Approach:
|
|
369
382
|
type: string
|
|
370
383
|
enum:
|
|
384
|
+
- draft
|
|
371
385
|
- fully-guided
|
|
372
386
|
- recipe-guided
|
|
373
387
|
- freeform
|
|
@@ -413,3 +427,24 @@ $defs:
|
|
|
413
427
|
type: string
|
|
414
428
|
pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
|
|
415
429
|
description: "Project-qualified display id of a register item in another project."
|
|
430
|
+
|
|
431
|
+
CommitType:
|
|
432
|
+
type: string
|
|
433
|
+
enum:
|
|
434
|
+
- feat
|
|
435
|
+
- fix
|
|
436
|
+
- docs
|
|
437
|
+
- refactor
|
|
438
|
+
- test
|
|
439
|
+
- chore
|
|
440
|
+
- perf
|
|
441
|
+
- build
|
|
442
|
+
- ci
|
|
443
|
+
- style
|
|
444
|
+
- revert
|
|
445
|
+
description: "Conventional Commits type."
|
|
446
|
+
|
|
447
|
+
CommitScope:
|
|
448
|
+
type: string
|
|
449
|
+
pattern: "^[a-z0-9][a-z0-9-]*$"
|
|
450
|
+
description: "Conventional Commits scope."
|
|
@@ -50,6 +50,8 @@ $defs:
|
|
|
50
50
|
lint-ts,
|
|
51
51
|
lint-fm,
|
|
52
52
|
lint-md,
|
|
53
|
+
lint-mermaid,
|
|
54
|
+
lint-d2,
|
|
53
55
|
build,
|
|
54
56
|
format-check,
|
|
55
57
|
]
|
|
@@ -99,6 +101,10 @@ $defs:
|
|
|
99
101
|
type: array
|
|
100
102
|
items:
|
|
101
103
|
$ref: "#/$defs/NonEmptyString"
|
|
104
|
+
commit_types:
|
|
105
|
+
description: >-
|
|
106
|
+
Mapping from register item types to Conventional Commits types for this project.
|
|
107
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
102
108
|
repos:
|
|
103
109
|
description: >-
|
|
104
110
|
Product repositories that tasks of this project may change. The project repository is
|
|
@@ -148,10 +154,19 @@ $defs:
|
|
|
148
154
|
integration_branch:
|
|
149
155
|
description: Branch exec integrates into. Omit to use the repository's current branch.
|
|
150
156
|
$ref: "#/$defs/NonEmptyString"
|
|
157
|
+
branch_template:
|
|
158
|
+
description: Product work branch template; must contain id or topic. Expanded values must be valid Git branch names.
|
|
159
|
+
type: string
|
|
160
|
+
default: "exec/{project}-{id}"
|
|
161
|
+
allOf:
|
|
162
|
+
- pattern: '\{(?:id|topic)\}'
|
|
163
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title)\})*$'
|
|
164
|
+
- not:
|
|
165
|
+
pattern: '[\s\u0000-\u001f\u007f~^:?*\[\\]|\.\.|@\{|^[-/]|/$|//|\.$|(^|/)\.|\.lock(/|$)'
|
|
151
166
|
integration_strategy:
|
|
152
|
-
description: Local merge commit (default), or retain the
|
|
167
|
+
description: Local merge commit (default), fast-forward only, or retain the branch for product-side PR review.
|
|
153
168
|
type: string
|
|
154
|
-
enum: [merge, branch-only]
|
|
169
|
+
enum: [merge, branch-only, ff]
|
|
155
170
|
default: merge
|
|
156
171
|
setup:
|
|
157
172
|
description: Whether exec installs dependencies and builds in the repository worktree.
|
|
@@ -162,6 +177,23 @@ $defs:
|
|
|
162
177
|
type: boolean
|
|
163
178
|
build:
|
|
164
179
|
type: boolean
|
|
180
|
+
commit_types:
|
|
181
|
+
description: >-
|
|
182
|
+
Mapping from register item types to Conventional Commits types for this repository.
|
|
183
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
184
|
+
commit_subject_template:
|
|
185
|
+
description: >-
|
|
186
|
+
Product commit subject. Omit to retain exec(register <ID>): <title>.
|
|
187
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
188
|
+
merge_message_template:
|
|
189
|
+
description: >-
|
|
190
|
+
Product merge message. Omit to retain exec(register <ID>): <title>. Refs is always appended.
|
|
191
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
192
|
+
CommitMessageTemplate:
|
|
193
|
+
type: string
|
|
194
|
+
allOf:
|
|
195
|
+
- pattern: '\S'
|
|
196
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title|branch|target)\})*$'
|
|
165
197
|
Run:
|
|
166
198
|
type: object
|
|
167
199
|
properties:
|
|
@@ -195,3 +227,10 @@ $defs:
|
|
|
195
227
|
type: string
|
|
196
228
|
register_date_timezone:
|
|
197
229
|
type: string
|
|
230
|
+
CommitTypeMap:
|
|
231
|
+
type: object
|
|
232
|
+
description: >-
|
|
233
|
+
Mapping from register item type (e.g., todo, issue) to Conventional Commits type (e.g., feat, fix).
|
|
234
|
+
additionalProperties:
|
|
235
|
+
type: string
|
|
236
|
+
enum: [feat, fix, docs, refactor, test, chore, perf, build, ci, style, revert]
|
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",
|
|
@@ -93,6 +95,8 @@
|
|
|
93
95
|
"docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
|
|
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",
|
|
98
|
+
"lint:mermaid": "node tools/lint-mermaid.mjs",
|
|
99
|
+
"lint:d2": "node tools/lint-d2.mjs",
|
|
96
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",
|
|
97
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",
|
|
98
102
|
"validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
|
|
@@ -101,7 +105,7 @@
|
|
|
101
105
|
"validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
|
|
102
106
|
"validate:catalog": "tsx src/specdojo.ts catalog validate",
|
|
103
107
|
"validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
|
|
104
|
-
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && 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",
|
|
105
109
|
"check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
|
|
106
110
|
"dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
|
|
107
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:
|
|
@@ -98,6 +98,8 @@ type は次のように使い分ける。
|
|
|
98
98
|
|
|
99
99
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
100
100
|
|
|
101
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
102
|
+
|
|
101
103
|
```bash
|
|
102
104
|
npx specdojo register add --project <project-id> \
|
|
103
105
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -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
|
+
}
|
|
@@ -105,6 +105,8 @@ type は次のように使い分ける。
|
|
|
105
105
|
|
|
106
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
107
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
108
110
|
```bash
|
|
109
111
|
npx specdojo register add --project <project-id> \
|
|
110
112
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -105,6 +105,8 @@ type は次のように使い分ける。
|
|
|
105
105
|
|
|
106
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
107
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
108
110
|
```bash
|
|
109
111
|
npx specdojo register add --project <project-id> \
|
|
110
112
|
--type todo --title "<title>" --description "<description>" \
|