specdojo 0.2.1 → 0.3.1
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 +165 -0
- package/CHANGELOG.md +298 -0
- package/README.md +92 -42
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/catalog-build-references.js +144 -0
- package/dist/catalog-build-render.js +144 -0
- package/dist/catalog-build.js +13 -290
- package/dist/catalog-generate.js +6 -9
- package/dist/catalog-plan-generate.js +2 -2
- package/dist/catalog-plan.js +6 -6
- package/dist/catalog-scaffold.js +4 -4
- package/dist/catalog.js +2 -2
- package/dist/dashboard-exec-records.js +105 -0
- package/dist/dashboard-routines.js +255 -0
- package/dist/dashboard-shared.js +14 -0
- package/dist/dashboard-timeline.js +175 -0
- package/dist/dashboard.js +31 -444
- package/dist/deliverable-trash.js +3 -3
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/doc-index.js +3 -3
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-commands.js +557 -0
- package/dist/exec-core.js +457 -0
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans-core.js +693 -0
- package/dist/exec-plans-generation.js +206 -0
- package/dist/exec-plans-storage.js +131 -0
- package/dist/exec-plans.js +3 -1016
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration-git.js +23 -0
- package/dist/exec-repo-integration-sync.js +264 -0
- package/dist/exec-repo-integration.js +534 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter-output.js +206 -0
- package/dist/exec-reporter.js +525 -248
- package/dist/exec-results.js +103 -71
- package/dist/exec-run-agent-pipeline.js +256 -0
- package/dist/exec-run-agent.js +531 -0
- package/dist/exec-run-in-place.js +541 -0
- package/dist/exec-run-job.js +717 -0
- package/dist/exec-run-lifecycle-commands.js +522 -0
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run-mode-shared.js +140 -0
- package/dist/exec-run-register-command.js +244 -0
- package/dist/exec-run-register-core.js +386 -0
- package/dist/exec-run-register-mode.js +206 -0
- package/dist/exec-run-register-resume.js +393 -0
- package/dist/exec-run-register-state.js +322 -0
- package/dist/exec-run-register-worktree.js +509 -0
- package/dist/exec-run-schedule-mode.js +294 -0
- package/dist/exec-run-schedule-prepare.js +353 -0
- package/dist/exec-run-schedule-task.js +572 -0
- package/dist/exec-run-shared.js +399 -0
- package/dist/exec-run.js +11 -4953
- package/dist/exec-shared.js +9 -2
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial-commands.js +558 -0
- package/dist/exec-trial-core.js +371 -0
- package/dist/exec-trial.js +2 -895
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops-commit.js +707 -0
- package/dist/exec-worktree-ops-lifecycle.js +292 -0
- package/dist/exec-worktree-ops-merge.js +303 -0
- package/dist/exec-worktree-ops.js +3 -847
- package/dist/exec-worktree.js +146 -31
- package/dist/exec.js +2 -999
- package/dist/frontmatter-namespace.js +2 -2
- package/dist/grade-apply.js +734 -0
- package/dist/grade-command-apply.js +250 -0
- package/dist/grade-command-inspect.js +138 -0
- package/dist/grade-command-plan.js +101 -0
- package/dist/grade-command-shared.js +68 -0
- package/dist/grade-core.js +307 -0
- package/dist/grade-markdown.js +274 -0
- package/dist/grade-pipeline-state.js +184 -0
- package/dist/grade-plan.js +507 -0
- package/dist/grade-result.js +133 -5
- package/dist/grade-target-discovery.js +265 -0
- package/dist/grade-targets.js +432 -0
- package/dist/grade.js +14 -2451
- package/dist/init-command.js +443 -0
- package/dist/job-definition.js +670 -0
- package/dist/job.js +64 -578
- package/dist/kata-command.js +2 -2
- package/dist/orchestrator.js +213 -0
- package/dist/register-command-types.js +1 -0
- package/dist/register-core.js +363 -0
- package/dist/register-create-commands.js +245 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-events.js +4 -4
- package/dist/register-item.js +13 -7
- package/dist/register-maintenance-commands.js +187 -0
- package/dist/register-migration.js +268 -0
- package/dist/register-renumber.js +314 -0
- package/dist/register-transition-commands.js +248 -0
- package/dist/register-update.js +230 -0
- package/dist/register-views.js +256 -0
- package/dist/register.js +175 -1975
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +114 -4
- package/dist/review-types.js +40 -1
- package/dist/routine-definition.js +401 -0
- package/dist/routine.js +73 -402
- package/dist/schedule-approach.js +2 -2
- package/dist/schedule-build.js +2 -2
- package/dist/schedule-strategy-generate-document.js +273 -0
- package/dist/schedule-strategy-generate-scope.js +199 -0
- package/dist/schedule-strategy-generate.js +9 -473
- package/dist/schedule.js +19 -6
- package/dist/specdojo-config.js +465 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/dist/yaml-pages.js +4 -4
- package/dist/yaml.js +28 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +335 -92
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +17 -12
- package/templates/antigravity/README.md +29 -4
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
- package/templates/antigravity/orchestrator.md +18 -7
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +18 -7
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
- package/templates/codex/orchestrator.md +18 -7
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +74 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
|
@@ -8,14 +8,39 @@
|
|
|
8
8
|
| ---------------------------- | -------------------------------------------------- |
|
|
9
9
|
| `orchestrator.md` | `.specdojo/antigravity/orchestrator.md` |
|
|
10
10
|
| `exec-defaults-snippet.yaml` | `.specdojo/antigravity/exec-defaults-snippet.yaml` |
|
|
11
|
-
| `
|
|
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` へ追加されるルールだけを差分表示します。
|
|
19
|
+
|
|
20
|
+
```sh
|
|
21
|
+
npx specdojo config scaffold --provider antigravity --global --dry-run
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
内容を確認してから適用します。
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
npx specdojo config scaffold --provider antigravity --global
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- `--global` を付けない通常の scaffold はユーザーディレクトリへ触れません。
|
|
31
|
+
- `permissions.allow` / `deny` / `ask` の既存要素と、それ以外のユーザー設定を保持し、不足するルールだけを末尾へ追加します。
|
|
32
|
+
- 書き換え前のファイルは `settings.json.backup-<timestamp>` へ退避します。設定ファイルがまだ無い場合は新規作成し、バックアップは作りません。
|
|
33
|
+
- 既存 JSON や permission 配列の形式が不正な場合は、バックアップも書き込みも行わずエラーにします。
|
|
34
|
+
- `--force` はリポジトリ内の配布物だけに作用し、グローバル設定の既存項目を上書きしません。
|
|
35
|
+
|
|
36
|
+
権限原本は、必要な検証コマンドを allow し、`git push`、破壊的コマンド、秘密情報、親 runner・hook・CI・agent 設定を変更できるパスを deny します。`.specdojo/doc-index.json` のような既知の生成物は検証で更新できるよう、`.specdojo/` 全体ではなく設定ファイルと provider ディレクトリを個別に deny します。provider 非依存の実行後ガードも併用されます。
|
|
12
37
|
|
|
13
38
|
## オーケストレーターの起動
|
|
14
39
|
|
|
15
40
|
Antigravity CLI(`agy`)はファイル定義の agent を持たないため、`--agent <name>` では起動できません。規範の本文を `-i` で渡します。
|
|
16
41
|
|
|
17
42
|
```sh
|
|
18
|
-
agy --add-dir "$(pwd)" --model gemini-3.
|
|
43
|
+
agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
|
|
19
44
|
```
|
|
20
45
|
|
|
21
46
|
`--add-dir "$(pwd)"` を付けないと、作業ディレクトリのファイルを読み書きできず、`AGENTS.md` と `.agents/rules/*.md` も読み込まれません。
|
|
@@ -25,11 +50,11 @@ agy --add-dir "$(pwd)" --model gemini-3.1-pro-high -i "$(cat .specdojo/antigravi
|
|
|
25
50
|
```json
|
|
26
51
|
{
|
|
27
52
|
"scripts": {
|
|
28
|
-
"orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.
|
|
53
|
+
"orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
|
|
29
54
|
}
|
|
30
55
|
}
|
|
31
56
|
```
|
|
32
57
|
|
|
33
58
|
## executor / reporter として使う
|
|
34
59
|
|
|
35
|
-
`exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`
|
|
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` へ書きません。使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
|
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# Antigravity CLI(agy)
|
|
2
|
-
#
|
|
1
|
+
# Antigravity CLI(agy)agent 定義のスニペット。
|
|
2
|
+
# members の要素をリポジトリ共通の .specdojo/agent-members.yaml へコピーして使う。
|
|
3
|
+
# project ごとの pm-members.yaml は人間専用なので、agent は記載しない。
|
|
3
4
|
# 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
|
|
4
5
|
# providers.antigravity.command_template で定義する(exec-defaults-snippet.yaml を参照)。
|
|
5
6
|
# モデルの差し替えは command_params.by_nickname で行う。
|
|
6
7
|
# 既定では disabled にしてある。使う member だけ disabled を外す。
|
|
7
8
|
|
|
9
|
+
version: 1
|
|
8
10
|
members:
|
|
9
11
|
- nickname: agy-executor
|
|
10
12
|
disabled: true
|
|
@@ -17,6 +19,7 @@ members:
|
|
|
17
19
|
mode: edit
|
|
18
20
|
proficiency: normal
|
|
19
21
|
persona: task-executor
|
|
22
|
+
capabilities: []
|
|
20
23
|
|
|
21
24
|
- nickname: agy-expert-executor
|
|
22
25
|
disabled: true
|
|
@@ -29,6 +32,7 @@ members:
|
|
|
29
32
|
mode: edit
|
|
30
33
|
proficiency: expert
|
|
31
34
|
persona: task-executor
|
|
35
|
+
capabilities: []
|
|
32
36
|
|
|
33
37
|
- nickname: agy-expert-review-executor
|
|
34
38
|
disabled: true
|
|
@@ -41,6 +45,7 @@ members:
|
|
|
41
45
|
mode: review
|
|
42
46
|
proficiency: expert
|
|
43
47
|
persona: reviewer
|
|
48
|
+
capabilities: []
|
|
44
49
|
|
|
45
50
|
- nickname: agy-reporter
|
|
46
51
|
disabled: true
|
|
@@ -53,3 +58,4 @@ members:
|
|
|
53
58
|
mode: report
|
|
54
59
|
proficiency: normal
|
|
55
60
|
persona: reporter
|
|
61
|
+
capabilities: []
|
|
@@ -11,22 +11,25 @@ providers:
|
|
|
11
11
|
# runner が stdin へ書く plan を "$(cat)" で引数に渡す(shell: true で実行される)。
|
|
12
12
|
# --sandbox は書き込み先を ~/.gemini 配下の scratch へ逃がすため、--add-dir で作業
|
|
13
13
|
# ディレクトリ(worktree)を明示して成果物へ書けるようにする(2026-09-21 実測)。
|
|
14
|
-
# --
|
|
15
|
-
#
|
|
14
|
+
# 非対話実行で必要な command は、config scaffold --provider antigravity --global が
|
|
15
|
+
# ~/.gemini/antigravity-cli/settings.json へ追記する。dangerously-skip-permissions は
|
|
16
|
+
# deny rule も含めた承認境界を迂回するため使わない。
|
|
16
17
|
# agy のモデル ID は推論強度を含む(gemini-3.8-flash-{high,medium,low} など)。--effort を
|
|
17
18
|
# 併用すると ID と食い違ったときに "invalid model selection" で起動に失敗するため、
|
|
18
19
|
# 強度はモデル ID だけで指定する(2026-09-21 実測: flash-high + --effort medium で失敗)。
|
|
19
|
-
|
|
20
|
+
# 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
|
|
21
|
+
# expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
|
|
22
|
+
command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
|
|
20
23
|
command_params:
|
|
21
24
|
by_proficiency:
|
|
22
25
|
normal: { model: gemini-3.8-flash-medium }
|
|
23
|
-
expert: { model: gemini-3.
|
|
26
|
+
expert: { model: gemini-3.8-flash-high }
|
|
24
27
|
# Gemini 以外の Antigravity 提供モデルは member nickname で明示的に選ぶ。
|
|
25
28
|
# by_nickname は proficiency / mode の既定値より優先される。
|
|
26
29
|
by_nickname:
|
|
27
|
-
agy-
|
|
28
|
-
agy-
|
|
29
|
-
agy-
|
|
30
|
+
agy-claude-executor: { model: claude-sonnet-5-5-medium }
|
|
31
|
+
agy-claude-expert-executor: { model: claude-opus-5-5-high }
|
|
32
|
+
agy-claude-expert-review-executor: { model: claude-opus-5-5-high }
|
|
30
33
|
agy-gpt-executor: { model: gpt-oss-120b-medium }
|
|
31
34
|
# Gemini API の制限文言は未観測。429 / quota / RESOURCE_EXHAUSTED を初期値とし、
|
|
32
35
|
# 実観測した文言で更新する(observed-agent-limit-stderr と同じ扱い)。
|
|
@@ -10,16 +10,17 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
10
10
|
- コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
11
11
|
- 破壊的変更や `git push` は行わない。
|
|
12
12
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
13
|
-
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
|
|
13
|
+
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
14
14
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
15
15
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
16
16
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
17
17
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
18
18
|
- `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
|
|
19
19
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
20
|
-
- commit メッセージは subject を日本語で書き、conventional commit の type と scope
|
|
20
|
+
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
21
21
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
22
22
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
23
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
23
24
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
24
25
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
25
26
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -79,28 +80,38 @@ type は次のように使い分ける。
|
|
|
79
80
|
| `question` | 判断を保留し、後で決める | `decided` |
|
|
80
81
|
| `risk` | 将来の不確実性 | `done` |
|
|
81
82
|
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
82
|
-
| `note` | 記録として残す観測・分析 |
|
|
83
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
83
84
|
|
|
84
|
-
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic`
|
|
85
|
+
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
85
86
|
|
|
86
87
|
```bash
|
|
87
88
|
npx specdojo register add --project <project-id> \
|
|
88
89
|
--type todo --title "<title>" --description "<description>" \
|
|
89
|
-
--priority high --owner DEV --due <YYYY-MM-DD>
|
|
90
|
+
--topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
|
|
90
91
|
```
|
|
91
92
|
|
|
93
|
+
起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
|
|
94
|
+
|
|
95
|
+
起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
|
|
96
|
+
|
|
92
97
|
起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
|
|
93
98
|
|
|
94
99
|
状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
|
|
95
100
|
|
|
101
|
+
記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
|
|
102
|
+
|
|
96
103
|
```bash
|
|
97
104
|
npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
98
|
-
--conclusion "<結論>" --by <actor> --reason "<理由>"
|
|
99
|
-
|
|
105
|
+
--conclusion "<結論>" --by <actor> --reason "<理由>" \
|
|
106
|
+
--commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
|
|
100
107
|
```
|
|
101
108
|
|
|
109
|
+
`-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
|
|
110
|
+
|
|
102
111
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
103
112
|
|
|
113
|
+
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
114
|
+
|
|
104
115
|
## 実践の型(kata)の扱い
|
|
105
116
|
|
|
106
117
|
rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
{
|
|
2
|
+
"permissions": {
|
|
3
|
+
"allow": ["command(git status)", "command(git diff)", "command(git log)", "command(git show)"],
|
|
4
|
+
"deny": [
|
|
5
|
+
"command(git add)",
|
|
6
|
+
"command(git commit)",
|
|
7
|
+
"command(git push)",
|
|
8
|
+
"command(git reset --hard)",
|
|
9
|
+
"command(rm -rf)",
|
|
10
|
+
"command(sudo)",
|
|
11
|
+
"read_file(.env)",
|
|
12
|
+
"read_file(secrets/)",
|
|
13
|
+
"write_file(.git/)",
|
|
14
|
+
"write_file(node_modules/)",
|
|
15
|
+
"write_file(.specdojo/specdojo.config.json)",
|
|
16
|
+
"write_file(.specdojo/exec-defaults.yaml)",
|
|
17
|
+
"write_file(.specdojo/index-config.yaml)",
|
|
18
|
+
"write_file(.specdojo/antigravity/)",
|
|
19
|
+
"write_file(.specdojo/claude/)",
|
|
20
|
+
"write_file(.specdojo/codex/)",
|
|
21
|
+
"write_file(.specdojo/copilot/)",
|
|
22
|
+
"write_file(.specdojo/opencode/)",
|
|
23
|
+
"write_file(.agents/rules/)",
|
|
24
|
+
"write_file(.agents/skills/)",
|
|
25
|
+
"write_file(.claude/)",
|
|
26
|
+
"write_file(.codex/)",
|
|
27
|
+
"write_file(.opencode/)",
|
|
28
|
+
"write_file(.github/agents/)",
|
|
29
|
+
"write_file(.github/workflows/)",
|
|
30
|
+
"write_file(.gitlab/ci/)",
|
|
31
|
+
"write_file(.circleci/)",
|
|
32
|
+
"write_file(.azure-pipelines/)",
|
|
33
|
+
"write_file(.jenkins/)",
|
|
34
|
+
"write_file(package.json)",
|
|
35
|
+
"write_file(AGENTS.md)",
|
|
36
|
+
"write_file(CLAUDE.md)",
|
|
37
|
+
"write_file(GEMINI.md)",
|
|
38
|
+
"write_file(lefthook.yml)",
|
|
39
|
+
"write_file(.lefthook.yml)",
|
|
40
|
+
"write_file(.gitlab-ci.yml)",
|
|
41
|
+
"write_file(.gitlab-ci.yaml)",
|
|
42
|
+
"write_file(azure-pipelines.yml)",
|
|
43
|
+
"write_file(azure-pipelines.yaml)",
|
|
44
|
+
"write_file(Jenkinsfile)",
|
|
45
|
+
"write_file(commitlint.config.js)",
|
|
46
|
+
"write_file(commitlint.config.cjs)",
|
|
47
|
+
"write_file(commitlint.config.mjs)",
|
|
48
|
+
"write_file(commitlint.config.ts)",
|
|
49
|
+
"write_file(.commitlintrc)",
|
|
50
|
+
"write_file(.commitlintrc.json)",
|
|
51
|
+
"write_file(.commitlintrc.yaml)",
|
|
52
|
+
"write_file(.commitlintrc.yml)"
|
|
53
|
+
]
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: claude-executor
|
|
3
|
+
description: SpecDojo pipeline の executor。成果物の編集と検証だけを行い、result は更新しない。
|
|
4
|
+
tools: Read, Edit, Write, Bash, Glob, Grep, WebSearch, WebFetch
|
|
5
|
+
model: sonnet
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
あなたは SpecDojo pipeline の Claude executor です。
|
|
9
|
+
|
|
10
|
+
標準入力で渡された executor plan をタスク固有の指示として読み、対象成果物の編集と検証だけを行ってください。result の作成・更新、evidence からの最終結果要約、agent 自身による claim / complete / block は行わず、プロジェクトの事実を捏造しないでください。
|
|
11
|
+
|
|
12
|
+
plan に共通規約として result 更新手順が含まれていても、それは reporter / runner の責務として扱い、executor は実行しません。`docs/ja/projects/**/execution/exec/results/**` は変更せず、変更ファイルと検証結果はツール出力および最終応答へ簡潔に残し、runner が evidence として収集できるようにしてください。
|
|
13
|
+
|
|
14
|
+
Markdown で自由記述するときは、`depends_on` のように `_` を含む識別子・フィールド名を必ずインラインコードで囲んでください。
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: claude-reporter
|
|
3
|
+
description: SpecDojo pipeline の reporter。渡された evidence だけから指定スキーマの構造化結果を返す。
|
|
4
|
+
tools: Read, Glob, Grep
|
|
5
|
+
model: sonnet
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
あなたは SpecDojo pipeline の Claude reporter です。
|
|
9
|
+
|
|
10
|
+
標準入力で渡された plan、executor evidence、出力スキーマだけを根拠に結果を構成してください。成果物、result、タスク状態、設定を変更せず、追加調査や外部情報の取得も行いません。
|
|
11
|
+
|
|
12
|
+
応答は runner が指定した構造化出力スキーマに厳密に一致するデータだけとし、Markdown の説明、コードフェンス、スキーマ外フィールドを加えないでください。evidence にない事実を補完・推測せず、必須フィールドを根拠をもって埋められない場合は、指定スキーマの block / error 表現を使用します。出力スキーマまたは必要な evidence が提示されていない場合も成功結果を捏造しません。
|
|
13
|
+
|
|
14
|
+
runner が Markdown として描画する自由記述フィールドでは、`depends_on` のように `_` を含む識別子・フィールド名を必ずインラインコードで囲んでください。
|
|
15
|
+
|
|
16
|
+
agent 自身で claim / complete / block を実行しないでください。
|
|
@@ -17,16 +17,17 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
17
17
|
- コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
18
18
|
- 破壊的変更や `git push` は行わない。
|
|
19
19
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
20
|
-
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
|
|
20
|
+
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
21
21
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
22
22
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
23
23
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
24
24
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
25
25
|
- `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
|
|
26
26
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
27
|
-
- commit メッセージは subject を日本語で書き、conventional commit の type と scope
|
|
27
|
+
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
28
28
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
29
29
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
30
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
30
31
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
31
32
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
32
33
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -86,28 +87,38 @@ type は次のように使い分ける。
|
|
|
86
87
|
| `question` | 判断を保留し、後で決める | `decided` |
|
|
87
88
|
| `risk` | 将来の不確実性 | `done` |
|
|
88
89
|
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
89
|
-
| `note` | 記録として残す観測・分析 |
|
|
90
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
90
91
|
|
|
91
|
-
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic`
|
|
92
|
+
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
92
93
|
|
|
93
94
|
```bash
|
|
94
95
|
npx specdojo register add --project <project-id> \
|
|
95
96
|
--type todo --title "<title>" --description "<description>" \
|
|
96
|
-
--priority high --owner DEV --due <YYYY-MM-DD>
|
|
97
|
+
--topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
|
|
97
98
|
```
|
|
98
99
|
|
|
100
|
+
起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
|
|
101
|
+
|
|
102
|
+
起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
|
|
103
|
+
|
|
99
104
|
起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
|
|
100
105
|
|
|
101
106
|
状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
|
|
102
107
|
|
|
108
|
+
記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
|
|
109
|
+
|
|
103
110
|
```bash
|
|
104
111
|
npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
105
|
-
--conclusion "<結論>" --by <actor> --reason "<理由>"
|
|
106
|
-
|
|
112
|
+
--conclusion "<結論>" --by <actor> --reason "<理由>" \
|
|
113
|
+
--commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
|
|
107
114
|
```
|
|
108
115
|
|
|
116
|
+
`-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
|
|
117
|
+
|
|
109
118
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
110
119
|
|
|
120
|
+
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
121
|
+
|
|
111
122
|
## 実践の型(kata)の扱い
|
|
112
123
|
|
|
113
124
|
rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
|
|
@@ -1,6 +1,32 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/claude-code-settings.json",
|
|
3
3
|
"permissions": {
|
|
4
|
-
"allow": ["Edit(
|
|
4
|
+
"allow": ["Edit(**)"],
|
|
5
|
+
"deny": [
|
|
6
|
+
"Edit(node_modules/**)",
|
|
7
|
+
"Edit(.specdojo/**)",
|
|
8
|
+
"Edit(.agents/rules/**)",
|
|
9
|
+
"Edit(.agents/skills/**)",
|
|
10
|
+
"Edit(.claude/**)",
|
|
11
|
+
"Edit(.codex/**)",
|
|
12
|
+
"Edit(.opencode/**)",
|
|
13
|
+
"Edit(.github/agents/**)",
|
|
14
|
+
"Edit(.github/workflows/**)",
|
|
15
|
+
"Edit(.gitlab/ci/**)",
|
|
16
|
+
"Edit(.circleci/**)",
|
|
17
|
+
"Edit(.azure-pipelines/**)",
|
|
18
|
+
"Edit(.jenkins/**)",
|
|
19
|
+
"Edit(./package.json)",
|
|
20
|
+
"Edit(./AGENTS.md)",
|
|
21
|
+
"Edit(./CLAUDE.md)",
|
|
22
|
+
"Edit(./GEMINI.md)",
|
|
23
|
+
"Edit(./lefthook.yml)",
|
|
24
|
+
"Edit(./.lefthook.yml)",
|
|
25
|
+
"Edit(./.gitlab-ci.yml)",
|
|
26
|
+
"Edit(./.gitlab-ci.yaml)",
|
|
27
|
+
"Edit(./azure-pipelines.yml)",
|
|
28
|
+
"Edit(./azure-pipelines.yaml)",
|
|
29
|
+
"Edit(./Jenkinsfile)"
|
|
30
|
+
]
|
|
5
31
|
}
|
|
6
32
|
}
|
|
@@ -24,7 +24,7 @@ specdojo:
|
|
|
24
24
|
利用プロジェクトのルートで scaffold コマンドを実行します。
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
|
-
specdojo
|
|
27
|
+
specdojo config scaffold --provider codex
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
コピー後に次を行います。
|
|
@@ -51,11 +51,12 @@ specdojo exec scaffold --provider codex
|
|
|
51
51
|
|
|
52
52
|
この構成では Codex executor は `npm run test:unit` を実行し、親 runner が `npm run test:integration` の結果を evidence へ追加する。
|
|
53
53
|
|
|
54
|
-
2.
|
|
55
|
-
3.
|
|
54
|
+
2. SpecDojo が起動する agent をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ定義する。project ごとの `pm-members.yaml` は人間専用なので、`type: agent` を書かない。
|
|
55
|
+
3. 対話セッション用のデフォルト(`.codex/config.toml`)は利用環境に合わせて作成する。モデルや `approval_policy` の好みを含むため、このテンプレートには含めていない。
|
|
56
|
+
4. コピーしたファイルと `.specdojo/agent-members.yaml` をコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
|
|
56
57
|
|
|
57
58
|
## 4. カスタマイズ
|
|
58
59
|
|
|
59
60
|
- worker のモデル・reasoning effort は `command_params.by_proficiency` の1箇所で調整する。subagent(`agents/*.toml`)側の `model` / `model_reasoning_effort` は利用プランに合わせて調整する。
|
|
60
|
-
- `codex-expert-executor` の result 更新禁止は pipeline の責務境界なので維持する。SpecDojo worker としての選択は
|
|
61
|
+
- `codex-expert-executor` の result 更新禁止は pipeline の責務境界なので維持する。SpecDojo worker としての選択は `.specdojo/agent-members.yaml` の `stage_role: executor` で行い、custom subagent ファイルは起動コマンドから直接選択されない。
|
|
61
62
|
- 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
|
|
@@ -17,16 +17,17 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
17
17
|
- コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
18
18
|
- 破壊的変更や `git push` は行わない。
|
|
19
19
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
20
|
-
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
|
|
20
|
+
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
21
21
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
22
22
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
23
23
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
24
24
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
25
25
|
- `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
|
|
26
26
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
27
|
-
- commit メッセージは subject を日本語で書き、conventional commit の type と scope
|
|
27
|
+
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
28
28
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
29
29
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
30
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
30
31
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
31
32
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
32
33
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -86,28 +87,38 @@ type は次のように使い分ける。
|
|
|
86
87
|
| `question` | 判断を保留し、後で決める | `decided` |
|
|
87
88
|
| `risk` | 将来の不確実性 | `done` |
|
|
88
89
|
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
89
|
-
| `note` | 記録として残す観測・分析 |
|
|
90
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
90
91
|
|
|
91
|
-
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic`
|
|
92
|
+
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
92
93
|
|
|
93
94
|
```bash
|
|
94
95
|
npx specdojo register add --project <project-id> \
|
|
95
96
|
--type todo --title "<title>" --description "<description>" \
|
|
96
|
-
--priority high --owner DEV --due <YYYY-MM-DD>
|
|
97
|
+
--topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
|
|
97
98
|
```
|
|
98
99
|
|
|
100
|
+
起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
|
|
101
|
+
|
|
102
|
+
起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
|
|
103
|
+
|
|
99
104
|
起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
|
|
100
105
|
|
|
101
106
|
状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
|
|
102
107
|
|
|
108
|
+
記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
|
|
109
|
+
|
|
103
110
|
```bash
|
|
104
111
|
npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
105
|
-
--conclusion "<結論>" --by <actor> --reason "<理由>"
|
|
106
|
-
|
|
112
|
+
--conclusion "<結論>" --by <actor> --reason "<理由>" \
|
|
113
|
+
--commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
|
|
107
114
|
```
|
|
108
115
|
|
|
116
|
+
`-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
|
|
117
|
+
|
|
109
118
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
110
119
|
|
|
120
|
+
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
121
|
+
|
|
111
122
|
## 実践の型(kata)の扱い
|
|
112
123
|
|
|
113
124
|
rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
|
|
@@ -10,16 +10,17 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
10
10
|
- コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
11
11
|
- 破壊的変更や `git push` は行わない。
|
|
12
12
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
13
|
-
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
|
|
13
|
+
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
14
14
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
15
15
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
16
16
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
17
17
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
18
18
|
- `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
|
|
19
19
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
20
|
-
- commit メッセージは subject を日本語で書き、conventional commit の type と scope
|
|
20
|
+
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
21
21
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
22
22
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
23
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
23
24
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
24
25
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
25
26
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -79,28 +80,38 @@ type は次のように使い分ける。
|
|
|
79
80
|
| `question` | 判断を保留し、後で決める | `decided` |
|
|
80
81
|
| `risk` | 将来の不確実性 | `done` |
|
|
81
82
|
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
82
|
-
| `note` | 記録として残す観測・分析 |
|
|
83
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
83
84
|
|
|
84
|
-
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic`
|
|
85
|
+
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
85
86
|
|
|
86
87
|
```bash
|
|
87
88
|
npx specdojo register add --project <project-id> \
|
|
88
89
|
--type todo --title "<title>" --description "<description>" \
|
|
89
|
-
--priority high --owner DEV --due <YYYY-MM-DD>
|
|
90
|
+
--topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
|
|
90
91
|
```
|
|
91
92
|
|
|
93
|
+
起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
|
|
94
|
+
|
|
95
|
+
起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
|
|
96
|
+
|
|
92
97
|
起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
|
|
93
98
|
|
|
94
99
|
状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
|
|
95
100
|
|
|
101
|
+
記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
|
|
102
|
+
|
|
96
103
|
```bash
|
|
97
104
|
npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
98
|
-
--conclusion "<結論>" --by <actor> --reason "<理由>"
|
|
99
|
-
|
|
105
|
+
--conclusion "<結論>" --by <actor> --reason "<理由>" \
|
|
106
|
+
--commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
|
|
100
107
|
```
|
|
101
108
|
|
|
109
|
+
`-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
|
|
110
|
+
|
|
102
111
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
103
112
|
|
|
113
|
+
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
114
|
+
|
|
104
115
|
## 実践の型(kata)の扱い
|
|
105
116
|
|
|
106
117
|
rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
|
|
@@ -9,29 +9,31 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
## 1. 目的
|
|
11
11
|
|
|
12
|
-
`specdojo exec` が GitHub Copilot CLI を agent
|
|
12
|
+
`specdojo exec` が GitHub Copilot CLI を agent として起動する際の設定と、対話用オーケストレーターの配布原本です。exec の executor / reporter は個別の agent 定義ファイルを使わず、permission は `.specdojo/exec-defaults.yaml` の `providers.copilot.command_template` のフラグが正本です。オーケストレーターだけは Copilot CLI の custom agent として `.github/agents/specdojo-orchestrator.md` を使います。
|
|
13
13
|
|
|
14
14
|
## 2. 構成
|
|
15
15
|
|
|
16
16
|
| パス | 利用プロジェクトでの配置先 | 説明 |
|
|
17
17
|
| ---------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
|
|
18
|
-
| `
|
|
18
|
+
| `agent-members-snippet.yaml` | `.specdojo/copilot/` | agent 定義のスニペット。`.specdojo/agent-members.yaml` へ統合して使う参照用 |
|
|
19
19
|
| `exec-defaults-snippet.yaml` | `.specdojo/copilot/` | `providers.copilot`(command template・rate limit 検出)のスニペット。`exec-defaults.yaml` へコピーして使う参照用 |
|
|
20
|
+
| 同梱 orchestrator wrapper | `.github/agents/` | `npm run orch:copilot` が参照する `specdojo-orchestrator` custom agent |
|
|
20
21
|
|
|
21
22
|
## 3. 導入手順
|
|
22
23
|
|
|
23
24
|
利用プロジェクトのルートで scaffold コマンドを実行します。
|
|
24
25
|
|
|
25
26
|
```sh
|
|
26
|
-
specdojo
|
|
27
|
+
specdojo config scaffold --provider copilot
|
|
27
28
|
```
|
|
28
29
|
|
|
29
30
|
コピー後に次を行います。
|
|
30
31
|
|
|
31
32
|
1. `.specdojo/copilot/exec-defaults-snippet.yaml` の `providers.copilot` を `.specdojo/exec-defaults.yaml` の `providers` へコピーする。
|
|
32
|
-
2. `.specdojo/copilot/
|
|
33
|
+
2. `.specdojo/copilot/agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へコピーし、使う場合は `disabled: false` にする。agent は project ごとの `pm-members.yaml` へ書かない。
|
|
33
34
|
3. `copilot login` で認証する(premium request の課金が発生する)。
|
|
34
|
-
4.
|
|
35
|
+
4. `npm run orch:copilot` でオーケストレーターを起動できることを確認する。
|
|
36
|
+
5. 最初のタスクで permission ログを確認し、`shell(...)` パターンのマッチ粒度が不足していれば `--allow-tool` を追記する。
|
|
35
37
|
|
|
36
38
|
## 4. カスタマイズ
|
|
37
39
|
|