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.
Files changed (137) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +100 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/generate.js +144 -13
  5. package/dist/commands/agent.js +33 -0
  6. package/dist/commands/init.js +2 -0
  7. package/dist/commands/orchestrator.js +10 -1
  8. package/dist/deliverable/deliverable.js +77 -4
  9. package/dist/devcontainer/command.js +18 -0
  10. package/dist/devcontainer/host-script.js +21 -0
  11. package/dist/devcontainer/scaffold.js +4 -3
  12. package/dist/exec/antigravity-session.js +154 -0
  13. package/dist/exec/core.js +1 -0
  14. package/dist/exec/parent-validation.js +14 -0
  15. package/dist/exec/plan-markdownlint.js +89 -0
  16. package/dist/exec/plans-core.js +46 -1
  17. package/dist/exec/plans-generation.js +45 -5
  18. package/dist/exec/plans-planning.js +1 -1
  19. package/dist/exec/plans-storage.js +1 -0
  20. package/dist/exec/product-branch-records.js +105 -0
  21. package/dist/exec/product-branches.js +52 -0
  22. package/dist/exec/register-product-message.js +50 -0
  23. package/dist/exec/register-resume.js +28 -0
  24. package/dist/exec/register.js +6 -0
  25. package/dist/exec/repo-integration-sync.js +4 -2
  26. package/dist/exec/repo-integration.js +41 -4
  27. package/dist/exec/repo-trace.js +2 -0
  28. package/dist/exec/results.js +9 -5
  29. package/dist/exec/run/lifecycle-commands.js +85 -16
  30. package/dist/exec/run/register-command.js +22 -0
  31. package/dist/exec/run/register-resume.js +11 -1
  32. package/dist/exec/run/register-worktree.js +29 -8
  33. package/dist/exec/run/schedule-mode.js +22 -2
  34. package/dist/exec/run/schedule-prepare.js +49 -4
  35. package/dist/exec/run/schedule-task.js +3 -0
  36. package/dist/exec/strategy.js +2 -1
  37. package/dist/exec/task-repos.js +78 -16
  38. package/dist/exec/worktree-command.js +2 -2
  39. package/dist/exec/worktree-ops-commit.js +1 -13
  40. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  41. package/dist/exec/worktree.js +3 -3
  42. package/dist/register/core.js +5 -0
  43. package/dist/register/create-commands.js +54 -2
  44. package/dist/register/deliverable-target.js +24 -17
  45. package/dist/register/event-merge.js +4 -0
  46. package/dist/register/events.js +6 -0
  47. package/dist/register/external-project.js +2 -0
  48. package/dist/register/input.js +168 -0
  49. package/dist/register/item.js +61 -0
  50. package/dist/register/register.js +33 -25
  51. package/dist/register/renumber.js +4 -0
  52. package/dist/register/update.js +6 -0
  53. package/dist/schedule/approach.js +9 -0
  54. package/dist/schedule/strategy-profiles.js +22 -2
  55. package/dist/shared/agent-types.js +4 -1
  56. package/dist/shared/branch-template.js +26 -0
  57. package/dist/shared/commit-message-template.js +38 -0
  58. package/dist/shared/commit-types.js +15 -0
  59. package/dist/shared/git.js +7 -0
  60. package/dist/shared/provider-scaffold.js +2 -0
  61. package/dist/shared/specdojo-config.js +35 -4
  62. package/dist/shared/specdojo-gitignore.js +1 -0
  63. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  64. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  65. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  66. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  67. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  68. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  69. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  70. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  71. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  72. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  73. package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
  74. package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
  75. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  76. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  77. package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
  78. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  79. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  80. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  81. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  82. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  83. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  84. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  85. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  86. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  87. package/docs/ja/specdojo/references/command-reference.md +111 -46
  88. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  89. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  90. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  91. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  92. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  93. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  94. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  95. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  96. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  97. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  98. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  99. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  100. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  101. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  102. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  103. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  104. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  105. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  106. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  107. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  108. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  109. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  110. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  111. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  112. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  113. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  114. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  115. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  116. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
  117. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  118. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  119. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  120. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
  121. package/package.json +6 -2
  122. package/templates/antigravity/README.md +19 -46
  123. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  124. package/templates/antigravity/orchestrator.md +2 -0
  125. package/templates/antigravity/settings.edit.json +73 -0
  126. package/templates/antigravity/settings.orchestrator.json +15 -0
  127. package/templates/antigravity/settings.report.json +7 -0
  128. package/templates/antigravity/settings.review.json +7 -0
  129. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  130. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  131. package/templates/codex/orchestrator.md +2 -0
  132. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  133. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
  134. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  135. package/templates/init-agent-members.yaml +1 -0
  136. package/templates/init-exec-defaults.yaml +1 -1
  137. 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
- ## 3. 対応方針
41
+ ## 4. 対応方針
36
42
 
37
43
  | 項目 | 内容 |
38
44
  | -------- | ------ |
@@ -41,10 +47,10 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
41
47
  | 依存事項 | _TODO_ |
42
48
  | 完了条件 | _TODO_ |
43
49
 
44
- ## 4. 対応結果
50
+ ## 5. 対応結果
45
51
 
46
52
  _TODO_: 解決内容、確認結果、再発防止策を記載する。未解決の場合は `-` とする。
47
53
 
48
- ## 5. 関連ドキュメント
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
- ## 3. 回答候補
35
+ ## 4. 回答候補
30
36
 
31
37
  | 候補 | 内容 | 利点 | 懸念 |
32
38
  | ---- | ------ | ------ | ------ |
