modulestf: terraform-aws-modules 규칙에 따라 Terraform 모듈을 검토하고 수정하는 agent skills

누구에게 적합한가

• 이 agent skills는 Claude Code 또는 Codex에서 Terraform 모듈을 작성·유지보수하면서, terraform-aws-modules 계열의 문서화된 규칙에 따라 모듈을 검토하거나 수정하고 싶은 엔지니어를 위한 것입니다. 자신의 머신에서, 자신의 GitHub 로그인으로 실행됩니다.
• 현재 함께 제공되는 규칙 프로파일은 terraform-aws-modules 하나뿐입니다. 프로젝트에 다른 계열의 규칙이 필요하다면, 공식 문서에는 그 적용 가능성에 대한 언급이 없습니다.
• 처음 사용하기 전에 반드시 agent에 terraform이라는 이름의 Terraform MCP server를 설정해야 합니다. 공식 문서에 따르면 이것이 없으면 provider 사실이 필요한 규칙은 not run으로 보고되며, PR 검토 결과는 기껏해야 "불확실" 수준에 그칩니다.
• 자신의 모듈이 이 계열에 속하는지 확실하지 않다면, 아래의 저위험 검토부터 시작하세요.

3분 만에 첫 시도 완료하기

사전 준비: Claude Code가 설치되어 있고, 공식 안내에 따라 HashiCorp Terraform MCP server를 terraform이라는 이름으로 agent에 연결해 두어야 합니다. 명시해야 할 부작용: 검토 워크플로는 PR을 임시 디렉터리에 클론하고, 각 example에서 terraform init -backend=false와 terraform validate를 실행합니다. 공식 문서는 이것이 state를 쓰지 않고 실제 backend를 사용하지 않는다고 설명하지만, 임시 디렉터리에서 Terraform 명령을 실행한다는 점은 변하지 않습니다.

1. 저장소를 클론하고 네 개의 skill 디렉터리 전부를 Claude Code의 skills 디렉터리에 넣습니다:

git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/

1. Claude Code에서 저위험 작업을 시작합니다: 기존의 재사용 가능한 Terraform 모듈 PR에 대해 검토를 실행합니다(진단형 작업). 성공 신호: agent가 verdict, findings, 그리고 게시용 PR 댓글 초안 한 건을 제시합니다.
2. 핵심 확인 지점: 사용자가 확인하기 전에는 아무것도 게시되지 않습니다. 확인하는 시점에 검토 이벤트를 함께 선택합니다 — 댓글 게시, 승인(approve), 또는 수정 요청이며, 공식 문서에 나열된 이 세 가지가 기준입니다. 검토 프로세스가 위 명령과 네트워크 외에 다른 파일을 읽거나 쓰거나 네트워크에 접근하는지는 공식 문서에 항목별로 설명되어 있지 않으므로, 알 수 없는 상태로 유지됩니다.
3. 일부 규칙이 not run으로 표시되면, 먼저 terraform MCP server가 올바르게 연결되어 있는지 확인하세요.

사용 사례

1. PR 검토: Claude Code에서 agent에게 terraform-aws-modules 규칙에 따라 열려 있는 PR을 검토하도록 합니다. 워크플로는 PR을 임시 디렉터리에 클론하고, 각 example에서 terraform init -backend=false와 terraform validate를 실행한 뒤 결론, 발견 항목, 게시 예정인 댓글을 제시합니다. 사용자가 댓글을 확인하고 검토 이벤트를 선택하기 전에는 아무것도 게시되지 않습니다.
2. 검토 후 수정: 검토가 결론을 내린 뒤, agent에게 review의 요구 사항에 따라 모듈을 수정하도록 합니다. 공식 문서는 이 skills가 "review, change and create reusable Terraform modules"를 수행하며 review가 요구하는 변경을 완료하도록 돕는다고 설명합니다. 변경은 모듈 파일을 수정하므로, 시작하기 전에 어떤 파일이 관련되는지 먼저 확인하세요. 공식 문서에는 이 변경의 단계별 작업 세부 사항이 나열되어 있지 않으며, 확인할 수 있는 것은 review의 발견 항목이 먼저 존재한다는 전제 아래 프로파일 규칙에 따라 변경을 실행한다는 점입니다.

사용 경계

• 명시된 부작용 제한(공식 원문): 어떤 skill도 terraform apply를 실행하거나 state를 쓰거나 실제 backend를 사용하지 않습니다. 어떤 skill도 merge하거나 pull request에 push하거나 threads를 해결하지 않습니다. 검토 프로세스는 확인 전에는 댓글이나 검토 이벤트를 게시하지 않습니다. 주의: 공식 문서에는 위 제한만 나열되어 있고 change 워크플로가 읽기 전용이라는 설명은 없습니다 — 이 skills의 위치 자체가 review 요구에 따른 모듈 수정과 생성을 포함하며, 해당 워크플로는 모듈 파일을 수정합니다. 변경 전에 범위를 직접 확인하세요.
• 실행 전제: Claude Code 또는 Codex에서 로컬로 실행되며, 자신의 GitHub 로그인을 사용합니다. 설치 방법은 네 개의 디렉터리를 복사하거나 심볼릭 링크하는 것이며, 두 플랫폼의 skills 디렉터리는 각각 ~/.claude/skills/와 ~/.agents/skills/입니다. 그 외의 설치 방법이나 플랫폼에 대한 근거는 없습니다.
• 검토를 위해서는 먼저 PR을 클론하고 임시 디렉터리에서 terraform init/validate를 실행해야 하므로, 로컬에 Terraform 환경이 필요합니다.
• 확인되지 않은 핵심 정보: 공식 문서에는 지원되는 Terraform 버전, provider 범위, 다른 agent와의 호환성, 그리고 "review, change and create" 외의 각 워크플로에 대한 구체적인 작업 목록이 설명되어 있지 않습니다. 검토 및 변경 프로세스의 파일과 네트워크에 대한 전체 접근 범위도 항목별로 나열되어 있지 않습니다. 사용 전에 자신의 환경에서 먼저 검증할 것을 권합니다.