cdk-review

name	cdk-review
description	AWS CDK インフラコードを詳細にレビュー。/cdk-review コマンドが呼ばれたとき、またはユーザーが CDK コードのレビューを依頼したときに使用する。cdk/ ディレクトリ内の TypeScript ファイルを対象に、型安全性・CDK ベストプラクティス・プロジェクトルール準拠を自動チェックする。
context	fork
agent	cdk-reviewer-agent

AWS CDK インフラコードをレビューしてください。以下の手順に従って実行してください。

Phase 1: 対象ファイルの検出

• Glob で cdk/**/*.ts を検出
• 除外: **/*.test.ts、*.config.*、cdk.json、node_modules、cdk.out/
• 種別を自動判定:
  • App: cdk/bin/*.ts
  • Stack: cdk/lib/*-stack.ts
  • Construct: cdk/lib/constructs/*.ts または cdk/lib/*-construct.ts
  • Parameter: cdk/parameter.ts または cdk/lib/parameters/*.ts
• 検出したすべてのファイルをレビュー対象とする（選択ステップはスキップ）

Phase 2: レビュー実行

各ファイルに対してエージェント定義の24項目でレビューを実施する。

• Read でファイル内容を取得
• Bash で git log から変更履歴を確認
• Grep で型安全性（any 使用）・Import 形式・L2 Construct 使用状況を確認
• コメントは docs/policy/code-comment-policy.md に照らして評価（実装コメントは WHY、doc comment は契約、コードが語る WHAT/HOW は不要）
• 各観点を3点満点でスコアリング

Phase 3: 結果出力

references/report-format.md のフォーマットに従ってレポートを出力する。 各ファイルの個別レポートを生成後、全体サマリーを出力すること。

レビューの姿勢

• 建設的: 批判ではなく、具体的なコード例を交えた改善提案を提示
• バランス: 良い点を最低3つ指摘
• 実用的: 現実的な改善案と根拠を明示