Veille on Valérian Pyckaert

Claude Code avec Terraform

Thu, 02 Jul 2026 19:17:37 +0200

Même si je n’ai pas encore eu l’occasion d’écrire un article sur Claude Code, je l’utilise depuis quelques mois sur des projets privés et également depuis plusieurs semaines en entreprise.

Dans cet article je vous partage mes tips & tricks pour utiliser Claude Code pour un repo Terraform, nous utiliserons encore une fois le projet the-forge-infra comme exemple.

CLAUDE.md : le point de départ

La première chose à faire lorsque vous avez accès à Claude Code est de créer un fichier CLAUDE.md à la racine de votre projet qui servira de point d’entrée pour Claude Code et contiendra toutes les informations nécessaires pour comprendre le projet. C’est un peu le README.md de Claude.

Ce fichier se doit d’être le plus complet possible, il doit contenir toutes les informations nécessaires pour comprendre le projet, son architecture, ses dépendances, ses contraintes, etc. mais aussi d’être relativement concis. Si votre fichier contient 500 lignes, ces mêmes 500 lignes seront ingérées par Claude à chaque prompt et consommera ainsi beaucoup de tokens.

Voici un exemple minimal de structure pour écrire votre premier fichier (pour un repo Terraform) :

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project overview

### Repository structure

- `main.tf`: Main Terraform configuration file.
- `variables.tf`: File containing all Terraform variables.
- `outputs.tf`: File containing all Terraform outputs.
- `modules/`: Directory containing reusable Terraform modules.

### Code conventions

Resources must be named using the following convention: `<resource_type>_<resource_name>`. 
Commits must follow the conventional commit format: `<type>(<scope>): <description>`.

## Forbidden actions

* Never push directly to the main branch. Always create a feature branch and submit a pull request for review./
* Never use hardcoded values in Terraform files. Always use variables or data sources.
* Never store sensitive information in the repository. Use a secure secrets management solution instead./

Les skills

Cette feature permet de décrire à Claude comment interagir avec notre repo pour cette tâche, en fonction du contexte il sera capable de déterminer si il doit utiliser un skill ou non, et si oui lequel.

Voici quelques exemples que j’utilise sur le repo d’infra du projet TheForge.

Create-module

Il n’est pas rare d’avoir à créer des modules Terraform, c’est pourquoi j’ai créé ce skill pour automatiser la partie rébarbative : création des fichiers de bases, variables, outputs, README, etc. Claude me fournit aussi la structure de base du module sur laquelle je peux ensuite faire du fine tuning.

.claude/skills/create-module/SKILL.md

---
name: create-module
description: Create a new Terraform module. Use this skill when user asks to create a new Terraform module with a standard file structure.
---

Create a new Terraform module scaffold. The module name comes from `$ARGUMENTS` (kebab-case). If empty, ask the user for the name before proceeding.

Create the directory `modules/<name>/` with exactly these five files:

**`modules/<name>/main.tf`**

**`modules/<name>/variables.tf`**

**`modules/<name>/outputs.tf`**

**`modules/<name>/README.md`**

Check https://registry.terraform.io/ to fill those files with the appropriate content for a Terraform module.

You must use the latest version for the given provider if appropriate, pin the exact version (wildcard versions are not allowed). 
Enrich the `README.md` with a description of the module, usage instructions, and examples.

Do not add any other files or directories beyond these five.

After creating the files, list them with their relative paths, then remind the user to:
- Ensure every variable in `variables.tf` has both `description` and `type` set.

Résultat lorsqu’on demande à Claude de créer un module via un prompt :

crées un module google_storage_bucket

Create PR

Ce skill a pour but de créer la PR à partir d’une branche et faire un summary des changements pour faciliter la revue de mes collègues. J’ai également ajouté une checklist pour m’assurer que je n’ai rien oublié avant de créer la PR, accélérant une fois encore la boucle de feedback.

.claude/skills/create-pr/SKILL.md

---
name: create-pr
description: Create a new Github Pull Request. Use this skill when user asks to create a new Github Pull Request.
---

Pre-requisites before creating a PR :
* Ensure no sensitive information is present in the code changes (e.g., passwords, API keys, secrets).
* Run terraform fmt, terraform validate to ensure the code is properly formatted and valid.
* Ensure each commit message follows the conventional commit format (e.g., feat: add new feature, fix: fix bug, docs: update documentation).

