Design Review

Design Document Review

設計書を 5.0 点満点で評価し、矛盾検出・改善を行う。

Evaluation (各1.0点)

スコア: 4.5+=本番OK / 3.5+=良好 / 2.5+=要改善 / <2.5=大幅見直し

Required Sections

必須: 概要 / 背景・動機 / ゴール・非ゴール / 設計詳細 / 代替案 推奨: API定義 / データモデル / エラー処理 / テスト戦略 / マイグレーション 任意: パフォーマンス / セキュリティ / 可観測性 / ロールバック / タイムライン / 依存関係

Review Process

Phase 1: 構造チェック

必須セクション存在、用語統一性、図表参照整合性

Phase 2: 内容チェック

記述の深さ、具体例の有無、判断根拠、前提条件の明示

Phase 3: 矛盾検出

Phase 4: ベストプラクティス照合

• アーキテクチャ: 単一責任、疎結合、Blast Radius局所化
• 運用: デプロイ戦略、SLO/SLI、ランブック
• データ: 冪等性、TTL、バックアップ、GDPR
• セキュリティ: 認証認可、入力バリデーション、TLS、OWASP Top 10
• テスト: Unit/Integration/E2E/負荷/カオスエンジニアリング

Output Format

# Design Review Report

## Score: X.X / 5.0
| 軸 | スコア | 判定 |
|---|---|---|
| 完全性 | X.X | ✅/⚠️/❌ |
...

## Critical Issues
- [ ] {issue} — {section} — {fix}

## Warnings
- [ ] {issue} — {section} — {improvement}

## Contradictions
- {sectionA} vs {sectionB} — {detail}

## Actions (priority order)
1. **[P0]** {action} — {reason}

Auto-Improvement

スコア 4.5 未満 → Critical Issues の修正案提示 → ユーザー確認 → 適用 → 再評価（最大3回）

注意: 設計意図は変更しない。追記は [ADDED BY REVIEW] タグ付き。

Reference Formats

• Google Design Doc: Context, Goals/Non-goals, Design, Alternatives, Cross-cutting
• ADR: Status, Context, Decision, Consequences
• RFC: Problem, Solution, Design, Drawbacks, Alternatives, Unresolved

Anti-Patterns