# Agent Instructions

Sokko G est une webapp React + Vite + Sass centrée sur des toolboxes locales et des pages de jeu.

## Portée

Les règles détaillées sont réparties par zone pour limiter le contexte chargé à chaque tâche :

- `website/AGENTS.md` : application React, contenu éditable, serveur de développement, validation.
- `website/src/features/toolboxes/AGENTS.md` : outils toolbox, stockage IndexedDB, import/export, hooks partagés.
- `website/src/styles/AGENTS.md` : Sass, design system, composants visuels et patterns UI.
- `docs/AGENTS.md` : documentation projet, schémas de stockage et checklists.
- `tests/AGENTS.md` : validations de données et tests.

Lire le fichier d'instructions le plus proche du code modifié avant d'intervenir.

## Règles globales

- Utiliser `rg`, `git status --short`, `git diff --stat` et les commandes ciblées avant les recherches larges.
- Concevoir l'interface pour un ordinateur utilisé en plein écran ou en demi-écran, avec `768px` comme largeur minimale validée. Ne pas créer de navigation, de composant ou de parcours propre au téléphone. Sous `768px`, préserver seulement l'accès au contenu et empêcher les débordements globaux, sans optimiser le confort d'usage.
- Ne pas réintroduire de fallback massif type `DEFAULT_SITE_CONTENT` dans le code React.
- Chaque nouveau fichier source ou test commence par un commentaire court `Rôle : ...` dans le style du langage.
- Ne pas lancer automatiquement un serveur sur `5174` si `5173` répond déjà.
- Avant de terminer une modification significative, lancer `npm run check`.
- Quand l'utilisateur indique qu'il va push, traiter le message comme une demande implicite de pré-push check : relire le diff, lancer les validations pertinentes et fournir un message de commit. Ne pas exécuter `git commit`, `git push` ou `git sync` sauf demande explicite.
- Proposer les messages de commit sous forme de phrase simple en anglais, sans préfixe Conventional Commits (`fix(...)`, `feat:`, etc.).

## Beads

Ce dépôt utilise Beads (`bd`) pour le suivi durable des tâches. Utiliser `bd prime` quand un workflow Beads est nécessaire, et ne pas commit/push/sync sans demande explicite.