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.
Files changed (168) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +122 -1
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-handoff.js +336 -0
  15. package/dist/exec-parent-validation.js +317 -43
  16. package/dist/exec-pipeline-state.js +74 -9
  17. package/dist/exec-plans.js +115 -113
  18. package/dist/exec-protection-handoff.js +43 -2
  19. package/dist/exec-provider-scaffold.js +247 -15
  20. package/dist/exec-register-resume.js +65 -19
  21. package/dist/exec-register.js +9 -3
  22. package/dist/exec-repo-integration.js +811 -0
  23. package/dist/exec-repo-trace.js +182 -0
  24. package/dist/exec-reporter.js +613 -132
  25. package/dist/exec-results.js +81 -56
  26. package/dist/exec-run-lock.js +110 -107
  27. package/dist/exec-run.js +1585 -356
  28. package/dist/exec-shared.js +7 -0
  29. package/dist/exec-slot-lock.js +242 -0
  30. package/dist/exec-task-repos.js +415 -0
  31. package/dist/exec-trial.js +51 -25
  32. package/dist/exec-worktree-command.js +87 -43
  33. package/dist/exec-worktree-ops.js +502 -57
  34. package/dist/exec-worktree.js +114 -27
  35. package/dist/exec.js +13 -6
  36. package/dist/grade-result.js +128 -0
  37. package/dist/grade.js +809 -72
  38. package/dist/init-command.js +443 -0
  39. package/dist/job.js +160 -10
  40. package/dist/orchestrator.js +213 -0
  41. package/dist/register-event-merge.js +169 -0
  42. package/dist/register-item.js +7 -1
  43. package/dist/register.js +294 -86
  44. package/dist/review-grade.js +252 -0
  45. package/dist/review-plan.js +111 -1
  46. package/dist/review-types.js +40 -1
  47. package/dist/routine.js +72 -5
  48. package/dist/schedule-build.js +2 -2
  49. package/dist/schedule.js +17 -4
  50. package/dist/specdojo-config.js +465 -19
  51. package/dist/specdojo-gitignore.js +135 -0
  52. package/dist/specdojo.js +6 -0
  53. package/dist/viewpoint-document-kinds-check.js +128 -0
  54. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  55. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  56. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  57. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  58. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  59. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  60. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  62. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  63. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  65. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  67. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  68. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  69. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  70. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  71. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  72. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  73. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  74. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  75. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  76. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  77. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  78. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  79. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  80. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  81. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  82. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  83. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  84. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  85. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  86. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  87. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  88. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  89. package/docs/ja/specdojo/index.md +2 -2
  90. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  91. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  92. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  93. package/docs/ja/specdojo/references/command-reference.md +335 -92
  94. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  95. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  96. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  97. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  98. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  99. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  101. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  102. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  104. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  105. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  106. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  107. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  108. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  109. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  110. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  111. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  112. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  113. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  114. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  115. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  116. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  117. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  118. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  119. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  120. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  121. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  122. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  123. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  124. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  125. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  126. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  127. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  128. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  129. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  130. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  131. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  132. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  133. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  134. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  135. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  136. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  137. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  138. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  139. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  140. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  141. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  142. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  143. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  144. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  145. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  146. package/package.json +15 -9
  147. package/templates/antigravity/README.md +27 -2
  148. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  149. package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
  150. package/templates/antigravity/orchestrator.md +18 -7
  151. package/templates/antigravity/settings.global.json +55 -0
  152. package/templates/claude/agents/claude-executor.md +14 -0
  153. package/templates/claude/agents/claude-reporter.md +16 -0
  154. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  155. package/templates/claude/settings.edit.json +27 -1
  156. package/templates/codex/README.md +5 -4
  157. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  158. package/templates/codex/orchestrator.md +18 -7
  159. package/templates/copilot/README.md +7 -5
  160. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  161. package/templates/devcontainer/devcontainer.json +27 -0
  162. package/templates/devcontainer/emacs/init.el +88 -0
  163. package/templates/devcontainer/post-create.sh +62 -0
  164. package/templates/init-agent-members.yaml +200 -0
  165. package/templates/init-exec-defaults.yaml +72 -0
  166. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  167. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  168. 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
- _REVIEW_VIEWPOINT_ROWS_
39
+ _DONE_CRITERIA_ROWS_
28
40
  <!-- prettier-ignore-end -->
29
41
 
30
42
  <!-- markdownlint-enable MD055 MD056 -->
31
43
 
