Skills

modulestf: agent skills para revisar e modificar módulos Terraform segundo as regras do terraform-aws-modules

Engenheiros que querem revisar e modificar módulos Terraform reutilizáveis segundo as regras do terraform-aws-modules em um coding agent devem começar usando estas skills para uma revisão de PR com ponto de confirmação; antes do uso, é obrigatório configurar no agent um MCP server do HashiCorp Terraform chamado terraform, caso contrário as regras que dependem de fatos de provider não rodam e a conclusão da revisão fica no máximo incerta.

Official source · modulestf

Install

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

Para quem é

  • Este conjunto de agent skills é indicado para engenheiros que escrevem e mantêm módulos Terraform no Claude Code ou no Codex e querem revisar ou modificar módulos segundo as regras documentadas da série terraform-aws-modules. Ele roda na sua própria máquina, com o seu próprio login do GitHub.
  • Atualmente, acompanha apenas um arquivo de regras: terraform-aws-modules. Se o seu projeto precisar de regras de outras famílias, as evidências oficiais não indicam sua aplicabilidade.
  • Antes do primeiro uso, é obrigatório configurar para o agent um MCP server do Terraform chamado terraform. Segundo a documentação oficial: sem ele, as regras que dependem de fatos de provider são reportadas como not run, e a revisão de PR terá no máximo uma conclusão "incerta".
  • Se você não tem certeza se o seu módulo pertence a essa família, comece pela revisão de baixo risco descrita abaixo.

Primeira tentativa em 3 minutos

Pré-requisitos: Claude Code instalado e o MCP server do HashiCorp Terraform conectado ao agent com o nome terraform, conforme as instruções oficiais. É preciso declarar os efeitos colaterais: o fluxo de revisão clona o PR para um diretório temporário e executa terraform init -backend=false e terraform validate em cada example — segundo a documentação oficial, isso não grava state nem usa backend real, mas executa comandos Terraform no diretório temporário.

  1. Clone o repositório e coloque os quatro diretórios de skills no diretório de skills do Claude Code:
git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/
  1. Inicie uma tarefa de baixo risco no Claude Code: executar uma revisão (operação de diagnóstico) sobre o PR de um módulo Terraform reutilizável já existente. Sinal de sucesso: o agent apresenta um verdict, os findings e um rascunho de comentário de PR sugerido.
  2. Ponto de confirmação essencial: nada é publicado antes da sua confirmação; ao confirmar, você também escolhe o evento de revisão — publicar o comentário, aprovar (approve) ou solicitar alterações, conforme as três opções listadas oficialmente. Se o fluxo de revisão lê ou grava outros arquivos ou acessa a rede além dos comandos mencionados, a documentação oficial não detalha; permanece desconhecido.
  3. Se algumas regras aparecerem como not run, verifique primeiro se o MCP server terraform está corretamente conectado.

Casos de uso

  1. Revisão de PR: no Claude Code, peça ao agent para revisar um PR aberto segundo as regras do terraform-aws-modules. O fluxo clona o PR para um diretório temporário, executa terraform init -backend=false e terraform validate em cada example e, em seguida, apresenta a conclusão, os findings e o comentário a ser publicado; nada é publicado antes de você confirmar o comentário e escolher o evento de revisão.
  2. Alterações após a revisão: depois que a revisão apresentar a conclusão, peça ao agent para modificar o módulo conforme as exigências da review. Segundo a documentação oficial, essas skills servem para "review, change and create reusable Terraform modules" e ajudam a concluir as alterações exigidas pela review; as alterações modificam os arquivos do módulo, portanto, antes de iniciá-las, confirme quais arquivos estão envolvidos. As evidências oficiais não listam os detalhes passo a passo dessa alteração; o que se pode confirmar é que ela é executada segundo as regras do arquivo, desde que os findings da review já existam.

Limites de uso

  • Limites de efeitos colaterais declarados (texto oficial): nenhuma skill executa terraform apply, grava state ou usa backend real; nenhuma skill faz merge, push no pull request ou resolve threads. O fluxo de revisão não publica comentários nem eventos de revisão antes da confirmação. Atenção: a documentação oficial lista apenas as restrições acima e não afirma que o fluxo de change é somente leitura — o posicionamento dessas skills inclui alterar e criar módulos conforme a review, e esse fluxo modifica os arquivos do módulo; antes de alterar, confirme por conta própria o escopo.
  • Pré-requisitos de execução: Claude Code ou Codex em execução local, com o seu próprio login do GitHub; a instalação é feita copiando ou criando links simbólicos para os quatro diretórios, cujos diretórios de skills são ~/.claude/skills/ e ~/.agents/skills/ nas duas plataformas. Não há evidências oficiais sobre outros métodos de instalação ou outras plataformas.
  • A revisão exige clonar o PR antes e executar terraform init/validate em um diretório temporário; é necessário ter um ambiente Terraform local.
  • Informações-chave não confirmadas: as evidências oficiais não indicam as versões do Terraform suportadas, o escopo de providers, a compatibilidade com outros agents, nem a lista detalhada de operações de cada fluxo além de "review, change and create"; o alcance completo de acesso a arquivos e à rede dos fluxos de revisão e de alteração também não está detalhado item a item. Recomenda-se validar no seu ambiente antes de usar.