Phil/philflow.io
1
0
Fork 0
Code Issues 21 Pull requests Projects Releases Packages Wiki Activity Actions

docs(relaunch): add product, voice and design base #31

Merged
Phil merged 1 commit from docs/relaunch-foundation into main 2026-08-12 21:25:22 +00:00
Conversation 0 Commits 1 Files changed 4 +1283
Phil commented 2026-08-12 21:21:39 +00:00
Owner
Copy link

Dieser PR legt die drei Fundament-Dokumente in den Projektroot und das zugehoerige Belegmaterial nach docs/relaunch/. Sie stehen bewusst vor jeder Gestaltungsarbeit: Der Design-Agent verweigert ohne PRODUCT.md und DESIGN.md den Start, und ohne ein gemeinsames Fundament produzieren parallel arbeitende Sektions-Agenten beliebig viele verschiedene Entwuerfe, die sich hinterher nicht mehr zusammenfuegen lassen.

Was drin ist

PRODUCT.md haelt die Produktwahrheit fest, ausdruecklich ohne jede Aesthetik: Zielkunde, Positionierung, Laufbahn, Preisstaffel samt Ankerlogik, die vollstaendige Verbotsliste fuer Aussagen sowie Stack und Randbedingungen.

VOICE.md leitet das Stimmprofil aus den drei Blogartikeln ab. Jedes Merkmal ist mit einem Beleg aus dem Bestand hinterlegt, nicht behauptet.

DESIGN.md haelt Marke und Randbedingungen fest, nicht die Gestaltungsrichtung. Die waehlt Phil spaeter aus drei Entwuerfen aus. Enthalten sind die fuenf Blautoene in Hex und oklch mit vollstaendiger Kontrastmatrix, das Schriftpaar, die Einheiten-Falle des 1px-rem-Systems und die Anti-Referenzen aus Phils dokumentiertem Feedback.

docs/relaunch/DESIGN.raw-ci-extractor.md ist die Roh-Extraktion aus dem bestehenden CI-Code. Belegmaterial, kein Arbeitsdokument, deshalb nicht im Root.

Befunde

Bei der Erarbeitung wurden drei Annahmen widerlegt:

  1. Die Behauptung, die Blogartikel enthielten null Em-Dashes, ist falsch. Es sind 60 Stueck ueber drei Artikel, nur der Tiefpunkt-Artikel ist sauber. Die Regel fuer neue Texte bleibt bindend, gilt aber als Korrektur am Bestand und nicht als dessen Beschreibung.
  2. Es gibt einen Schriftkonflikt. src/styles/config/default.scss setzt Aeion Mono als Schrift der gesamten Seite und stellt alle Ueberschriften auf Versalien bei Schriftstaerke 800. Die Startseite laeuft damit heute vollstaendig in Monospace-Versalien, was mit Source Serif 4 als Lesetype unvereinbar ist. In DESIGN.md als offene Gestaltungsentscheidung markiert.
  3. Weiss auf dem Akzentblau #2F6BFF erreicht 4,4988 zu 1 und verfehlt die AA-Schwelle fuer Fliesstext knapp. Da die Accessibility-Wertung bei 96 liegt und nicht fallen darf, sind in DESIGN.md zwei saubere Loesungen benannt.

Zahlen

Saemtliche Kennzahlen stehen nicht in diesen Dokumenten. Sie verweisen auf docs/relaunch/kennzahlen-freeze.md als alleinige Quelle, damit es keine zweite Wahrheit gibt.

Refs #22

Dieser PR legt die drei Fundament-Dokumente in den Projektroot und das zugehoerige Belegmaterial nach `docs/relaunch/`. Sie stehen bewusst vor jeder Gestaltungsarbeit: Der Design-Agent verweigert ohne `PRODUCT.md` und `DESIGN.md` den Start, und ohne ein gemeinsames Fundament produzieren parallel arbeitende Sektions-Agenten beliebig viele verschiedene Entwuerfe, die sich hinterher nicht mehr zusammenfuegen lassen. ## Was drin ist `PRODUCT.md` haelt die Produktwahrheit fest, ausdruecklich ohne jede Aesthetik: Zielkunde, Positionierung, Laufbahn, Preisstaffel samt Ankerlogik, die vollstaendige Verbotsliste fuer Aussagen sowie Stack und Randbedingungen. `VOICE.md` leitet das Stimmprofil aus den drei Blogartikeln ab. Jedes Merkmal ist mit einem Beleg aus dem Bestand hinterlegt, nicht behauptet. `DESIGN.md` haelt Marke und Randbedingungen fest, **nicht** die Gestaltungsrichtung. Die waehlt Phil spaeter aus drei Entwuerfen aus. Enthalten sind die fuenf Blautoene in Hex und oklch mit vollstaendiger Kontrastmatrix, das Schriftpaar, die Einheiten-Falle des 1px-rem-Systems und die Anti-Referenzen aus Phils dokumentiertem Feedback. `docs/relaunch/DESIGN.raw-ci-extractor.md` ist die Roh-Extraktion aus dem bestehenden CI-Code. Belegmaterial, kein Arbeitsdokument, deshalb nicht im Root. ## Befunde Bei der Erarbeitung wurden drei Annahmen widerlegt: 1. Die Behauptung, die Blogartikel enthielten null Em-Dashes, ist falsch. Es sind 60 Stueck ueber drei Artikel, nur der Tiefpunkt-Artikel ist sauber. Die Regel fuer neue Texte bleibt bindend, gilt aber als Korrektur am Bestand und nicht als dessen Beschreibung. 2. Es gibt einen Schriftkonflikt. `src/styles/config/default.scss` setzt Aeion Mono als Schrift der gesamten Seite und stellt alle Ueberschriften auf Versalien bei Schriftstaerke 800. Die Startseite laeuft damit heute vollstaendig in Monospace-Versalien, was mit Source Serif 4 als Lesetype unvereinbar ist. In `DESIGN.md` als offene Gestaltungsentscheidung markiert. 3. Weiss auf dem Akzentblau `#2F6BFF` erreicht 4,4988 zu 1 und verfehlt die AA-Schwelle fuer Fliesstext knapp. Da die Accessibility-Wertung bei 96 liegt und nicht fallen darf, sind in `DESIGN.md` zwei saubere Loesungen benannt. ## Zahlen Saemtliche Kennzahlen stehen nicht in diesen Dokumenten. Sie verweisen auf `docs/relaunch/kennzahlen-freeze.md` als alleinige Quelle, damit es keine zweite Wahrheit gibt. Refs #22
Diese Dokumente sind das Kontext-Gate fuer die Gestaltungsarbeit. Der
Design-Agent verweigert ohne PRODUCT.md und DESIGN.md den Start, und
ohne gemeinsames Fundament produzieren parallel arbeitende
Sektions-Agenten beliebig viele verschiedene Entwuerfe.

DESIGN.raw-ci-extractor.md ist Belegmaterial und liegt deshalb unter
docs/relaunch/, nicht im Projektroot.

Refs #22
Phil merged commit ecbcddde4c into main 2026-08-12 21:25:22 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Phil/philflow.io!31
No description provided.