sokko-g/AGENTS.md
Shinuwa 0fc18cd8b9
All checks were successful
Deploy Sokko G / deploy (push) Successful in 19s
Improve compact desktop usability and action guidance
2026-10-05 21:47:16 +02:00

2.2 KiB

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.