Convention

Une convention décrit la manière de faire habituellement attendue dans un projet ou une organisation.

Elle permet à plusieurs personnes - et à plusieurs agents - de produire un travail cohérent sans devoir rediscuter chaque détail.

Une convention peut concerner :

• la structure du code ;
• les choix architecturaux ;
• la stratégie de tests ;
• les règles de nommage ;
• l’usage de Git ;
• la documentation ;
• la manière de préparer une pull request.

Dans un projet assisté par IA, les conventions aident l’agent à distinguer les pratiques réellement attendues des habitudes qu’il pourrait déduire au hasard en parcourant le dépôt.

Exemple

Les contrôleurs HTTP ne contiennent pas de logique métier.
Toute nouvelle règle métier doit être testée au niveau du domaine.
Les commits utilisent le format Conventional Commits.

Ces règles indiquent à l’agent comment intégrer son travail au projet.

À ne pas confondre

Une convention n’est pas nécessairement une interdiction technique.

Elle explique le chemin attendu, mais son respect peut encore dépendre de la compréhension et de la discipline de l’agent. Lorsqu’une limite doit être garantie, une convention seule ne suffit pas toujours : il faut alors un guardrail.

À retenir

Sans conventions explicites, l’agent prend ce qu’il trouve pour ce qui devrait être fait. Un ancien compromis peut alors devenir, par accident, le modèle à reproduire.