Formation IA pour développeurs · Jour 2 · Atelier 6

Créer une charte IA de bonne conduite pour une équipe de développement

« Une page. Chaque règle dit comment on vérifie qu'elle est respectée. »

Seul ou en binôme CHARTE-IA.md à la racine du dépôt 35 min de travail, 10 min de restitution

La règle du jeu

Vous ne partez pas de zéro. Rassemblez vos pièces :

  • la charte commencée il y a deux semaines : outils validés, données interdites, niveau de relecture, prompts partagés, métriques ;
  • la checklist de l'atelier 4 (workflow SQL sûr) ;
  • la grille de l'atelier 5, et surtout sa colonne « Vérifié par » ;
  • le tableau « quelle donnée, quel outil » du module 4.3.

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.

1Rassembler
Vos pièces des ateliers 4 et 5, et votre première charte. 2 min
2Rédiger
À partir du modèle, avec l'aide de l'agent si vous voulez. 12 min
3Trier
Chaque règle invérifiable part dans « Recommandations ». 4 min
4Appliquer une règle
Installer son mécanisme, montrer qu'il bloque, commiter. 15 min

Avant de commencer

Le modèle

CHARTE-IA.md
# 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].

Des règles vérifiables, par couche

Piochez, adaptez, ou écrivez les vôtres.

CoucheRègleVérifiée par
DonnéesLes requêtes sont paramétrées, avec un test d'injectionTests en CI, revue
DonnéesLes logs sont masqués avant d'être donnés à un agentScript de masquage dans le dépôt
OutilsFiltre de code public activéRéglage de l'organisation GitHub
OutilsUn petit modèle pour les tâches simples, le grand pour l'agentiquePolitique de modèles autorisés
AgentsPas d'approbation automatique hors tests et lintRéglages gérés, revue des fichiers de réglages
AgentsL'agent n'a qu'un accès en lecture à une base de testRôle de base de données, mode lecture seule
AgentsServeurs MCP de source connue, en version épingléeRevue de .vscode/mcp.json, liste autorisée
Codegitleaks bloque le commit d'un secretHook de pré-commit, CI
CodeLes actions de CI sont épinglées par empreinte de commitRevue, Dependabot
TracesChaque choix de modèle ou de fournisseur a son ADRDossier 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 ».

Avec votre agent

L'agent peut écrire un premier jet. Le tri, c'est votre travail.

Prompt · Premier jet
É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.
Prompt · Relecture
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.

Appliquer une règle, pour de vrai (15 min)

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ègleMécanisme à installerComment 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éesRègle deny ou hook de l'atelier 4Demandez à l'agent d'afficher le fichier : il est refusé
Pas d'approbation automatique hors testsRéglages de l'agent, versionnés dans le dépôtDemandez une commande hors liste : l'outil vous demande l'autorisation
Les tests passent avant que l'agent rende la mainLe hook de fin de l'atelier 2Cassez un test : l'agent est relancé pour le corriger
Toute PR assistée par IA le déclareUn 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éesChaque uses: pointe vers une empreinte de commitRelisez le workflow : plus aucune étiquette comme @v4
Prompt · Installer le mécanisme
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.

Exemple · gitleaks en hook de pré-commit

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).

.githooks/pre-commit
#!/bin/sh
# Refuse le commit si un secret est détecté dans les fichiers ajoutés.
gitleaks git --pre-commit --staged --redact --verbose
Activer les hooks du dépôt (une fois par poste)
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.

Bonus · Un contrôle automatique

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.

verifier_charte.py · puis 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.

Critères de réussite

Les RSSI et chefs de projet peuvent écrire la charte de leur équipe réelle dans un simple document, sans dépôt.

En cas de blocage

SymptômeQue faire
Vous n'avez ni checklist ni grillePartez 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érificationDemandez-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 pasRappelez-lui la consigne du prompt, ou retirez ces lignes à la main.
La charte dépasse une pageGardez 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'heurePrenez 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 pasVé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 justeLe script ne juge que la forme. Reformulez la règle sans mot vague, ou ignorez l'alerte si la vérification est réelle.

Après la formation

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.