32
- _REVIEW_VIEWPOINT_DETAILS_
33
-
34
- ## 4. 進め方
44
+ ## 5. 進め方
35
45
 
36
- 確認の向きを「成果物 → recipe」に切り替え、対象成果物に紐づく recipe の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは recipe を編集するのではなく、見直し内容が妥当かを照合する。
46
+ このタスクは、対象成果物に紐づく recipe を見直すことを求めた。見直し後の recipe の品質は grade が評価済みである。対象は [[specdojo:recipe-authoring-standard]] への準拠と rulebook との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
37
47
 
38
- 1. 見直し対象の recipe を読み込み、改訂後の問い・観点・深掘り手順・レビュー観点を把握する。
39
- 2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 recipe の frontmatter から辿れる rulebook、該当する執筆標準のうち必要な文書と照合する。
40
- 3. 複数の成果物・review result・対象領域の慣行と照らし、それらが良い内容の作成に役立つものになっているかを確認する。
41
- 4. 見直し内容が [[specdojo:recipe-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従っているか確認する。
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
- ### 4.1. 見直しの根拠が不足する場合
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. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
63
- 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
64
- 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
65
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 6. 異常終了の条件
62
+ ## 7. 異常終了の条件
68
63
 
69
- - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
70
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- _REVIEW_VIEWPOINT_ROWS_
45
+ _DONE_CRITERIA_ROWS_
34
46
  <!-- prettier-ignore-end -->
35
47
 
36
48
  <!-- markdownlint-enable MD055 MD056 -->
37
49
 
38
- _REVIEW_VIEWPOINT_DETAILS_
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
- 各レビュー観点の pass / fail / unclear と証跡は `レビュー観点別結果`、問題点は `findings`、実装エビデンス全体の対応状況は `実践の型との整合確認` または申し送りへ記録する。
54
+ 1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
55
+ 2. 実行記録に、「実装エビデンス」に列挙された各パスについて、成果物の記述との対応と判定(一致・乖離・確認不能・未確認)が残っているかを確認する。記録のないパスは未充足事項とする。
56
+ 3. 乖離ごとに修正対象候補(実装・文書・意思決定)と根拠が記録されているか、調査できなかった範囲が明示されているかを確認する。
57
+ 4. 実装から目的・業務判断・将来方針を推測して成果物へ書いた形跡が finding にある場合は、このタスクの完了を妨げるかを判断する。
58
58
 
59
59
  本タスクの実行に必要な retrofit の確認方針は、このセクションで完結する。approach 全体の定義を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
60
60
 
61
- ## 6. 完了手順
61
+ ## 7. 完了手順
62
62
 
63
- 1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
64
- 2. result の各レビュー観点セクションと実装エビデンスの対応記録を埋める。
65
- 3. `evidence` の文書参照は `[[id]]` 形式、実装参照はリポジトリルート相対パスで記載し、絶対パスを使わない。
66
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 7. 異常終了の条件
68
+ ## 8. 異常終了の条件
69
69
 
70
- - `evidence_refs` 欠落、実装エビデンス不存在、対象ファイル不明、result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
71
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- _REVIEW_VIEWPOINT_ROWS_
40
+ _DONE_CRITERIA_ROWS_
29
41
  <!-- prettier-ignore-end -->
30
42
 
31
43
  <!-- markdownlint-enable MD055 MD056 -->
32
44
 
33
- _REVIEW_VIEWPOINT_DETAILS_
34
-
35
- ## 4. 進め方
45
+ ## 5. 進め方
36
46
 
37
- 確認の向きを「成果物 → rulebook」に切り替え、対象成果物に紐づく rulebook の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは rulebook を編集するのではなく、見直し内容が妥当かを照合する。
47
+ このタスクは、対象成果物に紐づく rulebook を見直すことを求めた。見直し後の rulebook の品質は grade が評価済みである。対象は [[specdojo:rulebook-authoring-standard]] への準拠、recipe / sample / template や `併せて適用する rulebook` との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
38
48
 
39
- 1. 見直し対象の rulebook を読み込み、改訂後の章構成・必須項目・禁止事項・判定基準を把握する。
40
- 2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 rulebook の frontmatter から辿れる recipe / sample / template、`併せて適用する rulebook`、該当する執筆標準のうち必要な文書と照合する。
41
- 3. 複数の成果物・review result・対象領域の慣行と照らし、それらが成果物の実態と整合しているかを確認する。
42
- 4. 見直し内容が [[specdojo:rulebook-authoring-standard]](章立て・記述ルール・禁止事項の正本)に従っているか確認する。
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
- ### 4.1. 見直しの根拠が不足する場合
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. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
64
- 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
65
- 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
66
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 6. 異常終了の条件
63
+ ## 7. 異常終了の条件
69
64
 
70
- - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
71
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- _REVIEW_VIEWPOINT_ROWS_
39
+ _DONE_CRITERIA_ROWS_
28
40
  <!-- prettier-ignore-end -->
29
41
 
30
42
  <!-- markdownlint-enable MD055 MD056 -->
31
43
 
32
- _REVIEW_VIEWPOINT_DETAILS_
33
-
34
- ## 4. 進め方
44
+ ## 5. 進め方
35
45
 
36
- 確認の向きを「成果物 → sample」に切り替え、対象成果物に紐づく sample の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは sample を編集するのではなく、見直し内容が妥当かを照合する。
46
+ このタスクは、対象成果物に紐づく sample を見直すことを求めた。見直し後の sample の品質は grade が評価済みである。対象は [[specdojo:sample-authoring-standard]] への準拠、rulebook / recipe との整合、実成果物の丸写しになっていないかである。review はこれらを照合し直さず、評価結果の finding として扱う。
37
47
 
38
- 1. 見直し対象の sample を読み込み、改訂後の粒度・文体・表の書き方を把握する。
39
- 2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 sample の frontmatter から辿れる rulebook / recipe、該当する執筆標準のうち必要な文書と照合する。rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として確認する。
40
- 3. 複数の成果物・review result・対象領域の慣行と照らし、それらが完成例として適切か、実成果物の丸写しになっていないかを確認する。
41
- 4. 見直し内容が [[specdojo:sample-authoring-standard]](構成・記述ルール・禁止事項の正本)に従っているか確認する。
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
- ### 4.1. 見直しの根拠が不足する場合
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. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
63
- 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
64
- 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
65
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 6. 異常終了の条件
62
+ ## 7. 異常終了の条件
68
63
 
69
- - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
70
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- _REVIEW_VIEWPOINT_ROWS_
39
+ _DONE_CRITERIA_ROWS_
28
40
  <!-- prettier-ignore-end -->
29
41
 
30
42
  <!-- markdownlint-enable MD055 MD056 -->
31
43
 
32
- _REVIEW_VIEWPOINT_DETAILS_
33
-
34
- ## 4. 進め方
44
+ ## 5. 進め方
35
45
 
36
- 確認の向きを「成果物 → template」に切り替え、対象成果物に紐づく template の見直し内容が妥当かを確認する。根拠となる成果物・review result・対象領域の慣行に加え、finding が指す規範も実際に読み込んだうえで照合する。読み込まずに記憶や推測で代替しない。レビューでは template を編集するのではなく、見直し内容が妥当かを照合する。
46
+ このタスクは、対象成果物に紐づく template を見直すことを求めた。見直し後の template の品質は grade が評価済みである。対象は [[specdojo:template-authoring-standard]] への準拠、章構成の骨組みとプレースホルダの網羅性、rulebook / recipe / sample との整合である。review はこれらを照合し直さず、評価結果の finding として扱う。
37
47
 
38
- 1. 見直し対象の template を読み込み、改訂後の章構成の骨組みとプレースホルダの配置・網羅性を把握する。
39
- 2. finding がある場合は、message と同じ viewpoint ID の判定根拠から指摘の根拠となる規範を特定し、対象 template の frontmatter から辿れる rulebook / recipe / sample、該当する執筆標準のうち必要な文書と照合する。
40
- 3. 複数の成果物・review result・対象領域の慣行と照らし、それらが成果物作成の開始点として適切かを確認する。
41
- 4. 見直し内容が [[specdojo:template-authoring-standard]](構成・プレースホルダ規約・禁止事項の正本)に従っているか確認する。
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
- ### 4.1. 見直しの根拠が不足する場合
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. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
63
- 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
64
- 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
65
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 6. 異常終了の条件
62
+ ## 7. 異常終了の条件
68
63
 
69
- - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
70
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- _REVIEW_VIEWPOINT_ROWS_
40
+ _DONE_CRITERIA_ROWS_
29
41
  <!-- prettier-ignore-end -->
30
42
 
31
43
  <!-- markdownlint-enable MD055 MD056 -->
32
44
 
33
- _REVIEW_VIEWPOINT_DETAILS_
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
- - それ以外の場合は、対象成果物に紐づく rulebook / recipe / sample / template の有無を確認し、`approach` に応じて確認の基準を決める。
42
- - `fully-guided`: rulebook の必須要素・禁止事項、recipe の問いとレビュー観点、sample の粒度・文体、template の章構成との整合を確認する(プレースホルダが残っていないことも確認する)。`併せて適用する rulebook` が `_MISSING_` でない場合は、その記法などのルールとの整合も確認する。
43
- - `recipe-guided`: recipe の問いとレビュー観点に照らして確認する(rulebook / sample / template の構造・文体は基準にしない)。
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
- ## 5. 完了手順
55
+ ## 6. 完了手順
55
56
 
56
- 1. レビュー観点ごとに pass / fail / unclear を判定し、根拠を記入する。
57
- 2. result の各レビュー観点セクションに記入する。result には各 RVP の `### RVP-NNN(ロール: viewpoint_id)` と `確認基準` が展開済みなので、`result` / `evidence` / `notes` を埋める。レビュー結果の記入はタスク完了に必須であり、未記入のまま終了しない(詳細は共通規約を参照)。
58
- 3. `evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載する。行番号アンカー(`#L12-L18` など)や絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
59
- 4. fail / unclear、または recommendation が revise / reject でも、レビュー結果を記録できた場合は正常終了する(終了コード 0)。
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
- ## 6. 異常終了の条件
62
+ ## 7. 異常終了の条件
62
63
 
63
- - 対象ファイル不明・依存未解決・result 更新不能など、レビュー自体を完了できない場合は異常終了する(終了コード 1)。
64
- - 標準エラー出力に理由を出力する(例: `review-blocked: <reason>; criterion=<id>; ref=<path>`)。
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
- 各 RVP セクションの `result` / `evidence` / `notes` を記入する。`evidence` の参照は `[[id]]` 形式(Obsidian wikilink)で記載し、行番号アンカーや絶対パスは使わない。位置の補足が必要な場合は `evidence` 本文で述べる。
7
+ _TODO_: 評価結果サイドカーのパス、鮮度確認で実行したコマンドとその出力(`content_hash` が現在の成果物と一致するか)、grade の `verdict` / `score` / finding 件数を記入する。評価結果が最新でない、または評価不能の場合は、その事実と理由を記入する。
8
8
 
9
- _REVIEW_RESULT_SECTIONS_
9
+ ## 2. 判断根拠
10
10
 
11
- ## 2. findings
11
+ _TODO_: 変更内容・plan・実行記録・完了条件・最新の finding を照合した内容と、verdict を選んだ理由を記入する。finding が残るのに完了とする場合は、その finding が今回の完了を妨げない理由を記入する。参照は `[[id]]` 形式(Obsidian wikilink)で記載し、行番号アンカーや絶対パスは使わない。
12
12
 
13
- _TODO_: 問題点・指摘事項を記入する(なければ削除)。
13
+ ## 3. 未充足事項・改善指示
14
14
 
15
- ## 3. 実践の型との整合確認
15
+ _TODO_: 未充足事項と、再計画・成果物の改善・再評価に使う改善指示を記入する(なければ「なし」と記入する)。評価結果の内容に疑義がある場合は、再評価が必要な対象と理由もここに記入する。
16
16
 
17
- _TODO_: `approach` に従ってどう確認したか(`fully-guided` で rulebook の必須要素・禁止事項、recipe の作り方、sample の粒度・文体、template の章構成との整合、`recipe-guided` で recipe のみを基準にした確認、`freeform` で実践の型より優先した実例やプロジェクト文脈との整合、`retrofit` で実際に参照した実装パス・成果物との対応判定・乖離ごとの修正対象候補・未確認範囲、`rulebook-maintenance` などの maintenance 系で見直した実践の型とその根拠、など)を記入する。複数文書間に矛盾があり rulebook を正として判定した箇所、確認の基準から外れていた文書とその代わりに根拠にした内容があれば、あわせて記録する。
17
+ ## 4. approach に応じた確認
18
18
 
19
- ## 4. decision
19
+ _TODO_: `approach` に応じて確認した内容を記入する。fully-guided / recipe-guided / freeform では求められた作成・更新が行われたか、retrofit では実装エビデンスの対応記録と未確認範囲、`rulebook-maintenance` などの maintenance 系では見直しの動機となった finding の解消状況を記入する。
20
20
 
21
- - recommendation: _TODO_(approve / revise / reject)
21
+ ## 5. decision
22
+
23
+ - verdict: _TODO_(complete / complete-with-findings / incomplete / grade-stale / grade-unavailable / changed-during-review)