VXerys/brand-from-codebase

Marke aus der Codebasis

Überblick

Das Produkt-Repository ist die einzige Quelle der Markenwahrheit. Ein Marken-Kit wird einmalig in marketing-videos/<brand>/brand.md extrahiert. Jeder Wert trägt seine Quelle Datei:Zeile und die Datei vermerkt den Commit des Repositorys, bei dem sie gelesen wurde, sodass sie aktualisiert statt erneut gelesen werden kann.

Vertrag von brand.md

Schreibe diese Abschnitte in dieser Reihenfolge. Jeder Wert endet mit seiner Quelle als (Pfad:Zeile).

1. Quellen: Repository-Pfade, Branch, git rev-parse --short HEAD pro Repository, Extraktionsdatum und ein maschinenlesbarer Block pro Repository, den die Pipeline-Prüfung G1 liest, um ein veraltetes Kit zu erkennen:

   ```refresh
   repo: <produkt-repo>
   ref: HEAD
   commit: c8fb26e
   paths: src/data/content.ts src/app/globals.css public/brand
   ```
   

   repo ist der Ordnername unter D:\Projects. Ein Repository, das kein Git verwendet, verwendet mtime: <ISO-Datum> anstelle von ref und commit.
2. Identität: Name, einzeilige Positionierung, Tagline, Tonfall (zitiere die Kopie-Datei, paraphrasiere nicht).
3. Farb-Tokens: Zuerst semantische Marken-Tokens (--color-brand-*, primary, AppColors.primary), dann unterstützende Tokens. Eine Tabelle pro Oberfläche, wenn sie sich unterscheiden: landing vs app.
4. Typografie: Pro Oberfläche. Landing-Fonts unterscheiden sich oft von App-Fonts; überprüfe sowohl das Root-Layout als auch etwaige fonts.ts auf Abschnittsebene.
5. Logos und Bilder: Dateipfade, die echte Produkt-Renderings vs. Stockfotos darstellen (Stock darf niemals als echte Benutzer präsentiert werden), sowie deren Lizenz- oder Credit-Datei.
6. Erlaubte Behauptungen: Funktionen, Modi, Preise, CTA-Beschriftungen, URLs, Kontakt. Jede ein direktes Zitat mit Quelle. Markiere Beispieldaten als SAMPLE (Renderings mit Dummy-Zahlen), sodass ein Video sie als „Contoh“ kennzeichnet.
7. Verbotene Behauptungen: Alles, was plausibel klingt, aber keine Quelle hat: Benutzerzahlen, Umsätze, Bewertungen, Erfahrungsberichte, Partnerlogos, „terpercaya“, „#1“.
8. Aufnahmeziele: Produktions- und Staging-URLs, lohnende Routen, App-Screenshot-Ordner, Play Store-URL.
9. Mehrdeutigkeiten: Doppelte oder widersprüchliche Tokens, Kopien, die sich zwischen Website und App unterscheiden, Werte, die ein Briefing an anderer Stelle verwendet, die der Code widerlegt. Liste sie für den Benutzer auf; löse sie niemals stillschweigend auf.

Extraktions-Checkliste

Suche nach	Typische Orte
Kopien, CTAs, Preise	src/data/content.ts, src/content/*.ts, Landing-Abschnitts-Komponenten, RELEASE_NOTES.md, docs/features/
Web-Tokens	globals.css @theme / :root, tailwind.config.*, palette.ts
Flutter-Tokens	lib/core/constants/app_colors.dart, app_text_styles.dart, pubspec.yaml Fonts
Schriftarten	app/layout.tsx (next/font), Abschnitt fonts.ts, pubspec.yaml
Logos	public/brand/, docs/brand/, assets/icons/brand/
URLs	grep -rn "https://<marken-domain>" über src/, metadataBase, site.ts, Begriffsseiten

Suche nach einem Wert, bevor du ihn als fehlend deklarierst: durchsuche die Domain, den CTA-Text und den Token-Namen im gesamten src/ mit grep.

Überspringe .env*, .mcp.json, google-services.json, Keystores und alle Schlüssel oder Tokens. Kopiere niemals deren Werte in brand.md.

Wenn das Quell-Repository nicht ausgecheckt ist (Cloud-Sitzungen)

Die Prüfung G1 meldet brand_repo_absent als Info und G2 überprüft jede Behauptung anhand der exakten Zitate in brand.md anstelle des Repositorys (claim_verified_brand_kit). Das funktioniert nur, wenn brand.md Zitate wörtlich mit Pfad:Zeile enthält. Extrahiere Zitate daher wörtlich, niemals paraphrasiert. Die Aktualisierung von brand.md erfordert das Repository: Führe sie auf dem Laptop durch oder füge das Produkt-Repository zur Cloud-Sitzung hinzu und setze MV_PROJECTS_ROOT auf dessen übergeordneten Ordner.

Aktualisierungsregel

Die Prüfung G1 führt git -C <repo> log --oneline <commit>..<ref> -- <paths> für jeden Refresh-Block aus und schlägt mit brand_stale fehl, wenn sich etwas geändert hat. Zur Behebung lies nur die geänderten Dateien erneut ein, aktualisiere ihre Zeilen und erhöhe commit im Block. Nicht-Git-Repositories werden anhand der Dateiänderungszeit mit mtime verglichen.

Aufnahme echter Benutzeroberflächen

Produktoberfläche	Methode
Live-Website	HyperFrames-Website-Aufnahme von der Produktions-URL (die product-launch-video-Route macht das); Staging nur, wenn der Benutzer sagt, dass die Funktion unveröffentlicht ist
Lokaler Entwicklungsserver	Nur, wenn der Benutzer nach einem unveröffentlichten Bildschirm fragt; kennzeichne ihn als unveröffentlicht im Briefing
Flutter-App	Vorhandene echte Screenshots (Website screens/, Play Store-Assets) oder Emulator-Screenshots, platziert in einem Geräterahmen
Kleine animierte Elemente (CTA-Button, Statistik-Karte)	Neu erstellt als HTML mit den brand.md-Tokens; erfinde niemals einen Bildschirm, der nicht existiert

Storyboard-Quellenangaben

Jede Behauptung auf dem Bildschirm in STORYBOARD.md trägt ihre brand.md-Quelle, zum Beispiel "Biaya layanan 2%" (<produkt-repo>/src/data/content.ts:212). Eine Behauptung ohne Quelle wird aus dem Storyboard gestrichen, nicht abgeschwächt.

Häufige Fehler

• Den erstbesten Marineblau-Ton (--navy-main) anstelle des semantischen Marken-Tokens (--color-brand-navy) nehmen. Bevorzuge semantische Namen und liste den anderen als Mehrdeutigkeit auf.
• App-Schriftarten für ein Landing-Page-Video verwenden oder umgekehrt.
• Eine URL als „nicht gefunden“ deklarieren, nachdem nur eine Datei überprüft wurde.
• Stockfotos zeigen, als wären sie Kunden.