specdojo 0.2.1 → 0.3.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/.github/agents/specdojo-orchestrator.md +165 -0
- package/CHANGELOG.md +280 -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/dashboard.js +122 -1
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- 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-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.js +115 -113
- 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.js +811 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter.js +613 -132
- package/dist/exec-results.js +81 -56
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run.js +1585 -356
- package/dist/exec-shared.js +7 -0
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial.js +51 -25
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops.js +502 -57
- package/dist/exec-worktree.js +114 -27
- package/dist/exec.js +13 -6
- package/dist/grade-result.js +128 -0
- package/dist/grade.js +809 -72
- package/dist/init-command.js +443 -0
- package/dist/job.js +160 -10
- package/dist/orchestrator.js +213 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-item.js +7 -1
- package/dist/register.js +294 -86
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +111 -1
- package/dist/review-types.js +40 -1
- package/dist/routine.js +72 -5
- package/dist/schedule-build.js +2 -2
- package/dist/schedule.js +17 -4
- package/dist/specdojo-config.js +465 -19
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -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 +91 -47
- 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 +25 -4
- 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 +74 -9
- 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 +15 -9
- package/templates/antigravity/README.md +27 -2
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
- 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 +72 -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
|
@@ -16,22 +16,56 @@
|
|
|
16
16
|
- 成果物 frontmatter の `based_on` に書けるのは、その成果物の `depends_on` の推移閉包に含まれる先行成果物だけである。閉包外の ID を書くと `catalog validate` が「`based_on` が `depends_on` の推移閉包に含まれていません」としてエラーになり、コミットがブロックされる。`based_on` を増やす必要が生じた場合は、自分で転記せず、根拠不足として result に記録する。
|
|
17
17
|
- ファイルの読み取り・書き込み・編集は、作業ディレクトリ(カレントディレクトリ)からの相対パスで指定する。絶対パスを自分で組み立てたり、作業ディレクトリ名を推測して指定したりしない(作業ディレクトリ名の取り違えは外部パス扱いになり拒否される)。
|
|
18
18
|
- 編集・書き込みが作業ディレクトリ外(`external_directory`)として拒否された場合、原因はパス指定の誤り(誤った絶対パス・ディレクトリ名の取り違え)である。bash の heredoc などへ回避的に切り替えず、相対パスに直したうえで同じ編集ツールで再実行する。
|
|
19
|
+
- 作業用のファイル(編集用スクリプト、検証用の一時データなど)はリポジトリの外(一時ディレクトリ)または worktree の `tmp/` 配下に置き、終了前に削除する。使い捨てのファイルを最上位に作らない。`tmp/` 配下のファイルは commit の対象から除外される。
|
|
19
20
|
- 整形・静的検査は、この plan の完了手順または本共通規約で明示されたコマンドを実行する。変更対象に必要な test、build、schema 検証は、plan に個別記載がなくても実行してよい。同じ test script では対象限定と全件を同一 executor run 内で連続実行せず、どちらか一方に絞る。下表、plan、またはプロジェクト標準が全件 test を求める場合は、全件を1回だけ実行して対象限定の実行を省く。この制約は executor が sandbox 内で実行する test script の回数に対するものであり、親検証に設定された ID のコマンドは対象外である(親 runner が別途実行する)。実行したコマンド・対象・結果は result に記録する。
|
|
20
21
|
- executor / reporter pipeline で親 runner の検証が設定されている場合、executor は設定済み ID に対応するコマンドを sandbox 内で実行せず、executor 終了後に親 runner が固定許可リストから実行して evidence へ追記する。`validate-schema` は `npm run validate:schema`、`test-unit` は `npm run test:unit`、`test-integration` は `npm run test:integration` に対応する。executor は親検証と同じコマンドの対象限定版も追加せず、二重実行しない。
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
33
|
-
| `
|
|
34
|
-
| `
|
|
35
|
-
| `
|
|
36
|
-
| `
|
|
37
|
-
| `
|
|
22
|
+
- 検査を実行する前に、リポジトリの `package.json`、`.specdojo/specdojo.config.json`、hook 設定を読み、下表の適用条件を確認する。条件を満たさない検査は実行せず、executor evidence の validations に `not_applicable` と非適用の理由を `reason` へ記録する。`not_run` は適用される検査を実行しなかった場合だけに使う。誤って `not_run` と記録しても、npm script・依存 package の不在、または SpecDojo サブコマンドの設定上の非適用を runner が機械的に確定できる場合は適用外として扱われるが、この救済を前提に記録を省略しない。
|
|
23
|
+
- 依存パッケージの有無は、対象リポジトリの `package.json` の `dependencies` / `devDependencies` と、リポジトリに固定された package manager の設定を基準に判断する。`npx` が未導入パッケージをネットワークから一時取得できることは、導入済みとはみなさない。設定ファイルがない、壊れているなどの理由で適用条件を確定できない検査は実行せず、validations に `not_applicable` として理由と次の確認事項を記録する。
|
|
24
|
+
- Markdown 成果物を編集した場合、Prettier が導入されているときだけ `npx prettier --write <対象ファイル>` で整形する。`markdownlint-cli` または `markdownlint` が導入されているときだけ `npx markdownlint <対象ファイル>` を実行し、`markdownlint-cli2` を採用するリポジトリでは、そのリポジトリで定めた CLI2 のコマンドを実行する。適用した検査でエラーが出た場合は修正してから完了とする。
|
|
25
|
+
- YAML 成果物を編集した場合、対応 schema `_SCHEMA_REF_` に従って記述する。`package.json` に `validate:schema:file` script がある場合だけ、`npm run validate:schema:file -- --schema _SCHEMA_REF_ --data <対象ファイル>` で schema 検査を実施する。適用した検査でエラーが出た場合は修正してから完了とする。
|
|
26
|
+
- 終了する前に、コミット時に実行される検査(pre-commit 相当)のうち、現在のリポジトリに設定され、上記の適用条件を満たすものを先回りで実行する。適用した検査の失敗はすべて修正してから完了する。
|
|
27
|
+
- 実行対象は、変更したファイルの種別で判断する。下表のうち、変更したファイルが該当し、かつ適用条件を満たす行の検査を実行する。該当行がない場合や適用条件を満たさない場合は追加の検査は不要である。ただし親検証に設定された ID のコマンドは下表よりも優先し、executor は実行しない。下表に同じコマンドが挙がっていても、親 runner の実行に委ねる。
|
|
28
|
+
- 検査コマンドの正本はリポジトリの hook 設定(`lefthook.yml` など)である。下表と設定が食い違う場合は、適用条件を満たす設定側のコマンドに合わせ、実行したコマンドと結果を result に記録する。`specdojo` コマンドは、リポジトリで定められた起動方法(`npx specdojo <subcommand>`、`npx tsx src/specdojo.ts <subcommand>` など)で実行する。ただし、sandbox 環境で `tsx` の IPC エラー(`EPERM`)が発生する場合は、代わりに `node --import tsx src/specdojo.ts <subcommand>` を使用して実行する。
|
|
29
|
+
|
|
30
|
+
| 変更したファイル | 適用条件 | 実行する検査 |
|
|
31
|
+
| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
32
|
+
| `*.md` | 対応するローカル依存が `package.json` にある | `npx prettier --write <対象ファイル>`、導入済み実装に対応する markdownlint コマンド |
|
|
33
|
+
| `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml` | Prettier が `package.json` にある | `npx prettier --write <対象ファイル>` |
|
|
34
|
+
| `src/`、`tests/`、`scripts/`、`tools/`、`tsconfig*.json` | `package.json` に `typecheck` script がある | `npm run typecheck` |
|
|
35
|
+
| `src/`、`tests/`、`docs/ja/specdojo/templates/`、`docs/ja/specdojo/exec-templates/`、`vitest.config.*` | pipeline executor は `test:unit`、それ以外は `test` script が `package.json` にある | pipeline executor は `npm run test:unit`、それ以外は `npm test`(`test-unit` が親検証に設定されている場合は executor では実行しない) |
|
|
36
|
+
| `docs/ja/projects/` 配下 | 対象 project に `catalog_path` が設定されている | `specdojo catalog validate` |
|
|
37
|
+
| `dct-*.yaml` | 対象 project に `catalog_path` が設定されている | `specdojo catalog build` |
|
|
38
|
+
| `pjr-index.md` | 対象 project に `project_register_path` が設定されている | `specdojo register build` |
|
|
39
|
+
| `sch-*.yaml` | 対象 project に `schedule_path` が設定されている | `specdojo exec refresh` |
|
|
40
|
+
| `docs/` 配下 | リポジトリで定められた起動方法により SpecDojo CLI を実行できる | `specdojo index build` |
|
|
41
|
+
|
|
42
|
+
<!-- review-only:start -->
|
|
43
|
+
|
|
44
|
+
### review の判断手順
|
|
45
|
+
|
|
46
|
+
review plan に共通で適用する。review はタスクの成果を判定し、成果物の品質は判定しない。成果物の品質は grade が一度だけ評価する。review はその評価結果(grade・finding)を事実として受け取り、このタスクを完了してよいかを判断する([[bps-task-completion]])。
|
|
47
|
+
|
|
48
|
+
- 成果物を再評価しない。観点ごとの pass / fail を付け直したり、評価結果の判定を自分の判断で置き換えたりしない。評価結果の内容に疑義がある場合は、疑義の内容と再評価が必要な理由を改善指示に記録する。
|
|
49
|
+
- 評価結果の鮮度を最初に確認する(`E-01`)。plan の「評価結果」章に示す評価対象と `--target` を使い、`specdojo grade list --target <対象種別> --path <評価対象> --changed-only` を実行する。`--target deliverable` の場合は `--dependency-changed` でも同様に実行する。いずれかが評価対象のパスを出力した場合、または評価結果サイドカーが存在しない場合は、評価結果が最新でない。成果物を自分で評価して補わず、verdict を `grade-stale` とする。
|
|
50
|
+
- 評価結果を確定できない場合(`E-02`)は、verdict を `grade-unavailable` とする。サイドカーを読み取れない場合と、`specdojo grade list --target <対象種別> --path <評価対象> --incomplete` が評価対象のパスを出力する場合(評価パイプラインが未完了)が該当する。
|
|
51
|
+
- 評価結果が最新であれば、サイドカーの `verdict` / `score` / `finding_counts` / `findings`、および `done_criteria`(存在する場合)を読み取る。
|
|
52
|
+
- 変更内容・この plan・実行記録・完了条件・最新の finding を照合し、このタスクの範囲と完了条件を満たすかを判断する(`S-02`)。完了条件の充足は、評価結果に判定がある場合はそれを事実として用いる。評価結果が扱わない事項を review で確かめる。対象は、フェーズ説明が求めた変更が行われたか、対象外の変更が混入していないか、実行記録の検証結果が成功しているかである。実行記録(先行する edit タスクの result)を特定できない場合は、確認できなかったことを判断根拠に記録する。
|
|
53
|
+
- finding が残っていても、このタスクの範囲と完了条件を満たしていれば完了できる。その場合は finding を消去・再評価せず、完了を妨げない理由と必要な改善指示を記録する。
|
|
54
|
+
- 判断の根拠は、評価結果・成果物・plan・実行記録を実際に読んで得た具体的な事実に限る。executor の最終メッセージや result の自己申告を、そのまま、または言い換えて根拠にしない。
|
|
55
|
+
- verdict を記録する直前に鮮度の確認を再実行する。最初の確認の後に成果物が変更されて評価結果が最新でなくなった場合は、verdict を `changed-during-review` とする(review 中の成果物変更)。
|
|
56
|
+
|
|
57
|
+
verdict は次の 6 値から 1 つを選ぶ。各値は [[bps-task-completion]] の検証・受入観点と一対一に対応する。
|
|
58
|
+
|
|
59
|
+
| verdict | 受入観点 | 選ぶ条件 | 記録すること |
|
|
60
|
+
| ------------------------ | ----------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------- |
|
|
61
|
+
| `complete` | 完了可能 | 評価結果が最新で、plan と完了条件を満たし、完了を妨げる未充足事項がない | 照合した根拠 |
|
|
62
|
+
| `complete-with-findings` | 品質 finding を伴う完了 | 評価結果に finding があるが、このタスクの範囲と完了条件は満たしている | finding が完了を妨げない理由と改善指示 |
|
|
63
|
+
| `incomplete` | 品質良好だが未完了 | plan または完了条件に未充足事項がある(grade の良否は問わない) | 未充足事項と、再計画に使う改善指示 |
|
|
64
|
+
| `grade-stale` | 評価結果が最新でない | 評価結果がない、`content_hash` が一致しない、または評価コンテキストの変化が未反映 | 鮮度確認のコマンドと出力。完了可否は判断しない |
|
|
65
|
+
| `grade-unavailable` | 評価不能 | 評価結果を読み取れない、または評価パイプラインが未完了で grade・finding が未確定 | 評価不能の理由と不足情報。完了は保留する |
|
|
66
|
+
| `changed-during-review` | review 中の成果物変更 | 最初の鮮度確認の後に成果物が変更され、評価結果が最新でなくなった | 変更を検知した確認の出力。verdict を確定せず再評価を求める |
|
|
67
|
+
|
|
68
|
+
- verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。runner は verdict に応じて再評価または再計画へ進む。
|
|
69
|
+
- review result の章立ては `評価結果の確認`、`判断根拠`、`未充足事項・改善指示`、`approach に応じた確認`、`decision` である。`decision` の `verdict` は必ず上表の値で埋める。
|
|
70
|
+
|
|
71
|
+
<!-- review-only:end -->
|
|
@@ -29,19 +29,21 @@ _OWNER_ROLE_VIEWPOINTS_
|
|
|
29
29
|
|
|
30
30
|
## 4. 進め方
|
|
31
31
|
|
|
32
|
-
対象成果物に必要と宣言された rulebook / recipe は、指定されたファイルを実際に読み込んだうえで、次の役割に沿って参照する。読み込まずに記憶や推測で代替しない。
|
|
32
|
+
対象成果物に必要と宣言された rulebook / recipe / sample は、指定されたファイルを実際に読み込んだうえで、次の役割に沿って参照する。読み込まずに記憶や推測で代替しない。
|
|
33
33
|
|
|
34
34
|
参照ファイル(成果物カタログの rulebook ID と rulebook frontmatter から解決。`_MISSING_` は `undecided`、`not-needed`、未整備、または `kind: generated` による非適用を表す。fully-guided では通常 `not-needed` の項目だけが該当する):
|
|
35
35
|
|
|
36
36
|
- rulebook: `_RULEBOOK_REF_`
|
|
37
37
|
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
38
38
|
- recipe: `_RECIPE_REF_`
|
|
39
|
+
- sample: `_SAMPLE_REF_`
|
|
39
40
|
|
|
40
41
|
1. rulebook: `_MISSING_` でなければ指定された rulebook を読み込み、成果物が必須要素をすべて満たし、禁止事項に抵触していないかを構造面の基準として確認する。
|
|
41
42
|
2. 併せて適用する rulebook: `_MISSING_` でない場合は各ファイルを読み込み、記法など主 rulebook が委譲したルールに従う。主 rulebook と矛盾する場合は主 rulebook を正とする。
|
|
42
43
|
3. recipe: `_MISSING_` でなければ指定された recipe を読み込み、示された問い・観点・深掘り手順に沿って内容を組み立てる。
|
|
44
|
+
4. sample: `_MISSING_` でなければ指定された sample を読み込み、rulebook の要求を満たす完成例の形式(章・表・記述の粒度)を確認する。sample は形式の参照に限って使い、sample の業務内容・固有名詞・値を対象成果物へ転記しない。
|
|
43
45
|
|
|
44
|
-
磨き込みでは sample
|
|
46
|
+
磨き込みでは template は読み込まない。粒度・文体・表現・章構成は、既存の対象成果物を基準としてそろえる。sample は既存の対象成果物に該当する記述が無い箇所や、rulebook の要求を形式に落とす方法が判断できない箇所の参考に限る。既存の対象成果物と sample の形式が異なる場合は、rulebook の許容範囲内である限り既存の対象成果物を優先する。複数の文書間で記述に矛盾がある場合は rulebook を正とする。
|
|
45
47
|
|
|
46
48
|
### grade result から展開された finding
|
|
47
49
|
|
|
@@ -49,7 +51,7 @@ _GRADE_FINDINGS_
|
|
|
49
51
|
|
|
50
52
|
plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
|
|
51
53
|
|
|
52
|
-
参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / 併せて適用する rulebook / recipe、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。成果物の作成・更新は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
54
|
+
参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / 併せて適用する rulebook / recipe / sample、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。成果物の作成・更新は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
53
55
|
|
|
54
56
|
本タスクの実行に必要な fully-guided の参照方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
55
57
|
|
|
@@ -77,7 +79,7 @@ plan に展開された finding は、message と同じ viewpoint ID の判定
|
|
|
77
79
|
|
|
78
80
|
### 4.3. 根拠のない具体化の禁止
|
|
79
81
|
|
|
80
|
-
- ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けが取れる場合に限る。
|
|
82
|
+
- ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けが取れる場合に限る。sample は別文脈の完成例であり、対象成果物の具体的な記述の裏付けにしない。
|
|
81
83
|
- 既存記述が曖昧・不完全(ファイル名のみでパスが無い、値が未確定など)であっても、裏付けが無ければ推測で具体化しない。完成度を上げる目的だけで、もっともらしい値を断定的に書き加えない。
|
|
82
84
|
- 裏付けが無く判断できない箇所は、既存の曖昧な記述を残したまま _TODO_ / _ASSUMPTION_ として論点を残す。
|
|
83
85
|
|
|
@@ -85,7 +87,7 @@ plan に展開された finding は、message と同じ viewpoint ID の判定
|
|
|
85
87
|
|
|
86
88
|
参照した文書・参照しなかった文書と、その判断根拠を result に残す。記録先は次のとおり。
|
|
87
89
|
|
|
88
|
-
- 参照した rulebook / recipe の使い分け、矛盾時に rulebook を正とした箇所、欠落・薄い実践の型の扱い、既存記述の加筆・修正・統合・削除の根拠、具体化を見送った箇所とその理由: result の `進め方と実践の型の適用` セクション。
|
|
90
|
+
- 参照した rulebook / recipe / sample の使い分け、矛盾時に rulebook を正とした箇所、欠落・薄い実践の型の扱い、既存記述の加筆・修正・統合・削除の根拠、具体化を見送った箇所とその理由: result の `進め方と実践の型の適用` セクション。
|
|
89
91
|
|
|
90
92
|
## 5. 完了の狙い
|
|
91
93
|
|
|
@@ -17,54 +17,52 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は成果物を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。
|
|
23
|
+
|
|
24
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
25
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
26
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
27
|
+
|
|
28
|
+
_GRADE_SUMMARY_
|
|
29
|
+
|
|
30
|
+
## 4. 完了条件
|
|
31
|
+
|
|
32
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
21
33
|
|
|
22
34
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
35
|
|
|
24
36
|
<!-- prettier-ignore-start -->
|
|
25
|
-
| ID | ロール | viewpoint_id |
|
|
37
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
26
38
|
| --- | ------ | ------------ | -------- |
|
|
27
|
-
|
|
39
|
+
_DONE_CRITERIA_ROWS_
|
|
28
40
|
<!-- prettier-ignore-end -->
|
|
29
41
|
|
|
30
42
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
43
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
44
|
+
## 5. 進め方
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
freeform のタスクは、実践の型に縛られず、類似成果物の実例とプロジェクト文脈に沿って成果物を作成・更新することを求めた。内容の品質は grade が評価済みである。review は実例やプロジェクト文脈との整合を照合し直さず、評価結果の finding として扱う。
|
|
37
47
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
3. 実践の型は、対象領域の実例やプロジェクト文脈と矛盾しない範囲の補助基準にとどめる。
|
|
43
|
-
4. 内部情報だけで判断できない一般的な観点・用語・標準があり、実行 agent が Web 検索能力を持つ場合は、関連情報を確認して出典を添える。Web 検索能力がない場合は、利用可能な内部情報の範囲で判定し、確認できない事項を result に記録する。
|
|
44
|
-
|
|
45
|
-
実践の型とプロジェクト文脈が矛盾する場合は、プロジェクト文脈を優先し、その理由を記録する。
|
|
48
|
+
1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
|
|
49
|
+
2. 実践の型とプロジェクト文脈が矛盾し、プロジェクト文脈を優先した箇所がある場合は、実行記録にその理由が残っているかを確認する。
|
|
50
|
+
3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。
|
|
51
|
+
4. 完了可否の判断に一般的な用語・標準の確認が必要で、実行 agent が Web 検索能力を持つ場合は、関連情報を確認して出典を判断根拠に添える。Web 検索能力がない場合は、確認できない事項を判断根拠に記録する。
|
|
46
52
|
|
|
47
53
|
本タスクの実行に必要な freeform の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
48
54
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
確認した内容と判断根拠を review result に残す。記録先は次のとおり。
|
|
52
|
-
|
|
53
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
54
|
-
- 優先した実例・プロジェクト文脈、実践の型を補助に使った場合の判断根拠、実践の型とプロジェクト文脈が矛盾しプロジェクト文脈を優先した箇所とその理由、Web 出典: review result の `実践の型との整合確認` セクション。
|
|
55
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
56
|
-
|
|
57
|
-
## 5. 完了手順
|
|
55
|
+
## 6. 完了手順
|
|
58
56
|
|
|
59
|
-
1.
|
|
60
|
-
2. result
|
|
61
|
-
3.
|
|
62
|
-
4.
|
|
57
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
58
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には前章で確認した内容を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
59
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
60
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
63
61
|
|
|
64
|
-
##
|
|
62
|
+
## 7. 異常終了の条件
|
|
65
63
|
|
|
66
|
-
- 対象ファイル不明・依存未解決・result
|
|
67
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
64
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
65
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
68
66
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
69
67
|
|
|
70
68
|
_COMMON_CONVENTIONS_
|
|
@@ -17,81 +17,60 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は成果物を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。
|
|
23
|
+
|
|
24
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
25
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
26
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
27
|
+
|
|
28
|
+
_GRADE_SUMMARY_
|
|
29
|
+
|
|
30
|
+
## 4. 完了条件
|
|
31
|
+
|
|
32
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
21
33
|
|
|
22
34
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
35
|
|
|
24
36
|
<!-- prettier-ignore-start -->
|
|
25
|
-
| ID | ロール | viewpoint_id |
|
|
37
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
26
38
|
| --- | ------ | ------------ | -------- |
|
|
27
|
-
|
|
39
|
+
_DONE_CRITERIA_ROWS_
|
|
28
40
|
<!-- prettier-ignore-end -->
|
|
29
41
|
|
|
30
42
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
43
|
|
|
32
|
-
|
|
44
|
+
## 5. 進め方
|
|
33
45
|
|
|
34
|
-
|
|
46
|
+
fully-guided のタスクは、rulebook / recipe / sample / template に従って成果物を作成・更新することを求めた。rulebook の必須要素・禁止事項、recipe の問い、sample の粒度・文体、template の章構成との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
35
47
|
|
|
36
|
-
|
|
48
|
+
参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備):
|
|
37
49
|
|
|
38
|
-
|
|
50
|
+
- rulebook: `_RULEBOOK_REF_`
|
|
51
|
+
- recipe: `_RECIPE_REF_`
|
|
52
|
+
- sample: `_SAMPLE_REF_`
|
|
53
|
+
- template: `_TEMPLATE_REF_`
|
|
39
54
|
|
|
40
|
-
|
|
55
|
+
1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
|
|
56
|
+
2. 実践の型の欠落(`_MISSING_`)や内容の薄さがある場合は、実行記録にその扱いが残っているかを確認する。実践の型そのものの整備が必要な場合は、改善指示に残す。
|
|
57
|
+
3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook の必須要素の欠落や禁止事項への抵触など、完了条件に直結する finding は完了を妨げる。
|
|
41
58
|
|
|
42
|
-
|
|
43
|
-
- recipe: `_RECIPE_REF_`(`_MISSING_` なら対象外)
|
|
44
|
-
- sample: `_SAMPLE_REF_`(`_MISSING_` なら対象外)
|
|
45
|
-
- template: `_TEMPLATE_REF_`(`_MISSING_` なら対象外)
|
|
46
|
-
|
|
47
|
-
1. rulebook: 指定された rulebook を読み込み、成果物が必須要素をすべて満たし、禁止事項に抵触していないかを構造面の基準として確認する。
|
|
48
|
-
2. recipe: 指定された recipe を読み込み、示された問い・観点に対して成果物の内容が十分かを確認する。
|
|
49
|
-
3. sample: 指定された sample を読み込み、粒度・文体・表現・表の書き方と整合しているかを確認する。
|
|
50
|
-
4. template: 指定された template を読み込み、章構成と整合しているか、_TODO_ などのプレースホルダが残っていないかを確認する。
|
|
51
|
-
|
|
52
|
-
複数の文書間で記述に矛盾がある場合は rulebook を正として判定する(template の章構成が rulebook と食い違う場合も rulebook を正とする)。
|
|
53
|
-
|
|
54
|
-
参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。クロス文書整合を確認するレビュー観点では、`depends_on` 成果物を実際に読み込み、対象成果物と突き合わせて整合を判定する。目的整合の判断ではプロジェクトコンテキストを参照する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。レビューの判定は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず、該当レビュー観点を unclear とし理由を残す。
|
|
59
|
+
確認に用いてよい文書は、この plan に記載されたものに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、プロジェクトコンテキスト、実行記録である。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
|
|
55
60
|
|
|
56
61
|
本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
57
62
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
- 指定された rulebook / recipe / sample / template のいずれかが存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を review result の `実践の型との整合確認` セクションに記録する。
|
|
61
|
-
- 欠落を理由にレビュー観点を unclear のまま放置しない。存在する他の実践の型と `depends_on` 成果物・プロジェクト文脈を基準にして判定根拠を補う。
|
|
62
|
-
- template が欠落する場合は、rulebook の構造を骨組みとして整合を確認する。
|
|
63
|
-
- 実践の型そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、findings または申し送りに残す。
|
|
64
|
-
|
|
65
|
-
### 4.2. 具体化の妥当性確認
|
|
66
|
-
|
|
67
|
-
- 対象成果物に、ファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述がある場合、その記述が参照範囲の文書(rulebook / recipe / sample / template、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けられているかを確認する。
|
|
68
|
-
- 裏付けが確認できない具体的な記述は、正確性を検証できないため該当レビュー観点を unclear とし、findings に該当箇所と裏付け不足の理由を記録する。記述がもっともらしく具体的に見えることは、裏付けの代わりにならない。
|
|
69
|
-
|
|
70
|
-
### 4.3. エビデンスの独立性
|
|
71
|
-
|
|
72
|
-
- evidence・notes は、対象成果物・rulebook / recipe / sample / template を実際に読んで得た具体的な観察(該当箇所の内容、章・行・ノード名など)に限る。
|
|
73
|
-
- 実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱わない。executor が「基準を満たした」と報告していることは、review 側の pass 判定の根拠にならない。
|
|
74
|
-
- 対象成果物を自分で確認した結果と executor の報告が一致しない場合は、対象成果物側の内容を優先し、findings に不一致を記録する。
|
|
75
|
-
|
|
76
|
-
### 4.4. 判断根拠の記録
|
|
77
|
-
|
|
78
|
-
確認した文書・確認しなかった文書と、その判断根拠を review result に残す。記録先は次のとおり。
|
|
79
|
-
|
|
80
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
81
|
-
- 参照した rulebook / recipe / sample / template の使い分け、矛盾時に rulebook を正とした箇所、欠落・薄い実践の型の扱い: review result の `実践の型との整合確認` セクション。
|
|
82
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
83
|
-
|
|
84
|
-
## 5. 完了手順
|
|
63
|
+
## 6. 完了手順
|
|
85
64
|
|
|
86
|
-
1.
|
|
87
|
-
2. result
|
|
88
|
-
3.
|
|
89
|
-
4.
|
|
65
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
66
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には前章で確認した内容を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
67
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
68
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
90
69
|
|
|
91
|
-
##
|
|
70
|
+
## 7. 異常終了の条件
|
|
92
71
|
|
|
93
|
-
- 対象ファイル不明・依存未解決・result
|
|
94
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
72
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
73
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
95
74
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
96
75
|
|
|
97
76
|
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Job Run Review Plan: _JOB_NAME_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
Job Run が作成した出力を変更せずにレビューし、統合可能かを判定する。
|
|
8
|
+
|
|
9
|
+
## 2. Job Run
|
|
10
|
+
|
|
11
|
+
- `job_id`: `_JOB_ID_`
|
|
12
|
+
- `run_id`: `_RUN_ID_`
|
|
13
|
+
- Run の状態: `_RUN_STATE_`
|
|
14
|
+
- exec ブランチ: `_BRANCH_`
|
|
15
|
+
- 実行前 commit: `_BASE_COMMIT_`
|
|
16
|
+
- 出力 commit: `_OUTPUT_COMMIT_`
|
|
17
|
+
- Job Run result: `_RUN_RESULT_REF_`
|
|
18
|
+
- review result: `_RESULT_REF_`
|
|
19
|
+
|
|
20
|
+
Job の目的:
|
|
21
|
+
|
|
22
|
+
_JOB_DESCRIPTION_
|
|
23
|
+
|
|
24
|
+
Job 固有の確認事項:
|
|
25
|
+
|
|
26
|
+
_ANALYSIS_DESCRIPTION_
|
|
27
|
+
|
|
28
|
+
## 3. 完了条件
|
|
29
|
+
|
|
30
|
+
1. `_BASE_COMMIT_.._OUTPUT_COMMIT_` の差分が当該 Job Run の出力だけで構成されている。
|
|
31
|
+
2. Job Run の状態、command evidence、result の記述が相互に整合している。
|
|
32
|
+
3. score・verdict・finding・失敗文書がある場合は、その変化と理由を確認している。
|
|
33
|
+
4. Run が失敗している場合は `incomplete` とし、再開または人手対応に必要な理由を残している。
|
|
34
|
+
5. reviewer は Job Run の出力を修正せず、review result だけに判断を記録している。
|
|
35
|
+
|
|
36
|
+
## 4. 判断手順
|
|
37
|
+
|
|
38
|
+
1. `git diff --stat _BASE_COMMIT_.._OUTPUT_COMMIT_` と `git diff --name-status _BASE_COMMIT_.._OUTPUT_COMMIT_` で出力範囲を確認する。
|
|
39
|
+
2. Job Run の plan・result・evidence・Run JSON と、Job が更新した成果物を照合する。
|
|
40
|
+
3. 完了条件を満たす場合は `complete`、軽微な finding を残して統合可能なら `complete-with-findings` とする。
|
|
41
|
+
4. 失敗、対象外変更、根拠不足がある場合は `incomplete` とし、改善指示と waiting の理由を明記する。
|
|
42
|
+
|
|
43
|
+
## 5. 完了手順
|
|
44
|
+
|
|
45
|
+
1. review result の全セクションを埋める。
|
|
46
|
+
2. `decision` に verdict を記録する。
|
|
47
|
+
3. verdict にかかわらず、レビュー自体を完了できた場合は終了コード 0 とする。
|
|
48
|
+
|
|
49
|
+
## 6. 異常終了の条件
|
|
50
|
+
|
|
51
|
+
- 出力 commit、Job Run の記録、result のいずれかを読めず、レビュー自体を完了できない場合は終了コード 1 とする。
|
|
52
|
+
- review executor は成果物や Job Run 出力を編集しない。
|
|
53
|
+
|
|
54
|
+
_COMMON_CONVENTIONS_
|
|
@@ -17,60 +17,51 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は成果物を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。
|
|
23
|
+
|
|
24
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
25
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
26
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
27
|
+
|
|
28
|
+
_GRADE_SUMMARY_
|
|
29
|
+
|
|
30
|
+
## 4. 完了条件
|
|
31
|
+
|
|
32
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
21
33
|
|
|
22
34
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
23
35
|
|
|
24
36
|
<!-- prettier-ignore-start -->
|
|
25
|
-
| ID | ロール | viewpoint_id |
|
|
37
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
26
38
|
| --- | ------ | ------------ | -------- |
|
|
27
|
-
|
|
39
|
+
_DONE_CRITERIA_ROWS_
|
|
28
40
|
<!-- prettier-ignore-end -->
|
|
29
41
|
|
|
30
42
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
31
43
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
35
|
-
|
|
36
|
-
## 4. 進め方
|
|
44
|
+
## 5. 進め方
|
|
37
45
|
|
|
38
|
-
|
|
46
|
+
recipe-guided のタスクは、recipe(`_RECIPE_REF_`)の問いに沿って成果物の内容を作成・更新することを求めた。rulebook / sample / template は未成熟と判断されており、構造・文体・粒度の必須基準ではない。recipe の問いに対する内容の十分さは grade が評価済みである。review はこれを照合し直さず、評価結果の finding として扱う。
|
|
39
47
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
2. recipe だけでは判断できない箇所は、`depends_on` 成果物・類似成果物・プロジェクト文脈との整合を確認する。
|
|
44
|
-
|
|
45
|
-
rulebook / sample / template は未成熟と判断されているため、存在しても構造・文体・粒度の必須基準としては扱わない。recipe の指示が他の文書と矛盾する場合は recipe を優先する。
|
|
48
|
+
1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
|
|
49
|
+
2. recipe が `_MISSING_`、または基準として機能しないほど内容が薄い場合は、実行記録に代わりの根拠が残っているかを確認する。recipe そのものの整備が必要な場合は、改善指示に残す。
|
|
50
|
+
3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook / sample / template の構造・文体だけを根拠とする finding は、recipe-guided の完了を妨げる理由にしない。
|
|
46
51
|
|
|
47
52
|
本タスクの実行に必要な recipe-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
48
53
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
- recipe は recipe-guided の唯一の主基準であるため、存在しない、または基準として機能しないほど内容が薄い場合は、その事実と判断を review result の `実践の型との整合確認` セクションに記録する。
|
|
52
|
-
- 欠落を理由にレビュー観点を unclear のまま放置しない。`depends_on` 成果物・類似成果物・プロジェクト文脈を基準にして判定根拠を補い、何を recipe の代わりに根拠としたかを明示する。
|
|
53
|
-
- recipe そのものの整備が必要と判断した場合でも、本タスクの範囲を超える整備は行わず、findings または申し送りに残す。
|
|
54
|
-
|
|
55
|
-
### 4.2. 判断根拠の記録
|
|
56
|
-
|
|
57
|
-
確認した文書と判断根拠を review result に残す。記録先は次のとおり。
|
|
58
|
-
|
|
59
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
60
|
-
- recipe に照らした確認内容、rulebook / sample / template を基準にしなかった理由と代わりに根拠にした内容、欠落・薄い recipe の扱い: review result の `実践の型との整合確認` セクション。
|
|
61
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
62
|
-
|
|
63
|
-
## 5. 完了手順
|
|
54
|
+
## 6. 完了手順
|
|
64
55
|
|
|
65
|
-
1.
|
|
66
|
-
2. result
|
|
67
|
-
3.
|
|
68
|
-
4.
|
|
56
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
57
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には前章で確認した内容を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
58
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
59
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
69
60
|
|
|
70
|
-
##
|
|
61
|
+
## 7. 異常終了の条件
|
|
71
62
|
|
|
72
|
-
- 対象ファイル不明・依存未解決・result
|
|
73
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
63
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
64
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
74
65
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
75
66
|
|
|
76
67
|
_COMMON_CONVENTIONS_
|