SKILL.md
AWS CDK によるインフラ管理原則
- IaC の統一: インフラ構築は AWS CDK (v2) を使用し、TypeScript で記述する。CloudFormation テンプレートの直接編集は禁止。
- L2/L3 コンストラクトの優先: セキュリティ（IAM 最小権限）と保守性の観点から、可能な限り L2 以上のコンストラクトを使用する。
- アセット管理の自動化: Lambda コードやフロントエンド資産の配備は、CDK の
fromAssetやBucketDeploymentを活用し、手動の S3 アップロードを排除する。 - 環境分離: 本番・開発などの環境差分は
cdk.jsonのcontextまたは環境変数で管理し、コード自体を分岐させない。 - ブートストラップ: 新しい AWS アカウント/リージョンへのデプロイ前には必ず
cdk bootstrapを実行すること。
Lambda 開発ルール
- 事前ビルド方式: Lambda のビルドに Docker を必要とする
NodejsFunctionではなく、esbuild等で事前ビルドした成果物をlambda.Code.fromAssetでデプロイする方式を推奨する（企業環境での Docker 制限対策）。
API Gateway & AppSync 連携ルール
- AppSync の優先: リアルタイム性や GraphQL の柔軟性が必要な場合は AppSync を優先的に検討する。
- CORS (OPTIONS) の認証除外: API Gateway を使用する場合、ブラウザのプリフライトリクエスト (
OPTIONS) は認証を通過できないため、OPTIONSメソッドのAuthorizationTypeは必ずNONEに設定すること。 - Authorization ヘッダー形式: Cognito User Pool Authorizer を使用する場合、デフォルトでは
Authorizationヘッダーに ID トークンを直接（Bearerプレフィックスなしで）含める必要がある。
その他運用ルール
- CLI 認証: AWS CLI を使用する場合はコマンド出力前に認証状況を確認すること。
- テンプレートのエンコーディング: CloudFormation テンプレート（CDK 実行時に生成されるものを含む）に日本語が含まれるとエラーの原因になるため、論理 ID や説明文には英語を使用すること。