Anti-Pattern Skill — Echten Code ausliefern, keine Dekorationen
Dieser Skill erkennt und verhindert die häufigsten Anti-Patterns, die Software unfertig oder unprofessionell wirken lassen.
Verbotene Anti-Patterns (NULL TOLERANZ)
UI/UX Anti-Patterns
❌ VERBOTEN:
- „Coming Soon“-Abschnitte oder -Beschriftungen
- Nicht funktionale Schaltflächen (müssen funktionieren oder entfernt werden)
- Formulare, die nirgendwo hinsenden
- Hartcodierte Fake-Daten in Produktionskomponenten
- Statische Tabellen, die sich als dynamisch ausgeben
- Links, die nirgendwo hinführen (href="#")
- „Baustelle“-Banner
- Feature-Flags, die dauerhaft auf false gesetzt sind
- Deaktivierte Eingabefelder ohne klare Erklärung
- Leere Zustände ohne hilfreiche Nachricht
- Paginierung, die nicht wirklich paginiert
- Suchleisten, die nicht wirklich suchen
- Filter, die dieselben Ergebnisse zurückgeben
- EINZELNE LANDING-PAGE, wenn der Nutzer „eine Website“ verlangt (MUSS mehrseitig sein)
- Keine Farbpalette vor dem Schreiben von CSS definiert
- Zufällige Hex-Farben ohne dokumentiertes Designsystem
- Inkonsistente Farben über Seiten hinweg (unterschiedliche Blautöne, unterschiedliche Abstände)
- EMOJIS irgendwo auf der Website (SVG-Icons von Lucide/Heroicons/Phosphor verwenden)
- Abschnitte, die sich berühren (kein Abstand zwischen Inhaltsblöcken)
- Footer direkt am oberen Abschnitt klebend (kein atmender Raum)
- Navigation mit mehr als 7 Einträgen auf oberster Ebene (überladen, überwältigend)
- Dienstleistungsseiten ohne individuelle Detailseiten (/services nur, kein /services/webdesign)
- Produktseiten ohne individuelle Detailseiten (/products nur, kein /products/[slug])
- Generische Dienstleistungsbeschreibungen (2-3 Zeilen pro Dienstleistung sind NICHT genug)
✅ ERFORDERLICH:
- Jeder sichtbare Button löst einen echten Handler aus oder wird entfernt
- Jedes Formular hat ein echtes onSubmit, das mit einem API-Aufruf verbunden ist
- Jede Liste lädt aus einer echten Datenquelle mit Ladezuständen
- Jeder Link navigiert zu einem echten Ziel
- Leere Zustände erklären warum und schlagen nächste Schritte vor
- Fehlerzustände zeigen echte Fehlermeldungen vom Server
- Ladezustände werden während echter asynchroner Operationen angezeigt
- Mehrseitige Website mit separaten Routen (Startseite, Über uns, Dienstleistungen, Kontakt, Produkte)
- Professionelle 6-Farben-Palette (--color-primary, secondary, accent, bg, surface, text)
- Konsistentes Designsystem über ALLE Seiten hinweg
- NULL Emojis – SVG-Icons verwenden (Lucide, Heroicons, Phosphor)
- Abschnittsabstand: mindestens 80px Padding zwischen Abschnitten
- Footer: mindestens 128px oberer Padding (niemals den Inhalt darüber berührend)
- Navigation: max. 7 Einträge, Dropdowns für Gruppen, sekundäre Links im Footer
- Dienstleistungen: Listenseite + individuelle Detailseiten pro Dienstleistung
- Produkte: Listenseite + individuelle Detailseiten pro Produkt
- Jede Dienstleistungsdetailseite: Beschreibung, Ablauf, Leistungen, Preise, FAQ, CTA
- Jede Produktdetailseite: Galerie, Spezifikationen, Preise, Bewertungen, ähnliche Produkte
Anti-Patterns der Website-Architektur
❌ VERBOTEN (wenn der Nutzer sagt „baue eine Website“):
- Die index.html als EINZIGE Datei erstellen
- Den gesamten Inhalt in eine scrollbare Seite packen
- Anker-Links (#about, #services) anstelle separater Seiten verwenden
- Es als „Website“ bezeichnen, obwohl es nur eine Landing-Page ist
- Kein Navigationsmenü zwischen Abschnitten/Seiten
- Kein gemeinsamer Header/Footer über alle Seiten hinweg
- Keine einzigartigen Meta-Titel/-Beschreibungen pro Seite
✅ ERFORDERLICH:
- Separate Route/Seite für jeden Abschnitt (z. B. /about, /services, /contact)
- Navigationsmenü, das alle Seiten verlinkt
- Gemeinsame Header- und Footer-Komponenten
- Jede Seite hat einen einzigartigen <title> und <meta description>
- Konsistente Farbpalette und Typografie über ALLE Seiten hinweg
- Mindestens 5 Seiten für jede „Website“-Anfrage (Startseite, Über uns, Dienstleistungen, Produkte/Portfolio, Kontakt)
Code Anti-Patterns
❌ VERBOTEN:
- return []; // TODO: implementieren
- throw new Error('Nicht implementiert');
- // Platzhalter
- Hartcodierte Arrays, die sich als API-Antworten ausgeben
- Funktionen mit leerem Rumpf
- Catch-Blöcke, die Fehler stillschweigend verschlucken
- Auskommentierter Code in der Produktion
- Magische Zahlen ohne benannte Konstanten
- Kopierter Code (DRY-Verletzung)
- Monsterfunktionen (>100 Zeilen)
- Tief verschachtelte Callbacks (>3 Ebenen)
- N+1-Datenbankabfragen in Schleifen
✅ ERFORDERLICH:
- Jede Funktion hat eine echte, funktionierende Implementierung
- Jeder Fehler wird ordnungsgemäß mit Benutzerfeedback behandelt
- Konstanten sind benannt und dokumentiert
- Code ist DRY – gemeinsame Logik extrahieren
- Funktionen sind fokussiert und unter 40 Zeilen
N+1-Abfrageerkennung
❌ VERBOTEN (N+1):
// Dies feuert 1 Abfrage pro Benutzer = N+1-Problem
for (const user of users) {
const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}
✅ ERFORDERLICH (Batch):
// Dies feuert insgesamt 1 Abfrage
const userIds = users.map(u => u.id);
const orders = await db.query(
'SELECT * FROM orders WHERE user_id IN (?)',
[userIds]
);
// Dann im Speicher gruppieren
const ordersByUser = groupBy(orders, 'user_id');
SQL Anti-Patterns
❌ VERBOTEN:
SELECT * FROM users -- Kein SELECT *
WHERE name LIKE '%" + input + "%' -- SQL-Injection
ORDER BY RAND() -- Performance-Killer
HAVING COUNT(*) > 0 -- WHERE verwenden
WHERE YEAR(created_at) = 2024 -- Zerbricht Index-Nutzung
✅ ERFORDERLICH:
SELECT id, name, email FROM users -- Explizite Spalten
WHERE name LIKE ? -- Parametrisiert
ORDER BY id DESC LIMIT 20 -- Deterministische Sortierung
WHERE created_at >= '2024-01-01' -- Index-freundlich
AND created_at < '2025-01-01'
Verifikations-Checkliste
Bevor EIN Auslieferungsgegenstand als abgeschlossen markiert wird:
Allgemein
- Kein „Coming Soon“ oder „Baustelle“ irgendwo
- Alle Schaltflächen sind funktional oder entfernt
- Alle Formulare senden an echte Endpunkte
- Alle Listen laden aus echten Datenquellen
- Keine hartcodierten Demodaten in Produktionspfaden
- Keine N+1-Abfragen (jede Schleife mit einer Abfrage prüfen)
- Keine TODO-Kommentare ohne Issue-Referenzen
- Fehlerzustände behandeln echte Fehler
- Ladezustände werden während echter Operationen angezeigt
Design & UI Anti-Patterns
- Keine Emojis irgendwo auf der Website (nur SVG-Icons verwenden)
- Abschnitte haben mindestens 80px Abstand zueinander (keine Berührung)
- Footer hat mindestens 128px oberen Padding (nicht am Inhalt klebend)
- Hauptnavigation hat max. 7 Einträge auf oberster Ebene
- Sekundäre Links im Footer, nicht in der Hauptnavigation
- Dienstleistungen haben individuelle Detailseiten (nicht nur eine Listenseite)
- Produkte haben individuelle Detailseiten (nicht nur eine Listenseite)
- Jede Dienstleistungsdetailseite hat: Beschreibung, Ablauf, Leistungen, CTA
- Jede Produktdetailseite hat: Galerie, Spezifikationen, Preise, Bewertungen
- Abwechselnde Abschnittshintergründe zur visuellen Trennung
SEO Anti-Patterns (für Website-Projekte)
- Keine Seite ohne einen einzigartigen
<title>und<meta name="description"> - Keine Seite ohne Open-Graph-Tags (og:title, og:description, og:image)
- Keine Seite ohne JSON-LD-Strukturdaten (
<script type="application/ld+json">) - Keine Nicht-Startseite ohne BreadcrumbList-Schema
- Keine doppelten JSON-LD-Blöcke (stattdessen
@id-Referenzen verwenden) - Keine fehlende
robots.txtodersitemap.xml - Keine Bilder ohne
alt-Text - Keine Seite ohne kanonische URL
- Kein fehlendes
<html lang="xx">-Attribut - Keine Seite mit mehr als einem
<h1>
Wann NICHT zu verwenden
Verwende diesen Skill NICHT, wenn:
- Allgemeine Codequalitätsprüfungen durchgeführt werden (verwende code-review-skill für breitere Analysen)
- Datenbankschemata entworfen werden (verwende database-design-skill für Schemaplanung)
- Geschäftslogik für Anwendungen geschrieben wird (verwende domain-driven-skill für vollständige Module)
- API-Endpunkt-Implementierungen überprüft werden (verwende api-design-skill für Endpunkt-Muster)
- Sicherheitsaudits durchgeführt werden (verwende security-auditor-skill für Schwachstellenanalysen)
- Bereitstellungskonfigurationen analysiert werden (verwende deployment-skill für CI/CD-Pipelines)
- Git-Workflows oder Versionsverwaltung überprüft werden (verwende git-workflow-skill für Branching/Commits)
- SQL-Abfragen geschrieben werden (verwende sql-best-practices-skill für Abfrageoptimierung)
- Layouts für mehrseitige Websites entworfen werden (verwende design-system-skill für professionelles UI/UX)
- Vorhandener Code auf Refactoring-Bedarf überprüft wird (verwende refactoring-skill für sichere Transformationen)