specdojo 0.2.0 → 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 +143 -30
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/dashboard.js +140 -9
- 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-format.js +13 -4
- 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/package-paths.js +19 -1
- 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 +466 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +8 -1
- 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 +261 -32
- 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 +184 -0
- 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 +336 -93
- 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 +16 -9
- package/templates/antigravity/README.md +60 -0
- package/templates/antigravity/agent-members-snippet.yaml +61 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
- package/templates/antigravity/orchestrator.md +157 -0
- 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 +164 -0
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
- package/templates/codex/orchestrator.md +157 -0
- 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 +204 -0
- 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
|
@@ -17,57 +17,52 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は見直し後の recipe を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。評価対象は対象成果物ではなく recipe である。
|
|
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
|
-
## 4. 進め方
|
|
44
|
+
## 5. 進め方
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
このタスクは、対象成果物に紐づく recipe を見直すことを求めた。見直し後の recipe の品質は grade が評価済みである。対象は [[specdojo:recipe-authoring-standard]] への準拠と rulebook との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
37
47
|
|
|
38
|
-
1.
|
|
39
|
-
2. finding
|
|
40
|
-
3.
|
|
41
|
-
4.
|
|
42
|
-
5. rulebook と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
48
|
+
1. 見直しの動機となった finding(先行する edit plan に展開された finding)を実行記録から特定し、最新の評価結果で解消しているかを確認する。
|
|
49
|
+
2. 解消していない finding がある場合は、実行記録に未解消の理由と次のアクションが残っているかを確認する。理由のない未解消は未充足事項とする。
|
|
50
|
+
3. 見直しが recipe の範囲に収まり、対象成果物そのものを書き換えていないかを確認する。
|
|
51
|
+
4. 最新の評価結果に残る finding が、このタスクの完了を妨げるかを判断する。
|
|
43
52
|
|
|
44
53
|
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な recipe メンテナンス確認の方針は、このセクションで完結する。
|
|
45
54
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
- finding の message と判定根拠、対象 recipe から辿れる rulebook、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
-
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
-
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
-
|
|
52
|
-
### 4.2. 判断根拠の記録
|
|
53
|
-
|
|
54
|
-
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
-
|
|
56
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
-
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
-
|
|
60
|
-
## 5. 完了手順
|
|
55
|
+
## 6. 完了手順
|
|
61
56
|
|
|
62
|
-
1.
|
|
63
|
-
2. result
|
|
64
|
-
3.
|
|
65
|
-
4.
|
|
57
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
58
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には見直しの動機となった finding の解消状況を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
59
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
60
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
66
61
|
|
|
67
|
-
##
|
|
62
|
+
## 7. 異常終了の条件
|
|
68
63
|
|
|
69
|
-
- 対象ファイル不明・依存未解決・result
|
|
70
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
64
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
65
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
71
66
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
67
|
|
|
73
68
|
_COMMON_CONVENTIONS_
|
|
@@ -19,56 +19,56 @@ _PROJECT_CONTEXT_
|
|
|
19
19
|
|
|
20
20
|
## 3. 実装エビデンス
|
|
21
21
|
|
|
22
|
-
次の参照は成果物カタログの `evidence_refs`
|
|
22
|
+
次の参照は成果物カタログの `evidence_refs` から展開した読み取り専用の確認入力である。実行記録にある対応記録の突き合わせに使い、実装は変更しない。
|
|
23
23
|
|
|
24
24
|
_IMPLEMENTATION_EVIDENCE_
|
|
25
25
|
|
|
26
|
-
## 4.
|
|
26
|
+
## 4. 評価結果
|
|
27
|
+
|
|
28
|
+
review は成果物を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。
|
|
29
|
+
|
|
30
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
31
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
32
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
33
|
+
|
|
34
|
+
_GRADE_SUMMARY_
|
|
35
|
+
|
|
36
|
+
## 5. 完了条件
|
|
37
|
+
|
|
38
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
27
39
|
|
|
28
40
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
29
41
|
|
|
30
42
|
<!-- prettier-ignore-start -->
|
|
31
|
-
| ID | ロール | viewpoint_id |
|
|
43
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
32
44
|
| --- | ------ | ------------ | -------- |
|
|
33
|
-
|
|
45
|
+
_DONE_CRITERIA_ROWS_
|
|
34
46
|
<!-- prettier-ignore-end -->
|
|
35
47
|
|
|
36
48
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
37
49
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
## 5. 進め方
|
|
41
|
-
|
|
42
|
-
1. 対象成果物、`depends_on`、プロジェクトコンテキストを読み、意図された仕様と `done_criteria` を確認する。
|
|
43
|
-
2. 「実装エビデンス」に列挙されたパスをすべて実際に読み、成果物内の記述と現在動作の対応を確認する。
|
|
44
|
-
3. 各対応を一致・乖離・実装から確認不能・未確認に分類する。成果物に実装上の事実が書かれていても、意図された仕様と異なる場合は pass にしない。
|
|
45
|
-
4. 乖離ごとに、文書が古い、実装が意図された仕様と異なる、承認根拠が不足、複数実装で挙動が異なる、のいずれかを判定し、実装または文書のどちらに修正が必要かを示す。
|
|
46
|
-
5. 実装から目的、業務判断、将来方針を推測しない。列挙されたエビデンスで判定できない場合は unclear とし、不足する根拠を明記する。
|
|
47
|
-
|
|
48
|
-
### 5.1. 判断根拠の記録
|
|
49
|
-
|
|
50
|
-
review result には、少なくとも次を記録する。
|
|
50
|
+
## 6. 進め方
|
|
51
51
|
|
|
52
|
-
|
|
53
|
-
- 成果物記述と実装の対応、および一致・乖離・確認不能・未確認の判定
|
|
54
|
-
- 乖離ごとの修正対象候補(実装・文書・意思決定)と根拠
|
|
55
|
-
- 調査できなかったパス、分岐、外部依存などの未確認範囲
|
|
52
|
+
retrofit のタスクは、既存の実装を根拠に成果物を意図された仕様へ合わせることを求めた。成果物の内容の品質は grade が評価済みである。review は成果物を読み直して判定せず、実装との対応が記録されているかを確認する。
|
|
56
53
|
|
|
57
|
-
|
|
54
|
+
1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
|
|
55
|
+
2. 実行記録に、「実装エビデンス」に列挙された各パスについて、成果物の記述との対応と判定(一致・乖離・確認不能・未確認)が残っているかを確認する。記録のないパスは未充足事項とする。
|
|
56
|
+
3. 乖離ごとに修正対象候補(実装・文書・意思決定)と根拠が記録されているか、調査できなかった範囲が明示されているかを確認する。
|
|
57
|
+
4. 実装から目的・業務判断・将来方針を推測して成果物へ書いた形跡が finding にある場合は、このタスクの完了を妨げるかを判断する。
|
|
58
58
|
|
|
59
59
|
本タスクの実行に必要な retrofit の確認方針は、このセクションで完結する。approach 全体の定義を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
60
60
|
|
|
61
|
-
##
|
|
61
|
+
## 7. 完了手順
|
|
62
62
|
|
|
63
|
-
1.
|
|
64
|
-
2. result
|
|
65
|
-
3.
|
|
66
|
-
4.
|
|
63
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
64
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には実装エビデンスの対応記録の確認結果と未確認範囲を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
65
|
+
3. 文書の参照は `[[id]]` 形式、実装参照はリポジトリルート相対パスで記載し、絶対パスを使わない。
|
|
66
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
67
67
|
|
|
68
|
-
##
|
|
68
|
+
## 8. 異常終了の条件
|
|
69
69
|
|
|
70
|
-
- `evidence_refs` 欠落、実装エビデンス不存在、対象ファイル不明、result
|
|
71
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
70
|
+
- `evidence_refs` 欠落、実装エビデンス不存在、対象ファイル不明、result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
71
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
72
72
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
73
73
|
|
|
74
74
|
_COMMON_CONVENTIONS_
|
|
@@ -18,57 +18,52 @@ _PHASE_DESCRIPTION_
|
|
|
18
18
|
|
|
19
19
|
_PROJECT_CONTEXT_
|
|
20
20
|
|
|
21
|
-
## 3.
|
|
21
|
+
## 3. 評価結果
|
|
22
|
+
|
|
23
|
+
review は見直し後の rulebook を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。評価対象は対象成果物ではなく rulebook である。
|
|
24
|
+
|
|
25
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
26
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
27
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
28
|
+
|
|
29
|
+
_GRADE_SUMMARY_
|
|
30
|
+
|
|
31
|
+
## 4. 完了条件
|
|
32
|
+
|
|
33
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
22
34
|
|
|
23
35
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
24
36
|
|
|
25
37
|
<!-- prettier-ignore-start -->
|
|
26
|
-
| ID | ロール | viewpoint_id |
|
|
38
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
27
39
|
| --- | ------ | ------------ | -------- |
|
|
28
|
-
|
|
40
|
+
_DONE_CRITERIA_ROWS_
|
|
29
41
|
<!-- prettier-ignore-end -->
|
|
30
42
|
|
|
31
43
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
32
44
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
## 4. 進め方
|
|
45
|
+
## 5. 進め方
|
|
36
46
|
|
|
37
|
-
|
|
47
|
+
このタスクは、対象成果物に紐づく rulebook を見直すことを求めた。見直し後の rulebook の品質は grade が評価済みである。対象は [[specdojo:rulebook-authoring-standard]] への準拠、recipe / sample / template や `併せて適用する rulebook` との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
38
48
|
|
|
39
|
-
1.
|
|
40
|
-
2. finding
|
|
41
|
-
3.
|
|
42
|
-
4.
|
|
43
|
-
5. recipe / sample / template、および `併せて適用する rulebook`(`_MISSING_` でない場合)と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
49
|
+
1. 見直しの動機となった finding(先行する edit plan に展開された finding)を実行記録から特定し、最新の評価結果で解消しているかを確認する。
|
|
50
|
+
2. 解消していない finding がある場合は、実行記録に未解消の理由と次のアクションが残っているかを確認する。理由のない未解消は未充足事項とする。
|
|
51
|
+
3. 見直しが rulebook の範囲に収まり、対象成果物そのものを書き換えていないかを確認する。
|
|
52
|
+
4. 最新の評価結果に残る finding が、このタスクの完了を妨げるかを判断する。
|
|
44
53
|
|
|
45
54
|
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な rulebook メンテナンス確認の方針は、このセクションで完結する。
|
|
46
55
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
- finding の message と判定根拠、対象 rulebook から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
50
|
-
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
51
|
-
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
52
|
-
|
|
53
|
-
### 4.2. 判断根拠の記録
|
|
54
|
-
|
|
55
|
-
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
56
|
-
|
|
57
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
58
|
-
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
59
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
60
|
-
|
|
61
|
-
## 5. 完了手順
|
|
56
|
+
## 6. 完了手順
|
|
62
57
|
|
|
63
|
-
1.
|
|
64
|
-
2. result
|
|
65
|
-
3.
|
|
66
|
-
4.
|
|
58
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
59
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には見直しの動機となった finding の解消状況を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
60
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
61
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
67
62
|
|
|
68
|
-
##
|
|
63
|
+
## 7. 異常終了の条件
|
|
69
64
|
|
|
70
|
-
- 対象ファイル不明・依存未解決・result
|
|
71
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
65
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
66
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
72
67
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
73
68
|
|
|
74
69
|
_COMMON_CONVENTIONS_
|
|
@@ -17,57 +17,52 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は見直し後の sample を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。評価対象は対象成果物ではなく sample である。
|
|
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
|
-
## 4. 進め方
|
|
44
|
+
## 5. 進め方
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
このタスクは、対象成果物に紐づく sample を見直すことを求めた。見直し後の sample の品質は grade が評価済みである。対象は [[specdojo:sample-authoring-standard]] への準拠、rulebook / recipe との整合、実成果物の丸写しになっていないかである。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
37
47
|
|
|
38
|
-
1.
|
|
39
|
-
2.
|
|
40
|
-
3.
|
|
41
|
-
4.
|
|
42
|
-
5. rulebook / recipe と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
48
|
+
1. 見直しの動機となった finding(先行する edit plan に展開された finding)を実行記録から特定し、最新の評価結果で解消しているかを確認する。
|
|
49
|
+
2. 解消していない finding がある場合は、実行記録に未解消の理由と次のアクションが残っているかを確認する。理由のない未解消は未充足事項とする。
|
|
50
|
+
3. 見直しが sample の範囲に収まり、対象成果物そのものを書き換えていないかを確認する。
|
|
51
|
+
4. 最新の評価結果に残る finding が、このタスクの完了を妨げるかを判断する。
|
|
43
52
|
|
|
44
53
|
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な sample メンテナンス確認の方針は、このセクションで完結する。
|
|
45
54
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
- finding の message と判定根拠、対象 sample から辿れる rulebook / recipe、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
-
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
-
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
-
|
|
52
|
-
### 4.2. 判断根拠の記録
|
|
53
|
-
|
|
54
|
-
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
-
|
|
56
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
-
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
-
|
|
60
|
-
## 5. 完了手順
|
|
55
|
+
## 6. 完了手順
|
|
61
56
|
|
|
62
|
-
1.
|
|
63
|
-
2. result
|
|
64
|
-
3.
|
|
65
|
-
4.
|
|
57
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
58
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には見直しの動機となった finding の解消状況を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
59
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
60
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
66
61
|
|
|
67
|
-
##
|
|
62
|
+
## 7. 異常終了の条件
|
|
68
63
|
|
|
69
|
-
- 対象ファイル不明・依存未解決・result
|
|
70
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
64
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
65
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
71
66
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
67
|
|
|
73
68
|
_COMMON_CONVENTIONS_
|
|
@@ -17,57 +17,52 @@ _PHASE_DESCRIPTION_
|
|
|
17
17
|
|
|
18
18
|
_PROJECT_CONTEXT_
|
|
19
19
|
|
|
20
|
-
## 3.
|
|
20
|
+
## 3. 評価結果
|
|
21
|
+
|
|
22
|
+
review は見直し後の template を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。評価対象は対象成果物ではなく template である。
|
|
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
|
-
## 4. 進め方
|
|
44
|
+
## 5. 進め方
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
このタスクは、対象成果物に紐づく template を見直すことを求めた。見直し後の template の品質は grade が評価済みである。対象は [[specdojo:template-authoring-standard]] への準拠、章構成の骨組みとプレースホルダの網羅性、rulebook / recipe / sample との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
37
47
|
|
|
38
|
-
1.
|
|
39
|
-
2. finding
|
|
40
|
-
3.
|
|
41
|
-
4.
|
|
42
|
-
5. rulebook / recipe / sample と記述が矛盾していないか確認する(構造・必須項目・禁止事項は rulebook を正とする)。
|
|
48
|
+
1. 見直しの動機となった finding(先行する edit plan に展開された finding)を実行記録から特定し、最新の評価結果で解消しているかを確認する。
|
|
49
|
+
2. 解消していない finding がある場合は、実行記録に未解消の理由と次のアクションが残っているかを確認する。理由のない未解消は未充足事項とする。
|
|
50
|
+
3. 見直しが template の範囲に収まり、対象成果物そのものを書き換えていないかを確認する。
|
|
51
|
+
4. 最新の評価結果に残る finding が、このタスクの完了を妨げるかを判断する。
|
|
43
52
|
|
|
44
53
|
approach 全体の定義は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照する。本タスクの実行に必要な template メンテナンス確認の方針は、このセクションで完結する。
|
|
45
54
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
- finding の message と判定根拠、対象 template から辿れる rulebook / recipe / sample、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても改訂の妥当性を判定できない場合に限り、根拠不足として unclear にする。成果物または review result がないことだけを理由に unclear にしない。
|
|
49
|
-
- 根拠不足の場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを review result の `実践の型との整合確認` セクションに記録する。
|
|
50
|
-
- 根拠不足のまま改訂が正当化できない箇所は findings に挙げる。
|
|
51
|
-
|
|
52
|
-
### 4.2. 判断根拠の記録
|
|
53
|
-
|
|
54
|
-
確認の根拠とした規範・成果物・review result と判断根拠を review result に残す。記録先は次のとおり。
|
|
55
|
-
|
|
56
|
-
- レビュー観点ごとの pass / fail / unclear 判定と根拠: review result の `レビュー観点別結果` セクション(各 `RVP-NNN`)。
|
|
57
|
-
- 根拠とした規範・成果物・review result、改訂内容の妥当性判断、矛盾時に rulebook を正とした箇所: review result の `実践の型との整合確認` セクション。
|
|
58
|
-
- 検出した問題点・指摘事項: review result の `findings` セクション。
|
|
59
|
-
|
|
60
|
-
## 5. 完了手順
|
|
55
|
+
## 6. 完了手順
|
|
61
56
|
|
|
62
|
-
1.
|
|
63
|
-
2. result
|
|
64
|
-
3.
|
|
65
|
-
4.
|
|
57
|
+
1. 共通規約の `review の判断手順` に従い、評価結果の鮮度を確認してから完了可否を判断する。
|
|
58
|
+
2. result の各セクションを埋める。`評価結果の確認` には鮮度確認のコマンドと出力、grade の `verdict` / `score` / finding 件数を書く。`判断根拠` には照合した内容を、`未充足事項・改善指示` には未充足事項と改善指示を書く。`approach に応じた確認` には見直しの動機となった finding の解消状況を、`decision` には `verdict` を書く。review result の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
|
|
59
|
+
3. 文書の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は本文で述べる。
|
|
60
|
+
4. verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。
|
|
66
61
|
|
|
67
|
-
##
|
|
62
|
+
## 7. 異常終了の条件
|
|
68
63
|
|
|
69
|
-
- 対象ファイル不明・依存未解決・result
|
|
70
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
64
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
65
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
71
66
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
72
67
|
|
|
73
68
|
_COMMON_CONVENTIONS_
|
|
@@ -18,50 +18,51 @@ _PHASE_DESCRIPTION_
|
|
|
18
18
|
|
|
19
19
|
_PROJECT_CONTEXT_
|
|
20
20
|
|
|
21
|
-
## 3.
|
|
21
|
+
## 3. 評価結果
|
|
22
|
+
|
|
23
|
+
review は成果物を再評価しない。次の評価結果を事実として受け取り、共通規約の `review の判断手順` に従ってタスクの完了可否を判断する。
|
|
24
|
+
|
|
25
|
+
- 評価対象: `_GRADE_SUBJECT_PATH_`
|
|
26
|
+
- grade の対象種別(`--target`): `_GRADE_TARGET_`
|
|
27
|
+
- 評価結果サイドカー: `_GRADE_RESULT_PATH_`(`_MISSING_` は評価対象が未作成、または評価対象の `id` を解決できないことを示す。この場合は評価結果が最新でないものとして扱う)
|
|
28
|
+
|
|
29
|
+
_GRADE_SUMMARY_
|
|
30
|
+
|
|
31
|
+
## 4. 完了条件
|
|
32
|
+
|
|
33
|
+
成果物カタログの `done_criteria` を、このタスクの完了条件として照合する。観点ごとに成果物を評価し直すための表ではない。
|
|
22
34
|
|
|
23
35
|
<!-- markdownlint-disable MD055 MD056 -->
|
|
24
36
|
|
|
25
37
|
<!-- prettier-ignore-start -->
|
|
26
|
-
| ID | ロール | viewpoint_id |
|
|
38
|
+
| ID | ロール | viewpoint_id | 完了条件 |
|
|
27
39
|
| --- | ------ | ------------ | -------- |
|
|
28
|
-
|
|
40
|
+
_DONE_CRITERIA_ROWS_
|
|
29
41
|
<!-- prettier-ignore-end -->
|
|
30
42
|
|
|
31
43
|
<!-- markdownlint-enable MD055 MD056 -->
|
|
32
44
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
owner ロールの観点は、成果物がその責務を果たしているかを確認する。owner 以外のロールの観点は、その文書から各ロールが自分の責務の成果物を作成できるかという入力適合性の最低限の確認とし、各ロールの内容まで踏み込む過剰な再レビューはしない(一文書一責務)。
|
|
36
|
-
|
|
37
|
-
## 4. 進め方
|
|
45
|
+
## 5. 進め方
|
|
38
46
|
|
|
39
|
-
- exec plan frontmatter の `approach`
|
|
40
|
-
- `approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
- `freeform`: 実践の型より、類似成果物の実例やプロジェクト文脈との整合を確認する。
|
|
45
|
-
- 未指定の場合は、存在するすべての実践の型をそれぞれの役割に沿って確認の基準にする。
|
|
46
|
-
- 複数の文書間で記述に矛盾がある場合、確認の基準に rulebook を含む `approach`(`fully-guided` など)では rulebook を正とする。
|
|
47
|
-
- `freeform` と実践の型メンテナンス系(`*-maintenance`)を除く `approach` では、確認に用いてよい文書をこの plan に記載されたもの(対象成果物に紐づく rulebook / 併せて適用する rulebook / recipe / sample / template、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキスト)に限定する。クロス文書整合のレビュー観点では `depends_on` 成果物を読み込んで対象成果物と突き合わせ、目的整合の判断ではプロジェクトコンテキストを参照する。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
|
|
48
|
-
- `freeform` を除く `approach` では、対象成果物中のファイルパス・コマンド・設定値など実装や設定の実態を示す具体的な記述が、確認に用いてよい文書で裏付けられているかを確認する。裏付けが確認できない具体的な記述は、正確性を検証できないため該当レビュー観点を unclear とし、findings に記録する。もっともらしく具体的に見えることは裏付けの代わりにならない。
|
|
49
|
-
- evidence・notes は、対象成果物・実践の型を実際に読んで得た具体的な観察に限る。実行 agent(executor)の最終メッセージや result の自己申告を、そのまま、または言い換えて evidence として扱わない。対象成果物の内容と executor の報告が一致しない場合は、対象成果物側を優先し findings に記録する。
|
|
50
|
-
- 存在しない、または確認の基準から外れた文書がある場合は、他に存在する文書、類似成果物、対象領域の慣行と整合しているかを確認し、判断の根拠を review result に残す。
|
|
47
|
+
- exec plan frontmatter の `approach` を確認し、このタスクが何を求めたかを把握する。実践の型(rulebook / recipe / sample / template)との整合は grade が評価済みであり、review で照合し直さない。
|
|
48
|
+
- `approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合、評価対象は実践の型そのものである。見直しの動機となった finding が、最新の評価結果で解消しているかを確認する。
|
|
49
|
+
- `approach` が `retrofit` の場合は、成果物と実装の対応記録(一致・乖離・確認不能・未確認)と、乖離ごとの修正対象候補が実行記録に残っているかを確認する。
|
|
50
|
+
- それ以外の場合は、フェーズ説明と完了条件が求めた作成・更新が行われたかを確認する。
|
|
51
|
+
- 確認に用いてよい文書は、この plan に記載されたものに限る。具体的には、評価結果、対象成果物、`depends_on` 成果物、プロジェクトコンテキスト、実行記録である。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
|
|
51
52
|
|
|
52
53
|
詳細は [[specdojo:ryu-guide]] を参照する。
|
|
53
54
|
|
|
54
|
-
##
|
|
55
|
+
## 6. 完了手順
|
|
55
56
|
|
|
56
|
-
1.
|
|
57
|
-
2. result
|
|
58
|
-
3.
|
|
59
|
-
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)。
|
|
60
61
|
|
|
61
|
-
##
|
|
62
|
+
## 7. 異常終了の条件
|
|
62
63
|
|
|
63
|
-
- 対象ファイル不明・依存未解決・result
|
|
64
|
-
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>;
|
|
64
|
+
- 対象ファイル不明・依存未解決・result 更新不能など、review 自体を完了できない場合は異常終了する(終了コード 1)。評価結果が最新でない・評価不能であることは異常終了の理由にせず、verdict として記録する。
|
|
65
|
+
- 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; ref=<path>`)。
|
|
65
66
|
- agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
|
|
66
67
|
|
|
67
68
|
_COMMON_CONVENTIONS_
|
|
@@ -2,20 +2,22 @@ _FRONTMATTER_
|
|
|
2
2
|
|
|
3
3
|
# Review Result
|
|
4
4
|
|
|
5
|
-
## 1.
|
|
5
|
+
## 1. 評価結果の確認
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
_TODO_: 評価結果サイドカーのパス、鮮度確認で実行したコマンドとその出力(`content_hash` が現在の成果物と一致するか)、grade の `verdict` / `score` / finding 件数を記入する。評価結果が最新でない、または評価不能の場合は、その事実と理由を記入する。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## 2. 判断根拠
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
_TODO_: 変更内容・plan・実行記録・完了条件・最新の finding を照合した内容と、verdict を選んだ理由を記入する。finding が残るのに完了とする場合は、その finding が今回の完了を妨げない理由を記入する。参照は `[[id]]` 形式(Obsidian wikilink)で記載し、行番号アンカーや絶対パスは使わない。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## 3. 未充足事項・改善指示
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
_TODO_: 未充足事項と、再計画・成果物の改善・再評価に使う改善指示を記入する(なければ「なし」と記入する)。評価結果の内容に疑義がある場合は、再評価が必要な対象と理由もここに記入する。
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
## 4. approach に応じた確認
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
_TODO_: `approach` に応じて確認した内容を記入する。fully-guided / recipe-guided / freeform では求められた作成・更新が行われたか、retrofit では実装エビデンスの対応記録と未確認範囲、`rulebook-maintenance` などの maintenance 系では見直しの動機となった finding の解消状況を記入する。
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
## 5. decision
|
|
22
|
+
|
|
23
|
+
- verdict: _TODO_(complete / complete-with-findings / incomplete / grade-stale / grade-unavailable / changed-during-review)
|