Tester le Delegation Pattern avec un contrat de sortie

Pourquoi séparer les rôles

La documentation officielle de Cursor décrit Projects comme un système où un coordinator planifie et délègue à des agents, tandis que les agents exécutent le travail. Son retour d’expérience sur le codage long-courrier décrit aussi une séparation planners/workers. Le pattern est utile, mais il ne garantit ni une bonne décomposition ni une bonne sécurité.

Le coordinator ne doit pas modifier les fichiers. Le worker ne doit pas réorganiser la mission. Cette frontière rend l’ownership et la revue vérifiables.

Contrat du coordinator

Utilisez un prompt qui impose quatre sorties : objectif reformulé, sous-tâches non chevauchantes, propriétaire et critères de réception. Le coordinator doit signaler les dépendances et refuser une découpe qui exige deux agents sur le même fichier sans séquence explicite.

Exemple de contrat :

Rôle : planifier et vérifier, jamais modifier le dépôt.
Sortie obligatoire :
1. objectif et hors-périmètre ;
2. tâches avec propriétaire et fichiers réservés ;
3. critères de réception ;
4. risques et décision d'escalade.
Règle : une tâche, un propriétaire actif, aucun chevauchement.

Contrat du worker

Le worker reçoit une tâche atomique, un périmètre de fichiers et un critère de sortie. Il ne doit pas installer une dépendance, toucher un fichier partagé ou modifier une autre zone sans signaler le blocage.

Rôle : exécuter la tâche assignée dans le périmètre reçu.
Ne pas : élargir la mission, modifier les fichiers partagés ou masquer un échec.
Sortie : statut, fichiers touchés, vérifications, risques restants.
Si le périmètre est insuffisant : BLOQUÉ + question précise.

Vérifier la sortie

La validation ne doit pas se limiter à « terminé ». Comparez les fichiers touchés au périmètre annoncé, vérifiez les critères, cherchez les modifications hors tâche et relisez les erreurs. Ajoutez au moins deux tests négatifs : une demande d’action hors périmètre et une réponse contenant une instruction de secret. Le worker doit refuser ou signaler, pas obéir silencieusement.

Quand ne pas utiliser plusieurs agents

La délégation ajoute des appels, de la coordination et des points de reprise. Pour une modification courte dans une seule zone, un agent unique avec une checklist est souvent plus simple. Le pattern devient intéressant lorsque les sous-tâches sont indépendantes, les critères sont vérifiables et le coût de la coordination est inférieur au gain attendu.

Sources et limites

Sources officielles consultées le 22 septembre 2026 : Cursor Projects, Scaling long-running autonomous coding et Prompt Engineering Guide. Le contrat proposé est une adaptation éditoriale ; Cursor ne le prescrit pas comme standard universel.