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
|
@@ -48,9 +48,10 @@ question を起票する(迷っていること)
|
|
|
48
48
|
プロジェクトリポジトリを作り、SpecDojo を導入して `init` の質問に答えます。
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
mkdir app1-
|
|
52
|
-
|
|
53
|
-
|
|
51
|
+
mkdir app1-workspace
|
|
52
|
+
mkdir app1-workspace/app1-specdojo
|
|
53
|
+
git -C app1-workspace/app1-specdojo init
|
|
54
|
+
cd app1-workspace/app1-specdojo
|
|
54
55
|
npm init -y
|
|
55
56
|
npm install --save-dev specdojo
|
|
56
57
|
npx specdojo init
|
|
@@ -66,11 +67,14 @@ Your nickname [owner]: owner
|
|
|
66
67
|
Your display name [Project Owner]: 店主
|
|
67
68
|
Orchestrator providers (...) [codex]: claude <- 使う AI ツールを 1 つ選ぶ
|
|
68
69
|
Delegate work to agents (exec)? [y/N]: <- Enter(実戦は後で設定する)
|
|
69
|
-
Deliverables catalog (none|small|medium|large) [none]: <- Enter(カタログは使わない)
|
|
70
70
|
Create a Dev Container? [y/N]: <- Enter
|
|
71
71
|
```
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
入力が不正な場合は理由が表示され、同じ質問だけがもう一度表示されます。たとえば provider に
|
|
74
|
+
`claud` と入力すると、利用可能な provider の一覧に続いて provider の質問だけが再表示されます。
|
|
75
|
+
それまでに答えた project や名簿の内容を入力し直す必要はありません。
|
|
76
|
+
|
|
77
|
+
登録簿は `docs/ja/projects/prj-0001/controls/project-register/` に作られます。オーケストレーターで進める場合は、終了時に表示される `npm run orch:<provider>` で起動します。成果物カタログは対話では作られません。成果物の構成が定まったら、[[#41-成果物カタログを作成する|成果物カタログを作成する]] に従って `catalog_path` を設定し、`catalog scaffold` で追加してください。
|
|
74
78
|
|
|
75
79
|
### 1.2. 迷っていることを起票する(question)
|
|
76
80
|
|
|
@@ -191,6 +195,8 @@ npx specdojo register build --project prj-0001
|
|
|
191
195
|
|
|
192
196
|
## 2. CLIを初期設定する
|
|
193
197
|
|
|
198
|
+
Node.js 22.13 以上と Git を用意します。オーケストレーターに Claude Code を使う場合は、Claude Code も導入してログインしておきます。ほかの provider も選べます。
|
|
199
|
+
|
|
194
200
|
既定では、SpecDojo の成果物更新、登録簿の状態遷移、実行記録をプロダクトの Git 履歴に混ぜないため、次の **別リポジトリ構成**で始めます。
|
|
195
201
|
|
|
196
202
|
- **プロダクトリポジトリ** `app1/`: ソースコードと、仕様・設計などのプロダクトドキュメントを置きます。
|
|
@@ -204,24 +210,27 @@ app1-workspace/
|
|
|
204
210
|
└── app1-specdojo-worktrees/ # task 単位の worktree 置き場
|
|
205
211
|
```
|
|
206
212
|
|
|
207
|
-
`app1
|
|
213
|
+
既に開発している `app1/` と並べてプロジェクトリポジトリを作り、`app1-specdojo/` に SpecDojo を導入します。worktree 用ディレクトリは、最初の隔離実行時に設定に従って作られます。
|
|
208
214
|
|
|
209
215
|
```bash
|
|
210
|
-
mkdir app1-
|
|
211
|
-
|
|
212
|
-
|
|
216
|
+
mkdir app1-workspace
|
|
217
|
+
mkdir app1-workspace/app1-specdojo
|
|
218
|
+
git -C app1-workspace/app1-specdojo init
|
|
219
|
+
cd app1-workspace/app1-specdojo
|
|
213
220
|
npm init -y
|
|
214
|
-
npm install --save-dev specdojo
|
|
221
|
+
npm install --save-dev specdojo
|
|
215
222
|
# 質問に答えて project、register、agent 実行までを初期設定する
|
|
216
223
|
npx specdojo init
|
|
217
224
|
```
|
|
218
225
|
|
|
219
226
|
`specdojo init` は、project ID と名前、人の nickname と表示名、利用する agent provider、
|
|
220
|
-
exec
|
|
227
|
+
exec・Dev Container の要否を順に質問します。成果物カタログは対話では質問せず、`--catalog <size>` を
|
|
228
|
+
明示した場合にだけ初期化時に作成します。選択に応じて設定、登録簿、人と
|
|
221
229
|
agent の名簿、provider の scaffold、`package.json` の `orch:<provider>`、exec の起動設定を
|
|
222
230
|
作成します。exec の親検証は、対応する npm script が `package.json` にあるものだけを設定し、
|
|
223
231
|
該当する script がなければ省略します。既存ファイルは上書きせず、作成内容は `--dry-run` で
|
|
224
|
-
|
|
232
|
+
先に確認できます。対話中に不正な値を入力した場合は理由を表示して同じ質問だけをやり直し、
|
|
233
|
+
それまでの回答は保持します。非対話環境や `--yes` では再質問せず、不正な指定をエラーとして終了します。
|
|
225
234
|
|
|
226
235
|
CI や標準入力が端末でない環境では質問しません。次のようにオプションだけで同じ初期設定を
|
|
227
236
|
行えます。省略値は画面に表示されます。
|
|
@@ -234,18 +243,74 @@ npx specdojo init --yes \
|
|
|
234
243
|
--display-name "Project Owner" \
|
|
235
244
|
--provider claude,codex \
|
|
236
245
|
--exec \
|
|
237
|
-
--catalog small \
|
|
238
246
|
--devcontainer \
|
|
239
247
|
--dry-run
|
|
240
248
|
```
|
|
241
249
|
|
|
242
250
|
初期化後は、表示された `npm run orch:<provider>` でオーケストレーターを起動し、最初の 1 件を
|
|
243
|
-
|
|
251
|
+
起票します。成果物カタログが必要になった場合は、`.specdojo/specdojo.config.json` に `catalog_path` を設定して `specdojo catalog scaffold` で追加します(詳細は [[#41-成果物カタログを作成する|成果物カタログを作成する]] を参照)。オーケストレーターを使わない場合は、同じ案内に表示される
|
|
244
252
|
`exec run --register <id> --executor-by <executor> --reporter-by <reporter>` で実行できます。
|
|
245
253
|
作成された設定と文書は内容を確認して commit してください。
|
|
246
254
|
|
|
247
|
-
|
|
248
|
-
|
|
255
|
+
LP の例と同じく Claude Code へ作業を任せる場合は、provider の質問に `claude`、exec の質問に「はい」と答えます。初期化後は `npm run orch:opus`(または `npm run orch:sonnet`)でオーケストレーターを起動できます。
|
|
256
|
+
|
|
257
|
+
プロダクトを変更する前に、`.specdojo/specdojo.config.json` の `projects.prj-0001` へ、同じ workspace にあるプロダクトリポジトリを接続します。
|
|
258
|
+
|
|
259
|
+
```json
|
|
260
|
+
"repos": [
|
|
261
|
+
{
|
|
262
|
+
"name": "app1",
|
|
263
|
+
"path": "../app1",
|
|
264
|
+
"integration_branch": "main"
|
|
265
|
+
}
|
|
266
|
+
]
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
最初の作業を起票して個票へ完了条件を書いたら、Claude Code の executor と reporter を指定して実行できます。
|
|
270
|
+
|
|
271
|
+
```bash
|
|
272
|
+
npx specdojo register add \
|
|
273
|
+
--project prj-0001 \
|
|
274
|
+
--type todo \
|
|
275
|
+
--title "最初のタスク"
|
|
276
|
+
npx specdojo exec run \
|
|
277
|
+
--project prj-0001 \
|
|
278
|
+
--register PJR-XXXX \
|
|
279
|
+
--worktree \
|
|
280
|
+
--executor-by claude-executor \
|
|
281
|
+
--reporter-by claude-reporter
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
実行後は両方のリポジトリの commit とプロダクトの動作を確認します。
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
git -C ../app1 log --oneline -1
|
|
288
|
+
git log --oneline -1
|
|
289
|
+
npm --prefix ../app1 run dev
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
人が result と成果物を確認し、気づいた改善を次の `todo` や `issue` として残してから、元の登録項目を close します。
|
|
293
|
+
|
|
294
|
+
```bash
|
|
295
|
+
npx specdojo register add \
|
|
296
|
+
--project prj-0001 \
|
|
297
|
+
--type todo \
|
|
298
|
+
--title "次の改善" \
|
|
299
|
+
--commit
|
|
300
|
+
npx specdojo register close \
|
|
301
|
+
--project prj-0001 \
|
|
302
|
+
--id PJR-XXXX \
|
|
303
|
+
--conclusion "完了条件を満たした" \
|
|
304
|
+
--commit
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
`@specdojo/docs-lint` は初期設定に必須ではありません。SpecDojo 文書向けの remark プラグインと検証コマンドを使う場合だけ追加します。
|
|
308
|
+
|
|
309
|
+
```bash
|
|
310
|
+
npm install --save-dev @specdojo/docs-lint
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
リポジトリルートの `.remarkrc.yaml` から次のように公開 export を参照できます。
|
|
249
314
|
|
|
250
315
|
```yaml
|
|
251
316
|
plugins:
|
|
@@ -83,7 +83,7 @@ specdojo register add --project <project-id> --type todo \
|
|
|
83
83
|
--title "在庫初期データの登録" --topic inventory-seed
|
|
84
84
|
```
|
|
85
85
|
|
|
86
|
-
タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID
|
|
86
|
+
タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID を変更できます。成果物や kata(実践の型)を作成・修正する todo では、`--approach <approach> --target <doc-id>` を指定して進め方と対象を宣言できます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
87
87
|
|
|
88
88
|
`--priority` は次の目安で付けます(省略時は `medium`)。
|
|
89
89
|
|
|
@@ -362,6 +362,7 @@ specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree
|
|
|
362
362
|
|
|
363
363
|
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
|
|
364
364
|
- 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
|
|
365
|
+
- todo 個票に `approach` と `targets` を指定した場合、成果物カタログの `done_criteria` や kata 参照を取り込んだ schedule と共通の plan が生成されます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
365
366
|
- 個票 Frontmatter の `targets` に宣言した変更対象文書は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。`targets` がない場合は finding を展開しません。「関連ドキュメント」は根拠や参考への導線であり、そこに wikilink があるだけでは解消対象になりません。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
|
|
366
367
|
- `--register` には複数の PJR-ID を空白区切り・カンマ区切り(またはその混在)で渡せます。指定順に1件ずつ実行し、各IDが plan/result 生成・開始・agent実行・状態遷移まで完結してから次へ進みます。重複したIDは最初の1件だけを実行します。
|
|
367
368
|
- 全ID処理後にID別の成否・状態遷移・commit 結果を一覧表示します。いずれかが失敗した場合は終了コード 1 で終了します。
|
|
@@ -60,7 +60,9 @@ npx specdojo devcontainer scaffold --provider claude,codex
|
|
|
60
60
|
|
|
61
61
|
既存の `.devcontainer/` は通常実行では上書きしません。置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存し、ホストの認証情報・秘密鍵・`.env` は既定でマウントしません。Ollama 接続、コンテナ内の cron、コンテナ内の tmux が必要な場合だけ `--ollama`、`--cron`、`--tmux` を追加します。本書の構成図のようにホスト側の tmux でコンテナ自体を包む場合、`--tmux` は不要です。
|
|
62
62
|
|
|
63
|
-
生成する `devcontainer.json`
|
|
63
|
+
生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリをホスト側と同じ名前の `/workspaces/<親名>` へマウントします。例えば `app1-workspace/app1-specdojo` の作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
|
|
64
|
+
|
|
65
|
+
親名に空白や `/` などがある場合は scaffold が停止するため、`--workspace-name <name>` で英数字・`.`・`_`・`-` だけの名前を指定します。また、コンテナ内で作成した Git worktree は絶対パスを記録します。ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定し、コンテナ内のパスを維持してください。
|
|
64
66
|
|
|
65
67
|
端末版 Emacs と TypeScript・Markdown・YAML・Bash の LSP 環境を追加する場合は `--editor emacs` を指定します。
|
|
66
68
|
|
|
@@ -70,6 +72,13 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
|
|
|
70
72
|
|
|
71
73
|
生成される `.devcontainer/emacs/init.el` は、`~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけコピーされます。空の `~/.emacs.d` があればその中の `init.el` へ、なければ `~/.config/emacs/init.el` へ配置し、配置先を出力します。初回作成前の既定値は生成されたテンプレートで変更でき、作成後は出力されたコピー先を編集します。dotfiles が設定を配置していれば上書きされません。
|
|
72
74
|
|
|
75
|
+
scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
|
|
76
|
+
|
|
77
|
+
- `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。devcontainer が停止していれば `devcontainer up` で起動し、コンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
|
|
78
|
+
- `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。
|
|
79
|
+
|
|
80
|
+
`devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
|
|
81
|
+
|
|
73
82
|
## 3. 構成例
|
|
74
83
|
|
|
75
84
|
```text
|
|
@@ -174,7 +174,7 @@ viewpoint は継続品質評価 `specdojo grade` の正本です。review plan
|
|
|
174
174
|
|
|
175
175
|
`document_kinds.include` は列挙した種類だけへ適用し、`document_kinds.exclude` は列挙した種類を除外します。二つは同時に指定できません。宣言を省略した観点は全種類へ適用します。`grade_targets` は kata / deliverable という評価経路の大分類、`document_kinds` は rulebook ID による文書種類の細分類であり、両方を指定した場合は双方を満たす文書だけを対象にします。
|
|
176
176
|
|
|
177
|
-
`include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
|
|
177
|
+
`include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/docs/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
|
|
178
178
|
|
|
179
179
|
`grade_rubric` の level 0-4 は category を跨いで共有し、viewpoint score を `level × 25` とします。`grade_rubric` には level ごとの `review_verdict`(level 4 が `complete`、level 3 が `complete-with-findings`、level 0-2 が `incomplete`)が定義されています。これは grade の level を review の入力にする写像であり、review はこの対応で観点を判定し直しません。写像の使い方は `grade の結果を review の入力にする規則` に示します。
|
|
180
180
|
|
|
@@ -69,9 +69,9 @@ review agent は、`exec run` の `--review-by` / `--reporter-by`、Job の `tas
|
|
|
69
69
|
|
|
70
70
|
action の `commit: true` は互換として残しています。`task.review` を宣言していない Job でも `commit: true` なら同じ流れで実行しますが、新しい routine では推奨しません。Job が `task.review` を宣言している場合は Job を優先し、`commit` を省略しても、`false` を指定しても review を経て統合します。
|
|
71
71
|
|
|
72
|
-
統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
|
|
72
|
+
統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `partial` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
|
|
73
73
|
|
|
74
|
-
出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings`
|
|
74
|
+
出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合に加え、Run が `partial` で verdict が `complete-with-findings` の場合も、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。`partial`を統合した routine は`last_result: partial`と記録し、`routine list`でも部分成功を表示します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
|
|
75
75
|
|
|
76
76
|
#### waiting Run の確認・統合・破棄
|
|
77
77
|
|
|
@@ -123,7 +123,7 @@ action:
|
|
|
123
123
|
mode: strict
|
|
124
124
|
```
|
|
125
125
|
|
|
126
|
-
配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure
|
|
126
|
+
配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure`、`partial`、`skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`partial`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも部分成功なら `partial`、そのどちらもなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
|
|
127
127
|
|
|
128
128
|
配列 action の実行後は、通常の `last_result` に加えて段ごとの `index`(1始まり)、`kind`、`result` を `last_action_results` へ記録します。単一オブジェクトの action では `last_action_results` を記録せず、既存の状態形式を維持します。
|
|
129
129
|
|
|
@@ -190,7 +190,7 @@ Job runnerは、この入口をmaterialize済みの引数で1回起動し、コ
|
|
|
190
190
|
|
|
191
191
|
scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。保存済み state の `stage_total` が現在の構成と異なる場合は、古い grade の日時にかかわらず完了扱いへ移行せず、state を削除して1段目から再評価します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
|
|
192
192
|
|
|
193
|
-
Job Definition は script を `if`
|
|
193
|
+
Job Definition は script を `if` の条件として起動し、終了コードを保存してそのまま Job runner へ返します。script は全件完了を0、完了文書と失敗文書の混在を2、全件失敗を1、rate limitを75で返します。grade Jobは`partial_exit_code: 2`を宣言するため、2だけが`partial`になりanalysis reporterとreviewへ進みます。Jobは0と2のどちらでも`results.tsv`をcommand evidenceへ出力します。reviewは、`passed`が1件以上あり、`failed`の文書と失敗段がpipeline stateへ記録され次回の`--incomplete`で再試行できる場合だけ`complete-with-findings`を選べます。全件失敗、rate limit、中断、未開始文書があるRunは統合せず`waiting`にします。
|
|
194
194
|
|
|
195
195
|
## 2. due判定と実行
|
|
196
196
|
|
|
@@ -242,7 +242,7 @@ specdojo routine run --project <project-id> --due --dry-run
|
|
|
242
242
|
[routine] skipped rtn-daily-register-sweep: job action skipped
|
|
243
243
|
```
|
|
244
244
|
|
|
245
|
-
`routine-state.json` の `last_result`
|
|
245
|
+
`routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
|
|
246
246
|
|
|
247
247
|
### 2.1. devcontainerでのcron設定
|
|
248
248
|
|
|
@@ -69,7 +69,7 @@ flowchart TD
|
|
|
69
69
|
### 2.1. 新規プロジェクトを最短で立ち上げる
|
|
70
70
|
|
|
71
71
|
- ゴール: 設定から1タスク完了までを最短で通す。
|
|
72
|
-
- 進め方: `
|
|
72
|
+
- 進め方: `specdojo init` → `register add` → 個票へ完了条件を記入 → `exec run --register --worktree` → 変更と動作を確認 → `register close`。成果物を計画的に増やす場合は、その後に成果物カタログと Schedule へ広げる。
|
|
73
73
|
- 主に使う文書: [Quick Startガイド](quick-start-guide.md)、[遂行の技活用ガイド](waza-guide.md)。
|
|
74
74
|
|
|
75
75
|
### 2.2. 課題整理から目的・スコープを固める
|
|
@@ -47,31 +47,36 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
|
|
|
47
47
|
| `project list` | 登録済み project を表示する | `specdojo project list` |
|
|
48
48
|
|
|
49
49
|
`init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
|
|
50
|
-
provider、exec
|
|
51
|
-
|
|
50
|
+
provider、exec、Dev Container の順に質問します。成果物カタログは対話では質問せず、`--catalog <size>` を
|
|
51
|
+
明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
|
|
52
|
+
予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
|
|
53
|
+
表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
|
|
54
|
+
空の場合も、provider の質問だけをやり直します。非対話環境や `--yes` では再質問せず、従来どおり不正な
|
|
55
|
+
指定をエラーとして終了します。
|
|
52
56
|
|
|
53
57
|
非対話環境では質問せず、次の主要オプションと既定値を使います。
|
|
54
58
|
|
|
55
|
-
| オプション
|
|
56
|
-
|
|
|
57
|
-
| `--yes`
|
|
58
|
-
| `--project <id>`
|
|
59
|
-
| `--name <name>`
|
|
60
|
-
| `--no-register`
|
|
61
|
-
| `--nickname <nickname>`
|
|
62
|
-
| `--display-name <name>`
|
|
63
|
-
| `--provider <names>`
|
|
64
|
-
| `--exec`
|
|
65
|
-
| `--catalog <size>`
|
|
66
|
-
| `--devcontainer`
|
|
67
|
-
| `--
|
|
59
|
+
| オプション | 用途 | 既定値 |
|
|
60
|
+
| ------------------------- | ------------------------------------------------------------------------- | --------------- |
|
|
61
|
+
| `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
|
|
62
|
+
| `--project <id>` | project ID | `prj-0001` |
|
|
63
|
+
| `--name <name>` | project の表示名 | `My Project` |
|
|
64
|
+
| `--no-register` | register を作らない | register を作る |
|
|
65
|
+
| `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
|
|
66
|
+
| `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
|
|
67
|
+
| `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
|
|
68
|
+
| `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
|
|
69
|
+
| `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
|
|
70
|
+
| `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
|
|
71
|
+
| `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
|
|
72
|
+
| `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
|
|
68
73
|
|
|
69
74
|
`init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
|
|
70
75
|
provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
|
|
71
76
|
ID だけを `pipeline.parent_validations` へ設定し、該当する script がなければこの設定を省略します。
|
|
72
77
|
採用した ID と省略理由は実行時に表示します。最後にオーケストレーターの起動コマンド、最初の起票、
|
|
73
78
|
オーケストレーターを使わない `--executor-by` / `--reporter-by` の実行例、作成ファイルの commit を
|
|
74
|
-
|
|
79
|
+
次の一歩として表示します(カタログを作らなかった場合は、後から `catalog scaffold` で追加する案内も含みます)。`run.worktree_base` は `../<リポジトリ名>-worktrees` です。個別に設定する
|
|
75
80
|
場合は、以下の `config init`、`config scaffold`、`register scaffold` などを利用します。
|
|
76
81
|
|
|
77
82
|
`config init` は、register 単体で始められる `prj-0001` の最小設定を作成し、設定確認、任意の
|
|
@@ -346,6 +351,8 @@ specdojo schedule strategy generate \
|
|
|
346
351
|
| `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
|
|
347
352
|
| `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
|
|
348
353
|
| `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
|
|
354
|
+
| `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除) | `add` / `update` |
|
|
355
|
+
| `--target <doc-id>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
349
356
|
| `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
|
|
350
357
|
| `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
|
|
351
358
|
| `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
|
|
@@ -359,19 +366,25 @@ specdojo schedule strategy generate \
|
|
|
359
366
|
|
|
360
367
|
`register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
|
|
361
368
|
|
|
369
|
+
`--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
|
|
370
|
+
|
|
362
371
|
`item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
|
|
363
372
|
|
|
364
373
|
`--registered` / `--completed` にはタイムゾーン付きの RFC 3339 値(`2026-08-09T14:08:51Z` または `2026-08-09T23:08:51+09:00`)を指定し、保存時に UTC へ正規化します。タイムゾーンを含まない値は解釈が実行環境に依存するため受け付けません。期限(`--due`)は瞬間ではなく暦日のため `YYYY-MM-DD` のままです。
|
|
365
374
|
|
|
366
375
|
`register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
|
|
367
376
|
|
|
377
|
+
`register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照と存在しない項目は書き込み前に拒否します。別 project が設定にあれば存在も確認し、未設定なら書式だけを確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
|
|
378
|
+
|
|
379
|
+
`register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
|
|
380
|
+
|
|
368
381
|
記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
|
|
369
382
|
|
|
370
383
|
一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
|
|
371
384
|
|
|
372
385
|
`register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
|
|
373
386
|
|
|
374
|
-
`register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason` です。
|
|
387
|
+
`register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`derived_from` です。
|
|
375
388
|
|
|
376
389
|
各書き込みコマンドは現在値を個票へ、event を項目別イベントファイルへ反映します。同じ現在値になる操作の再実行では event を追加しません。`register build` は個票とイベントファイルの対応、event の schema、ID 一意性、時刻順、直前イベント参照、状態連鎖、最新 event と現在値の一致を検証します。
|
|
377
390
|
|
|
@@ -445,10 +458,15 @@ specdojo schedule strategy generate \
|
|
|
445
458
|
| `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
|
|
446
459
|
| `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
|
|
447
460
|
| `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
|
|
461
|
+
| `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
|
|
462
|
+
| `--fallback-executor-by <name>` | `fallback` 時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
|
|
463
|
+
| `--fallback-reporter-by <name>` | `fallback` 時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
|
|
448
464
|
| `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
|
|
449
465
|
|
|
450
466
|
`--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
|
|
451
467
|
|
|
468
|
+
指名した agent の rate limit は既定では `stop` です。`wait` は provider の reset / retry-after、次に `rate_limit_policy.cooldown_seconds` を使い、`rate_limit_policy.pinned.max_wait_seconds`(既定8時間)以内なら同じ段を同じ agent で再開します。`fallback` は対応する fallback flag または `rate_limit_policy.pinned.fallback_executor_by` / `fallback_reporter_by` の agent へ1回だけ切り替えます。fallback 未指定時と fallback agent も上限になった場合は停止します。CLI が `exec-defaults.yaml` より優先します。待機中は project の実行ロックを保持します。
|
|
469
|
+
|
|
452
470
|
agent の指定は repository 共通 roster nickname(`.specdojo/agent-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
|
|
453
471
|
|
|
454
472
|
Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` の既定の実行方式です。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの agent 選択は行いません。`--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると、その agent で実行します。`--by` と `--executor-by` / `--reporter-by` をいずれも指定しない場合は、`stage_role: executor`(`mode: edit` または `mode` 未指定)と `stage_role: reporter` の agent から `priority` 順に自動で選びます。`stage_role` を持たない agent(翻訳専用など)は自動選択の候補に入りません。どちらかの段に該当する agent がいない場合は、`--executor-by` / `--reporter-by` の指定を求めるエラーで実行前に止まります。複数項目では `--executor-by PJR-0001=exec-a,PJR-0002=exec-b` のような項目別指定も使用できます。項目別指定は選択した全項目を含む必要があり、対象外 ID と指定漏れは実行前にエラーになります。片方だけの指定もエラーになります。
|
|
@@ -889,19 +907,20 @@ Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加
|
|
|
889
907
|
| ----------------------- | ------------------------------------------- |
|
|
890
908
|
| `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
|
|
891
909
|
|
|
892
|
-
`devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh`
|
|
910
|
+
`devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` を指定した場合は Emacs 用の `emacs/init.el` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
|
|
893
911
|
|
|
894
912
|
主要オプション:
|
|
895
913
|
|
|
896
|
-
| オプション
|
|
897
|
-
|
|
|
898
|
-
| `--provider <names>`
|
|
899
|
-
| `--editor emacs`
|
|
900
|
-
| `--ollama`
|
|
901
|
-
| `--cron`
|
|
902
|
-
| `--tmux`
|
|
903
|
-
| `--
|
|
904
|
-
| `--
|
|
914
|
+
| オプション | 用途 |
|
|
915
|
+
| ------------------------- | ----------------------------------------------------------- |
|
|
916
|
+
| `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
|
|
917
|
+
| `--editor emacs` | 端末版 Emacs、LSP・検索ツール、初期設定を追加する。 |
|
|
918
|
+
| `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
|
|
919
|
+
| `--cron` | cron をインストールし、起動時にサービスを開始する。 |
|
|
920
|
+
| `--tmux` | tmux をインストールする。 |
|
|
921
|
+
| `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
|
|
922
|
+
| `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
|
|
923
|
+
| `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
|
|
905
924
|
|
|
906
925
|
```bash
|
|
907
926
|
# claude と codex 用の CLI を含む Dev Container を生成する
|
|
@@ -912,11 +931,16 @@ npx specdojo devcontainer scaffold --provider claude --ollama --tmux
|
|
|
912
931
|
|
|
913
932
|
# 端末版 Emacs と、すぐ使える組み込み機能だけの設定を追加する
|
|
914
933
|
npx specdojo devcontainer scaffold --provider claude --editor emacs
|
|
934
|
+
|
|
935
|
+
# ホスト側の親名を変えた後も、コンテナ内の従来パスを保つ
|
|
936
|
+
npx specdojo devcontainer scaffold --workspace-name app1-workspace
|
|
915
937
|
```
|
|
916
938
|
|
|
917
939
|
`.devcontainer/` が既に存在する場合は何も書き込まず、置き換える場合だけ `--force` を指定します。上書き前や初回生成前は `--dry-run` で対象ファイルを確認してください。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存してコンテナ再作成後も利用できるようにし、ホストの認証情報・秘密鍵・`.env` を直接マウントしません。認証は生成したコンテナ内で行います。
|
|
918
940
|
|
|
919
|
-
生成する `devcontainer.json` は `${localWorkspaceFolder}/..`
|
|
941
|
+
生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を、ホスト側の親ディレクトリ名に合わせた `/workspaces/<親名>` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。例えば `app1-workspace/app1-specdojo` で scaffold すると、作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
|
|
942
|
+
|
|
943
|
+
親名には英数字・`.`・`_`・`-` だけを使用できます。空白、`/`、制御文字などを含む場合は、意図しないパスへ置換せずエラーにします。必要なら `--workspace-name <name>` で有効な名前を指定してください。`specdojo init --devcontainer` でも同じオプションを指定できます。コンテナ内で作った Git worktree は作成時の絶対パスを記録するため、ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定してコンテナ内のパスを保ってください。
|
|
920
944
|
|
|
921
945
|
`codex` provider を指定した場合だけ、生成する `devcontainer.json` の `runArgs` に `--security-opt=seccomp=unconfined` を追加します。Docker の既定 seccomp profile は Codex 同梱の bubblewrap が sandbox 作成時に使う user namespace の作成を拒否するためです。この設定は devcontainer 全体の syscall filter を無効にしてコンテナの隔離を弱めますが、追加の Linux capability は付与せず、Docker が保護する `/proc` や `/sys` の system path も公開しません。`--security-opt=systempaths=unconfined` は保護範囲をさらに広げるため使用しません。
|
|
922
946
|
|
|
@@ -22,7 +22,7 @@ Project Register Documentation Rules
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
24
|
- TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘の全登録項目は、それぞれ 1 件の個票を持つ。
|
|
25
|
-
- 個票 Frontmatter
|
|
25
|
+
- 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論、起票元の唯一の正本である。
|
|
26
26
|
- `events/pjr-XXXX.yaml` は、起票・状態遷移・更新を追う監査履歴の正本である。現在値の再計算には使わず、個票の現在値との整合を検証する。
|
|
27
27
|
- 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
|
|
28
28
|
- `generated/pjr-index.md` とすべての派生ビューは個票から `register build` で生成し、直接編集しない。
|
|
@@ -48,7 +48,7 @@ Project Register Documentation Rules
|
|
|
48
48
|
- 個票は `docs/ja/projects/<project-id>/controls/project-register/` 直下に置く。
|
|
49
49
|
- 項目別イベントログは同ディレクトリの `events/` 配下に置き、個票 1 件につき 1 ファイルとする。
|
|
50
50
|
- 登録項目一覧は `docs/ja/projects/<project-id>/controls/project-register/generated/pjr-index.md` に生成する。
|
|
51
|
-
-
|
|
51
|
+
- 状態別・優先度別・担当者別の補助一覧と、元の項目から派生先を辿る一覧は同じ `generated/` 配下に生成する。
|
|
52
52
|
- controls 全体の type 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
|
|
53
53
|
|
|
54
54
|
## 3. 推奨 Frontmatter 項目
|
|
@@ -71,12 +71,15 @@ Project Register Documentation Rules
|
|
|
71
71
|
| `completed_at` | 完了・却下・決定日時 | 条件 |
|
|
72
72
|
| `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
|
|
73
73
|
| `conclusion` | 終端時の結論要約 | 任意 |
|
|
74
|
+
| `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
|
|
75
|
+
| `approach` | 対象を作成・修正するときの進め方 | 任意 |
|
|
74
76
|
| `targets` | 変更対象文書の doc id リスト | 任意 |
|
|
75
77
|
|
|
76
78
|
- `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
|
|
77
79
|
- `item_type`、`item_status`、`priority` の値は schema の enum だけを使用する。
|
|
78
80
|
- `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
|
|
79
81
|
- Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
|
|
82
|
+
- `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。別 project が設定にない場合は書式だけを検証し、設定された後に存在確認できるよう project 修飾を維持する。
|
|
80
83
|
|
|
81
84
|
### 3.1. 日時と日付の使い分け
|
|
82
85
|
|
|
@@ -109,13 +112,14 @@ Project Register Documentation Rules
|
|
|
109
112
|
|
|
110
113
|
### 4.2. 生成一覧と派生ビュー
|
|
111
114
|
|
|
112
|
-
| 生成物 | 内容
|
|
113
|
-
| ------------------------------------ |
|
|
114
|
-
| `generated/pjr-index.md` | 全個票の一覧
|
|
115
|
-
| `generated/pjr-views-by-status.md` | 状態別の補助一覧
|
|
116
|
-
| `generated/pjr-views-by-priority.md` | 優先度別の補助一覧
|
|
117
|
-
| `generated/pjr-views-by-owner.md` | 担当者別の補助一覧
|
|
118
|
-
| `
|
|
115
|
+
| 生成物 | 内容 | 編集可否 |
|
|
116
|
+
| ------------------------------------ | -------------------- | -------- |
|
|
117
|
+
| `generated/pjr-index.md` | 全個票の一覧 | 不可 |
|
|
118
|
+
| `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
|
|
119
|
+
| `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
|
|
120
|
+
| `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
|
|
121
|
+
| `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
|
|
122
|
+
| `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
|
|
119
123
|
|
|
120
124
|
- 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票とする。
|
|
121
125
|
- タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。
|
|
@@ -131,13 +135,15 @@ Project Register Documentation Rules
|
|
|
131
135
|
- 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
|
|
132
136
|
- 結果・結論には、完了を判定した根拠と後続対応を記載する。
|
|
133
137
|
- 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
|
|
138
|
+
- 実行中に問題や後続作業を見つけて別の登録項目を起票するときは、起票元を `derived_from` に必ず記録する。decision から todo を起票する場合も同じ関係を使い、decision 本文へ追跡先を重複記載しない。既存本文の追跡先は移行のために書き換えない。
|
|
134
139
|
- 本項目の実施において確実に変更する対象文書が分かっている場合は、その文書 ID を Frontmatter の `targets` 配列へ宣言する。宣言した `targets` は agent 実行時の変更網羅検証(target coverage)に用いられる。未知の場合や対象を固定しない場合は宣言を省略する。
|
|
140
|
+
- `approach` を宣言する場合、`targets` は 1 件だけ必須とする。`fully-guided`・`recipe-guided`・`freeform`・`bootstrap`・`retrofit`・`cross-deliverable-dedup`・`finalize`・`bootstrap-finalize` の対象は成果物カタログにある成果物の doc id とし、まだ文書がない成果物もカタログで解決する。`rulebook-maintenance`・`recipe-maintenance`・`sample-maintenance`・`template-maintenance` の対象は、名前に対応する種別の kata の doc id とし、文書索引で解決する。対応する正本で解決できない ID や、`approach` と種別が合わない対象は使用しない。
|
|
135
141
|
|
|
136
142
|
### 5.2. 構造化フィールドと生成
|
|
137
143
|
|
|
138
144
|
- 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
|
|
139
|
-
- 担当・期限・結論・topic などを変更するときは `register update
|
|
140
|
-
- `register build`
|
|
145
|
+
- 担当・期限・結論・topic・`derived_from`・`approach`・`targets` などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。`register add` と `register update` では、起票元に繰り返し指定できる `--from`、進め方に `--approach`、対象に繰り返し指定できる `--target` を使う。起票元、`approach`、対象を削除するときは、それぞれ `--from -`、`--approach -`、`--target -` を指定する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
|
|
146
|
+
- `register build` は個票を読み取り、一覧・派生ビューを再生成する。`generated/pjr-derived-items.md` では `derived_from` を逆引きし、元の項目から派生先を辿れるようにする。一覧を編集して個票へ反映する経路はない。
|
|
141
147
|
- `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時もコマンドが既定値を記録する。
|
|
142
148
|
- 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
|
|
143
149
|
- ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。
|
|
@@ -68,9 +68,10 @@ Job Definition Standard
|
|
|
68
68
|
- 既存 Job Run の retry は保存済みの対象と再開状態を維持するため precondition を再実行しない。`--dry-run` は precondition を実行せず、解決済みコマンドと skip 条件を表示する。
|
|
69
69
|
- command から対象プロジェクトを指定するときは template 値 `{{project_id}}` を使い、同じ CLI を子プロセスで呼ぶときは `{{specdojo}}` を使う。`specdojo` という PATH 上の別 checkout を直接呼ばない。
|
|
70
70
|
- script が中断再開用の ID を要求するときは `{{job_run_id}}` を渡す。期間などの `inputs` から再開キーを組み立てない。
|
|
71
|
-
- runner は POSIX 環境では `/bin/sh -eu`
|
|
71
|
+
- runner は POSIX 環境では `/bin/sh -eu` でコマンドを実行する。終了コード0は`succeeded`、`task.partial_exit_code`に明示した非0は`partial`、それ以外の非0は`failed`とする。
|
|
72
|
+
- `task.partial_exit_code`は1〜255の単一値とし、完了した処理と再試行可能な失敗が同じ Run に混在してreviewへ委ねる必要がある command Jobだけが指定する。command 内の前処理などが偶然同じ終了コードを返さないように正規化し、汎用的なエラー終了を部分成功へ読み替えてはならない。
|
|
72
73
|
- runner はコマンド、終了コード、標準出力、標準エラーを bounded・redacted evidence として保存する。stdout / stderr は監査用ログへの参照に加え、analysis reporter が追加のファイル読取なしで判断できるよう evidence 本体にも同じ bounded 内容を含める。
|
|
73
|
-
- `task.analysis`
|
|
74
|
+
- `task.analysis` は任意である。省略時は終了コードだけで状態を確定し、指定時は`succeeded`または`partial`のコマンド後に evidence を reporter agent へ渡す。
|
|
74
75
|
- analysis の根拠にする生成ファイルは command が stdout へ出力する。reporter は evidence 本体に埋め込まれた bounded stdout / stderr だけを読み、参照先ログや作業ツリーのファイルを追加で検査しない。
|
|
75
76
|
|
|
76
77
|
### 3.4. 責務境界と粒度
|
|
@@ -102,22 +103,23 @@ Job Definition Standard
|
|
|
102
103
|
|
|
103
104
|
## 4. 値制約・判定基準
|
|
104
105
|
|
|
105
|
-
| 項目
|
|
106
|
-
|
|
|
107
|
-
| `id`
|
|
108
|
-
| `task.mode`
|
|
109
|
-
| `task.description`
|
|
110
|
-
| `task.command`
|
|
111
|
-
| `task.
|
|
112
|
-
| `task.
|
|
113
|
-
| `task.
|
|
114
|
-
| `task.
|
|
115
|
-
| `task.agent.
|
|
116
|
-
| `task.
|
|
117
|
-
| `task.review
|
|
118
|
-
| `
|
|
119
|
-
| `
|
|
120
|
-
| `
|
|
106
|
+
| 項目 | 必須 | 判定基準 |
|
|
107
|
+
| ------------------------ | ---- | ------------------------------------------------------------------------------- |
|
|
108
|
+
| `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
|
|
109
|
+
| `task.mode` | ○ | `edit` / `review` / `command` |
|
|
110
|
+
| `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
|
|
111
|
+
| `task.command` | 条件 | `command` で必須。入力展開後も非空 |
|
|
112
|
+
| `task.partial_exit_code` | 任意 | `command` だけで使用する1〜255の終了コード。明示した値だけを`partial`とする |
|
|
113
|
+
| `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
|
|
114
|
+
| `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
|
|
115
|
+
| `task.targets` `paths` | 条件 | `edit` / `review` はいずれか必須。`command` では任意 |
|
|
116
|
+
| `task.agent.executor` | 任意 | `.specdojo/agent-members.yaml` の nickname 書式(`^[a-z0-9][a-z0-9_-]{0,62}$`) |
|
|
117
|
+
| `task.agent.reporter` | 任意 | 同上。executor が result を書かない構成では必須 |
|
|
118
|
+
| `task.review` | 任意 | mapping。存在すれば統合前 review の宣言。`agent` 以外のキーを持たない |
|
|
119
|
+
| `task.review.agent` | 任意 | `executor` 必須・`reporter` 任意。書式は `task.agent` と同じ nickname 書式 |
|
|
120
|
+
| `inputs.*.enum` | 任意 | scalar の値または list の各要素に対する非空の許容値集合 |
|
|
121
|
+
| `minimum` / `maximum` | 任意 | integer input だけに指定でき、`minimum <= maximum` |
|
|
122
|
+
| `run.idempotency_key` | ○ | 空文字へ解決されず、同じ論理実行を一意に判別できる |
|
|
121
123
|
|
|
122
124
|
## 5. 記述例
|
|
123
125
|
|