Nous découvrons de meilleures manières de développer du logiciel en partenariat avec des agents d’Intelligence Artificielle.

À travers ce travail, nous apprenons à valoriser :

  • La direction claire et le contexte structuré plus que la simple génération passive de code.
  • L’avancement incrémental validé plus que les livraisons monolithiques sans contrôle.
  • La compréhension humaine et la simplicité plus que les abstractions prématurées de la machine.
  • La traçabilité et la documentation vivante plus que la vitesse sans contrôle.

Même si les éléments de droite ont de la valeur, nous donnons priorité aux éléments de gauche.

Nos principes

I. Nous assumons le siège de direction

Nous ne demandons pas seulement du code. Nous dirigeons des agents très rapides.

Nous préparons l’environnement. Nous définissons les règles. Nous délimitons les frontières d’action.

II. Nous respectons le rythme de la pensée

Nous ne mélangeons pas exploration, planification et implémentation.

D’abord nous explorons l’idée. Ensuite nous planifions les étapes. Alors seulement nous donnons l’ordre de construire.

III. Nous célébrons l’étape unique

Nous refusons l’impulsion de créer tout le système en une seule fois.

Nous préférons implémenter, relire et valider une petite étape par cycle.

IV. Nous exigeons l’explicabilité

Nous n’acceptons pas du code que nous ne pouvons pas expliquer.

Si l’architecture devient inintelligible pour l’esprit humain, la vitesse a cessé d’aider.

V. Nous validons sans cesse

Aucune ligne de code n’est prête sans preuve de fonctionnement.

La validation n’est pas de la bureaucratie. C’est le contrat minimum entre intention et réalité.

VI. Nous protégeons l’historique

Nous utilisons Git dès le premier cycle.

Des commits petits et bien décrits préservent le contexte, réduisent la peur et rendent l’avancement réversible.

VII. Nous gouvernons par le contexte

Nous reconnaissons le fichier AGENTS.md comme la constitution du projet.

Il enregistre règles, critères, limites et mode de travail.

VIII. Nous modélisons avant de persister

Nous respectons la structure des données.

Avant d’écrire la logique métier, nous documentons entités, champs, relations et règles.

IX. Nous restreignons pour libérer

Nous limitons la créativité technique de la machine pour protéger la maintenance du produit.

La solution la plus simple qui fonctionne est souvent la meilleure première solution.

X. Nous cultivons la mémoire du projet

La documentation vivante préserve le pourquoi des décisions.

Sans mémoire, chaque nouvelle session tente de reconstruire le projet depuis zéro.

Un exemple de cycle

1. Écrivez l'objectif de l'étape.
2. Dites quels fichiers peuvent changer.
3. Implémentez peu.
4. Lancez lint, test et build.
5. Relisez le diff.
6. Enregistrez risques et prochaines étapes.

Le vibe coding n’est pas renoncer à l’ingénierie.

C’est utiliser l’IA sans abandonner direction, discernement et responsabilité.