AI TOOLS RADAR
All skills / DONNGI
donngi/agent-skills

aws-terraform-personal-style

DonngiのAWS Terraform個人スタイルで新規コードを書く・既存コードをレビューする。envs/modules構成、meta objectによるmodule合成、IAM 3リソース1ファイル、Sid必須のinline policy、S3 native state locking、日本語コメントなどの規約に従う。Terraformで .tf ファイルを新規作成・編集する時に使用する。

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/donngi/agent-skills --skill aws-terraform-personal-style

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

AWS Terraform Personal Style (Donngi)

DonngiがAWS Terraformを書くときのスタイルを再現する。プロジェクト固有の命名や構成に依存せず、スタイル（構造と書き方） を統一する。

いつ使うか

  • 新規にAWS Terraformコードを書く時（特に envs/ + modules/ 構成）
  • 既存のTerraformコードを個人スタイルに寄せてレビュー・リファクタリングする時

最優先の原則（まずこれを守る）

  1. ファイルは1リソース種別ごとに分割する
  • <service>_<resource>.tf 形式（例: cloudfront_distribution.tf, dynamodb_article.tf）
  • 詳細: references/file-organization.md
  1. IAMの `aws_iam_role` + `aws_iam_policy` + `aws_iam_role_policy_attachment` は同一ファイルに3点セットで書く
  • ファイル名は iam_<component>.tf
  • 詳細: references/iam.md
  1. 同一リソースから複数のmetadataを渡すときだけ `object` に集約する
  • 同一リソースの name と arn のように密結合したmetaは xxx_meta = { name, arn, ... } にバンドル
  • 単一値や無関係な値まで無理に集約しない（primitive型でOK）
  • 詳細: references/module-composition.md
  1. IAM policyは `Sid` 必須、Actionはワイルドカード禁止
  • Sidは Allow<What><Action> のような説明的な名前
  • 1 Sid = 1 リソース/用途グループで分割
  • 詳細: references/iam.md
  1. コメントは日本語で、「なぜ」を書く
  • AWS公式docへのリンクも適宜貼る
  • 詳細: references/comments-and-style.md
  1. 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.mdenvs/から複数modulesを呼ぶとき、module間でデータを渡すとき
references/naming.mdresource local name / AWS name / role名 を決めるとき
references/variables-and-locals.md新規変数を追加するとき、localsを使うか迷ったとき、validation / sensitive / nullable / ephemeral を使うか判断するとき
references/iam.mdIAM role/policy を作るとき（必読）
references/providers-and-backend.md新規env作成時、aliased provider や LocalStack 対応時
references/comments-and-style.mdコメントを書くとき、定数やmanaged policyを参照するとき

ワークフロー

  1. 該当する references/*.md を読む（特に IAM は必ず読む）
  2. 既存の envs/<env>/main.tf と modules/*/ の構造に合わせて配線する
  3. 新規モジュールは以下を分離配置する：
  • variables.tf（入力変数 — 変数が無くても空ファイルを必ず置く）
  • outputs.tf（出力 — 出力が無くても空ファイルを必ず置く）
  • versions.tf（module側にも必須。required_version + required_providers、configuration_aliases も必要ならここに書く）
  • 本体 .tf ファイル群（リソース種別ごとに分割）
  1. IAMがあるコンポーネントは iam_<component>.tf で3点セットを1ファイルにまとめる
  2. モジュールの出力は関連attributeを object にバンドルしてexportする