specdojo 0.2.1 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +165 -0
- package/CHANGELOG.md +298 -0
- package/README.md +92 -42
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/catalog-build-references.js +144 -0
- package/dist/catalog-build-render.js +144 -0
- package/dist/catalog-build.js +13 -290
- package/dist/catalog-generate.js +6 -9
- package/dist/catalog-plan-generate.js +2 -2
- package/dist/catalog-plan.js +6 -6
- package/dist/catalog-scaffold.js +4 -4
- package/dist/catalog.js +2 -2
- package/dist/dashboard-exec-records.js +105 -0
- package/dist/dashboard-routines.js +255 -0
- package/dist/dashboard-shared.js +14 -0
- package/dist/dashboard-timeline.js +175 -0
- package/dist/dashboard.js +31 -444
- package/dist/deliverable-trash.js +3 -3
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/doc-index.js +3 -3
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-commands.js +557 -0
- package/dist/exec-core.js +457 -0
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans-core.js +693 -0
- package/dist/exec-plans-generation.js +206 -0
- package/dist/exec-plans-storage.js +131 -0
- package/dist/exec-plans.js +3 -1016
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration-git.js +23 -0
- package/dist/exec-repo-integration-sync.js +264 -0
- package/dist/exec-repo-integration.js +534 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter-output.js +206 -0
- package/dist/exec-reporter.js +525 -248
- package/dist/exec-results.js +103 -71
- package/dist/exec-run-agent-pipeline.js +256 -0
- package/dist/exec-run-agent.js +531 -0
- package/dist/exec-run-in-place.js +541 -0
- package/dist/exec-run-job.js +717 -0
- package/dist/exec-run-lifecycle-commands.js +522 -0
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run-mode-shared.js +140 -0
- package/dist/exec-run-register-command.js +244 -0
- package/dist/exec-run-register-core.js +386 -0
- package/dist/exec-run-register-mode.js +206 -0
- package/dist/exec-run-register-resume.js +393 -0
- package/dist/exec-run-register-state.js +322 -0
- package/dist/exec-run-register-worktree.js +509 -0
- package/dist/exec-run-schedule-mode.js +294 -0
- package/dist/exec-run-schedule-prepare.js +353 -0
- package/dist/exec-run-schedule-task.js +572 -0
- package/dist/exec-run-shared.js +399 -0
- package/dist/exec-run.js +11 -4953
- package/dist/exec-shared.js +9 -2
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial-commands.js +558 -0
- package/dist/exec-trial-core.js +371 -0
- package/dist/exec-trial.js +2 -895
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops-commit.js +707 -0
- package/dist/exec-worktree-ops-lifecycle.js +292 -0
- package/dist/exec-worktree-ops-merge.js +303 -0
- package/dist/exec-worktree-ops.js +3 -847
- package/dist/exec-worktree.js +146 -31
- package/dist/exec.js +2 -999
- package/dist/frontmatter-namespace.js +2 -2
- package/dist/grade-apply.js +734 -0
- package/dist/grade-command-apply.js +250 -0
- package/dist/grade-command-inspect.js +138 -0
- package/dist/grade-command-plan.js +101 -0
- package/dist/grade-command-shared.js +68 -0
- package/dist/grade-core.js +307 -0
- package/dist/grade-markdown.js +274 -0
- package/dist/grade-pipeline-state.js +184 -0
- package/dist/grade-plan.js +507 -0
- package/dist/grade-result.js +133 -5
- package/dist/grade-target-discovery.js +265 -0
- package/dist/grade-targets.js +432 -0
- package/dist/grade.js +14 -2451
- package/dist/init-command.js +443 -0
- package/dist/job-definition.js +670 -0
- package/dist/job.js +64 -578
- package/dist/kata-command.js +2 -2
- package/dist/orchestrator.js +213 -0
- package/dist/register-command-types.js +1 -0
- package/dist/register-core.js +363 -0
- package/dist/register-create-commands.js +245 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-events.js +4 -4
- package/dist/register-item.js +13 -7
- package/dist/register-maintenance-commands.js +187 -0
- package/dist/register-migration.js +268 -0
- package/dist/register-renumber.js +314 -0
- package/dist/register-transition-commands.js +248 -0
- package/dist/register-update.js +230 -0
- package/dist/register-views.js +256 -0
- package/dist/register.js +175 -1975
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +114 -4
- package/dist/review-types.js +40 -1
- package/dist/routine-definition.js +401 -0
- package/dist/routine.js +73 -402
- package/dist/schedule-approach.js +2 -2
- package/dist/schedule-build.js +2 -2
- package/dist/schedule-strategy-generate-document.js +273 -0
- package/dist/schedule-strategy-generate-scope.js +199 -0
- package/dist/schedule-strategy-generate.js +9 -473
- package/dist/schedule.js +19 -6
- package/dist/specdojo-config.js +465 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/dist/yaml-pages.js +4 -4
- package/dist/yaml.js +28 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +335 -92
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +17 -12
- package/templates/antigravity/README.md +29 -4
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
- package/templates/antigravity/orchestrator.md +18 -7
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +18 -7
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
- package/templates/codex/orchestrator.md +18 -7
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +74 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
|
@@ -226,13 +226,14 @@ tasks:
|
|
|
226
226
|
|
|
227
227
|
大規模プロジェクトでは、次の文書を併用することを推奨する。
|
|
228
228
|
|
|
229
|
-
| 文書
|
|
230
|
-
|
|
|
231
|
-
| `pm-organization.md`
|
|
232
|
-
| `pm-members.yaml`
|
|
233
|
-
|
|
|
234
|
-
| `
|
|
235
|
-
|
|
|
229
|
+
| 文書 | 目的 |
|
|
230
|
+
| ------------------------------ | -------------------------------------------- |
|
|
231
|
+
| `pm-organization.md` | ロールと責務境界を定義する |
|
|
232
|
+
| `pm-members.yaml` | 人間の実行主体を project ごとに定義する |
|
|
233
|
+
| `.specdojo/agent-members.yaml` | agent の実行主体を repository 共通で定義する |
|
|
234
|
+
| `pm-raci.md` | 成果物・プロセスごとの責任分担を定義する |
|
|
235
|
+
| `prj-stakeholder-register.md` | 外部関係者、期待、懸念、合意対象を管理する |
|
|
236
|
+
| communication 関連文書 | 報告、共有、合意、エスカレーションを管理する |
|
|
236
237
|
|
|
237
238
|
## 5. 用語定義
|
|
238
239
|
|
|
@@ -268,7 +269,7 @@ tasks:
|
|
|
268
269
|
|
|
269
270
|
### 6.2. `pm-members.yaml`
|
|
270
271
|
|
|
271
|
-
`pm-members.yaml`
|
|
272
|
+
`pm-members.yaml` は、人間の実行主体の machine-readable な一覧を project ごとに管理する。agent の実行定義は repository 共通の `.specdojo/agent-members.yaml` に置き、CLI は両者を検証・合成して利用する。
|
|
272
273
|
|
|
273
274
|
標準フィールド:
|
|
274
275
|
|
|
@@ -280,9 +281,9 @@ tasks:
|
|
|
280
281
|
| `members[].display_name` | ○ | 表示名 |
|
|
281
282
|
| `members[].email` | 任意 | 公開可能な連絡先。公開文書では `null` を推奨 |
|
|
282
283
|
| `members[].roles` | 任意 | 対応する Role code のリスト。兼務の場合は複数記載する。汎用 agent は `[]` 可 |
|
|
283
|
-
| `members[].type` | ○ | `human`
|
|
284
|
-
| `members[].persona` | 任意 |
|
|
285
|
-
| `members[].focus` | 任意 |
|
|
284
|
+
| `members[].type` | ○ | `human` 固定 |
|
|
285
|
+
| `members[].persona` | 任意 | member の作業姿勢 |
|
|
286
|
+
| `members[].focus` | 任意 | member が重視する観点 |
|
|
286
287
|
| `members[].scheduler_strategy` | 任意 | scheduler の既定選択戦略 |
|
|
287
288
|
| `members[].note` | 任意 | 補足 |
|
|
288
289
|
|
|
@@ -324,16 +325,16 @@ WBS Item から Schedule Task を作る際は、以下の順で担当を決め
|
|
|
324
325
|
|
|
325
326
|
### 7.2. `owner` と `--by` の違い
|
|
326
327
|
|
|
327
|
-
| 項目 | 意味 | 値の例 | 管理先
|
|
328
|
-
| ------- | --------------------------------- | ----------------------- |
|
|
329
|
-
| `owner` | タスクの主責任ロール | `PO`, `BA`, `ARC`, `QE` | Schedule
|
|
330
|
-
| `roles` | member が対応できるロールのリスト | `[BA]`, `[PO, PM, OPS]` | `pm-members.yaml`
|
|
331
|
-
| `--by` | タスクを claim / 実行する主体 | `ba-agent` |
|
|
328
|
+
| 項目 | 意味 | 値の例 | 管理先 |
|
|
329
|
+
| ------- | --------------------------------- | ----------------------- | ------------------- |
|
|
330
|
+
| `owner` | タスクの主責任ロール | `PO`, `BA`, `ARC`, `QE` | Schedule |
|
|
331
|
+
| `roles` | member が対応できるロールのリスト | `[BA]`, `[PO, PM, OPS]` | `pm-members.yaml` |
|
|
332
|
+
| `--by` | タスクを claim / 実行する主体 | `ba-agent` | 合成名簿 / 実行ログ |
|
|
332
333
|
|
|
333
334
|
原則:
|
|
334
335
|
|
|
335
336
|
- Schedule Task の `owner` には member nickname を書かない。
|
|
336
|
-
- `--by` に指定できる nickname
|
|
337
|
+
- `--by` に指定できる nickname は、`pm-members.yaml` と `.specdojo/agent-members.yaml` の合成名簿に一意に存在しなければならない。
|
|
337
338
|
- member の `roles` にタスクの `owner` が含まれていることを推奨する。
|
|
338
339
|
- `roles: []` の汎用 agent が実行する場合は、実行時の文脈で対象 Role を明示する。
|
|
339
340
|
|
|
@@ -380,17 +381,21 @@ members:
|
|
|
380
381
|
display_name: Project Owner
|
|
381
382
|
roles: [PO, PM, OPS]
|
|
382
383
|
type: human
|
|
384
|
+
```
|
|
383
385
|
|
|
384
|
-
|
|
385
|
-
display_name: Project Owner Agent
|
|
386
|
-
roles: [PO, PM, OPS]
|
|
387
|
-
type: agent
|
|
388
|
-
scheduler_strategy: critical-first
|
|
386
|
+
`.specdojo/agent-members.yaml`:
|
|
389
387
|
|
|
388
|
+
```yaml
|
|
389
|
+
version: 1
|
|
390
|
+
members:
|
|
390
391
|
- nickname: ba-agent
|
|
391
392
|
display_name: Business Analyst Agent
|
|
392
393
|
roles: [BA]
|
|
393
394
|
type: agent
|
|
395
|
+
provider: custom
|
|
396
|
+
capabilities: []
|
|
397
|
+
proficiency: normal
|
|
398
|
+
priority: 1
|
|
394
399
|
```
|
|
395
400
|
|
|
396
401
|
Schedule:
|
|
@@ -408,16 +413,16 @@ tasks:
|
|
|
408
413
|
|
|
409
414
|
People / Organization 定義は、以下のタイミングで見直す。
|
|
410
415
|
|
|
411
|
-
| 更新トリガー | 見直し対象
|
|
412
|
-
| -------------------------------------- |
|
|
413
|
-
| プロジェクトスコープ変更 | Stakeholder、Role、RACI
|
|
414
|
-
| 成果物カタログまたは WBS の変更 | RACI、Schedule owner
|
|
415
|
-
| Schedule のトラック追加 | Role、Member、scheduler strategy
|
|
416
|
-
| agent 追加・削除 |
|
|
417
|
-
| 複数人運用の開始 | `PM` ロール、RACI、承認責任
|
|
418
|
-
| 外部利用者・貢献者の関与開始 | stakeholder register、コミュニケーション要件
|
|
419
|
-
| 公開前 | 個人情報、機密情報、公開可能な連絡先
|
|
420
|
-
| 実行ログに存在する nickname の変更要求 | 変更せず、新 nickname 追加または無効化で対応
|
|
416
|
+
| 更新トリガー | 見直し対象 |
|
|
417
|
+
| -------------------------------------- | --------------------------------------------------------- |
|
|
418
|
+
| プロジェクトスコープ変更 | Stakeholder、Role、RACI |
|
|
419
|
+
| 成果物カタログまたは WBS の変更 | RACI、Schedule owner |
|
|
420
|
+
| Schedule のトラック追加 | Role、Member、scheduler strategy |
|
|
421
|
+
| agent 追加・削除 | `.specdojo/agent-members.yaml`、委任方針、agent overrides |
|
|
422
|
+
| 複数人運用の開始 | `PM` ロール、RACI、承認責任 |
|
|
423
|
+
| 外部利用者・貢献者の関与開始 | stakeholder register、コミュニケーション要件 |
|
|
424
|
+
| 公開前 | 個人情報、機密情報、公開可能な連絡先 |
|
|
425
|
+
| 実行ログに存在する nickname の変更要求 | 変更せず、新 nickname 追加または無効化で対応 |
|
|
421
426
|
|
|
422
427
|
## 12. 禁止事項
|
|
423
428
|
|
|
@@ -66,7 +66,7 @@ Philosophy Authoring Standard
|
|
|
66
66
|
- ファイル名は `<subject>-philosophy.md` とする。
|
|
67
67
|
- `id` / `type` / `status` を必須とし、共通原則は [document-metadata-standard.md](document-metadata-standard.md) に従う。
|
|
68
68
|
- `type` は `philosophy` 固定とする。
|
|
69
|
-
- `id` は `specdojo:<subject>-philosophy` 形式とし、authority は所有元、local-id は主題と文書種別だけを表す([id-and-file-naming-standard.md](id-and-file-naming-standard.md) の
|
|
69
|
+
- `id` は `specdojo:<subject>-philosophy` 形式とし、authority は所有元、local-id は主題と文書種別だけを表す([id-and-file-naming-standard.md](id-and-file-naming-standard.md) の `型の文書のlocal-id` に従う)。
|
|
70
70
|
- `status` は `draft` / `ready` / `deprecated` のいずれかとする。
|
|
71
71
|
|
|
72
72
|
| 項目 | 必須 | 説明 |
|
|
@@ -68,23 +68,26 @@ specdojo:
|
|
|
68
68
|
|
|
69
69
|
章構成は以下を原則とする。不要な章は省略可だが、省略理由を記載することを推奨する。
|
|
70
70
|
|
|
71
|
-
| 章番号 | 章タイトル | 必須
|
|
72
|
-
| ------ | --------------------- |
|
|
73
|
-
| 1 | 全体方針 | ○
|
|
74
|
-
| 2 | 位置づけと用語定義 | 任意
|
|
75
|
-
| 3 | ファイル命名・ID規則 | ○
|
|
76
|
-
| 4 | 推奨 Frontmatter 項目 | 任意
|
|
77
|
-
| 5 | 本文要件 | ○
|
|
78
|
-
| 6 | 記述ガイド | ○
|
|
79
|
-
| 7 | 禁止事項 | ○
|
|
80
|
-
| 8 | サンプル |
|
|
71
|
+
| 章番号 | 章タイトル | 必須 | 説明 |
|
|
72
|
+
| ------ | --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
|
|
73
|
+
| 1 | 全体方針 | ○ | 目的・適用範囲・記載レベルの方針をまとめる |
|
|
74
|
+
| 2 | 位置づけと用語定義 | 任意 | Mermaid などで関係を示し、複数の解釈を防ぐ必要がある用語だけを定義する。用語定義が不要な場合は章を`位置づけ`とする |
|
|
75
|
+
| 3 | ファイル命名・ID規則 | ○ | id / ファイル名 / 命名規則 |
|
|
76
|
+
| 4 | 推奨 Frontmatter 項目 | 任意 | スキーマと必須/任意の項目 |
|
|
77
|
+
| 5 | 本文要件 | ○ | 各章・キーの目的、必須・任意、記述規約。template 未整備系統では開始時の参考となる本文構成も扱う |
|
|
78
|
+
| 6 | 記述ガイド | ○ | 各章の書き方、推奨表、例など |
|
|
79
|
+
| 7 | 禁止事項 | ○ | してはいけない記述、スキーマ違反など |
|
|
80
|
+
| 8 | サンプル | 経過措置 | 完成例は sample へ外出しする。既存 rulebook の外出しが完了するまでの経過措置として、最小例だけを自己完結したコードブロックで埋め込む |
|
|
81
81
|
|
|
82
82
|
補足:
|
|
83
83
|
|
|
84
84
|
- template を文書 ID で宣言する系統では、見出し順・表・記入欄の骨組みを template の正本とし、rulebook の本文要件には各章・キーの目的、必須・任意、記述規約を残す。同じ見出しの羅列を転載しない。
|
|
85
85
|
- `template: not-needed`、`template: undecided`、template 項目省略の系統では、成果物の内容要件を判断できるよう、本文要件に必要な章・キーと必須・任意を記載する。
|
|
86
86
|
- 記述ガイドには、章ごとの書き方と例(表・サンプル)を置き、重複を避けるため共通事項は上位(index)を SSOT とする方針を記載する。
|
|
87
|
-
- sample / recipe / template との対応関係は Frontmatter の `sample` / `recipe` / `template` だけで示す。本文にリンク章(`サンプル` / `作成レシピ` / `テンプレート`)や wikilink を置かない。fully-guided 実行では rulebook
|
|
87
|
+
- sample / recipe / template との対応関係は Frontmatter の `sample` / `recipe` / `template` だけで示す。本文にリンク章(`サンプル` / `作成レシピ` / `テンプレート`)や wikilink を置かない。fully-guided 実行では rulebook / recipe / sample の参照先を Frontmatter から解決して plan へ注入し、template は読み込まないため、本文中のリンクは参照手段として働かない。
|
|
88
|
+
- **完成例の正本は sample とする。** 新規作成および改訂では、完成例を `<prefix>-sample` へ置き、rulebook へ再掲しない。同じ完成例を 2 箇所に持つと、本文要件を変えたときに片方が取り残される。
|
|
89
|
+
- `サンプル` 章は経過措置である。`xep-fully-guided-template.md` は Frontmatter の `sample` で宣言された sample を読み込むため、完成例は sample から参照できる。外出しが済むまでは、**形式の輪郭が伝わる最小例**に限って残してよい。完成例を丸ごと埋め込まない。
|
|
90
|
+
- 既存 rulebook の `サンプル` 章は、少数の rulebook で試行して plan の肥大化と grade の finding を確認したうえで、残りを段階的に外出しする。個別の改訂で先行して削除しない。
|
|
88
91
|
- 用語定義は、ドメイン固有語や同じ語に複数の解釈がある場合だけ置く。本文構成(標準テンプレ)や記述ガイドで見出し・用語の意味を十分に定義できる場合は、重複を避けて用語定義を省略する。
|
|
89
92
|
|
|
90
93
|
## 5. 記述ガイド
|
|
@@ -138,3 +141,10 @@ specdojo:
|
|
|
138
141
|
Frontmatter と scaffold 専用の `_PLACEHOLDER_` 値は網羅判定に使用しない。
|
|
139
142
|
- 対応 schema がない rulebook、`draft` / `deprecated` の rulebook、Markdown を対象とする
|
|
140
143
|
rulebook は enum 網羅検査の対象外とする。
|
|
144
|
+
- rulebook を追加・改名したら、`docs/ja/specdojo/defaults/pm-review-viewpoints.yaml` で
|
|
145
|
+
`document_kinds` の `include` / `exclude` を列挙している観点ごとに、新しい rulebook の扱いを判断する。
|
|
146
|
+
観点を当てはめない場合は `exclude`(`include` の観点では当てはめる場合に `include`)へ、
|
|
147
|
+
既定の結果のままにする場合は `confirmed_default` へ rulebook ID を追加する。
|
|
148
|
+
- 判断の漏れは `src/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
|
|
149
|
+
error として報告する。検証は `npm test`(`npm run check` に含まれる)で実行され、
|
|
150
|
+
`npx tsx src/viewpoint-document-kinds-check.ts` で単独でも確認できる。
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# yaml-language-server: $schema=../../../specdojo/schemas/v1/agent-members.schema.yaml
|
|
2
|
+
# specdojo-schema: validate=false reason=template
|
|
3
|
+
id: specdojo:agent-members-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
title: 保護された agent 定義テンプレート
|
|
7
|
+
rulebook: none
|
|
8
|
+
|
|
9
|
+
# この content を .specdojo/agent-members.yaml に配置する。
|
|
10
|
+
content:
|
|
11
|
+
version: 1
|
|
12
|
+
members:
|
|
13
|
+
- nickname: _AGENT_NICKNAME_
|
|
14
|
+
display_name: _AGENT_DISPLAY_NAME_
|
|
15
|
+
email: null
|
|
16
|
+
roles: []
|
|
17
|
+
type: agent
|
|
18
|
+
provider: _AGENT_PROVIDER_
|
|
19
|
+
mode: _AGENT_MODE_
|
|
20
|
+
stage_role: _AGENT_STAGE_ROLE_
|
|
21
|
+
proficiency: _AGENT_PROFICIENCY_
|
|
22
|
+
priority: _AGENT_PRIORITY_
|
|
23
|
+
capabilities:
|
|
24
|
+
- _AGENT_CAPABILITY_
|
|
25
|
+
note: "_TODO_: 支援範囲と人間が保持する最終判断を記述する。"
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:bps-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: flow
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:bps-rulebook
|
|
12
|
+
based_on: _BASED_ON_
|
|
13
|
+
supersedes: []
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# _DELIVERABLE_NAME_
|
|
17
|
+
|
|
18
|
+
_TODO_: `_DELIVERABLE_OVERVIEW_` を基に、観測可能な起点、対象の流れ、確定する業務成果を一文で記述する。
|
|
19
|
+
|
|
20
|
+
## 1. 概要
|
|
21
|
+
|
|
22
|
+
- 業務目的: _TODO_: この流れが守る業務価値と、完了時に得られる成果を記述する。
|
|
23
|
+
- プロセス領域: _TODO_: CDFD と同じ領域 ID と名称を記述する。
|
|
24
|
+
- 対象者: _TODO_: 誰が判断・実施し、誰が成果を利用するかを記述する。
|
|
25
|
+
- 主担当: _TODO_: 流れ全体の完了に責任を持つ役割を記述する。
|
|
26
|
+
- 開始点: _TODO_: 最初のトリガーを受領した時点を記述する。
|
|
27
|
+
- 終了点: _TODO_: 業務成果が確定したと判定できる時点を記述する。
|
|
28
|
+
- 対象外: _TODO_: 前後の流れ、横断フロー、実装方式など、本書で扱わない事項と委譲先を記述する。
|
|
29
|
+
|
|
30
|
+
## 2. トリガー
|
|
31
|
+
|
|
32
|
+
| トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
|
|
33
|
+
| -------------- | ------------ | -------- | ---------------------- | ----------------- | -------------------- |
|
|
34
|
+
| `_TRIGGER_ID_` | _EVENT_NAME_ | _SOURCE_ | _RECEIVED_INFORMATION_ | _START_CONDITION_ | _NON_START_HANDLING_ |
|
|
35
|
+
|
|
36
|
+
<!-- トリガーごとに一行を追加する。開始条件は yes / no で判定できる事実とし、不成立時は非起動、差戻し、または例外 ID を示す。独立した業務成果へ至る起点は同じ文書へ追加せず、別の BPS に分ける。 -->
|
|
37
|
+
|
|
38
|
+
## 3. 前提条件
|
|
39
|
+
|
|
40
|
+
- _TODO_: 開始前に確認する業務条件と、不成立時の非起動、差戻し、または例外 ID を記述する。
|
|
41
|
+
- _TODO_: 入力の正本、担当者の判断権限、重複処理の有無など、開始可否を左右する条件を記述する。
|
|
42
|
+
|
|
43
|
+
## 4. 入力
|
|
44
|
+
|
|
45
|
+
| 入力 | 入手元 | 利用目的 | 必須 | 正本 |
|
|
46
|
+
| ------------ | -------------- | --------- | ---------- | ----------------- |
|
|
47
|
+
| _INPUT_NAME_ | _INPUT_SOURCE_ | _PURPOSE_ | _REQUIRED_ | _SOURCE_OF_TRUTH_ |
|
|
48
|
+
|
|
49
|
+
<!-- 入力は業務上の論理名で記述する。必須欄は ○ または条件付きとし、条件付きの場合は条件と欠落時の扱いを同じセルに記述する。 -->
|
|
50
|
+
|
|
51
|
+
## 5. 処理
|
|
52
|
+
|
|
53
|
+
| ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
|
|
54
|
+
| ----------- | -------------- | ------------ | ------------ | ---------------------- | ----------------------- | ---------------- |
|
|
55
|
+
| `_STEP_ID_` | `_PROCESS_ID_` | _OWNER_ROLE_ | _STEP_INPUT_ | _ACTIVITY_OR_DECISION_ | _OUTPUT_AND_COMPLETION_ | `_EXCEPTION_ID_` |
|
|
56
|
+
|
|
57
|
+
<!-- 正常な順序に沿って S-01 から一行ずつ追加する。分岐では条件と合流先または終了先を本文で補足する。例外がない行は「-」とする。 -->
|
|
58
|
+
|
|
59
|
+
## 6. 出力
|
|
60
|
+
|
|
61
|
+
| 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
|
|
62
|
+
| ------------- | ----------- | ------------------------ | ----------------- | -------------- |
|
|
63
|
+
| _OUTPUT_NAME_ | _RECIPIENT_ | _CONFIRMATION_CONDITION_ | _SOURCE_OF_TRUTH_ | _NEXT_PROCESS_ |
|
|
64
|
+
|
|
65
|
+
<!-- 正常終了と条件付き終了で異なる業務成果がある場合は、それぞれ一行にする。状態変化や業務イベントは参照先の ID と、この流れが担う確定・発行条件だけを記述する。 -->
|
|
66
|
+
|
|
67
|
+
## 7. 例外・代替経路
|
|
68
|
+
|
|
69
|
+
| 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
|
|
70
|
+
| ---------------- | ------------ | --------------------- | ---------------- | ------------ | ---------- | ------------------------------- |
|
|
71
|
+
| `_EXCEPTION_ID_` | `_STEP_ID_` | _DETECTION_CONDITION_ | _STOPPING_SCOPE_ | _OWNER_ROLE_ | _HANDLING_ | _RESUME_OR_ALTERNATIVE_OUTCOME_ |
|
|
72
|
+
|
|
73
|
+
<!-- 業務成果または後続処理を変える主要例外だけを追加する。主要例外がない場合は表を削除し、確認した範囲と「業務成果を変える例外なし」の結論を記述する。 -->
|
|
74
|
+
|
|
75
|
+
## 8. 検証・受入観点
|
|
76
|
+
|
|
77
|
+
| 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
|
|
78
|
+
| ----------- | ----------------- | --------------------------- | ------------------- |
|
|
79
|
+
| _VIEWPOINT_ | _INPUT_CONDITION_ | _EXPECTED_BUSINESS_OUTCOME_ | _VERIFIABLE_RECORD_ |
|
|
80
|
+
|
|
81
|
+
<!-- 正常系、条件付き処理、主要例外を少なくとも一行ずつ扱い、第三者が業務成果を受け入れられる条件を記述する。 -->
|
|
82
|
+
|
|
83
|
+
<!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。
|
|
84
|
+
|
|
85
|
+
## 9. 未決事項
|
|
86
|
+
|
|
87
|
+
| 論点 | 影響する章・ステップ | 区分 | 決定者 | 決定時期 |
|
|
88
|
+
| ------------------- | ---------------------- | ------------- | --------------- | ----------------- |
|
|
89
|
+
| _UNDECIDED_: _ISSUE_ | _IMPACTED_SECTION_OR_ID_ | _ISSUE_CLASS_ | _DECISION_ROLE_ | _DECISION_TIMING_ |
|
|
90
|
+
|
|
91
|
+
-->
|
|
@@ -25,10 +25,7 @@ metadata_template:
|
|
|
25
25
|
|
|
26
26
|
# Role code の語彙は pm-roles.yaml を参照する。
|
|
27
27
|
# Schedule の owner には Role code を使い、member nickname は書かない。
|
|
28
|
-
#
|
|
29
|
-
# から解決するため、member には書かない。テンプレートを持たない provider(custom 等)
|
|
30
|
-
# に限り command を上書きとして追加し、その場合も認証情報、秘密鍵、トークン、
|
|
31
|
-
# 個人環境に閉じたパスを含めない。
|
|
28
|
+
# agent 定義は repository 共通の .specdojo/agent-members.yaml に置く。
|
|
32
29
|
|
|
33
30
|
members:
|
|
34
31
|
- nickname: _HUMAN_NICKNAME_
|
|
@@ -43,63 +40,9 @@ members:
|
|
|
43
40
|
scheduler_strategy: critical-first
|
|
44
41
|
note: "_TODO_: 最終判断、公開可否、説明責任の扱いを 1 行で記述する。"
|
|
45
42
|
|
|
46
|
-
- nickname: _EDIT_AGENT_NICKNAME_
|
|
47
|
-
priority: _EDIT_AGENT_PRIORITY_
|
|
48
|
-
display_name: _EDIT_AGENT_DISPLAY_NAME_
|
|
49
|
-
email: null
|
|
50
|
-
roles:
|
|
51
|
-
- _EDIT_AGENT_ROLE_CODE_
|
|
52
|
-
type: agent
|
|
53
|
-
mode: edit
|
|
54
|
-
proficiency: _EDIT_AGENT_PROFICIENCY_
|
|
55
|
-
persona: _AGENT_PERSONA_
|
|
56
|
-
focus:
|
|
57
|
-
- _TODO_: edit agent が重視する観点を記述する。
|
|
58
|
-
capabilities:
|
|
59
|
-
- _EDIT_AGENT_CAPABILITY_
|
|
60
|
-
provider: _AGENT_PROVIDER_
|
|
61
|
-
scheduler_strategy: _EDIT_AGENT_SCHEDULER_STRATEGY_
|
|
62
|
-
note: "_TODO_: 草案作成・整合確認などの支援範囲を記述し、承認責任を持たないことを明記する。"
|
|
63
|
-
|
|
64
|
-
- nickname: _REVIEW_AGENT_NICKNAME_
|
|
65
|
-
priority: _REVIEW_AGENT_PRIORITY_
|
|
66
|
-
display_name: _REVIEW_AGENT_DISPLAY_NAME_
|
|
67
|
-
email: null
|
|
68
|
-
roles:
|
|
69
|
-
- _REVIEW_AGENT_ROLE_CODE_
|
|
70
|
-
type: agent
|
|
71
|
-
mode: review
|
|
72
|
-
proficiency: _REVIEW_AGENT_PROFICIENCY_
|
|
73
|
-
persona: _REVIEW_AGENT_PERSONA_
|
|
74
|
-
focus:
|
|
75
|
-
- _TODO_: review agent が重視する観点を記述する。
|
|
76
|
-
capabilities:
|
|
77
|
-
- _REVIEW_AGENT_CAPABILITY_
|
|
78
|
-
provider: _AGENT_PROVIDER_
|
|
79
|
-
scheduler_strategy: _REVIEW_AGENT_SCHEDULER_STRATEGY_
|
|
80
|
-
note: "_TODO_: レビュー支援範囲を記述し、公開可否判断を行わないことを明記する。"
|
|
81
|
-
|
|
82
|
-
- nickname: _GENERAL_AGENT_NICKNAME_
|
|
83
|
-
priority: _GENERAL_AGENT_PRIORITY_
|
|
84
|
-
display_name: _GENERAL_AGENT_DISPLAY_NAME_
|
|
85
|
-
email: null
|
|
86
|
-
roles: []
|
|
87
|
-
type: agent
|
|
88
|
-
mode: edit
|
|
89
|
-
proficiency: _GENERAL_AGENT_PROFICIENCY_
|
|
90
|
-
persona: general-assistant
|
|
91
|
-
focus:
|
|
92
|
-
- _TODO_: 汎用支援 agent が重視する観点を記述する。
|
|
93
|
-
capabilities: []
|
|
94
|
-
provider: _AGENT_PROVIDER_
|
|
95
|
-
scheduler_strategy: _GENERAL_AGENT_SCHEDULER_STRATEGY_
|
|
96
|
-
note: "_TODO_: 特定 Role に固定しない場合は、実行時の owner または plan で対象 Role を補うことを記述する。"
|
|
97
|
-
|
|
98
43
|
rules:
|
|
99
44
|
- Schedule の owner には pm-roles.yaml に記載された Role code を使用し、member nickname は書かない。
|
|
100
45
|
- specdojo exec --by には members[].nickname を指定し、実行ログ記録後の nickname は変更しない。
|
|
101
46
|
- members[].roles は member が対応できる Role code を表し、Schedule の owner の代替として使わない。
|
|
102
|
-
- agent
|
|
103
|
-
- 起動コマンドは .specdojo/exec-defaults.yaml の providers.<provider>.command_template から解決し、member の command はテンプレートを持たない構成に限って上書きとして使う。
|
|
104
|
-
- command template と command 上書きには、認証情報、秘密鍵、トークン、個人環境に閉じたパスを記載しない。
|
|
47
|
+
- agent は .specdojo/agent-members.yaml に定義し、この名簿には記載しない。
|
|
105
48
|
- 公開文書には個人名、私用メールアドレス、非公開組織情報を記載しない。
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# agent-members.schema.yaml
|
|
2
|
+
$schema: "https://json-schema.org/draft/2020-12/schema"
|
|
3
|
+
title: "SpecDojo Protected Agent Member Registry schema"
|
|
4
|
+
type: object
|
|
5
|
+
additionalProperties: false
|
|
6
|
+
required: [version, members]
|
|
7
|
+
properties:
|
|
8
|
+
version:
|
|
9
|
+
type: integer
|
|
10
|
+
minimum: 1
|
|
11
|
+
members:
|
|
12
|
+
type: array
|
|
13
|
+
items:
|
|
14
|
+
$ref: "#/$defs/AgentMember"
|
|
15
|
+
uniqueItems: true
|
|
16
|
+
$defs:
|
|
17
|
+
RoleLabel:
|
|
18
|
+
type: string
|
|
19
|
+
pattern: "^[A-Z]{2,4}$"
|
|
20
|
+
AgentMember:
|
|
21
|
+
type: object
|
|
22
|
+
additionalProperties: false
|
|
23
|
+
required: [nickname, display_name, roles, type, provider, capabilities, proficiency, priority]
|
|
24
|
+
properties:
|
|
25
|
+
nickname:
|
|
26
|
+
type: string
|
|
27
|
+
pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
|
|
28
|
+
display_name:
|
|
29
|
+
type: string
|
|
30
|
+
minLength: 1
|
|
31
|
+
email:
|
|
32
|
+
oneOf:
|
|
33
|
+
- type: string
|
|
34
|
+
format: email
|
|
35
|
+
- type: "null"
|
|
36
|
+
roles:
|
|
37
|
+
type: array
|
|
38
|
+
items:
|
|
39
|
+
$ref: "#/$defs/RoleLabel"
|
|
40
|
+
uniqueItems: true
|
|
41
|
+
type:
|
|
42
|
+
const: agent
|
|
43
|
+
provider:
|
|
44
|
+
enum: [opencode, claude, codex, copilot, antigravity, custom]
|
|
45
|
+
persona:
|
|
46
|
+
type: string
|
|
47
|
+
minLength: 1
|
|
48
|
+
focus:
|
|
49
|
+
type: array
|
|
50
|
+
items:
|
|
51
|
+
type: string
|
|
52
|
+
minLength: 1
|
|
53
|
+
uniqueItems: true
|
|
54
|
+
capabilities:
|
|
55
|
+
type: array
|
|
56
|
+
items:
|
|
57
|
+
$ref: "./exec-common.schema.yaml#/$defs/Capability"
|
|
58
|
+
uniqueItems: true
|
|
59
|
+
proficiency:
|
|
60
|
+
$ref: "./exec-common.schema.yaml#/$defs/Proficiency"
|
|
61
|
+
priority:
|
|
62
|
+
type: integer
|
|
63
|
+
minimum: 1
|
|
64
|
+
command:
|
|
65
|
+
type: string
|
|
66
|
+
minLength: 1
|
|
67
|
+
mode:
|
|
68
|
+
enum: [edit, review, report]
|
|
69
|
+
stage_role:
|
|
70
|
+
enum: [executor, reporter]
|
|
71
|
+
disabled:
|
|
72
|
+
type: boolean
|
|
73
|
+
scheduler_strategy:
|
|
74
|
+
enum: [critical-first, dependency-first, fifo, manual]
|
|
75
|
+
note:
|
|
76
|
+
type: string
|
|
@@ -24,8 +24,10 @@ $defs:
|
|
|
24
24
|
Where the task came from.
|
|
25
25
|
schedule: a task expanded from the deliverable catalog and schedule. It has a
|
|
26
26
|
target deliverable, runs in a worktree, and derives its commit allowlist from targets.
|
|
27
|
-
register: a project register item (PJR-XXXX) executed by exec run --register.
|
|
28
|
-
|
|
27
|
+
register: a project register item (PJR-XXXX) executed by exec run --register. When
|
|
28
|
+
the ticket declares targets, they are copied into the plan frontmatter and target
|
|
29
|
+
coverage validation is enabled. It scopes its commit by working tree snapshot
|
|
30
|
+
regardless of whether targets are present.
|
|
29
31
|
job: a materialized Job Run executed by exec run --job. It carries resolved targets
|
|
30
32
|
and records its lifecycle in execution/jobs/runs.
|
|
31
33
|
Omitted means schedule.
|
|
@@ -18,6 +18,10 @@ properties:
|
|
|
18
18
|
$ref: "#/$defs/PipelineDefaults"
|
|
19
19
|
description: "Runner-owned defaults for executor/reporter pipelines."
|
|
20
20
|
|
|
21
|
+
run:
|
|
22
|
+
$ref: "#/$defs/RunDefaults"
|
|
23
|
+
description: "Defaults for `exec run`, including register execution location and project concurrency."
|
|
24
|
+
|
|
21
25
|
rate_limit_detection:
|
|
22
26
|
$ref: "#/$defs/RateLimitDetection"
|
|
23
27
|
description: >
|
|
@@ -45,6 +49,10 @@ properties:
|
|
|
45
49
|
$ref: "#/$defs/ProviderOverride"
|
|
46
50
|
|
|
47
51
|
$defs:
|
|
52
|
+
ParentValidationId:
|
|
53
|
+
type: string
|
|
54
|
+
enum: [validate-schema, typecheck, test-unit, test-integration, lint-ts, lint-fm, lint-md]
|
|
55
|
+
|
|
48
56
|
PipelineDefaults:
|
|
49
57
|
type: object
|
|
50
58
|
additionalProperties: false
|
|
@@ -58,9 +66,54 @@ $defs:
|
|
|
58
66
|
Fixed validation IDs executed by the SpecDojo parent runner after a successful
|
|
59
67
|
executor process and before reporter invocation. IDs resolve through the built-in
|
|
60
68
|
allowlist; command strings and arguments cannot be supplied by agents or config.
|
|
69
|
+
A plain ID runs in the project repository worktree. `{ id, repo }` runs the same fixed
|
|
70
|
+
command in the worktree of the named repository (`project` or a product repository
|
|
71
|
+
declared in `projects.<id>.repos` of specdojo.config.json), even when that repository
|
|
72
|
+
has no changes. The same ID may be assigned to several repositories; each
|
|
73
|
+
`(id, repo)` pair must be unique.
|
|
61
74
|
items:
|
|
62
|
-
|
|
63
|
-
|
|
75
|
+
oneOf:
|
|
76
|
+
- $ref: "#/$defs/ParentValidationId"
|
|
77
|
+
- type: object
|
|
78
|
+
additionalProperties: false
|
|
79
|
+
required: [id, repo]
|
|
80
|
+
properties:
|
|
81
|
+
id:
|
|
82
|
+
$ref: "#/$defs/ParentValidationId"
|
|
83
|
+
repo:
|
|
84
|
+
type: string
|
|
85
|
+
pattern: "^[a-z0-9-]+$"
|
|
86
|
+
description: >
|
|
87
|
+
Repository name: `project` for the project repository, or a product
|
|
88
|
+
repository name from `projects.<id>.repos`.
|
|
89
|
+
parent_validation_concurrency:
|
|
90
|
+
type: integer
|
|
91
|
+
minimum: 1
|
|
92
|
+
description: >
|
|
93
|
+
Maximum number of work items whose parent validations may run at the same time for one
|
|
94
|
+
project (default 1). The limit holds within one `exec run` process and across the
|
|
95
|
+
processes that share the project's exec-run lock (a primary run and its `--join` runs).
|
|
96
|
+
Executor and reporter stages stay parallel; only parent validations wait for a slot.
|
|
97
|
+
|
|
98
|
+
RunDefaults:
|
|
99
|
+
type: object
|
|
100
|
+
additionalProperties: false
|
|
101
|
+
minProperties: 1
|
|
102
|
+
properties:
|
|
103
|
+
register_execution:
|
|
104
|
+
type: string
|
|
105
|
+
enum: [in-place, worktree]
|
|
106
|
+
description: >
|
|
107
|
+
Default execution location for `exec run --register`. `--worktree` and `--in-place`
|
|
108
|
+
override this value. When omitted, the historical `in-place` behavior is retained for
|
|
109
|
+
compatibility with existing repositories.
|
|
110
|
+
max_concurrent_runs:
|
|
111
|
+
type: integer
|
|
112
|
+
minimum: 1
|
|
113
|
+
description: >
|
|
114
|
+
Maximum number of `exec run` processes that may run at the same time for one project,
|
|
115
|
+
counting the primary run and every `exec run --register --worktree --join` run
|
|
116
|
+
(default 4). 1 disables `--join`.
|
|
64
117
|
|
|
65
118
|
ProviderOverride:
|
|
66
119
|
type: object
|