사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/donngi/agent-skills --skill aws-terraform-personal-style시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
AWS Terraform Personal Style (Donngi)
DonngiがAWS Terraformを書くときのスタイルを再現する。プロジェクト固有の命名や構成に依存せず、スタイル（構造と書き方） を統一する。
いつ使うか
- 新規にAWS Terraformコードを書く時（特に
envs/+modules/構成） - 既存のTerraformコードを個人スタイルに寄せてレビュー・リファクタリングする時
最優先の原則（まずこれを守る）
- ファイルは1リソース種別ごとに分割する
<service>_<resource>.tf形式（例:cloudfront_distribution.tf,dynamodb_article.tf）- 詳細: references/file-organization.md
- IAMの `aws_iam_role` + `aws_iam_policy` + `aws_iam_role_policy_attachment` は同一ファイルに3点セットで書く
- ファイル名は
iam_<component>.tf - 詳細: references/iam.md
- 同一リソースから複数のmetadataを渡すときだけ `object` に集約する
- 同一リソースの
nameとarnのように密結合したmetaはxxx_meta = { name, arn, ... }にバンドル - 単一値や無関係な値まで無理に集約しない（primitive型でOK）
- 詳細: references/module-composition.md
- IAM policyは `Sid` 必須、Actionはワイルドカード禁止
- Sidは
Allow<What><Action>のような説明的な名前 - 1 Sid = 1 リソース/用途グループで分割
- 詳細: references/iam.md
- コメントは日本語で、「なぜ」を書く
- AWS公式docへのリンクも適宜貼る
- 詳細: references/comments-and-style.md
- env配下は `main.tf` / `providers.tf` / `versions.tf` / `backend.tf` の4点構成
- backend は S3 + S3 native state locking を使用
- 詳細: references/providers-and-backend.md
詳細リファレンス（タスクに応じて読む）
| リファレンス | 読むべき場面 |
|---|---|
| references/file-organization.md | 新規モジュール作成時、ファイル分割の判断時 |
| references/module-composition.md | envs/から複数modulesを呼ぶとき、module間でデータを渡すとき |
| references/naming.md | resource local name / AWS name / role名 を決めるとき |
| references/variables-and-locals.md | 新規変数を追加するとき、localsを使うか迷ったとき、validation / sensitive / nullable / ephemeral を使うか判断するとき |
| references/iam.md | IAM role/policy を作るとき（必読） |
| references/providers-and-backend.md | 新規env作成時、aliased provider や LocalStack 対応時 |
| references/comments-and-style.md | コメントを書くとき、定数やmanaged policyを参照するとき |
ワークフロー
- 該当する references/*.md を読む（特に IAM は必ず読む）
- 既存の
envs/<env>/main.tfとmodules/*/の構造に合わせて配線する - 新規モジュールは以下を分離配置する：
variables.tf（入力変数 — 変数が無くても空ファイルを必ず置く）outputs.tf（出力 — 出力が無くても空ファイルを必ず置く）versions.tf（module側にも必須。required_version+required_providers、configuration_aliasesも必要ならここに書く）- 本体
.tfファイル群（リソース種別ごとに分割）
- IAMがあるコンポーネントは
iam_<component>.tfで3点セットを1ファイルにまとめる - モジュールの出力は関連attributeを
objectにバンドルしてexportする