specdojo 0.3.1 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +47 -0
- package/README.md +77 -18
- package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
- package/dist/catalog/build-render.js +32 -0
- package/dist/{catalog-build.js → catalog/build.js} +9 -9
- package/dist/{catalog.js → catalog/catalog.js} +10 -10
- package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
- package/dist/catalog/paths.js +1 -0
- package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
- package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
- package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
- package/dist/{agent.js → commands/agent.js} +11 -11
- package/dist/{build-command.js → commands/build.js} +2 -2
- package/dist/{init-command.js → commands/init.js} +98 -32
- package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
- package/dist/{watch.js → commands/watch.js} +3 -3
- package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
- package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
- package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
- package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
- package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
- package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
- package/dist/{timeline.js → dashboard/timeline.js} +1 -1
- package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
- package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
- package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
- package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
- package/dist/{doc-index.js → docs/doc-index.js} +1 -1
- package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
- package/dist/{index-command.js → docs/index-command.js} +1 -1
- package/dist/docs/template-resolution.js +1 -0
- package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
- package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
- package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
- package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
- package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
- package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
- package/dist/{exec-commands.js → exec/commands.js} +22 -18
- package/dist/{exec-core.js → exec/core.js} +11 -11
- package/dist/{exec-events.js → exec/events.js} +2 -2
- package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
- package/dist/exec/exec.js +2 -0
- package/dist/exec/format.js +1 -0
- package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
- package/dist/{exec-limit.js → exec/limit.js} +93 -12
- package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
- package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
- package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
- package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
- package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
- package/dist/{exec-plans.js → exec/plans.js} +3 -3
- package/dist/{exec-project.js → exec/project.js} +1 -1
- package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
- package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
- package/dist/{exec-register.js → exec/register.js} +92 -9
- package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
- package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
- package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
- package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
- package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
- package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
- package/dist/{exec-results.js → exec/results.js} +256 -22
- package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
- package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
- package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
- package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
- package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
- package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
- package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
- package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
- package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
- package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
- package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
- package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
- package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
- package/dist/{exec-run.js → exec/run/run.js} +11 -11
- package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
- package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
- package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
- package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
- package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
- package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
- package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
- package/dist/exec/schedule/gantt-chart.js +2 -0
- package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
- package/dist/exec/schedule/index.js +1 -0
- package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
- package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
- package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
- package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
- package/dist/exec/shared.js +63 -0
- package/dist/exec/slot-lock.js +1 -0
- package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
- package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
- package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
- package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
- package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
- package/dist/{exec-trial.js → exec/trial.js} +2 -2
- package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
- package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
- package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
- package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
- package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
- package/dist/exec/worktree.js +305 -0
- package/dist/{grade-apply.js → grade/apply.js} +9 -9
- package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
- package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
- package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
- package/dist/{grade-core.js → grade/core.js} +3 -3
- package/dist/grade/grade.js +19 -0
- package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
- package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
- package/dist/{grade-plan.js → grade/plan.js} +5 -5
- package/dist/{grade-result.js → grade/result.js} +5 -94
- package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
- package/dist/{grade-targets.js → grade/targets.js} +11 -8
- package/dist/{job-definition.js → job/definition.js} +25 -6
- package/dist/{job.js → job/job.js} +12 -11
- package/dist/{kata-command.js → kata/command.js} +3 -3
- package/dist/{kata.js → kata/kata.js} +5 -5
- package/dist/register/approach.js +134 -0
- package/dist/{register-core.js → register/core.js} +13 -7
- package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
- package/dist/{register-date.js → register/date.js} +1 -1
- package/dist/register/derivation.js +163 -0
- package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
- package/dist/{register-events.js → register/events.js} +9 -3
- package/dist/{register-history.js → register/history.js} +7 -6
- package/dist/{register-item.js → register/item.js} +23 -5
- package/dist/register/lifecycle-lock.js +5 -0
- package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
- package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
- package/dist/{register-migration.js → register/migration.js} +4 -4
- package/dist/{register.js → register/register.js} +32 -27
- package/dist/{register-renumber.js → register/renumber.js} +38 -11
- package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
- package/dist/{register-update.js → register/update.js} +5 -5
- package/dist/{register-views.js → register/views.js} +47 -7
- package/dist/{review-grade.js → review/grade.js} +2 -2
- package/dist/{review-plan.js → review/plan.js} +3 -3
- package/dist/{routine-definition.js → routine/definition.js} +2 -2
- package/dist/{routine.js → routine/routine.js} +49 -22
- package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
- package/dist/{schedule-build.js → schedule/build.js} +7 -4
- package/dist/{schedule.js → schedule/schedule.js} +6 -6
- package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
- package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
- package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
- package/dist/shared/agent-types.js +23 -0
- package/dist/shared/artifact-path.js +9 -0
- package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
- package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
- package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
- package/dist/shared/fs.js +30 -0
- package/dist/{exec-worktree.js → shared/git.js} +83 -241
- package/dist/shared/grade-result.js +94 -0
- package/dist/{package-paths.js → shared/package-paths.js} +3 -3
- package/dist/shared/plan-templates.js +114 -0
- package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
- package/dist/shared/random.js +4 -0
- package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
- package/dist/shared/schedule-paths.js +9 -0
- package/dist/{specdojo-config.js → shared/specdojo-config.js} +93 -5
- package/dist/{exec-shared.js → shared/text.js} +0 -134
- package/dist/shared/time.js +28 -0
- package/dist/specdojo.js +22 -22
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
- package/docs/ja/specdojo/guides/exec-config-guide.md +91 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +31 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
- package/docs/ja/specdojo/guides/review-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
- package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +52 -28
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
- package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
- package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
- package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
- package/package.json +1 -1
- package/templates/antigravity/README.md +5 -1
- package/templates/antigravity/agent-members-snippet.yaml +108 -12
- package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
- package/templates/claude/README.md +27 -3
- package/templates/claude/agents/claude-executor.md +0 -1
- package/templates/claude/agents/claude-reporter.md +2 -1
- package/templates/claude/agents/claude-review-executor.md +0 -1
- package/templates/codex/README.md +23 -4
- package/templates/devcontainer/devcontainer.json +2 -2
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
- package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
- package/templates/init-agent-members.yaml +75 -25
- package/templates/init-exec-defaults.yaml +24 -8
- package/templates/opencode/README.md +17 -3
- package/templates/opencode/agents/opencode-executor.md +0 -1
- package/templates/opencode/agents/opencode-reporter.md +2 -1
- package/templates/opencode/agents/opencode-review-executor.md +0 -1
- package/dist/exec-schedule-gantt-chart.js +0 -2
- package/dist/exec.js +0 -2
- package/dist/grade.js +0 -19
- package/templates/claude/agents/claude-expert-review-executor.md +0 -14
- /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
- /package/dist/{catalog-types.js → catalog/types.js} +0 -0
- /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
- /package/dist/{role-types.js → exec/role-types.js} +0 -0
- /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
- /package/dist/{exec-types.js → exec/types.js} +0 -0
- /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
- /package/dist/{register-command-types.js → register/command-types.js} +0 -0
- /package/dist/{review-types.js → review/types.js} +0 -0
- /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
- /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
- /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
- /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
- /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
- /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
- /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
- /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
- /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
- /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
- /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
- /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
- /package/dist/{yaml.js → shared/yaml.js} +0 -0
|
@@ -145,6 +145,6 @@ specdojo:
|
|
|
145
145
|
`document_kinds` の `include` / `exclude` を列挙している観点ごとに、新しい rulebook の扱いを判断する。
|
|
146
146
|
観点を当てはめない場合は `exclude`(`include` の観点では当てはめる場合に `include`)へ、
|
|
147
147
|
既定の結果のままにする場合は `confirmed_default` へ rulebook ID を追加する。
|
|
148
|
-
- 判断の漏れは `src/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
|
|
148
|
+
- 判断の漏れは `src/docs/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
|
|
149
149
|
error として報告する。検証は `npm test`(`npm run check` に含まれる)で実行され、
|
|
150
|
-
`npx tsx src/viewpoint-document-kinds-check.ts` で単独でも確認できる。
|
|
150
|
+
`npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも確認できる。
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:pjr-derived-items-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _PROJECT_ID_:pjr-derived-items
|
|
9
|
+
type: project
|
|
10
|
+
status: ready
|
|
11
|
+
rulebook: specdojo:pjr-rulebook
|
|
12
|
+
part_of:
|
|
13
|
+
- _PROJECT_ID_:pjr-index
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# 登録項目の派生関係
|
|
17
|
+
|
|
18
|
+
> このファイルは個票の `derived_from` から生成された派生ビューです。正本は個票の Frontmatter であり、このファイルは再生成可能です。
|
|
19
|
+
|
|
20
|
+
## 1. 元の項目から派生先を辿る
|
|
21
|
+
|
|
22
|
+
<!-- specdojo:view-slot=derived-items -->
|
|
@@ -13,7 +13,18 @@ properties:
|
|
|
13
13
|
items:
|
|
14
14
|
$ref: "#/$defs/AgentMember"
|
|
15
15
|
uniqueItems: true
|
|
16
|
+
aliases:
|
|
17
|
+
type: array
|
|
18
|
+
description: >
|
|
19
|
+
Backward-compatible names that refer to concrete members. alias_of may refer to
|
|
20
|
+
another alias, but every chain must terminate at an enabled member.
|
|
21
|
+
items:
|
|
22
|
+
$ref: "#/$defs/AgentAlias"
|
|
23
|
+
uniqueItems: true
|
|
16
24
|
$defs:
|
|
25
|
+
AgentNickname:
|
|
26
|
+
type: string
|
|
27
|
+
pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
|
|
17
28
|
RoleLabel:
|
|
18
29
|
type: string
|
|
19
30
|
pattern: "^[A-Z]{2,4}$"
|
|
@@ -23,8 +34,7 @@ $defs:
|
|
|
23
34
|
required: [nickname, display_name, roles, type, provider, capabilities, proficiency, priority]
|
|
24
35
|
properties:
|
|
25
36
|
nickname:
|
|
26
|
-
|
|
27
|
-
pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
|
|
37
|
+
$ref: "#/$defs/AgentNickname"
|
|
28
38
|
display_name:
|
|
29
39
|
type: string
|
|
30
40
|
minLength: 1
|
|
@@ -42,6 +52,14 @@ $defs:
|
|
|
42
52
|
const: agent
|
|
43
53
|
provider:
|
|
44
54
|
enum: [opencode, claude, codex, copilot, antigravity, custom]
|
|
55
|
+
model:
|
|
56
|
+
type: string
|
|
57
|
+
minLength: 1
|
|
58
|
+
description: "Provider model identifier, including its version when applicable."
|
|
59
|
+
effort:
|
|
60
|
+
type: string
|
|
61
|
+
minLength: 1
|
|
62
|
+
description: "Provider-specific reasoning effort passed when the provider supports it."
|
|
45
63
|
persona:
|
|
46
64
|
type: string
|
|
47
65
|
minLength: 1
|
|
@@ -74,3 +92,12 @@ $defs:
|
|
|
74
92
|
enum: [critical-first, dependency-first, fifo, manual]
|
|
75
93
|
note:
|
|
76
94
|
type: string
|
|
95
|
+
AgentAlias:
|
|
96
|
+
type: object
|
|
97
|
+
additionalProperties: false
|
|
98
|
+
required: [nickname, alias_of]
|
|
99
|
+
properties:
|
|
100
|
+
nickname:
|
|
101
|
+
$ref: "#/$defs/AgentNickname"
|
|
102
|
+
alias_of:
|
|
103
|
+
$ref: "#/$defs/AgentNickname"
|
|
@@ -262,6 +262,26 @@ $defs:
|
|
|
262
262
|
oom:
|
|
263
263
|
type: number
|
|
264
264
|
exclusiveMinimum: 0
|
|
265
|
+
pinned:
|
|
266
|
+
type: object
|
|
267
|
+
additionalProperties: false
|
|
268
|
+
description: >
|
|
269
|
+
Recovery for an agent selected by nickname. CLI --on-rate-limit and fallback stage
|
|
270
|
+
flags override these values. Omitted action preserves the historical stop behavior.
|
|
271
|
+
properties:
|
|
272
|
+
action:
|
|
273
|
+
type: string
|
|
274
|
+
enum: [stop, wait, fallback]
|
|
275
|
+
max_wait_seconds:
|
|
276
|
+
type: number
|
|
277
|
+
minimum: 0
|
|
278
|
+
description: Maximum wait for reset/retry-after/cooldown (default 28800 seconds).
|
|
279
|
+
fallback_executor_by:
|
|
280
|
+
type: string
|
|
281
|
+
pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
|
|
282
|
+
fallback_reporter_by:
|
|
283
|
+
type: string
|
|
284
|
+
pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
|
|
265
285
|
on_non_critical:
|
|
266
286
|
type: object
|
|
267
287
|
additionalProperties: false
|
|
@@ -176,6 +176,29 @@ properties:
|
|
|
176
176
|
reason:
|
|
177
177
|
type: string
|
|
178
178
|
maxLength: 1000
|
|
179
|
+
rate_limit_events:
|
|
180
|
+
description: Runner-recorded wait/fallback history for a pinned executor.
|
|
181
|
+
type: array
|
|
182
|
+
items:
|
|
183
|
+
type: object
|
|
184
|
+
additionalProperties: false
|
|
185
|
+
required: [action, from_actor, to_actor, resumed_at]
|
|
186
|
+
properties:
|
|
187
|
+
action:
|
|
188
|
+
type: string
|
|
189
|
+
enum: [wait, fallback]
|
|
190
|
+
from_actor:
|
|
191
|
+
type: string
|
|
192
|
+
minLength: 1
|
|
193
|
+
to_actor:
|
|
194
|
+
type: string
|
|
195
|
+
minLength: 1
|
|
196
|
+
resumed_at:
|
|
197
|
+
type: string
|
|
198
|
+
format: date-time
|
|
199
|
+
resume_at:
|
|
200
|
+
type: string
|
|
201
|
+
format: date-time
|
|
179
202
|
final_message:
|
|
180
203
|
type: string
|
|
181
204
|
maxLength: 4000
|
|
@@ -46,7 +46,7 @@ properties:
|
|
|
46
46
|
type: string
|
|
47
47
|
format: date-time
|
|
48
48
|
state:
|
|
49
|
-
enum: [running, succeeded, failed, noop]
|
|
49
|
+
enum: [running, succeeded, partial, failed, noop]
|
|
50
50
|
inputs:
|
|
51
51
|
type: object
|
|
52
52
|
task:
|
|
@@ -78,7 +78,7 @@ properties:
|
|
|
78
78
|
type: string
|
|
79
79
|
format: date-time
|
|
80
80
|
status:
|
|
81
|
-
enum: [running, succeeded, failed, noop]
|
|
81
|
+
enum: [running, succeeded, partial, failed, noop]
|
|
82
82
|
result_ref:
|
|
83
83
|
type: string
|
|
84
84
|
evidence_ref:
|
|
@@ -190,6 +190,13 @@ $defs:
|
|
|
190
190
|
command:
|
|
191
191
|
type: string
|
|
192
192
|
minLength: 1
|
|
193
|
+
partial_exit_code:
|
|
194
|
+
description: >
|
|
195
|
+
Optional non-zero exit code that records a reviewable partial Job Run. Other non-zero
|
|
196
|
+
exit codes remain failures.
|
|
197
|
+
type: integer
|
|
198
|
+
minimum: 1
|
|
199
|
+
maximum: 255
|
|
193
200
|
precondition:
|
|
194
201
|
type: object
|
|
195
202
|
additionalProperties: false
|
|
@@ -57,6 +57,8 @@ $defs:
|
|
|
57
57
|
format: date-time
|
|
58
58
|
artifact_ref:
|
|
59
59
|
type: [string, "null"]
|
|
60
|
+
rate_limit_events:
|
|
61
|
+
$ref: "#/$defs/rateLimitEvents"
|
|
60
62
|
# Keys are repository names (`project` for the project repository) in integration order.
|
|
61
63
|
repos:
|
|
62
64
|
type: object
|
|
@@ -102,3 +104,27 @@ $defs:
|
|
|
102
104
|
format: date-time
|
|
103
105
|
artifact_ref:
|
|
104
106
|
type: [string, "null"]
|
|
107
|
+
rate_limit_events:
|
|
108
|
+
$ref: "#/$defs/rateLimitEvents"
|
|
109
|
+
rateLimitEvents:
|
|
110
|
+
type: array
|
|
111
|
+
items:
|
|
112
|
+
type: object
|
|
113
|
+
additionalProperties: false
|
|
114
|
+
required: [action, from_actor, to_actor, resumed_at]
|
|
115
|
+
properties:
|
|
116
|
+
action:
|
|
117
|
+
type: string
|
|
118
|
+
enum: [wait, fallback]
|
|
119
|
+
from_actor:
|
|
120
|
+
type: string
|
|
121
|
+
minLength: 1
|
|
122
|
+
to_actor:
|
|
123
|
+
type: string
|
|
124
|
+
minLength: 1
|
|
125
|
+
resumed_at:
|
|
126
|
+
type: string
|
|
127
|
+
format: date-time
|
|
128
|
+
resume_at:
|
|
129
|
+
type: string
|
|
130
|
+
format: date-time
|
|
@@ -7,8 +7,9 @@ description: >
|
|
|
7
7
|
|
|
8
8
|
The frontmatter is the single source of truth for the structured fields of one
|
|
9
9
|
register item: classification (item_type), processing status (item_status),
|
|
10
|
-
priority, owner, dates, block reason and
|
|
11
|
-
view generated from these files, so the same field is never stored in
|
|
10
|
+
priority, owner, dates, block reason, conclusion and derivation sources. The register list
|
|
11
|
+
(pjr-index) is a derived view generated from these files, so the same field is never stored in
|
|
12
|
+
two places.
|
|
12
13
|
|
|
13
14
|
Conventions:
|
|
14
15
|
- Undecided values are expressed by omitting the key. Table placeholders such as
|
|
@@ -43,6 +44,19 @@ properties:
|
|
|
43
44
|
# required と同じ位置で対象プロパティを宣言する。
|
|
44
45
|
properties:
|
|
45
46
|
completed_at: true
|
|
47
|
+
- if:
|
|
48
|
+
required:
|
|
49
|
+
- approach
|
|
50
|
+
properties:
|
|
51
|
+
approach: true
|
|
52
|
+
then:
|
|
53
|
+
required:
|
|
54
|
+
- targets
|
|
55
|
+
properties:
|
|
56
|
+
targets:
|
|
57
|
+
type: array
|
|
58
|
+
minItems: 1
|
|
59
|
+
maxItems: 1
|
|
46
60
|
- type: object
|
|
47
61
|
required:
|
|
48
62
|
- rulebook
|
|
@@ -143,6 +157,26 @@ properties:
|
|
|
143
157
|
rejection. Omit the key while it is undetermined; the details stay in
|
|
144
158
|
the body (list column: 結論).
|
|
145
159
|
|
|
160
|
+
derived_from:
|
|
161
|
+
type: array
|
|
162
|
+
items:
|
|
163
|
+
oneOf:
|
|
164
|
+
- $ref: "#/$defs/LocalRegisterItemRef"
|
|
165
|
+
- $ref: "#/$defs/QualifiedRegisterItemRef"
|
|
166
|
+
minItems: 1
|
|
167
|
+
uniqueItems: true
|
|
168
|
+
description: >
|
|
169
|
+
Register items from which this item was derived. Use PJR-XXXX for an item in the
|
|
170
|
+
same project and <project-id>:PJR-XXXX for an item in another project. Omit the key
|
|
171
|
+
when the item was not derived from another register item.
|
|
172
|
+
|
|
173
|
+
approach:
|
|
174
|
+
$ref: "#/$defs/Approach"
|
|
175
|
+
description: >
|
|
176
|
+
Execution approach for the single target. When present, targets must
|
|
177
|
+
contain exactly one document id whose kind is compatible with the
|
|
178
|
+
approach.
|
|
179
|
+
|
|
146
180
|
targets:
|
|
147
181
|
type: array
|
|
148
182
|
items:
|
|
@@ -150,11 +184,13 @@ properties:
|
|
|
150
184
|
minLength: 1
|
|
151
185
|
minItems: 1
|
|
152
186
|
description: >
|
|
153
|
-
Doc ids of documents this register item targets
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
187
|
+
Doc ids of documents this register item targets. Deliverable targets
|
|
188
|
+
used with an approach are resolved via the project catalog so that
|
|
189
|
+
not-yet-created deliverables can be selected; kata and standalone
|
|
190
|
+
targets are resolved via the doc index. When present, exec plan
|
|
191
|
+
generation copies these into the plan frontmatter so that target
|
|
192
|
+
coverage validation works for register-originated plans. Omit the
|
|
193
|
+
key when the target documents are unknown or not applicable.
|
|
158
194
|
|
|
159
195
|
$defs:
|
|
160
196
|
ItemType:
|
|
@@ -200,6 +236,23 @@ $defs:
|
|
|
200
236
|
- low
|
|
201
237
|
description: "Handling priority of a register item."
|
|
202
238
|
|
|
239
|
+
Approach:
|
|
240
|
+
type: string
|
|
241
|
+
enum:
|
|
242
|
+
- fully-guided
|
|
243
|
+
- recipe-guided
|
|
244
|
+
- freeform
|
|
245
|
+
- bootstrap
|
|
246
|
+
- retrofit
|
|
247
|
+
- cross-deliverable-dedup
|
|
248
|
+
- rulebook-maintenance
|
|
249
|
+
- recipe-maintenance
|
|
250
|
+
- sample-maintenance
|
|
251
|
+
- template-maintenance
|
|
252
|
+
- finalize
|
|
253
|
+
- bootstrap-finalize
|
|
254
|
+
description: "Execution approach shared with src/shared/agent-types.ts."
|
|
255
|
+
|
|
203
256
|
Date:
|
|
204
257
|
type: string
|
|
205
258
|
format: date
|
|
@@ -215,3 +268,13 @@ $defs:
|
|
|
215
268
|
Storing the instant instead of a calendar day keeps the record independent of
|
|
216
269
|
the display timezone. Write it as a quoted YAML string, because an unquoted
|
|
217
270
|
date-time is loaded as a timestamp value instead of a string.
|
|
271
|
+
|
|
272
|
+
LocalRegisterItemRef:
|
|
273
|
+
type: string
|
|
274
|
+
pattern: "^PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
|
|
275
|
+
description: "Display id of a register item in the same project."
|
|
276
|
+
|
|
277
|
+
QualifiedRegisterItemRef:
|
|
278
|
+
type: string
|
|
279
|
+
pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
|
|
280
|
+
description: "Project-qualified display id of a register item in another project."
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
$schema: "https://json-schema.org/draft/2020-12/schema"
|
|
2
2
|
title: SpecDojo Config (.specdojo/specdojo.config.json)
|
|
3
3
|
description: >-
|
|
4
|
-
Shape of .specdojo/specdojo.config.json. The CLI (src/specdojo-config.ts loadConfig) is the
|
|
4
|
+
Shape of .specdojo/specdojo.config.json. The CLI (src/shared/specdojo-config.ts loadConfig) is the
|
|
5
5
|
authority for checks that a schema cannot express: repository names that collide with a
|
|
6
6
|
project id and repository paths that do not exist.
|
|
7
7
|
type: object
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.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",
|
|
@@ -57,4 +57,8 @@ agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigra
|
|
|
57
57
|
|
|
58
58
|
## executor / reporter として使う
|
|
59
59
|
|
|
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`
|
|
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` へ書きません。
|
|
61
|
+
|
|
62
|
+
名簿は実体と別名の 2 段で書きます。実体(`flash-executor`・`agy-opus-executor` など)は model の系統で名付け、model の ID を `model` に持ちます。従来の名前(`agy-executor`・`agy-claude-executor` など)は `aliases` で実体を指す別名にします。スニペット末尾の `aliases` の例は、向き先の member を有効にしたものだけを写します(別名は無効な member を指せません)。
|
|
63
|
+
|
|
64
|
+
使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
|
|
@@ -3,59 +3,155 @@
|
|
|
3
3
|
# project ごとの pm-members.yaml は人間専用なので、agent は記載しない。
|
|
4
4
|
# 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
|
|
5
5
|
# providers.antigravity.command_template で定義する(exec-defaults-snippet.yaml を参照)。
|
|
6
|
-
#
|
|
7
|
-
#
|
|
6
|
+
#
|
|
7
|
+
# 名簿は実体と別名の 2 段で書く(PJR-ZM1K)。
|
|
8
|
+
# members : model の系統で名付けた実体。provider・model・役割を持ち、model の ID(推論強度を含む)は
|
|
9
|
+
# 実体の model の 1 か所に書く。Claude Code など既定の provider と同じ系統の model は、
|
|
10
|
+
# agy- を前に付けて区別する(agy-opus-executor など)。
|
|
11
|
+
# aliases : 従来の名前(agy-executor など)。実体を指すだけで、Job・routine・利用者の設定はそのまま動く。
|
|
12
|
+
#
|
|
13
|
+
# 既定では members を disabled にしてある。使う member だけ disabled を外す。
|
|
14
|
+
# 別名は有効な member を指す必要があるため、下の aliases の例は、向き先の member の disabled を
|
|
15
|
+
# 外したものだけを .specdojo/agent-members.yaml の aliases へ写す。
|
|
8
16
|
|
|
9
17
|
version: 1
|
|
10
18
|
members:
|
|
11
|
-
- nickname:
|
|
19
|
+
- nickname: flash-executor
|
|
12
20
|
disabled: true
|
|
13
21
|
priority: 4
|
|
14
|
-
display_name: Antigravity Executor
|
|
22
|
+
display_name: Antigravity Flash Executor
|
|
15
23
|
email: null
|
|
16
24
|
roles: []
|
|
17
25
|
type: agent
|
|
18
26
|
provider: antigravity
|
|
27
|
+
model: gemini-3.8-flash-medium
|
|
19
28
|
mode: edit
|
|
29
|
+
stage_role: executor
|
|
20
30
|
proficiency: normal
|
|
21
31
|
persona: task-executor
|
|
22
32
|
capabilities: []
|
|
23
33
|
|
|
24
|
-
- nickname:
|
|
34
|
+
- nickname: flash-high-executor
|
|
25
35
|
disabled: true
|
|
26
36
|
priority: 3
|
|
27
|
-
display_name: Antigravity
|
|
37
|
+
display_name: Antigravity Flash High Executor
|
|
28
38
|
email: null
|
|
29
39
|
roles: []
|
|
30
40
|
type: agent
|
|
31
41
|
provider: antigravity
|
|
42
|
+
model: gemini-3.8-flash-high
|
|
32
43
|
mode: edit
|
|
44
|
+
stage_role: executor
|
|
33
45
|
proficiency: expert
|
|
34
46
|
persona: task-executor
|
|
35
47
|
capabilities: []
|
|
36
48
|
|
|
37
|
-
- nickname:
|
|
49
|
+
- nickname: flash-high-review-executor
|
|
38
50
|
disabled: true
|
|
39
51
|
priority: 3
|
|
40
|
-
display_name: Antigravity
|
|
52
|
+
display_name: Antigravity Flash High Review Executor
|
|
41
53
|
email: null
|
|
42
54
|
roles: []
|
|
43
55
|
type: agent
|
|
44
56
|
provider: antigravity
|
|
57
|
+
model: gemini-3.8-flash-high
|
|
45
58
|
mode: review
|
|
59
|
+
stage_role: executor
|
|
46
60
|
proficiency: expert
|
|
47
|
-
persona: reviewer
|
|
61
|
+
persona: multi-viewpoint-reviewer
|
|
48
62
|
capabilities: []
|
|
49
63
|
|
|
50
|
-
- nickname:
|
|
64
|
+
- nickname: flash-reporter
|
|
51
65
|
disabled: true
|
|
52
66
|
priority: 4
|
|
53
|
-
display_name: Antigravity Reporter
|
|
67
|
+
display_name: Antigravity Flash Reporter
|
|
54
68
|
email: null
|
|
55
69
|
roles: []
|
|
56
70
|
type: agent
|
|
57
71
|
provider: antigravity
|
|
72
|
+
model: gemini-3.8-flash-medium
|
|
58
73
|
mode: report
|
|
74
|
+
stage_role: reporter
|
|
59
75
|
proficiency: normal
|
|
60
|
-
persona: reporter
|
|
76
|
+
persona: execution-reporter
|
|
61
77
|
capabilities: []
|
|
78
|
+
|
|
79
|
+
# Gemini 以外の Antigravity 提供 model。自動選択では選ばれにくい priority にし、by-name で使う。
|
|
80
|
+
- nickname: agy-sonnet-executor
|
|
81
|
+
disabled: true
|
|
82
|
+
priority: 5
|
|
83
|
+
display_name: Antigravity Claude Sonnet Executor
|
|
84
|
+
email: null
|
|
85
|
+
roles: []
|
|
86
|
+
type: agent
|
|
87
|
+
provider: antigravity
|
|
88
|
+
model: claude-sonnet-5-5-medium
|
|
89
|
+
mode: edit
|
|
90
|
+
stage_role: executor
|
|
91
|
+
proficiency: normal
|
|
92
|
+
persona: task-executor
|
|
93
|
+
capabilities: []
|
|
94
|
+
|
|
95
|
+
- nickname: agy-opus-executor
|
|
96
|
+
disabled: true
|
|
97
|
+
priority: 5
|
|
98
|
+
display_name: Antigravity Claude Opus Executor
|
|
99
|
+
email: null
|
|
100
|
+
roles: []
|
|
101
|
+
type: agent
|
|
102
|
+
provider: antigravity
|
|
103
|
+
model: claude-opus-5-5-high
|
|
104
|
+
mode: edit
|
|
105
|
+
stage_role: executor
|
|
106
|
+
proficiency: expert
|
|
107
|
+
persona: task-executor
|
|
108
|
+
capabilities: []
|
|
109
|
+
|
|
110
|
+
- nickname: agy-opus-review-executor
|
|
111
|
+
disabled: true
|
|
112
|
+
priority: 5
|
|
113
|
+
display_name: Antigravity Claude Opus Review Executor
|
|
114
|
+
email: null
|
|
115
|
+
roles: []
|
|
116
|
+
type: agent
|
|
117
|
+
provider: antigravity
|
|
118
|
+
model: claude-opus-5-5-high
|
|
119
|
+
mode: review
|
|
120
|
+
stage_role: executor
|
|
121
|
+
proficiency: expert
|
|
122
|
+
persona: multi-viewpoint-reviewer
|
|
123
|
+
capabilities: []
|
|
124
|
+
|
|
125
|
+
- nickname: agy-gpt-oss-executor
|
|
126
|
+
disabled: true
|
|
127
|
+
priority: 5
|
|
128
|
+
display_name: Antigravity GPT OSS Executor
|
|
129
|
+
email: null
|
|
130
|
+
roles: []
|
|
131
|
+
type: agent
|
|
132
|
+
provider: antigravity
|
|
133
|
+
model: gpt-oss-120b-medium
|
|
134
|
+
mode: edit
|
|
135
|
+
stage_role: executor
|
|
136
|
+
proficiency: normal
|
|
137
|
+
persona: task-executor
|
|
138
|
+
capabilities: []
|
|
139
|
+
|
|
140
|
+
# 別名の例(従来の名前 -> 実体)。向き先の member を有効にしたものだけを写す。
|
|
141
|
+
# aliases:
|
|
142
|
+
# - nickname: agy-executor
|
|
143
|
+
# alias_of: flash-executor
|
|
144
|
+
# - nickname: agy-expert-executor
|
|
145
|
+
# alias_of: flash-high-executor
|
|
146
|
+
# - nickname: agy-expert-review-executor
|
|
147
|
+
# alias_of: flash-high-review-executor
|
|
148
|
+
# - nickname: agy-reporter
|
|
149
|
+
# alias_of: flash-reporter
|
|
150
|
+
# - nickname: agy-claude-executor
|
|
151
|
+
# alias_of: agy-sonnet-executor
|
|
152
|
+
# - nickname: agy-claude-expert-executor
|
|
153
|
+
# alias_of: agy-opus-executor
|
|
154
|
+
# - nickname: agy-claude-expert-review-executor
|
|
155
|
+
# alias_of: agy-opus-review-executor
|
|
156
|
+
# - nickname: agy-gpt-executor
|
|
157
|
+
# alias_of: agy-gpt-oss-executor
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
# Antigravity CLI(agy)provider 設定のスニペット。
|
|
2
2
|
# 利用プロジェクトの .specdojo/exec-defaults.yaml の providers へコピーして使う。
|
|
3
|
-
#
|
|
4
|
-
#
|
|
3
|
+
# model は実体の member の model に書き、command_template の {model} で渡す(PJR-ZM1K)。
|
|
4
|
+
# model を持たない従来の 1 段の member を残す場合だけ、command_params.by_proficiency /
|
|
5
|
+
# by_nickname で model を補う(member の model があればそちらが優先される)。
|
|
5
6
|
# 設計の背景は sysd-antigravity-agent-settings と exec-config-guide.md を参照。
|
|
6
7
|
|
|
7
8
|
providers:
|
|
@@ -20,17 +21,11 @@ providers:
|
|
|
20
21
|
# 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
|
|
21
22
|
# expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
|
|
22
23
|
command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
# by_nickname は proficiency / mode の既定値より優先される。
|
|
29
|
-
by_nickname:
|
|
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 }
|
|
33
|
-
agy-gpt-executor: { model: gpt-oss-120b-medium }
|
|
24
|
+
# 従来の 1 段の名簿(model を持たない member)を使い続ける場合の補い方:
|
|
25
|
+
# command_params:
|
|
26
|
+
# by_proficiency:
|
|
27
|
+
# normal: { model: gemini-3.8-flash-medium }
|
|
28
|
+
# expert: { model: gemini-3.8-flash-high }
|
|
34
29
|
# Gemini API の制限文言は未観測。429 / quota / RESOURCE_EXHAUSTED を初期値とし、
|
|
35
30
|
# 実観測した文言で更新する(observed-agent-limit-stderr と同じ扱い)。
|
|
36
31
|
rate_limit_detection:
|
|
@@ -15,7 +15,7 @@ specdojo:
|
|
|
15
15
|
|
|
16
16
|
| パス | 利用プロジェクトでの配置先 | 説明 |
|
|
17
17
|
| ---------------------- | -------------------------- | --------------------------------------------------------------------- |
|
|
18
|
-
| `agents/*.md` | `.claude/agents/` | agent 定義。`--agent <name>` で参照されるため配置先は固定
|
|
18
|
+
| `agents/*.md` | `.claude/agents/` | 役割ごとの agent 定義。`--agent <name>` で参照されるため配置先は固定 |
|
|
19
19
|
| `settings.edit.json` | `.specdojo/claude/` | edit executor 用 permission 設定。成果物への書き込みを許可する |
|
|
20
20
|
| `settings.review.json` | `.specdojo/claude/` | review executor 用 permission 設定。result 配下のみ書き込みを許可する |
|
|
21
21
|
| `settings.report.json` | `.specdojo/claude/` | reporter 用 permission 設定。Edit/Write と git add/commit を拒否する |
|
|
@@ -31,14 +31,38 @@ specdojo exec scaffold --provider claude
|
|
|
31
31
|
既存ファイルは上書きされません(`--force` 指定時のみ上書き)。`--dry-run` でコピー予定を確認できます。コピー後に次の 2 点を行います。
|
|
32
32
|
|
|
33
33
|
1. `.specdojo/exec-defaults.yaml` の `providers.claude.command_template` に `--settings .specdojo/claude/settings.{mode}.json` を指定する(`--permission-mode bypassPermissions` は付けない)。member 側に `command` は書かない。
|
|
34
|
-
2.
|
|
34
|
+
2. agent の定義は役割(executor・review executor・reporter)ごとの 1 ファイルで、model を持たない。`command_params.by_mode` で mode から定義を選び、model は実体の member の `model` を `--model {model}` で渡す。
|
|
35
|
+
3. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
|
|
35
36
|
|
|
36
37
|
```yaml
|
|
37
38
|
providers:
|
|
38
39
|
claude:
|
|
39
|
-
command_template: "claude -p --verbose --agent {
|
|
40
|
+
command_template: "claude -p --verbose --agent {agent} --model {model} --settings .specdojo/claude/settings.{mode}.json"
|
|
41
|
+
command_params:
|
|
42
|
+
by_mode:
|
|
43
|
+
edit: { agent: claude-executor }
|
|
44
|
+
review: { agent: claude-review-executor }
|
|
45
|
+
report: { agent: claude-reporter }
|
|
40
46
|
```
|
|
41
47
|
|
|
48
|
+
`.specdojo/agent-members.yaml` は実体と別名の 2 段で書く。実体は model の系統で名付け(`sonnet-executor`・`opus-executor` など)、`model` に `sonnet` / `opus` を持つ。従来の名前(`claude-executor`・`claude-expert-executor` など)は `aliases` で実体を指す別名にする。
|
|
49
|
+
|
|
50
|
+
```yaml
|
|
51
|
+
members:
|
|
52
|
+
- nickname: opus-executor
|
|
53
|
+
provider: claude
|
|
54
|
+
model: opus
|
|
55
|
+
mode: edit
|
|
56
|
+
stage_role: executor
|
|
57
|
+
proficiency: expert
|
|
58
|
+
# display_name などの必須項目は省略
|
|
59
|
+
aliases:
|
|
60
|
+
- nickname: claude-expert-executor
|
|
61
|
+
alias_of: opus-executor
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
従来の `--agent {nickname}` と model を持つ定義ファイルで組んだ 1 段の名簿は、そのまま動く。scaffold は既存ファイルを上書きしないため、`--force` で役割ごとの定義(model を持たない)に置き換える場合だけ、上の `command_template` へ移す。移行の手順は exec-config-guide の `agent の名簿の 2 段構成と移行` を参照する。
|
|
65
|
+
|
|
42
66
|
## 4. カスタマイズ
|
|
43
67
|
|
|
44
68
|
- edit 用の既定値は `docs/**`、`src/**`、`tests/**` を許可する。`Edit(...)` / `Write(...)` のパスパターンは、利用プロジェクトの成果物・execution ディレクトリ配置に合わせて調整する。
|