33
39
  | A | _TODO_ | _TODO_ | _TODO_ |
34
40
 
35
- ## 4. 回答・結論
41
+ ## 5. 回答・結論
36
42
 
37
43
  _TODO_: 回答または採択した方針を記載する。未回答の場合は `-` とする。
38
44
 
39
- ## 5. 承認
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
- ## 6. 関連ドキュメント
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
- ## 3. 対応方針
40
+ ## 4. 対応方針
35
41
 
36
42
  | 項目 | 内容 |
37
43
  | ------------------ | ------------------------- |
@@ -40,10 +46,10 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
40
46
  | トリガー | _TODO_ |
41
47
  | エスカレーション先 | _TODO_ |
42
48
 
43
- ## 4. モニタリング
49
+ ## 5. モニタリング
44
50
 
45
51
  _TODO_: 監視周期、確認方法、状態更新の条件を記載する。
46
52
 
47
- ## 5. 関連ドキュメント
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
- ## 3. 作業内容
35
+ ## 4. 作業内容
30
36
 
31
37
  | No | 作業 | 担当 | 状態 | メモ |
32
38
  | --- | ------ | ------ | ---- | ---- |
33
39
  | 1 | _TODO_ | _TODO_ | open | - |
34
40
 
35
- ## 4. 対応結果
41
+ ## 5. 対応結果
36
42
 
37
43
  _TODO_: 完了時に、実施内容・成果物・残課題を記載する。未完了の場合は `-` とする。
38
44
 
39
- ## 5. 関連ドキュメント
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;
@@ -108,6 +108,8 @@ $defs:
108
108
  lint-ts,
109
109
  lint-fm,
110
110
  lint-md,
111
+ lint-mermaid,
112
+ lint-d2,
111
113
  build,
112
114
  format-check,
113
115
  ]
@@ -63,6 +63,7 @@ $defs:
63
63
  - status
64
64
  - title
65
65
  - description
66
+ - input
66
67
  - type
67
68
  - track
68
69
  - priority
@@ -81,6 +82,8 @@ $defs:
81
82
  - derived_from
82
83
  - depends_on
83
84
  - autopilot
85
+ - commit_type
86
+ - commit_scope
84
87
  from:
85
88
  type: string
86
89
  to:
@@ -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."
@@ -123,6 +123,7 @@ properties:
123
123
  type: string
124
124
  enum:
125
125
  - author-deliverable
126
+ - draft-with-context
126
127
  - bootstrap-kata-set
127
128
  - reflect-implementation
128
129
  - deduplicate-across-deliverables
@@ -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 exec branch for product-side PR review.
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.5.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` が配置するファイルの原本です。この README 自体はコピーされません。
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 --global --dry-run
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
- ```sh
27
- npx specdojo config scaffold --provider antigravity --global
19
+ ```yaml
20
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
28
21
  ```
29
22
 
30
- - `--global` を付けない通常の scaffold はユーザーディレクトリへ触れません。
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
- agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
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
- ## executor / reporter として使う
31
+ この入口は orchestrator プロファイルと選択 project の宣言済み repository を使い、cwd も `--add-dir` に加えます。保護設定の編集は利用者の承認に従い、秘密情報・Git metadata・push の制限は維持します。直接 `agy` を起動すると、この権限生成処理は適用されません。
59
32
 
60
- `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。
33
+ 既存利用者は command template と個別 command を上記へ移行し、`--dangerously-skip-permissions` を削除してください。既存 npm script は scaffold が上書きしないため、`orchestrator launch` 経由へ手動変更します。旧 `--global` は互換用途で残ります。既存ルールを自動で消さず、ユーザー設定をバックアップして自身の制限を役割プロファイルへ移してください。
61
34
 
62
- 名簿は実体と別名の 2 段で書きます。実体(`flash-executor`・`agy-opus-executor` など)は model の系統で名付け、model の ID を `model` に持ちます。従来の名前(`agy-executor`・`agy-claude-executor` など)は `aliases` で実体を指す別名にします。スニペット末尾の `aliases` の例は、向き先の member を有効にしたものだけを写します(別名は無効な member を指せません)。
35
+ `--settings` と既存グローバル・project 設定の配列マージは実機で未検証です。Claude と同等の隔離を確認したとは扱いません。仕様・移行・無害なファイルでの実機検証手順は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。実機の許可/拒否と、統合後の PJR-JSEY の証跡を記録してから運用へ適用します。
63
36
 
64
- 使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
37
+ モデル ID は `agy models` で確認し、推論強度を含むため `--effort` と併用しません。認証は利用者が別途行い、設定や成果物に資格情報を書きません。
@@ -7,20 +7,19 @@
7
7
 
8
8
  providers:
9
9
  antigravity:
10
- # Antigravity CLI(agy)は --agent による定義ファイルの選択を持たず、codex と同じく
11
- # プロンプト(plan)だけで役割を与える。-p はプロンプトを引数に取り stdin を読まないため、
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
- # 非対話実行で必要な command は、config scaffold --provider antigravity --global が
16
- # ~/.gemini/antigravity-cli/settings.json へ追記する。dangerously-skip-permissions は
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: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
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
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
5
+ "deny": ["write_file(*)", "command(*)", "unsandboxed(*)", "mcp(*)", "execute_url(*)"]
6
+ }
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "toolPermission": "request-review",
3
+ "permissions": {
4
+ "allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
5
+ "deny": ["write_file(*)", "command(*)", "unsandboxed(*)", "mcp(*)", "execute_url(*)"]
6
+ }
7
+ }
@@ -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>" \