Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-k351-continuous-abolition-all-viewpoints
specdojo.typeproject
specdojo.statusready
specdojo.rulebookspecdojo:pjr-rulebook
specdojo.part_ofprj-0001:pjr-index
specdojo.item_typetodo
specdojo.item_statusdone
specdojo.priorityhigh
specdojo.ownerARC
specdojo.registered_at2026-09-25T12:45:13Z
specdojo.completed_at2026-09-27T12:42:30Z
specdojo.conclusioncontinuous を廃止し 28 観点を grade の対象にした。rubric を v2(9 category)とし pass_score を 75 に改めた。旧形式はエラーで拒否する。標本の試行で既存 finding の質の低下はなかった

PJR-K351 continuous を廃止し 28 観点すべてを grade の対象にする ​

1. 概要 ​

continuous を廃止し、28 観点すべてを grade の対象にする。grade と review が同じ観点集合を見るという prj-0001:pjr-2zvs-grade-review-integration の最終結論を実装する。rubric の重みを 4 category から 9 category へ広げるため、既存の score がすべて変わる。一度しか起こせない変更なので、観点定義を安定させてから行う。

2. 経緯 ​

当初は vp-ops-agent-boundary 1 件を試し、continuous: true にできるかを決める項目だった。prj-0001:pjr-wpwb-viewpoint-evaluation-criteria の検討で、除外する根拠がどれも成り立たないことが分かり、範囲を 28 観点へ広げた。

当初の除外理由検証の結果
主観的な判断を毎回繰り返しても意味がないgrade は変化したときだけ動く。無変化での再評価は 19 回中 0 回
主観的な判断は繰り返すと不安定になる裁量型の vp-arc-conciseness の level 変動は 19 回中 1 回(5%)。最も安定していた
vp-dev-change-impact は変更を対象にしている対象は影響の記述の有無であり、スナップショットで判定できる

3. 事実 ​

3.1. grade の score に入っていない category が 5 つある ​

項目値
定義された category9
grade の score に入る category4(architecture、consistency、quality、usability)
一度も入らない category5(purpose、planning、business、implementation、operations)
score 100 の成果物23 件

23 件の満点は、9 category のうち 5 つを一度も見ていない満点である。

3.2. rubric の重みは 4 category しかない ​

yaml
weights:
  kata: { architecture: 20, consistency: 20, quality: 35, usability: 25 }
  deliverable: { architecture: 20, consistency: 25, quality: 30, usability: 25 }

3.3. grade.ts が continuous に拒否権を重ねている ​

typescript
viewpoint.continuous === true && viewpoint.evaluation !== "human";

evaluation !== "human" は prj-0001:pjr-wpwb-viewpoint-evaluation-criteria の改名で外す。本項目では continuous の条件そのものを消す。

4. 移行の影響 ​

影響内容
schemacontinuous を削除し、weights を 9 category にする
既存結果303 件の score が変わる。過去の結果とは比べられなくなる
promptagent へ渡す観点が 12 から 28 に増える(2.3 倍)
閾値70 点という v1 の閾値の意味が変わるため、決め直す

prompt が長くなることが残る懸念である。 注意が分散し、既存観点の finding の質が下がるおそれがある。実測で確かめる。

5. 前提 ​

前提項目
観点の適用範囲を文書の種類で宣言しているprj-0001:pjr-ag7b-viewpoint-applicability-by-document-kind
check へ判定規準を書き込んでいるprj-0001:pjr-dkx8-vp-arc-conciseness-vp-ux-user-flow-check
evaluation の改名と実行経路の変更が済んでいるprj-0001:pjr-wpwb-viewpoint-evaluation-criteria

適用範囲の宣言がないまま 28 観点へ広げると、絞り込みがないまま全文書に全観点を当てることになり、noise が増える。 前提 3 件を先に終える。

