Was macht Nicht-Überteilen?
Builder-Prompts sind privater Kontext, niemals Kundentexte. Kundenschnittstellen sollten so klingen, als hätte ein menschliches Produktteam sie geschrieben: Null durchgesickerte Interna, null Füll-Untertitel und null KI-Kopier-Markierungen.
Geltungsbereich
- Streng: UI-Komponenten, Zielseiten, Preise, Onboarding, Einstellungen, Formulare, modale Fenster, leere Zustände, Toasts, Ladeanzeigen, Fehler, Store-Einträge, SEO-Metadaten.
- Sachlich und faktenbasiert:
/privacy,/terms,/security,llms.txt, SDK-Dokumentation, Changelogs (reine technische Fakten erlaubt; Übertreibungen, Meta-Erzählungen wie „"hinzugefügt, um zu ersetzen"“ und KI-Klischees verboten). - Ausgenommen: Code-Kommentare, Commit-Nachrichten, Pull-Requests, interne Dokumente, Admin-Ansichten.
1. Das Publikums-Tor
Klassifiziere jede Tatsache aus dem Prompt, bevor du UI-Text schreibst:
- VERWERFEN (0 Wörter im UI): Review-Queues (
in Überprüfung,TestFlight,ausstehende Genehmigung), KYC- oder DNS-Blocker, Speicher- und Datenbank-Interna (localStorage,IndexedDB,SQLite,Redis, Vektor-DBs, Modellnamen), Hosting-Kosten-Motive, Schlüsselspeicher, Paket- oder Store-IDs in Prosa, Signierungsausreden. - ÜBERSETZEN: Schreibe Builder-Kontext in ruhige Kundenwörter um:
| Interner Kontext | Niemals schreiben | Stattdessen schreiben |
|---|---|---|
| App oder Erweiterung in Überprüfung | Im App Store-Review, Ausstehende Genehmigung | Demnächst (nur Roadmap-Abzeichen) |
| Offline- oder Browser-Speicher | Gespeichert in IndexedDB, Kein Backend | 0 Wörter (oder Funktioniert offline im Hero) |
| KI-Suche und Fallback-LLM | Abfrage von Pinecone-Vektoren via Haiku-Fallback... | Fragen Sie Ihre Dokumente / Suche... |
| Abrechnungs- oder SSO-Blocker | Stripe KYC ausstehend, SAML blockiert | Zustand des ausgelieferten Pfads (Im App abonnieren) |
| Nicht signierter Desktop-Build | Notarisierung ausstehend; Rechtsklick Öffnen | Direkter Download · macOS und Windows |
| Verschlüsselungs-Infrastruktur | Militärische Verschlüsselung außerhalb der DB | Verschlüsselte Synchronisation (Details auf /privacy) |
| App- oder Bundle-IDs | com.acme.app, id1234567890 | Aus Prosa weglassen; nur Store-Badge-Link |
- BEHALTEN: Was heute funktioniert und der nächste Schritt. Siehe references/translations.md und references/leak-patterns.md.
2. Dichte-Vertrag und Regel für wiederholte Überschriften
Lösche Hilfstexte, die ihre Überschrift oder ihr Label wiederholen (Benachrichtigungen -> "Konfigurieren Sie, wie Sie Benachrichtigungen erhalten"). Erzähle niemals das sichtbare Layout nach ("Die folgende Tabelle vergleicht...", "Verwenden Sie das folgende Formular, um..."). Fülle niemals spärliche Karten auf.
| Slot | Obergrenze | Regel |
|---|---|---|
| Hero-Untertitel | 1 Satz, <= 18 Wörter | Ergebnis und unterstützte Plattformen |
| Status-Abzeichen | 1 bis 3 Wörter | Live ist Standard; Abzeichen nur Demnächst |
| Plan-Punkt | <= 6 Wörter | Nur ausgelieferte Funktionen |
| Karten-Untertitel | <= 10 Wörter (oder 0) | Weglassen, wenn Überschrift und Button ausreichen |
| Einstellungs- oder Formularhilfetext | 0 Wörter Standard | <= 10 Wörter nur bei nicht offensichtlichen Formaten |
| Leerer Zustand | <= 6 Wörter + 1 Button | Keine Datenbank-, Tabellen- oder Abfrage-Substantive |
| Toast | 1 bis 4 Wörter, kein ! | Gespeichert, Kopiert, Einladung gesendet |
| Ladezustand | 1 bis 3 Wörter | Suche..., Generiere... |
| Fehler | Was fehlgeschlagen ist + nächster Schritt | Keine HTTP-Codes, Routen oder Ratenfenster |
3. Anti-Paranoia-Regel
Biete niemals unaufgeforderte Verneinungen an ("Verlässt nie Ihren Computer", "Null Server", "100 % lokal", "Militärische Qualität"). Gib Datenbehandlung sachlich auf /privacy bekannt.
4. Menschliche Stimme
Entferne synthetische KI-Kopier-Markierungen zusammen mit internen Lecks:
- Keine „Nicht X, sondern Y“-Kontraste: Streiche negative Einleitungen ("Nicht nur eine Notiz-App, es ist...", "Gebaut für Geschwindigkeit, nicht für Bloat", "Kein Schnickschnack, sondern..."). Gib direkt an, was das Produkt tut.
- Keine erzwungenen Dreiergruppen oder staccato-Slogans: Streiche dreiteilige Fragmente ("Schnell. Einfach. Leistungsstark.", "Planen. Verfolgen. Ausliefern."). Ersetze Drillinge ("designen, zusammenarbeiten und skalieren") durch eine konkrete Fähigkeit oder Zahl.
- Keine Gedankenstriche (
—) oder Leerzeichen--im UI-Text: Verwende Punkte, Kommas oder Doppelpunkte oder streiche den zweiten Satzteil. - Keine standardmäßigen KI-Modetwörter oder
-end-Endungen: Verbietenahtlos,mühelos,supercharged,entfesseln,heben,stärken,optimieren,wegweisend,neuartig,bahnbrechend,robust,maßgeschneidert,eingehen,Geflecht,entscheidend,neudenken,für moderne Teams gestaltetund angehängte Partizipien ("...für mühelose Synchronisation sorgend"). Bevorzuge einfache Verben (ist,hat,synchronisiert,exportiert) gegenüberdient alsoderbietet. - Keine dekorative Formatierung: Schreibe Überschriften, Karten-Etiketten und Buttons in Satzfall (Titel-Fall nur für Eigennamen und Plannamen). Verwende niemals Emoji-Aufzählungszeichen (
🚀,✨,⚡,🔒,💡,🎉) in Funktionslisten oder Überschriften. Wiederhole niemals**Fett Label:** Erklärungüber mehrere Funktionslisten hinweg. - Keine Chatbot- oder falsch-fröhlichen Mikrotexte: Streiche gestellte Eröffnungen ("Lassen Sie uns eintauchen", "Hier ist, was Sie wissen müssen"), übertriebenes Lob ("Sie sind bereit!", "Großartig!"), falsche Entschuldigungen ("Ups! Etwas ist schiefgelaufen") und Ausrufezeichen in alltäglichen UI-Zuständen.
5. Audit-Modus und rote Flaggen
Durchsuche Quelltext-Bäume mit python3 scripts/audit.py src/ app/, schreibe dann markierte Texte um – auf Basis konkreter Fakten statt Synonym-Austausch. Siehe references/examples.md.
Rote Flaggen, die sofortige Neuschreibung erfordern: in Überprüfung, ausstehende Genehmigung, localStorage, lokaler Speicher, IndexedDB, kein Backend, Vektor-Embeddings, Fallback-Modell, Ratenlimit, KYC, Notarisierung, verlässt nie Ihren, militärischer Qualität, Paket-IDs in Prosa, wiederholte Einstellungs-Untertitel, "wurde erfolgreich gespeichert", nahtlos, mühelos, supercharged, entfesseln, nicht nur ein, staccato-Drei-Wort-Slogans, Emoji-Funktions-Aufzählungszeichen, Gedankenstriche in Klammern, "Ups! Etwas ist schiefgelaufen", "Sie sind bereit!".