LLI Wiki — My Digital Knowledge Base

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 :

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

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

Mastodon LLIMastodon SocialFosstodon