Arrêter de trop en dire
Les instructions du builder sont un contexte privé, jamais une copie client. Les interfaces client doivent être lues comme si une équipe produit humaine les avait écrites : zéro fuite de mécanismes internes, zéro sous-titre de remplissage, zéro marqueur de rédaction IA.
Périmètre d'application
- Strict : Composants UI, pages de destination, tarifs, onboarding, paramètres, formulaires, modales, états vides, toasts, chargeurs, erreurs, fiches de store, métadonnées SEO.
- Calme et factuel :
/privacy,/terms,/security,llms.txt, docs SDK, journaux de modifications (faits techniques simples autorisés ; battage, méta-narration comme"added to replace", et clichés IA interdits). - Exempt : Commentaires de code, messages de commit, pull requests, docs internes, vues administrateur.
1. La porte du public
Classez chaque fait de l'invite avant d'écrire du texte d'interface :
- SUPPRIMER (0 mots dans l'UI) : Files d'attente de révision (
in review,TestFlight,pending approval), blocages KYC ou DNS, plomberie de stockage et de base de données (localStorage,IndexedDB,SQLite,Redis, bases vectorielles, noms de modèles), motifs de coûts d'hébergement, magasins de clés, identifiants de package ou de store en prose, excuses de signature. - TRADUIRE : Réécrire le contexte du builder en mots calmes pour le client :
| Contexte interne | N'écrivez jamais | Écrivez à la place |
|---|---|---|
| Application ou extension en révision | In App Store review, Pending approval | Coming soon (badge roadmap uniquement) |
| Stockage hors ligne ou navigateur | Stored in IndexedDB, No backend | 0 mots (ou Works offline dans le héros) |
| Recherche IA et LLM de secours | Querying Pinecone vectors via Haiku fallback... | Ask your docs / Searching... |
| Bloqueur de facturation ou SSO | Stripe KYC pending, SAML blocked | Énoncer le chemin livré (Subscribe in app) |
| Build desktop non signé | Notarization pending; right-click Open | Direct download · macOS and Windows |
| Plomberie de chiffrement | Military-grade encryption outside DB | Encrypted sync (spécification sur /privacy) |
| Identifiants d'application ou de bundle | com.acme.app, id1234567890 | Omettre de la prose ; lien vers le badge du store uniquement |
- CONSERVER : Ce qui fonctionne aujourd'hui et la prochaine action. Voir references/translations.md et references/leak-patterns.md.
2. Contrat de densité et règle du titre redondant
Supprimer le texte d'aide qui répète son titre ou son libellé (Notifications -> "Configure how you receive notifications"). Ne jamais narrer la mise en page visible ("The table below compares...", "Use the form below to..."). Ne jamais remplir les cartes creuses.
| Emplacement | Plafond | Règle |
|---|---|---|
| Sous-titre du héros | 1 phrase, <= 18 mots | Résultat et plateformes prises en charge |
| Badge d'état | 1 à 3 mots | "Live" est la valeur par défaut ; badge uniquement Coming soon |
| Puce de plan | <= 6 mots | Fonctionnalités livrées uniquement |
| Sous-titre de carte | <= 10 mots (ou 0) | Omettre quand le titre et le bouton suffisent |
| Aide de paramètre ou formulaire | 0 mots par défaut | <= 10 mots uniquement pour les formats non évidents |
| État vide | <= 6 mots + 1 bouton | Zéro nom de base de données, de table ou de requête |
| Toast | 1 à 4 mots, pas de ! | Saved, Copied, Invite sent |
| État de chargement | 1 à 3 mots | Searching..., Generating... |
| Erreur | Ce qui a échoué + prochaine étape | Zéro codes HTTP, routes ou fenêtres de débit |
3. Règle anti-paranoïa
Ne jamais proposer de dénis non sollicités ("Never leaves your computer", "Zero servers", "100% local", "Military-grade"). Divulguer le traitement des données calmement sur /privacy.
4. Voix humaine
Supprimer les marqueurs de rédaction IA synthétique en même temps que les fuites internes :
- Pas de contrastes "Pas X, mais Y" : Couper les tournures négatives ("Not just a note app, it's...", "Built for speed, not bloat", "No fluff, just..."). Énoncer directement ce que le produit fait.
- Pas de triades forcées ni de slogans saccadés : Couper les fragments en trois temps ("Fast. Simple. Powerful.", "Plan. Track. Ship."). Remplacer les triplets ("design, collaborate, and scale") par une seule capacité concrète ou un nombre.
- Pas de tirets cadratins (
—) ni de--espacés dans la copie UI : Utiliser des points, des virgules ou des deux-points, ou supprimer la seconde clause. - Pas de mots à la mode IA ni de terminaisons en
-ing: Interdireseamless,seamlessly,effortless,effortlessly,supercharge,unleash,elevate,empower,streamline,cutting-edge,next-generation,game-changing,robust,tailored,delve,tapestry,pivotal,reimagining,crafted for modern teams, et les participes greffés ("...ensuring effortless sync"). Préférer les verbes simples (is,has,syncs,exports) àserves asouboasts. - Pas de formatage décoratif : Écrire les titres, les libellés de cartes et les boutons en minuscule (garder la capitale initiale pour les noms propres et les noms de plans uniquement). Ne jamais mettre d'émojis (
🚀,✨,⚡,🔒,💡,🎉) sur les listes de fonctionnalités ou les titres. Ne jamais répéter**Libellé en gras :** explicationdans les listes de fonctionnalités. - Pas de microcopie de chatbot ou de fausse gaieté : Couper les ouvertures préparées ("Let's dive in", "Here's what you need to know"), les louanges exagérées ("You're all set!", "Awesome!"), les excuses hypocrites ("Oops! Something went wrong"), et les points d'exclamation dans les états UI courants.
5. Mode audit et signaux d'alarme
Scanner les arborescences source avec python3 scripts/audit.py src/ app/, puis réécrire la copie signalée autour de faits concrets au lieu de changer des mots par des synonymes. Voir references/examples.md.
Signaux d'alarme nécessitant une réécriture immédiate : in review, pending approval, localStorage, local storage, IndexedDB, no backend, vector embeddings, fallback model, rate limit, KYC, notarization, never leaves your, military-grade, identifiants de package en prose, sous-titres de paramètres redondants, "has been successfully saved", seamless, effortless, supercharge, unleash, not just a, slogans saccadés en 3 mots, émojis sur les fonctionnalités, tirets cadratins entre parenthèses, "Oops! Something went wrong", "You're all set!".