« Une page. Chaque règle dit comment on vérifie qu'elle est respectée. »
CHARTE-IA.md à la racine du dépôt
35 min de travail, 10 min de restitution
Vous ne partez pas de zéro. Rassemblez vos pièces :
Au moins six règles, rangées selon les cinq couches vues au module 6.1, plus une section « En cas d'incident ».
Puis vous choisissez une de vos règles et vous installez son mécanisme pour de vrai : un hook, une règle deny, un modèle de PR. Vous montrez qu'il bloque.
À la fin, votre dépôt contient CHARTE-IA.md et le mécanisme d'au moins une règle, testé et commité. Vous savez aussi quelle règle vous mettrez en place dans votre équipe d'ici 30 jours.
# Charte d'usage de l'IA · équipe [nom] Nous utilisons l'IA pour aller plus vite, sans exposer nos données, notre code ni nos utilisateurs. Chaque règle ci-dessous dit comment on vérifie qu'elle est respectée. ## Données | Règle | Vérifiée par | Responsable | |---|---|---| | Aucun agent ne lit .env, les dumps ni le dossier data/ | Règle deny ou hook, relue en revue | Lead dev | | Jamais de données clients réelles dans un prompt | Données fictives fournies dans tests/fixtures | Chaque dev | ## Outils | Règle | Vérifiée par | Responsable | |---|---|---| | [outil] avec l'offre [entreprise], entraînement désactivé | Politique de l'organisation | [qui] | ## Agents | Règle | Vérifiée par | Responsable | |---|---|---| | AGENTS.md contient une section sécurité | Fichier relu en revue (CODEOWNERS) | [qui] | ## Code | Règle | Vérifiée par | Responsable | |---|---|---| | Toute PR assistée par IA est relue par un humain | Branche protégée, case « assisté par IA » dans la PR | [qui] | ## Traces | Règle | Vérifiée par | Responsable | |---|---|---| | Les commits assistés portent un trailer Co-Authored-By | Modèle de commit, revue | [qui] | ## En cas d'incident - Une donnée ou un secret est parti vers un outil : on arrête, on révoque, on prévient le jour même. - Qui prévenir : [RSSI], [DPO]. Par quel canal : [canal]. ## Recommandations Ce qui compte mais ne se vérifie pas : [valeurs, bonnes habitudes]. ## Révision Prochaine révision : [date]. Fréquence : tous les trois mois. Responsable : [qui].
Piochez, adaptez, ou écrivez les vôtres.
| Couche | Règle | Vérifiée par |
|---|---|---|
| Données | Les requêtes sont paramétrées, avec un test d'injection | Tests en CI, revue |
| Données | Les logs sont masqués avant d'être donnés à un agent | Script de masquage dans le dépôt |
| Outils | Filtre de code public activé | Réglage de l'organisation GitHub |
| Outils | Un petit modèle pour les tâches simples, le grand pour l'agentique | Politique de modèles autorisés |
| Agents | Pas d'approbation automatique hors tests et lint | Réglages gérés, revue des fichiers de réglages |
| Agents | L'agent n'a qu'un accès en lecture à une base de test | Rôle de base de données, mode lecture seule |
| Agents | Serveurs MCP de source connue, en version épinglée | Revue de .vscode/mcp.json, liste autorisée |
| Code | gitleaks bloque le commit d'un secret | Hook de pré-commit, CI |
| Code | Les actions de CI sont épinglées par empreinte de commit | Revue, Dependabot |
| Traces | Chaque choix de modèle ou de fournisseur a son ADR | Dossier docs/adr/, revue |
Invérifiables : « Utiliser l'IA de façon responsable. » « Être vigilant sur les données. » « Bien relire le code généré. » Ce ne sont pas des règles, ce sont des valeurs. Elles vont en préambule ou dans « Recommandations ».
L'agent peut écrire un premier jet. Le tri, c'est votre travail.
Écris CHARTE-IA.md à partir de ce modèle [coller le modèle], de la checklist de l'atelier 4 et de la grille de l'atelier 5 [coller ou citer les fichiers]. Une page au plus. Chaque règle a trois colonnes : la règle, « Vérifiée par » (un outil, un hook, la CI, la revue ou un contrat), le responsable. N'invente aucun outil que ce projet n'utilise pas.
Relis CHARTE-IA.md. Liste les règles dont la colonne « Vérifiée par » ne nomme pas un mécanisme qu'on peut constater. Pour chacune, propose soit un mécanisme réaliste dans ce projet, soit son déplacement dans « Recommandations ». Ne modifie pas le fichier.
Pour la section « Agents », le guide de l'OpenSSF donne des consignes de sécurité prêtes à mettre dans AGENTS.md : Security-Focused Guide for AI Code Assistant Instructions.
Une charte n'est vérifiable que si ses mécanismes existent. Choisissez une règle de votre charte qui n'est pas encore en place dans votre dépôt, installez son mécanisme, et montrez qu'il bloque.
| Règle | Mécanisme à installer | Comment montrer qu'elle bloque |
|---|---|---|
| Aucun secret n'est commité | gitleaks en hook de pré-commit (voir ci-dessous) | Commitez un faux secret : le commit est refusé |
Aucun agent ne lit .env ni les données | Règle deny ou hook de l'atelier 4 | Demandez à l'agent d'afficher le fichier : il est refusé |
| Pas d'approbation automatique hors tests | Réglages de l'agent, versionnés dans le dépôt | Demandez une commande hors liste : l'outil vous demande l'autorisation |
| Les tests passent avant que l'agent rende la main | Le hook de fin de l'atelier 2 | Cassez un test : l'agent est relancé pour le corriger |
| Toute PR assistée par IA le déclare | Un modèle de PR, .github/pull_request_template.md, avec la case « assisté par IA » | Ouvrez une PR : la case apparaît |
| Les actions de CI sont épinglées | Chaque uses: pointe vers une empreinte de commit | Relisez le workflow : plus aucune étiquette comme @v4 |
Dans CHARTE-IA.md, la règle « [la règle] » doit être vérifiée par : [le mécanisme]. Mets ce mécanisme en place dans ce dépôt. Montre-moi les fichiers avant de les écrire, puis donne-moi la manipulation exacte pour vérifier qu'il bloque.
Un hook Git versionné dans le dépôt, pour que toute l'équipe en profite. Il demande gitleaks sur le poste (version vérifiée sur la page des versions du projet).
#!/bin/sh # Refuse le commit si un secret est détecté dans les fichiers ajoutés. gitleaks git --pre-commit --staged --redact --verbose
git config core.hooksPath .githooks
Sous macOS et Linux, rendez le script exécutable : chmod +x .githooks/pre-commit. Sous Windows, Git l'exécute avec son propre shell. Testez : ajoutez une ligne api_key = "sk_live_51Hx0000000000000000000000" dans un fichier, puis git commit. Le commit doit être refusé.
Mettez ensuite à jour la colonne « Vérifiée par » de cette règle, et commitez le tout.
Ce script, sans dépendance, relit votre charte et vous signale les règles sans « Vérifiée par » et les formulations vagues. Vous pouvez aussi le lancer en CI.
python verifier_charte.py CHARTE-IA.md
"""Signale les règles de la charte qu'on ne peut pas vérifier."""
import re
import sys
VAGUE = re.compile(r"responsable|vigilan|bien relire|attenti|bonnes? pratiques?", re.I)
PAS_DE_REGLE = {"", "règle", "---"}
problemes = 0
section = ""
for ligne in open(sys.argv[1], encoding="utf-8"):
if ligne.startswith("## "):
section = ligne[3:].strip()
if not ligne.startswith("|") or section == "Recommandations":
continue
colonnes = [c.strip() for c in ligne.strip().strip("|").split("|")]
regle = colonnes[0]
if regle.lower() in PAS_DE_REGLE or set(regle) <= {"-", ":"}:
continue
verifiee = colonnes[1] if len(colonnes) > 1 else ""
if not verifiee or verifiee.startswith("["):
print(f"[{section}] « {regle} » : colonne « Vérifiée par » vide")
problemes += 1
elif VAGUE.search(regle):
print(f"[{section}] « {regle} » : formulation vague, à préciser")
problemes += 1
print(f"{problemes} règle(s) à revoir" if problemes else "Toutes les règles nomment leur vérification.")
sys.exit(1 if problemes else 0)
Le script ne juge que la forme. Qu'un mécanisme existe vraiment, c'est la revue qui le dit.
CHARTE-IA.md est à la racine du dépôt, et tient sur une page.Les RSSI et chefs de projet peuvent écrire la charte de leur équipe réelle dans un simple document, sans dépôt.
| Symptôme | Que faire |
|---|---|
| Vous n'avez ni checklist ni grille | Partez du modèle et du tableau « Des règles vérifiables, par couche ». Six règles prises dedans suffisent. |
| Une règle n'a pas de mécanisme de vérification | Demandez-vous qui s'en apercevrait si elle n'était pas respectée, et comment. Si personne, elle va dans « Recommandations ». |
| L'agent invente des outils que vous n'utilisez pas | Rappelez-lui la consigne du prompt, ou retirez ces lignes à la main. |
| La charte dépasse une page | Gardez une règle par ligne, sans explication. Les explications vont dans AGENTS.md ou dans un wiki. |
| Aucune règle ne se prête à un mécanisme en un quart d'heure | Prenez le modèle de PR avec la case « assisté par IA » : un seul fichier à créer. |
| gitleaks n'est pas installé | Prenez une autre règle du tableau, ou lancez gitleaks avec Docker comme au module 4.4. |
| Le hook de pré-commit ne se déclenche pas | Vérifiez git config core.hooksPath : il doit valoir .githooks. Sous macOS et Linux, vérifiez que le script est exécutable. |
verifier_charte.py signale une règle juste | Le script ne juge que la forme. Reformulez la règle sans mot vague, ou ignorez l'alerte si la vérification est réelle. |
Choisissez une règle de cette charte et mettez-la en place dans votre équipe d'ici 30 jours. Notez-la en bas du questionnaire de fin.