cdk-diff

name	cdk-diff
description	cdk diffを実行し、変更内容をMarkdownテーブルで整形して表示する。インフラ変更のレビューやデプロイ前確認に使用する。
context	fork
agent	general-purpose

以下の手順を実行する：

1. cdk/ ディレクトリで以下のコマンドを実行する：

   cd cdk && npx cdk diff 2>&1
   

2. 出力を解析して、下記フォーマットに従ってMarkdownを生成して出力する。

---

出力フォーマット

ステップ1: 変更サマリー（件数の一覧）

スタックごとの変更件数を表形式で示す。

## CDK Diff 結果

### 📊 変更サマリー

| スタック | ➕ 追加 | 🔄 更新 | ➖ 削除 |
|---------|:------:|:------:|:------:|
| MyStack | 2      | 1      | 0      |

変更がない場合は 変更はありません ✅ と表示して終了する。

ステップ2: 変更種別ごとのセクション

変更種別ごとに独立したセクションを設ける。各セクションは変更がある場合のみ出力する。

➕ 追加されるリソース

### ➕ 追加されるリソース

| スタック | リソースタイプ | 論理ID |
|---------|------------|------|
| MyStack | AWS::Lambda::Function | MyFunction |

🔄 更新されるリソース

更新の場合は変更前・変更後を独立した列で示す。プロパティが複数ある場合は行を分ける。

### 🔄 更新されるリソース

| スタック | 論理ID | プロパティ | 変更前 | 変更後 |
|---------|------|---------|:----:|:----:|
| MyStack | MyFunction | Runtime | nodejs16.x | nodejs20.x |
| MyStack | MyBucket | VersioningConfiguration | Suspended | Enabled |

➖ 削除されるリソース

### ➖ 削除されるリソース

| スタック | リソースタイプ | 論理ID |
|---------|------------|------|
| MyStack | AWS::IAM::Role | OldRole |

⚠️ IAMの変更（IAM変更がある場合のみ）

AWS::IAM::* に対する変更がある場合のみ、最後に注記セクションを追加する。

### ⚠️ IAMの変更

以下のIAMリソースに変更があります。意図した変更か確認してください。

| スタック | 変更種別 | リソースタイプ | 論理ID |
|---------|---------|------------|------|
| MyStack | 🔄 更新 | AWS::IAM::Role | MyRole |

---

解析ルール

cdk diff 出力の記号と意味：

記号	意味
[+]	追加
[-]	削除
[~]	更新

• プロパティ差分は └─ [~] PropertyName: "old" => "new" の形式で入れ子になっている。更新テーブルの「変更前」「変更後」列にそれぞれの値を記載する。
• ANSIエスケープコードや制御文字は無視して純粋なテキストとして解析する。
• リソースタイプが AWS::CDK::Metadata の変更は無視する。