← Tous les travaux
Outil interne · Studio

Le cahier des charges qui se pré-remplit avant Claude Code

Icône Brief Generator

Un outil mono-fichier qui capture une fois les standards du studio — stack, charte UI/UX, mode de fonctionnement attendu de l’agent — puis les repropose en un clic à chaque nouveau projet.
Le but : ne plus jamais réexpliquer son studio à une IA depuis zéro.

RôleConception & itération
StackHTML / CSS / JS vanilla · Cloudflare Workers · Anthropic + Gemini
StatutOutil interne, en itération active
PériodeFiche mise à jour le 15 août 2026
Essayer la démo →
Le problème de départ

Charte UI/UX, mode de fonctionnement attendu de l’agent, stack par défaut, contraintes légales : autant de décisions déjà prises en amont, mais qu’il fallait retaper — ou pire, oublier de préciser — au début de chaque session.
Brief Generator les fixe une fois, sous forme de pips et de templates réutilisables, puis génère un Markdown collable tel quel en tête de conversation.
Non-objectif assumé : l’outil ne code pas à ma place et n’automatise aucune décision produit, il structure et mémorise ce qui a déjà été décidé.

30
versions itérées en une session continue
8
sections de brief
14
critères pour recommander une stack
Le différenciant

Un champ du brief ne décrit pas le projet, mais la manière dont l’agent doit le traiter : une séquence fixe en 6 étapes, chacune réglable sur une variante avec une note libre en complément.
Le Markdown généré calibre explicitement le comportement attendu de l’agent avant la première ligne de code — pas seulement une liste de fonctionnalités.

  • Renseignement
  • Idéalisation
  • Amélioration
  • Codage
  • Vérification
  • Rendu
Sécurité & périmètre

Tout le brief reste en localStorage, dans le navigateur.
L’agent IA passe par un proxy Cloudflare Worker : la clé API n’est jamais stockée côté serveur, elle transite à chaque requête vers le fournisseur choisi, saisie par l’utilisateur lui-même.
Comme tout fichier HTML/JS ouvert dans un navigateur, le code reste lisible via « Afficher le code source » — aucune obfuscation ne change vraiment ça, documenté comme tel plutôt que promis à tort.

Bugs corrigés en route
FIXÉAlternance stricte user/assistant exigée par l’API Anthropic : un renvoi après erreur laissait 2 messages « user » consécutifs → filtré côté requête
FIXÉPlafond de réponse IA figé à 1024 tokens côté proxy → réponses tronquées sans avertissement → relevé à 4096 + bouton « Continuer »
FIXÉIDs de modèles Gemini écrits à la main, invalides côté API → liste corrigée depuis la documentation officielle
Ce que je documente aussi
  • Comparateur de stack volontairement simple

    Il lit une checklist de critères fixes, pas une analyse sémantique du texte déjà saisi dans le brief — au prix de devoir cocher soi-même certains critères évidents.

  • Outil interne, pas un produit grand public

    Pensé pour un usage solo répété d’un projet à l’autre, pas pour être découvert sans contexte — la démo ci-dessus demande de coller sa propre clé API pour être utile.