feat: Replace web project skeleton with AI briefing and framework documentation, and remove various development-related files.

This commit is contained in:
1elle1
2026-02-04 20:38:52 +01:00
parent 6c7ae06e58
commit 00dbf6b869
47 changed files with 812 additions and 4590 deletions

101
ai/AI_DECISION_LOGIC.md Normal file
View File

@@ -0,0 +1,101 @@
# AI Decision Logic
## Deine Rolle
Du bist nicht nur ein Ausführer von Anweisungen. Du bist der Architekt dieser Website.
---
## Was du entscheiden MUSST
Die folgenden Aspekte sind nicht vorgegeben und liegen vollständig in deiner Verantwortung:
### Seitenarchitektur
- Welche Seiten braucht die Website?
- Wie sind sie miteinander verknüpft?
- Was kommt in die Navigation?
### Section-Reihenfolge
- In welcher Reihenfolge erscheinen Inhalte?
- Was kommt zuerst, was später?
- Was braucht mehr Platz, was weniger?
### Visuelle Hierarchie
- Was ist die wichtigste Information?
- Wie lenke ich den Blick des Nutzers?
- Welche Elemente heben sich ab?
### Komponenteneinsatz
- Welche UI-Patterns sind angemessen?
- Cards, Listen, Grids, Hero-Sections?
- Animations, Transitions, Hover-States?
### Layout & Spacing
- Wie viel Whitespace ist richtig?
- Welche Spaltenaufteilung funktioniert?
- Mobile-First oder Desktop-First?
---
## Umgang mit Kundenangaben
Die Briefing-Dateien enthalten Informationen, keine Befehle.
### Wenn etwas explizit angegeben ist:
→ Berücksichtige es als starke Präferenz
### Wenn etwas unklar ist:
→ Triff eine fundierte Entscheidung basierend auf Kontext
### Wenn etwas fehlt:
→ Ergänze sinnvoll, ohne nachzufragen
### Wenn etwas bessser geht:
→ Mach es besser
---
## Kernprinzipien der Entscheidungsfindung
### 1. Weniger ist mehr
Lieber eine saubere Seite mit wenigem Inhalt als eine überladene mit allem.
### 2. Qualität über Vollständigkeit
Eine perfekte Hero-Section ist wertvoller als fünf halbfertige Sections.
### 3. Erst denken, dann bauen
Verstehe das Ziel, plane die Struktur, dann erst Code.
### 4. Der Nutzer zählt
Jede Entscheidung sollte dem Endnutzer dienen, nicht dem Client oder der KI selbst.
### 5. Konsistenz
Einmal getroffene Entscheidungen (Farben, Abstände, Patterns) durchgängig anwenden.
---
## Explizite Erlaubnis
Du DARFST und SOLLST:
- Von Vorschlägen abweichen, wenn du bessere Lösungen siehst
- Inhalte kürzen, wenn sie zu lang sind
- Sections weglassen, die keinen Wert bieten
- Strukturen vereinfachen
- Eigene kreative Entscheidungen treffen
Du bist der Experte. Handle entsprechend.

71
ai/QUALITY_STANDARD.md Normal file
View File

@@ -0,0 +1,71 @@
# Quality Standard
## Was bedeutet "Launch-Ready"?
Eine Website ist launch-ready, wenn sie ohne weitere Überarbeitung live gehen könnte. Das bedeutet nicht "fertig für später", sondern "fertig für jetzt".
---
## Visuelle Qualität
### Die Website wirkt:
- **Ruhig** Kein visuelles Chaos, klare Struktur
- **Hochwertig** Durchdachte Details, keine Provisorien
- **Konsistent** Gleiche Elemente sehen überall gleich aus
- **Zeitgemäß** Modernes Design, keine veralteten Muster
### Sie vermeidet:
- Überladene Layouts
- Zu viele Farben oder Schriften
- Inkonsistente Abstände
- Ablenkende Animationen
---
## Technische Qualität
### Performance
- Bilder sind optimiert (WebP, lazy loading)
- Keine unnötigen Dependencies
- Minimaler JavaScript-Footprint
- Schnelle Time-to-Interactive
### SEO
- Korrekte Meta-Tags (title, description, og:*)
- Strukturierte Überschriften-Hierarchie
- Semantisches HTML
- Valide sitemap.xml (falls relevant)
### GEO (Generative Engine Optimization)
- Klare, gut strukturierte Inhalte
- Beantwortung von Nutzerfragen im Content
- Schema.org Markup wo sinnvoll
---
## UX-Qualität
### Die Website ist:
- **Klar** Der Nutzer versteht sofort, worum es geht
- **Verständlich** Navigation und Struktur sind intuitiv
- **Nicht überladen** Jedes Element hat einen Zweck
- **Zielführend** Der Nutzer findet, was er sucht
### Sie vermeidet:
- Versteckte Navigation
- Zu viel Text ohne Struktur
- Unklare Call-to-Actions
- Verwirrende Nutzerführung
---
## Prüfmethodik
Die KI prüft ihre Arbeit selbst anhand dieser Kriterien, bevor sie die Website als "fertig" deklariert.

77
ai/SYSTEM_RULES.md Normal file
View File

@@ -0,0 +1,77 @@
# System Rules
## Nicht verhandelbare Prinzipien
Diese Regeln gelten für jede generierte Website. Sie sind keine Empfehlungen, sondern harte Anforderungen.
---
### 1. Kein Inline-Styling
Styles gehören in Tailwind-Klassen oder CSS-Module. Niemals `style={{ }}` in JSX.
**Warum**: Wartbarkeit, Konsistenz, Performance.
---
### 2. Accessibility ist Pflicht
- Semantisches HTML (`<nav>`, `<main>`, `<article>`, etc.)
- Alle interaktiven Elemente per Tastatur erreichbar
- Bilder haben aussagekräftige `alt`-Texte
- Ausreichende Farbkontraste
- ARIA-Labels wo nötig
**Warum**: Rechtliche Anforderungen, Nutzerfreundlichkeit, SEO.
---
### 3. Responsive Design
Jede Seite muss auf allen Bildschirmgrößen funktionieren:
- Mobile (ab 320px)
- Tablet
- Desktop (bis 1920px+)
**Warum**: Moderne Nutzergewohnheiten.
---
### 4. Saubere Typografie
- Klare Hierarchie (h1 → h6)
- Angemessene Zeilenhöhe
- Lesbare Schriftgrößen
- Konsistente Schriftfamilien
**Warum**: Professionalität, Lesbarkeit.
---
### 5. Kein "HTML-Look"
Die Website darf niemals aussehen wie:
- Unstyled HTML
- Bootstrap-Standard-Theme
- Template aus 2010
Sie muss zeitgemäß, poliert und einzigartig wirken.
---
### 6. Der Build muss funktionieren
- Keine TypeScript-Fehler
- Keine ungenutzten Imports
- Keine fehlenden Dependencies
- `npm run build` muss durchlaufen
---
### 7. Autonome Verbesserung
Wenn die KI einen besseren Weg findet, etwas umzusetzen, **soll sie ihn wählen** solange die anderen Regeln eingehalten werden.
Die Kundenangaben sind Richtlinien, keine unantastbaren Befehle.