peterruiter/claude-build-framework

Rédiger un briefing d'agent

Modèle : ${CLAUDE_PLUGIN_ROOT}/templates/agent-brief.md. Contexte : ${CLAUDE_PLUGIN_ROOT}/docs/waves-and-agents.md.

Étapes

1. Rassembler les faits (ne pas deviner) :
   • chemin du dépôt, branche, résumé de la stack (CLAUDE.md), commandes de la porte (CLAUDE.md ou le profil) ;
   • langues : lire build/contracts/locales.json : compter, source, la langue la plus longue (généralement l'allemand ou le finnois) et une langue avec beaucoup de pluriels (dont Intl.PluralRules a besoin de few/many, si configurée) pour les captures d'écran ;
   • résidence des données (CLAUDE.md) ;
   • dossier de chaînes, glossaire, changelog (id le plus élevé : dire « prochain libre au moment où vous écrivez ») ;
   • slot de migration réservé, base de données scratch, ports, dossier scratch (à partir du plan de vague, ou en choisir des libres et les enregistrer) ;
   • les fichiers à étudier en premier et les fichiers que l'agent possède.
2. Rédiger l'objectif en termes utilisateur, puis des puces de périmètre concret et ce qui est hors périmètre.
3. Remplir chaque placeholder du modèle. Supprimer les sections qui ne s'appliquent vraiment pas (par ex. captures d'écran pour un élément backend uniquement) et expliquer pourquoi en une ligne.
4. Conserver les règles permanentes textuellement du modèle : toutes les langues configurées avec leurs formes plurielles, WCAG 2.2 AA, mode clair et sombre, confidentialité dès la conception, résidence des données, une entrée What's new, section STATE.md, modifications ciblées et petites, pas de commit/push/déploiement/cloud, pas de secrets, pas d'attribution IA dans tout ce que l'agent écrit.
5. Vérifications avec des numéros et le format du rapport à la fin.
6. Si l'élément touche des surfaces sensibles à la sécurité (connexion, jetons, liens, webhooks, exportations, limites de locataires), ajouter les lignes pertinentes de ${CLAUDE_PLUGIN_ROOT}/docs/security-review.md comme critères d'acceptation explicites avec des tests.
7. Produire le briefing en un seul bloc, prêt à être passé comme instruction à l'agent.