Claude Code comme assistant de DBA : CLAUDE.md, règles, skills, agents, hooks et permissions
Comment les couches de configuration de Claude Code (CLAUDE.md, règles par chemin, skills, sous-agents, hooks, permissions, MCP) s'emboîtent dans un dépôt de scripts DBA.
J'utilise Claude Code tous les jours sur un dépôt rempli de modules PowerShell, de scripts T-SQL et de YAML de pipelines. Tel quel, c'est un généraliste brillant. Ce qui en fait un vrai assistant de DBA, c'est la configuration autour : quelques petits fichiers, chacun avec une seule mission. Cet article explique les couches et la façon dont elles s'emboîtent.
Les couches
flowchart TD
U["Demande du DBA"] --> S["Session Claude Code"]
S --> C["CLAUDE.md : toujours chargé"]
S --> R["Règles : chargées selon le chemin"]
S --> K["Skills : chargés à la demande"]
S --> A["Sous-agents : travail délégué"]
S --> H["Hooks : exécutés sur événement"]
S --> P["Settings : permissions"]
S --> M["Serveurs MCP : outils externes"]
P -->|allow ask deny| M
H -->|retour ou blocage| S
A --> R
K --> A
| Couche | Fichier | Chargée | Rôle |
|---|---|---|---|
| Mémoire du projet | CLAUDE.md |
à chaque session | ce qui est vrai partout : architecture, build et tests, sécurité, façon de travailler |
| Règles | .claude/rules/*.md |
à l'ouverture d'un fichier correspondant | une convention par type de fichier |
| Skills | .claude/skills/<nom>/SKILL.md |
à la demande | un workflow ou un corpus de connaissances |
| Sous-agents | .claude/agents/*.md |
quand on leur délègue | un spécialiste avec son contexte et ses outils |
| Hooks | settings.json |
sur un événement | contrôles et notifications déterministes |
| Settings | .claude/settings.json |
toujours | permissions, hooks, environnement |
| MCP | .mcp.json ou portée utilisateur |
au démarrage | accès à Grafana, Jira, documentation, Azure |
CLAUDE.md : ce qui vaut partout
Le CLAUDE.md du dépôt est lu au début de chaque session : chaque ligne coûte du contexte dans chaque conversation. Je n'y garde que ce qui doit rester vrai même quand aucun fichier précis n'est ouvert :
- l'architecture en quelques lignes (le dépôt parent contient modules et applications sous forme de sous-modules) ;
- les commandes de validation (lint, import du module, tests) ;
- un index des autres couches (« conventions T-SQL : règle X »), pour que Claude sache où chercher ;
- la section sécurité : quels scripts l'IA n'exécute jamais, ce qui exige une approbation explicite ;
- la façon de travailler : énoncer ses hypothèses, changements minimaux, vérifier avant de déclarer terminé.
Le fichier personnel du répertoire utilisateur porte le comportement générique ; quand le fichier du projet dit autre chose, c'est lui qui l'emporte.
Règles par chemin : une convention par type de fichier
Les faits propres à chaque application vivaient dans CLAUDE.md, chargés pour rien. Je les ai déplacés dans des règles. Une règle est un fichier Markdown avec une liste paths en en-tête ; Claude la charge quand il ouvre un fichier correspondant.
---
paths:
- "**/*.sql"
---
# Scripts T-SQL
- En-tête : objectif, paramètres, exemple d'appel.
- `SET NOCOUNT ON` et `TRY...CATCH` avec `THROW` dans les procédures.
- Les scripts qui créent ou suppriment des objets sont idempotents.
J'ai une règle par convention de langage (fonctions PowerShell, SQL, pipelines, documentation) et une par application, dont les décisions et points ouverts ne comptent que lorsqu'on touche à son dossier.
Skills, agents, hooks, permissions
- Les skills portent un workflow (« diagnostiquer un run en échec », « écrire une requête KQL ») ou de la connaissance (une carte du parc de serveurs). Seule la courte description est toujours visible ; le corps se charge quand la tâche correspond ou quand je tape la commande slash.
- Les sous-agents sont des spécialistes (SQL, PowerShell, Azure, relecture de documentation). Ils travaillent dans leur propre contexte et rendent un résumé, ce qui garde la conversation principale légère. Voir l'article dédié.
- Les hooks exécutent des commandes sur des événements : lint de chaque fichier PowerShell modifié, son quand Claude a fini. C'est du code, donc ça s'exécute toujours, contrairement à une consigne qu'un modèle peut oublier.
- Les permissions de
settings.jsonont trois listes :allow(sans confirmation),ask,deny. Les lectures sont autorisées, les scripts destructeurs refusés.
Le trajet d'une demande
Je demande de modifier un modèle SQL. Claude ouvre un fichier .sql, la règle SQL se charge. CLAUDE.md indique que le SQL va à l'agent SQL, qui reçoit un brief court et le nom de la règle. À chaque écriture de fichier, le hook de lint tourne. Tout ce qui touche à la production passe d'abord par la liste de permissions.
Retour d'expérience
- Chaque fait à un seul endroit. Les conventions dupliquées dérivent. Les agents et skills renvoient vers la règle, ils ne la recopient pas.
- Démarrer la session à la racine du dépôt. Règles, hooks et listes deny sont dans le dossier
.clauderacine ; une session lancée dans un sous-dossier ne reçoit pas les réglages racine et tourne sans les règles deny. - Partagé ou local. Les réglages versionnés contiennent les approbations en lecture seule ; les approbations personnelles vont dans le fichier local, jamais commité.
- Une consigne n'est pas une garantie. Si une chose ne doit jamais arriver, on utilise une règle deny ou un hook, pas une phrase dans
CLAUDE.md. - Élaguer. Un
CLAUDE.mdtrop long est lu moins attentivement. Un paragraphe qui ne sert qu'à un dossier devient une règle.