Agent Instructions

Cette zone contient l'application React + Vite et les assets publics.

Références

Avant de modifier un outil toolbox, le stockage IndexedDB, l'import/export ou les formats de données, lire :

../docs/STORAGE_SCHEMA.md
../docs/FEATURE_CHECKLIST.md

Avant de modifier le style, les composants UI, les layouts, les boutons, cards, panels, hovers, scrollbars ou notifications, lire :

../DESIGN_SYSTEM.md

Après ce type de modification, mettre à jour ces documents si le format, le workflow ou le pattern visuel change.

Contenu éditable

Le contenu éditorial du site doit rester dans :

public/data/site.json
public/data/<gameId>/...

site.json est la source de vérité. npm run check doit échouer si le contenu requis est invalide.

En-têtes de fichiers

Chaque nouveau fichier source ou test doit commencer par un commentaire court Rôle : ... décrivant ce qu'il gère.

Mettre cet en-tête à jour si la responsabilité du fichier change.
Garder l'intro concise, une à trois lignes maximum selon la complexité du fichier.
Enrichir l'en-tête seulement quand le fichier porte une logique transverse, un hook partagé, un format de données ou un comportement réutilisable.
Utiliser // Rôle : ... dans les fichiers JS, JSX, MJS et SCSS.

Serveur de développement

Si le port 5173 est déjà occupé, considérer qu'un npm run dev est probablement déjà en cours. Ne pas lancer automatiquement un nouveau serveur sur 5174.

Quand une vérification navigateur est nécessaire, utiliser l'instance déjà ouverte sur http://localhost:5173 si elle répond.

Validation

Avant de terminer une modification significative, lancer :

npm run check

Le check couvre la génération des index de listes, les tests et le build de production.

Pré-push check

Quand l'utilisateur indique qu'il va push, faire une passe globale avant de conclure :

code mort, imports inutilisés, fonctions inutilisées, styles obsolètes ;
duplication de code ou de style pouvant être factorisée sans complexifier ;
cohérence entre boutons, badges, cards, panels, hovers, focus states et scrollbars ;
cohérence entre public/data/site.json, les validations et les textes utilisés ;
cohérence entre ../docs/STORAGE_SCHEMA.md et les normalisations IndexedDB réelles ;
import/export des toolboxes quand la structure de données a changé ;
champs inutiles persistés dans IndexedDB ou dans les exports ;
fichiers générés attendus, notamment les index de listes ;
optimisations simples de performance : recalculs au render, listeners non nettoyés, observers, effets CSS lourds appliqués en masse.

Après lecture du diff pré-push, proposer un message de commit anglais, concis et représentatif.

2.7 KiB Raw Blame History