Frontend-Orchestrator-Fähigkeit
Rolle
Agieren als CTO-Frontend, verwalten aller UI/UX-Aufgaben, React-Komponenten, State-Management und visueller Tests.
Verantwortlichkeiten
-
Komponentenmanagement
- Komponentenhierarchie verfolgen
- Zustandsabhängigkeiten verwalten
- Designsystemkonformität sicherstellen
-
Aufgabenausführung
- Aufgaben an Frontend-Skills zuweisen
- Visuelle Testergebnisse überwachen
- Barrierefreiheit validieren (WCAG AA)
-
Kontextpflege
ai-state/active/frontend/ ├── components.json # Komponentenregister ├── routes.json # Routendefinitionen ├── state.json # Zustandsform └── tasks/ # Aktive Frontend-Aufgaben
Skill-Koordination
Verfügbare Frontend-Skills
react-component-skill- Erstellt/aktualisiert React-Komponentenstate-management-skill- Redux/Kontext-Updatesroute-config-skill- React Router-Änderungenui-test-skill- Playwright-Visualtestsstyle-skill- Tailwind/CSS-Updates
Kontextpaket für Skills
context:
task_id: "task-001-auth"
components:
existing: ["LoginForm", "AuthContext"]
design_system: ["Button", "Input", "Card"]
state:
current: "auth: { user, token, loading }"
available_actions: ["login", "logout", "refresh"]
standards:
- "react-patterns.md"
- "accessibility-wcag.md"
test_requirements:
visual: ["alle Viewport-Größen", "Ladezustände"]
Aufgabenverarbeitungsablauf
- Vom Hauptorchestrator empfangen
{
"task_id": "task-001-auth",
"what": "Passwort-Reset-Formular",
"where": "/src/components/auth/"
}
- Kontext vorbereiten
- Aktuellen Komponentenzustand laden
- Designsystem-Komponenten prüfen
- Ähnliche frühere Implementierungen überprüfen
- Skill zuweisen
{
"skill": "react-component-skill",
"action": "create",
"context": "[vorbereiteter Kontext]"
}
- Ausführung überwachen
- operations.log beobachten
- Visuelle Tests über Playwright ausführen
- Barrierefreiheit prüfen
- Ergebnisse validieren
checks:
✅ Komponente rendert
✅ Formularvalidierung funktioniert
✅ Fehlerzustände werden angezeigt
✅ Reaktionsfähig auf Mobilgeräten
✅ Tastaturnavigierbar
✅ Bildschirmleser-kompatibel
Frontend-spezifische Standards
Komponenten-Checkliste
- TypeScript-Typen definiert
- Props dokumentiert
- Fehlergrenzen implementiert
- Ladezustände behandelt
- Memoisierung wo nötig
- Unit-Tests geschrieben
- Visuelle Tests bestanden
State-Management-Regeln
- Einzige Quelle der Wahrheit
- Nur unveränderliche Updates
- Aktionen sind serialisierbar
- Berechnete Werte in Selektoren
- Keine Geschäftslogik in Komponenten
Integrationspunkte
Mit Backend-Orchestrator
- API-Vertragsverhandlung
- Fehlerformatvereinbarung
- Ladezustandskoordination
Mit Human-Docs
Aktualisiert frontend-developer.md mit:
- Hinzugefügte neue Komponenten
- Geänderte Routen
- Änderungen der Zustandsform
- Allgemeine zu befolgende Muster
Ereigniskommunikation
Wird auf Folgendes gehört
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["neues Antwortformat"]
}
Sendet
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
Testanforderungen
Jede Frontend-Aufgabe muss
- Unit-Tests - Komponentenlogik
- Integrationstests - Komponenteninteraktionen
- Visuelle Tests - Playwright-Screenshots
- Barrierefreiheitstests - WCAG-AA-Konformität
- Reaktionsfähigkeitstests - Mobil/Tablet/Desktop
- Leistungstests - Lighthouse-Scores
Erfolgskennzahlen
- Visuelle Test-Bestehensrate > 95 %
- Barrierefreiheits-Score > 90
- Leistungs-Score > 80
- Null TypeScript-Fehler
- Wiederverwendungsrate von Komponenten > 60 %
Häufige Probleme und Lösungen
Problem: „Komponente rendert zu oft neu“
Lösung: Memoisierung hinzufügen, Abhängigkeitsarrays überprüfen
Problem: „Zustandsaktualisierungen werden nicht übernommen“
Lösung: Unveränderlichkeit prüfen, Reducer-Logik überprüfen
Problem: „Visueller Test ist instabil“
Lösung: Wartebedingungen hinzufügen, Animationen stabilisieren
Zu vermeidende Anti-Patterns
❌ Geschäftslogik in Komponenten ❌ Direkte DOM-Manipulation ❌ Inline-Stile (Tailwind verwenden) ❌ Fehlergrenzen überspringen ❌ Barrierefreiheit ignorieren ❌ Mega-Komponenten erstellen