promptbyprompt/fiches-agent

Fiches agent

Un sous-agent commence avec une mémoire vide. Il ne connaît que ce que vous écrivez. Avant de lancer un sous-agent, un workflow ou une tâche longue, rédigez une fiche avec templates/brief.md (dans le dossier de cette compétence).

Étapes

1. Tâche volumineuse avec plusieurs parties : exécutez d'abord un agent de planification avec templates/planner.md. Il renvoie 5 à 8 étapes, chacune avec un done_when mesurable. Chaque étape reçoit ensuite sa propre fiche.
2. Travail de qualité (musique, son, visuels, style d'écriture) : suivez d'abord templates/reference.md. Rassemblez 2 à 3 références, mesurez-les, rédigez l'écart, prototypage d'une pièce, et laissez le propriétaire juger avant la suite.
3. Rédigez la fiche avec chaque titre de templates/brief.md. Écrivez « aucun » sous un titre qui ne s'applique pas. Collez templates/test-policy.md dans chaque fiche qui construit ou modifie quelque chose.
4. Après une étape de construction, examinez avec 2 ou 3 critiques issus de templates/critic.md, en parallèle, sur le même matériel enregistré. Donnez la liste fusionnée des must_fix à un agent de correction.
5. Lancez un chien de garde à côté de chaque agent qui tourne plus de 15 minutes environ (voir ci-dessous).
6. Dites à l'utilisateur ce que vous avez lancé, le budget et une estimation honnête. Dites ce qui est incertain.

Règles pour chaque fiche

• Lire en premier : pointez vers des fichiers et des sections plutôt que de copier un long contexte.
• Citez les mots du propriétaire (traduits si nécessaire), afin que l'agent voie ce qui a vraiment été demandé.
• Si le propriétaire est absent, dites-le : « Le propriétaire ne peut pas répondre. Décidez vous-même et enregistrez chaque décision. »
• Les critères de complétion doivent pouvoir être vérifiés par un script, un test ou une mesure. Utilisez des chiffres et des plages.
• Un agent ne voit ni n'entend comme une personne. Faites-le mesurer (captures d'écran, comptages d'images, volume sonore, pics), indiquez dans le rapport ce que personne n'a regardé ou écouté, et laissez le goût au propriétaire.
• Chaque fiche a un budget de temps, un budget de test et une règle d'arrêt : « Quand le temps est écoulé, arrêtez-vous, notez ce qui reste et revenez. » Les tâches longues ont également un point de contrôle (« À 2 h, si X n'a pas commencé, passez à Y »).
• N'écrivez jamais « relancez tous les tests précédents » ou « gardez tout en fonctionnement » sans limites. Testez la nouvelle partie à son emplacement ; relancez un ancien test uniquement si vous avez modifié ce qu'il couvre.
• Listez les priorités pour le cas où le temps viendrait à manquer, en commençant par la plus importante, et dites ce qu'il advient du reste.
• Les livrables conservent les noms, formats et longueurs de ce qu'ils remplacent, afin que l'étape suivante puisse les interchanger.
• Un fichier de progression reçoit une ligne horodatée par pièce terminée, afin que le travail survive à une interruption.
• Les règles strictes énoncent la raison (« Ne jamais enregistrer X : l'enregistrement effacerait ses références »).
• Reportez les échecs antérieurs sous forme de règles (« un clip précédent était noir : utilisez le profil Main et yuv420p »).
• Limitez les quêtes secondaires risquées : « Passez au maximum 15 minutes dessus, puis revenez à Y. »
• Les agents parallèles reçoivent des périmètres : « L'étape 3 n'est PAS votre travail : ne touchez pas à A ou B. »
• Demandez un format de retour fixe : ce qui a été fait, ce qui a été sauté et pourquoi, les mesures, le temps de test, le temps utilisé, une estimation pour le reste, les emplacements des fichiers.

Chien de garde

À côté de chaque agent long, lancez une commande en arrière-plan qui attend le budget de temps, puis imprime une ligne :

sleep 5400 ; echo "BUDGET dépassé : étape 3 (90 min)"

Exécutez-la en arrière-plan (Claude Code vous avertit lorsqu'elle se termine). Lorsqu'elle se déclenche : lisez le fichier de progression de l'agent, puis soit dites à l'agent de conclure et de revenir, soit arrêtez-le, soit prolongez le budget une fois et prévenez l'utilisateur. Si l'agent revient tôt, arrêtez le chien de garde.