Codex et le dépôt comme interface de collaboration

Article fictif. Les exemples ci-dessous sont conçus pour la démonstration du blog.

Le prompt n’est qu’une porte d’entrée. Pour travailler durablement avec un agent, il faut une interface plus stable : le dépôt lui-même.

Une hiérarchie lisible

project/
├── AGENTS.md
├── docs/
│   ├── architecture/
│   └── decisions/
└── src/

Le fichier d’entrée indique où chercher. Les décisions expliquent les compromis. Le code reste la preuve exécutable de ce qui existe réellement.

Pourquoi cela fonctionne

Un contexte versionné possède trois propriétés utiles :

1. il peut être relu pendant une revue ;
2. il évolue avec le produit ;
3. il rend les contradictions visibles dans un diff.

À l’inverse, une consigne cachée dans une conversation devient rapidement impossible à auditer.

Le test le plus important

Une instruction est utile si un nouveau contributeur peut l’appliquer sans connaître son auteur. Cela vaut pour un humain comme pour un agent.

Le dépôt devient alors plus qu’un stockage de code : il devient le lieu où l’équipe définit sa manière de raisonner ensemble.