chore: 静的チェックCI（fmt/validate/tflint/trivy/terraform-docs）を導入

[yebis0942]

概要

クラウド認証情報なしで動く静的チェックCIを導入し、CIをグリーンにするために必要な既存コードの修正を行いました。品質担保の仕組み整備の第1弾です（E2Eテストの自動実行・リリース自動化は後続で対応予定）。

CIの内容（.github/workflows/ci.yml）

PRごと・mainへのpushごとに以下を実行します。AWS/GCPの認証情報は一切使いません。

ジョブ	内容
fmt	terraform fmt -check -recursive
validate	4ルート（modules/aws/ecs-fargate, modules/gcp/cloud-run, examples/aws-ecs-fargate, examples/gcp-cloud-run）で init -backend=false → validate
tflint	4ルートで実行。terraform推奨プリセット + AWS/Googleルールセット（.tflint.hcl）
trivy	セキュリティ設定スキャン（旧tfsecの後継）
docs	terraform-docsでREADMEを再生成し、差分があれば失敗（ドリフト検査）

既存コードの修正（チェックで実際に検出されたもの）

• 旧 #tfsec:ignore:AWSxxx が全く効いていなかったため、現行trivyのID形式（#trivy:ignore:AVD-AWS-xxxx）へ更新。これまでignore対象でなかった検出にも理由コメント付きでignoreを追加。いずれも意図的な設計（ALB公開等）またはサンプル用の簡易設定で、実設定の変更はありません
• Terratestの name_prefix がPR #14のvalidation（8文字以内）に違反していたため、test-<3文字>（8文字）に短縮。go build で確認済み
• tflint検出の未使用宣言を削除（local.certificate_arn / local.has_certificate / data.google_dns_managed_zone）
• terraform-docs設定がAWSモジュールにしかなかったため、GCPモジュール・GCP exampleにも展開しREADMEを再生成（生成部の見出しがAWSと統一され、required_version の古い表記も実態に修正）
• name_prefix のdescriptionにvalidation制約（8文字以内等）を明記

ローカルでの動作確認

CIと同一のコマンド・同一バージョン（terraform 1.13.3 / tflint 0.64.0 / terraform-docs 0.24.0 / trivy）で以下をすべてexit 0で確認済みです。

• terraform fmt -check -recursive
• 4ルートで terraform init -backend=false → terraform validate
• 4ルートで tflint
• trivy config --exit-code 1 .（検出0件）
• terraform-docs再生成 → 差分なし（冪等性確認済み）
• actionlint（ワークフロー自体の検証）
• cd test && go build ./...

気づいた点（別PRで対応予定）

examples/aws-ecs-fargate の var.certificate_arn と enable_acm_import は現在どこにも配線されておらず、ALBの証明書は常に route53_domain.tf の aws_acm_certificate.bridge が使われます（READMEの記載と実装が乖離）。機能修正になるため本PRではtflint-ignoreと理由コメントのみ付与し、配線の修正は別PRで対応します。

マージ後に行うこと

• GitHubのbranch protection（mainへの直接push禁止・CIグリーン必須・レビュー必須）を有効します。
  • CIジョブ名は terraform fmt / terraform validate (*) / tflint (*) / trivy config scan / terraform-docs drift check です。

🤖 Generated with Claude Code