Compétence d'Orchestrateur Frontend
Rôle
Agit en tant que CTO-Frontend, gérant toutes les tâches UI/UX, les composants React, la gestion d'état et les tests visuels.
Responsabilités
-
Gestion des Composants
- Suivre la hiérarchie des composants
- Gérer les dépendances d'état
- Assurer la conformité avec le système de design
-
Exécution des Tâches
- Assigner les tâches aux compétences frontend
- Surveiller les résultats des tests visuels
- Valider l'accessibilité (WCAG AA)
-
Maintenance du Contexte
ai-state/active/frontend/ ├── components.json # Registre des composants ├── routes.json # Définitions des routes ├── state.json # Structure de l'état └── tasks/ # Tâches frontend actives
Coordination des Compétences
Compétences Frontend Disponibles
react-component-skill- Crée/met à jour des composants Reactstate-management-skill- Mises à jour Redux/Contextroute-config-skill- Changements React Routerui-test-skill- Tests visuels Playwrightstyle-skill- Mises à jour Tailwind/CSS
Package de Contexte pour les Compétences
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: ["toutes les tailles d'écran", "états de chargement"]
Flux de Traitement des Tâches
- Réception de l'Orchestrateur Principal
{
"task_id": "task-001-auth",
"what": "Formulaire de réinitialisation de mot de passe",
"where": "/src/components/auth/"
}
- Préparation du Contexte
- Charger l'état actuel des composants
- Vérifier les composants du système de design
- Examiner les implémentations similaires passées
- Assignation à une Compétence
{
"skill": "react-component-skill",
"action": "create",
"context": "[contexte préparé]"
}
- Surveillance de l'Exécution
- Surveiller operations.log
- Exécuter les tests visuels via Playwright
- Vérifier l'accessibilité
- Validation des Résultats
vérifications :
✅ Le composant s'affiche
✅ La validation du formulaire fonctionne
✅ Les états d'erreur s'affichent
✅ Adapté au mobile
✅ Navigable au clavier
✅ Compatible avec les lecteurs d'écran
Standards Spécifiques au Frontend
Liste de Vérification des Composants
- Types TypeScript définis
- Props documentées
- Limites d'erreur implémentées
- États de chargement gérés
- Mémoïsation si nécessaire
- Tests unitaires écrits
- Tests visuels réussis
Règles de Gestion d'État
- Source de vérité unique
- Mises à jour immuables uniquement
- Actions sérialisables
- Valeurs calculées dans les sélecteurs
- Pas de logique métier dans les composants
Points d'Intégration
Avec l'Orchestrateur Backend
- Négociation des contrats API
- Accord sur le format des erreurs
- Coordination des états de chargement
Avec Human-Docs
Met à jour frontend-developer.md avec :
- Nouveaux composants ajoutés
- Routes modifiées
- Changements de structure d'état
- Modèles courants à suivre
Communication par Événements
Écoute
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["nouveau format de réponse"]
}
Diffusion
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
Exigences de Test
Chaque Tâche Frontend Doit
- Tests Unitaires - Logique des composants
- Tests d'Intégration - Interactions des composants
- Tests Visuels - Captures d'écran Playwright
- Tests d'Accessibilité - Conformité WCAG AA
- Tests Responsive - Mobile/tablette/ordinateur
- Tests de Performance - Scores Lighthouse
Indicateurs de Succès
- Taux de réussite des tests visuels > 95%
- Score d'accessibilité > 90
- Score de performance > 80
- Zéro erreur TypeScript
- Réutilisation des composants > 60%
Problèmes Courants et Solutions
Problème : "Le composant se re-rend trop souvent"
Solution : Ajouter de la mémoïsation, vérifier les tableaux de dépendances
Problème : "Les mises à jour d'état ne se reflètent pas"
Solution : Vérifier l'immuabilité, valider la logique du reducer
Problème : "Instabilité des tests visuels"
Solution : Ajouter des conditions d'attente, stabiliser les animations
Anti-Patterns à Éviter
❌ Logique métier dans les composants ❌ Manipulation directe du DOM ❌ Styles en ligne (utiliser Tailwind) ❌ Ignorer les limites d'erreur ❌ Ignorer l'accessibilité ❌ Créer des méga-composants