6. 完了条件 ​

  • pm-review-viewpoints.schema.yaml から continuous が削除されている。
  • docs/ja/specdojo/defaults/pm-review-viewpoints.yaml の 28 観点から continuous が削除されている。
  • src/grade.ts が continuous を参照していない。grade の対象は grade_targets と文書の種類で決まる。
  • rubric の weights が 9 category を持ち、kata と成果物それぞれの重みに理由がある。
  • 閾値を決め直しており、理由が記録されている。
  • 旧形式の continuous を読み込んだ場合、削除済みであることを示すエラーで失敗する。黙って無視しない。
  • 標本の文書で試行し、prompt が長くなったことで既存観点の finding の質が下がっていないことを確かめている。
  • 既存結果の score が変わることを、利用者が読むガイドに記載している。
  • npm run check が通過している。

7. 作業内容 ​

No作業担当状態メモ
1前提 3 件の完了を待つARCdoneAG7B・DKX8・WPWB はいずれも done
2rubric の 9 category の重みを決めるQEdonekata と成果物で分け、理由を defaults のコメントに記録
3標本で試行し、finding の質を確かめるQEopen12 観点と 28 観点を比べる。agent による grade の実行が必要
4閾値を決め直すQEdone70 から 75 へ。level 3 の下限に合わせる
5schema・defaults・grade.ts から continuous を消すDEVdone旧形式は削除済みを示すエラーで拒否する
6ガイドへ score の非互換を記載するOPSdonereview-guide.md の「grade と共有する評価属性・rubric」へ記載

8. 対応結果 ​

  • pm-review-viewpoints.schema.yaml の Viewpoint から continuous を削除した。additionalProperties: false のため、schema 検証でも旧フィールドは拒否される。
  • docs/ja/specdojo/defaults/pm-review-viewpoints.yaml の 28 観点から continuous を削除した。
  • src/grade.ts は continuous を参照しない。grade の対象は grade_targets と document_kinds(文書の種類)だけで決まる。
  • 観点定義の読み込み(src/review-plan.ts)は、continuous を持つ観点を削除済みであることを示すエラーで拒否する。共通正本・overlay・extends のない全量ファイルのいずれにも適用する。
  • rubric を grade-rubric-v2 とし、weights を 9 category へ広げた。v1 の 4 category の相対比を保って縮め(kata は 70、成果物は 65)、空いた分を新しい 5 category へ配った。成果物は目的・業務価値・実装可能性が固有に問われるため、kata より多く配った。理由は defaults のコメントに記録した。
  • 観点の category に重みがない rubric は、grade の実行時にエラーで失敗する。重み 0 のまま黙って score から落ちることを防ぐ。
  • pass_score を 70 から 75 へ改めた。75 は level 3(軽微な課題)の score で、major のない文書が category の数や重みに関係なく満たす下限と一致する。
  • review-guide.md に、v2 の score が v1 と比較できないこと、--changed-only では旧基準の結果が再評価されないことを記載した。
  • 標本の文書での 12 観点と 28 観点の比較試行(作業 3)は未実施である。agent による grade の実行が必要なため、別途 QE が行う。

標本での試行(2026-09-27、orchestrator) ​

executor が未実施とした作業 3 を、orchestrator が bps-sample.md で行った(tools/grade/run-per-document.sh --target kata --kind sample、codex-expert-executor)。

項目変更前(v1、2026-09-27 05:46)変更後(v2、2026-09-27 12:41)
評価した観点824
score / verdict91 / pass95 / pass
findingminor 6minor 6(文面は変更前と同じ)
category49(追加の 5 category はすべて 100、finding 0)

既存観点の finding は件数・重さ・内容とも変わらず、prompt が長くなったことによる質の低下は見られなかった。ただし、finding の文面が一字一句同じだったため、前回の結果が評価の入力に使われている可能性がある。また、追加の観点は 1 件の finding も出していない。標本は 1 件だけなので、追加観点の検出力は、成果物(target: deliverable)を含む複数の文書で継続して確認する。

9. 関連ドキュメント ​