1. Create a new Github Pull Request for the current branch. The title of the PR comes from `$ARGUMENTS`. If empty, ask the user for the title before proceeding.

2. The PR description should be generated based on the changes in the current branch. If `$ARGUMENTS` contains a description, use it instead.

3. The PR should be created against the default branch of the repository (usually `main` or `master`).

4. After creating the PR, output the URL of the newly created PR.

crées moi la Pull request “add claude config”

Conclusion

Comme nous l’avons vu, ces fichiers de configuration agentic sont de simples fichiers markdown et sont facilement partageables. A ce titre, il existe de nombreux repository pour partager des templates de fichiers CLAUDE.md, notamment pour Terraform. Je ne les utilisent pas encore pour le moment parce que je ne souhaite pas m’imposer de contraintes supplémentaires, je préfère mettre en place ma code base et ma stratégie et expliquer à l’agent comment je souhaite qu’il interagisse avec mon code.

Vous pouvez retrouver le repo d’exemple que j’ai utilisé pour cet article sur GitHub.

Marp

Sun, 14 Jun 2026 15:00:08 +0200

Je vous ai précédemment présenté Scratch qui permet d’éditer ses notes en Markdown et de les versionner sur Git.

Aujourd’hui, je vous propose de découvrir Marp.

Qu’est-ce que c’est ?

Marp est un outil open-source qui permet de créer des présentations à partir de fichiers Markdown.

Pourquoi choisir Marp ?

Son principal atout est de s’appuyer sur le langage Markdown ce qui le rend accessible à la grange majorité des développeurs. Pour ma part c’est mon langage de prédilection pour rédiger mes notes et documentations. Ce site est d’ailleurs entièrement rédigé en Markdown.

Intégration dans Visual Studio Code : Marp propose une extension pour Visual Studio Code qui permet de créer et d’éditer des présentations directement depuis l’éditeur.

Exportation en PDF : Marp CLI permet d’exporter vos présentations au format PDF, ce qui est pratique pour les partager ou les imprimer.

Thèmes personnalisables : Marp offre la possibilité de personnaliser l’apparence de vos présentations grâce à des thèmes prédéfinis ou en créant vos propres styles CSS. Mon thème favori étant “pine-rose-moon” :

Live preview

Marpit : Marp est un écosystème (core, cli, marp for vscode) basé sur Marpit, un framework qui permet de créer des présentations en HTML et CSS à partir de Markdown. Cela signifie que vous pouvez utiliser toutes les fonctionnalités de Marpit pour personnaliser vos présentations.

Exemple

Si comme moi vous avez installé l’extension pour VsCode, vous pouvez créer un fichier .md et commencer à rédiger votre présentation.

--- 
marp: true
---

Sources

Marp site officiel
Marpit site officiel
Pine Rose Moon thème

Scratch - Vos notes en markdown

Sat, 13 Jun 2026 19:00:00 +0200

Qu’est-ce que c’est ?

Scratch est un outil de prise de notes que j’ai découvert récemment via un article sur Korben. Il permet l’édition de notes en mode WYSIWYG tout en étant markdown based.

Parmi les principales features on trouve :

Support des charts Mermaid
Integration git
Support IA : Claude Code, Codex, etc.

Qu’est ce que j’en pense ?

Je l’utilise depuis quelques jours et c’est vraiment agréable à utiliser. Son interface est très similaire à l’application “Notes” d’Apple, ce qui le rend très intuitif. Les fonctionnalités sont assez basiques mais suffisent amplement pour mes besoins de prise de notes, j’ai pu essayer Notion et Obsidian mais je les trouvent trop complexes pour ce que je veux faire, je passe plus de temps à configurer l’outil et organiser mes notes.

Je vais continuer de l’utiliser pour voir comment il évolue, la seule chose que j’ai à lui reprocher à ce jour c’est que c’est un énième outil à installer. J’aurai aimé une intégration native dans les IDE (VSCode, JetBrains, etc.) pour pouvoir prendre des notes directement dans mon environnement de travail.

Sources

Hugo

Wed, 29 Apr 2026 11:30:03 +0000

Qu’est-ce que c’est ?

Hugo est un générateur de site statique open-source écrit en Go. Il permet de créer des sites web rapides et performants sans avoir besoin d’une base de données ou d’un serveur dynamique. Hugo est particulièrement apprécié pour sa simplicité d’utilisation, sa flexibilité et sa rapidité de génération.

