modulestf : des agent skills pour examiner et modifier des modules Terraform selon les règles de terraform-aws-modules

À qui cela s'adresse

• Cet ensemble d'agent skills s'adresse aux ingénieurs qui écrivent et maintiennent des modules Terraform dans Claude Code ou Codex, et qui souhaitent examiner ou modifier des modules selon les règles écrites de la famille terraform-aws-modules. Il s'exécute sur votre propre machine, avec votre propre connexion GitHub.
• Il n'est actuellement livré qu'avec un seul jeu de règles : terraform-aws-modules. Si votre projet nécessite les règles d'une autre famille, les éléments officiels ne disent rien sur leur applicabilité.
• Avant la première utilisation, vous devez obligatoirement configurer pour l'agent un serveur MCP Terraform nommé terraform. Les sources officielles sont explicites : sans lui, les règles qui dépendent de faits du provider sont signalées comme not run, et une revue de PR aboutit tout au plus à une conclusion « incertaine ».
• Si vous ne savez pas si votre module appartient à cette famille, commencez par la revue à faible risque décrite ci-dessous.

Premier essai en 3 minutes

Prérequis : Claude Code est installé, et vous avez raccordé à l'agent le serveur MCP HashiCorp Terraform sous le nom terraform, conformément aux instructions officielles. Déclaration d'effets de bord nécessaire : le flux de revue clone la PR dans un répertoire temporaire et exécute terraform init -backend=false et terraform validate dans chaque example — les sources officielles précisent que cela n'écrit pas de state et n'utilise pas de backend réel, mais des commandes Terraform sont bien exécutées dans le répertoire temporaire.

1. Clonez le dépôt et placez les quatre répertoires de skills dans le répertoire des skills de Claude Code :

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

1. Lancez dans Claude Code une tâche à faible risque : faire exécuter une revue (opération de diagnostic) sur la PR d'un module Terraform réutilisable existant. Signal de succès : l'agent produit un verdict, des findings et un brouillon de commentaire de PR suggéré.
2. Point de confirmation clé : rien n'est publié sans votre confirmation ; au moment de confirmer, vous choisissez aussi l'événement de revue — publier un commentaire, approuver (approve) ou demander des modifications, selon les trois options officiellement listées. Les sources officielles ne détaillent pas, un à un, les autres fichiers lus ou écrits ni les accès réseau du flux de revue en dehors des commandes mentionnées : cela reste inconnu.
3. Si certaines règles apparaissent comme not run, vérifiez d'abord que le serveur MCP terraform est correctement raccordé.

Cas d'usage

1. Revue de PR : dans Claude Code, demandez à l'agent de passer en revue une PR ouverte selon les règles terraform-aws-modules. Le flux clone la PR dans un répertoire temporaire, exécute terraform init -backend=false et terraform validate dans chaque example, puis produit une conclusion, des findings et un commentaire prêt à publier ; tant que vous n'avez pas confirmé le commentaire et choisi l'événement de revue, rien n'est publié.
2. Modifications après revue : une fois la conclusion obtenue, demandez à l'agent de modifier le module selon les exigences de la revue. Les sources officielles indiquent que ces skills permettent de « review, change and create reusable Terraform modules » et aident à réaliser les changements exigés par la revue ; les modifications altèrent les fichiers du module, donc vérifiez avant de lancer quels fichiers sont concernés. Les éléments officiels ne décrivent pas les étapes détaillées de cette opération ; ce qu'on peut affirmer, c'est qu'elle applique les changements selon les règles du jeu de règles, à condition que les findings de la revue existent déjà.

Limites d'usage

• Restrictions d'effets de bord explicites (texte officiel) : aucun skill n'exécute terraform apply, n'écrit de state ni n'utilise de backend réel ; aucun skill ne fait de merge, ne pousse vers la pull request ni ne résout de threads. Le flux de revue ne publie ni commentaire ni événement de revue sans confirmation. Attention : les sources officielles ne listent que ces restrictions et ne précisent pas que le flux de modification est en lecture seule — la vocation de ces skills inclut la modification et la création de modules selon les exigences de la revue, et ce flux modifie les fichiers du module ; vérifiez vous-même le périmètre avant toute modification.
• Prérequis d'exécution : Claude Code ou Codex en local, avec votre propre connexion GitHub ; l'installation consiste à copier ou créer des liens symboliques vers les quatre répertoires, dont les répertoires de skills sont respectivement ~/.claude/skills/ et ~/.agents/skills/ sur les deux plateformes. Aucun élément officiel ne couvre d'autres méthodes d'installation ou plateformes.
• La revue nécessite de cloner d'abord la PR et d'exécuter terraform init/validate dans un répertoire temporaire ; un environnement Terraform doit donc être présent en local.
• Informations clés non confirmées : les éléments officiels ne précisent ni les versions de Terraform prises en charge, ni le périmètre des providers, ni la compatibilité avec d'autres agents, ni la liste détaillée des opérations de chaque flux en dehors de « review, change and create » ; l'étendue complète des accès aux fichiers et au réseau des flux de revue et de modification n'est pas non plus listée en détail. Il est recommandé de valider le tout dans votre environnement avant usage.