decision-eval

意思決定評価 — アーキテクチャ上の代替案の自動スコアリング

アーキテクトが2つ以上の案を提案した後、gate:archを作成する前に実行します。

実行するタイミング

以下の条件をすべて満たす場合に、このスキルを実行します。

1. ADR（docs/adr/ADR-*.md）またはARCHドキュメント（docs/architecture/ARCH-*.md）に、名前付きの代替案が2つ以上含まれるセクションがある（## Alternatives Considered、## Options、または**Option A:**のように太字で始まる選択肢を探します）
2. アーキテクトがまだgate:archを作成していない
3. ユーザーが「skip scoring」、「no scoring」、または「skip decision-eval」と言っていない
4. PROJECT.mdのproject_sizeがnanoではない

条件を満たさない場合は、何も言わずにスキップします（そのことに触れる必要もありません）。

実行方法

最新のADRまたはARCHドキュメントを読み、2つ以上の案があることを確認してから、そのファイルパスをコンテキストとしてdecision-scorerエージェントを起動します。

# Identify target document
TARGET=$(ls -t docs/adr/ADR-*.md 2>/dev/null | head -1)
[ -z "$TARGET" ] && TARGET=$(ls -t docs/architecture/ARCH-*.md 2>/dev/null | head -1)

# Confirm 2+ variants
VARIANT_COUNT=$(grep -cE "^\*\*[A-Za-z]|^### [A-Za-z]|^- \*\*[A-Za-z]" "$TARGET" 2>/dev/null || echo 0)

VARIANT_COUNT >= 2の場合、エージェントを起動します。

Agent: decision-scorer
Context: <TARGET file path>
Task: Score the architectural variants in <TARGET> against .great_cto/PROJECT.md criteria.
      Save output to docs/decisions/.

出力先

decision-scorerエージェントは結果を次の場所に保存します。

docs/decisions/DECISION-<slug>-<YYYYMMDD>.md

エージェントの処理が完了したら、出力ファイルを読み、推奨案をアーキテクトに伝えます。

Decision scoring complete:
  Recommended: <variant name> (<score>/5.00)
  Runner-up:   <variant name> (<score>/5.00)
  Full report: docs/decisions/DECISION-<slug>-<YYYYMMDD>.md

Architect: review the scoring rationale before accepting or overriding the recommendation.

スキップ条件

以下の場合は何も出力せず、次のステップに進みます。

• PROJECT.mdでproject_size: nanoとなっている
• ADR／ARCHドキュメントで見つかった案が2つ未満
• ユーザーメッセージに「skip scoring」、「skip decision-eval」、または「no scoring」が含まれる
• 対象ドキュメントがバグ修正またはドキュメントのみのADRである（タイトルに「fix:」、「docs:」、「chore:」が含まれるか確認します）

アーキテクトのワークフローとの統合

このスキルは、agents/architect.mdのステップ4（ADRの作成）とステップ5（gate:archの作成）の間にあります。アーキテクトは名前を指定して呼び出します。

Invoke skill: decision-eval

スコアリングの完了後、アーキテクトは次のいずれかを実行できます。

• 推奨案を採用する → 推奨された案でgate:archに進む
• 推奨案を覆す → gate:archを作成する前に、ADRに新しい## Scoring Overrideセクションを追加して根拠を記録する