Pourquoi choisir Hugo ?

J’applique un principe fondamental dès qu’il s’agit de choisir un outil : KISS (Keep It Simple, Stupid). Hugo s’appuie sur du markdown pour la rédaction de contenu, c’est un format que j’apprécie déjà pour la documentation technique. Les commandes pour build, déployer ou ajouter du contenu pré-formaté sont d’une simplicité enfantine, ce qui me permet de me concentrer sur la création de contenu plutôt que sur la configuration de l’outil.

Enfin, Hugo est largement supporté par la communauté et peut être déployé partout facilement : Github Pages, Netlify, AWS/GCP/Azure, etc.

Pour ma part j’ai choisi de m’appuyer sur Cloudflare Pages pour héberger mon site.

Convaincus ? Alors passons à la pratique !

Créer son premier site

Pré-requis :

Go & Git installés sur votre machine

Je ne m’attarderai pas sur l’installation de Go et Git, il existe de nombreux tutoriels en ligne pour cela. Assurez-vous simplement d’avoir les dernières versions installées.

Installer Hugo

go install github.com/gohugoio/hugo@latest
hugo version

Vous devriez obtenir quelque chose de la sorte :

hugo v0.160.1-d6bc8165e62b29d7d70ede01ed01d0f88de327e6+extended windows/amd64 BuildDate=2026-04-08T14:02:42Z VendorInfo=gohugoio

Créer un nouveau projet

hugo new site mon-site
cd mon-site

Architecture

Voici l’architecture de base d’un projet Hugo :

mon-site/
├── archetypes/ # modèles de contenu
├── content/ # fichiers de contenu (articles, pages, etc.)
├── data/ # données structurées (YAML, JSON, etc.)
├── layouts/ # templates pour le rendu
├── static/ # fichiers statiques (images, CSS, JS)
├── themes/ # thèmes pour le design
├── config.toml/.yaml # configuration du site
└── ... # autres fichiers et dossiers

Lancer le serveur de développement

hugo server

Félicitations, votre site est désormais accessible via http://localhost:1313

Configuration Git

Initions un nouveau dépôt Git et poussons notre projet sur GitHub (ou toute autre plateforme de votre choix) :

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

Personnalisation

Ajouter un thème

Il existe une multitude de thèmes disponibles sur Hugo Themes. Pour en ajouter un à votre projet, suivez les instructions spécifiques à chaque thème.

En ce qui me concerne j’ai choisi le thème PaperMod, que j’ai personnalisé pour répondre à mes besoins.

Voyons ensemble comment l’installer et le configurer

cd mon-site
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically)

NB: Bien que je ne sois pas un grand fan de Git Submodules, c’est la méthode recommandée par les auteurs du thème pour l’installation et la mise à jour.

Dernière étape, il faut indiquer à Hugo d’utiliser ce thème en modifiant le fichier config.toml :

theme: PaperMod

C’est terminé, un petit coup de hugo server et vous devriez voir votre nouveau thème en action !

Archetypes

Il est également possible de créer des templates de contenu pour faciliter la création de nouvelles pages ou articles. Par exemple, pour créer un template d’article de blog, créez un fichier blog.md dans le dossier archetypes avec le contenu suivant :

---
date: '{{ .Date }}'
draft: true
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
---

Maintenant, lorsque vous souhaitez créer un nouvel article de blog, il vous suffit d’exécuter la commande suivante :

hugo new posts/mon-nouvel-article.md -k blog

On déploie ?

Ce n’est pas tout de faire tourner son projet en local, encore faut-il le rendre accessible au monde entier !

J’ai déjà parlé brièvement de l’hébergement sur différentes plateformes plus tôt dans l’article. Pour ma part j’ai choisi de m’appuyer sur Cloudflare Pages, qui offre une intégration transparente avec GitHub et une configuration très simple.

J’ai quelques projets d’articles autour de Cloudflare en tête donc autant commencer à m’y familiariser dès maintenant !

Hébergement

Là encore c’est très simple et je trouve la documentation officielle d’Hugo très bien faite à ce sujet : Hugo Deployment.

Si vous suivez scrupuleusement les étapes votre site devrait être en ligne en quelques minutes seulement !