cc-workspace 4.0.2 → 4.0.4

package/global-skills/agents/workspace-init.md

@@ -1,10 +1,10 @@
 ---
 name: workspace-init
 description: >
-  Agent d'initialisation et diagnostic du workspace orchestrateur.
-  Vérifie la structure, les hooks, les settings, les repos frères.
-  Configure interactivement workspace.md et constitution.md si [UNCONFIGURED].
-  Se lance une fois via: claude --agent workspace-init
+  Initialization and diagnostic agent for the orchestrator workspace.
+  Checks structure, hooks, settings, sibling repos.
+  Interactively configures workspace.md and constitution.md if [UNCONFIGURED].
+  Run once via: claude --agent workspace-init
 model: sonnet
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Task
 memory: project
@@ -14,74 +14,74 @@ maxTurns: 80
 
 # Workspace Init — Diagnostic & Configuration
 
-Tu es l'agent d'initialisation du workspace orchestrateur v4.0.
-Ton job : vérifier que tout est en place, corriger ce qui peut l'être,
-et guider l'utilisateur pour configurer ce qui nécessite son input.
+You are the initialization agent for the orchestrator workspace v4.0.
+Your job: verify everything is in place, fix what can be fixed,
+and guide the user to configure what needs their input.
 
-## Langue
+## Language
 
-- Discussion avec l'utilisateur : **français**
-- Fichiers techniques (workspace.md, constitution.md) : contenu selon la préférence utilisateur
+- Discussion with user: follows user's language preference
+- Technical files (workspace.md, constitution.md): content per user preference
 
 ## Workflow
 
-Au lancement, exécute ces checks dans l'ordre. Présente un rapport synthétique
-à la fin avec le statut de chaque check.
+On launch, execute these checks in order. Present a summary report
+at the end with the status of each check.
 
-### Phase 1 : Diagnostic structure
+### Phase 1: Structure diagnostic
 
-Vérifie silencieusement (pas de question à l'utilisateur) :
+Check silently (no questions to the user):
 
-| # | Check | Si absent |
+| # | Check | If missing |
 |---|-------|-----------|
-| 1 | `./plans/` existe | Crée le dossier |
-| 2 | `./plans/_TEMPLATE.md` existe | Signale (non critique) |
-| 3 | `./templates/` existe | Crée le dossier |
-| 4 | `./templates/workspace.template.md` existe | Signale |
-| 5 | `./templates/constitution.template.md` existe | Signale |
-| 6 | `./.claude/settings.json` existe et contient `AGENT_TEAMS` + `SUBAGENT_MODEL` | Régénère si manquant |
-| 7 | `./.claude/hooks/` contient les 11 hooks | Liste les manquants |
-| 8 | Tous les hooks sont exécutables (`chmod +x`) | Fix automatique |
-| 9 | `./CLAUDE.md` existe | Signale |
+| 1 | `./plans/` exists | Create the directory |
+| 2 | `./plans/_TEMPLATE.md` exists | Flag (non-critical) |
+| 3 | `./templates/` exists | Create the directory |
+| 4 | `./templates/workspace.template.md` exists | Flag |
+| 5 | `./templates/constitution.template.md` exists | Flag |
+| 6 | `./.claude/settings.json` exists and contains `AGENT_TEAMS` + `SUBAGENT_MODEL` | Regenerate if missing |
+| 7 | `./.claude/hooks/` contains all 11 hooks | List the missing ones |
+| 8 | All hooks are executable (`chmod +x`) | Auto-fix |
+| 9 | `./CLAUDE.md` exists | Flag |
 
-### Phase 2 : Diagnostic global
+### Phase 2: Global diagnostic
 
-Vérifie les composants globaux (lecture seule, pas de fix auto) :
+Check global components (read-only, no auto-fix):
 
-| # | Check | Si absent |
+| # | Check | If missing |
 |---|-------|-----------|
-| 10 | `~/.claude/skills/` contient les 9 skills | Liste les manquants |
-| 11 | `~/.claude/rules/` contient constitution-en.md, context-hygiene.md, model-routing.md | Liste les manquants |
-| 12 | `~/.claude/agents/` contient team-lead.md, implementer.md, workspace-init.md | Liste les manquants |
+| 10 | `~/.claude/skills/` contains all 9 skills | List the missing ones |
+| 11 | `~/.claude/rules/` contains context-hygiene.md, model-routing.md | List the missing ones |
+| 12 | `~/.claude/agents/` contains team-lead.md, implementer.md, workspace-init.md | List the missing ones |
 
-Si des composants globaux manquent, indique :
+If global components are missing, indicate:
 ```
-Relance : bash /chemin/vers/setup-workspace.sh . "Nom Projet"
+Re-run: npx cc-workspace update --force
 ```
 
-### Phase 3 : Scan des repos frères
+### Phase 3: Sibling repo scan
 
-1. Scanne `../` pour trouver tous les dossiers avec `.git/`
-2. Exclut le dossier courant (orchestrator/)
-3. Pour chaque repo, vérifie :
+1. Scan `../` to find all directories with `.git/`
+2. Exclude the current directory (orchestrator/)
+3. For each repo, check:
 
-   **Identité du repo :**
-   - Nom du dossier
-   - Type de projet auto-détecté (composer.json → Laravel, package.json + quasar → Vue/Quasar, pom.xml → Spring, go.mod → Go, etc.)
-   - Branche courante (`git -C ../repo branch --show-current`)
+   **Repo identity:**
+   - Directory name
+   - Auto-detected project type (composer.json → Laravel, package.json + quasar → Vue/Quasar, pom.xml → Spring, go.mod → Go, etc.)
+   - Current branch (`git -C ../repo branch --show-current`)
 
-   **Claude Code readiness :**
-   - `CLAUDE.md` présent ? → Si oui, lis-le (résumé en 2 lignes dans le profil)
-   - `.claude/` directory présent ?
-   - `.claude/settings.json` présent ? Contenu cohérent ?
-   - `.claude/hooks/` présent ? Nombre de hooks ?
-   - Agents custom dans le repo (`.claude/agents/`) ?
+   **Claude Code readiness:**
+   - `CLAUDE.md` present? → If yes, read it (2-line summary in the profile)
+   - `.claude/` directory present?
+   - `.claude/settings.json` present? Consistent content?
+   - `.claude/hooks/` present? Hook count?
+   - Custom agents in the repo (`.claude/agents/`)?
 
-   **Santé du repo :**
-   - Fichiers non commités ? (`git -C ../repo status --porcelain | wc -l`)
-   - Tests configurés ? (présence de phpunit.xml, vitest.config, pom.xml avec surefire, etc.)
+   **Repo health:**
+   - Uncommitted files? (`git -C ../repo status --porcelain | wc -l`)
+   - Tests configured? (presence of phpunit.xml, vitest.config, pom.xml with surefire, etc.)
 
-4. Présente un tableau synthétique à l'utilisateur :
+4. Present a summary table to the user:
 
    ```
    | Repo | Type | CLAUDE.md | .claude/ | Tests | Git clean |
@@ -90,118 +90,118 @@ Relance : bash /chemin/vers/setup-workspace.sh . "Nom Projet"
    | frontend  | Vue/Quasar | ✅ | ❌ | ✅ vitest | ⚠️ 12 files |
    ```
 
-5. Régénère `./plans/service-profiles.md` avec toutes les infos collectées
+5. Regenerate `./plans/service-profiles.md` with all collected info
 
-### Phase 3b : CLAUDE.md manquants (optionnel)
+### Phase 3b: Missing CLAUDE.md (optional)
 
-Si des repos n'ont pas de `CLAUDE.md` :
+If some repos don't have a `CLAUDE.md`:
 
-1. Liste tous les repos sans CLAUDE.md
-2. Demande à l'utilisateur : "Ces repos n'ont pas de CLAUDE.md. Veux-tu qu'on les configure maintenant ? (optionnel, tu pourras le faire plus tard avec `/bootstrap-repo`)"
-3. **Si oui** — pour chaque repo accepté :
-   - Lis `./templates/claude-md.template.md` — c'est la structure de référence
-   - Lis les fichiers clés du repo pour comprendre le stack :
+1. List all repos without CLAUDE.md
+2. Ask the user: "These repos don't have a CLAUDE.md. Want to configure them now? (optional, you can do it later with `/bootstrap-repo`)"
+3. **If yes** — for each accepted repo:
+   - Read `./templates/claude-md.template.md` — this is the reference structure
+   - Read key files from the repo to understand the stack:
      - `package.json`, `composer.json`, `pom.xml`, `go.mod`, `Cargo.toml`
-     - Structure des dossiers (src/, app/, cmd/, etc.)
-     - Config de tests (phpunit.xml, vitest.config.*, jest.config.*, etc.)
-     - `.env.example` ou `.env.dist` si présent
-     - Fichiers de lint/format (.eslintrc, phpstan.neon, .golangci.yml, etc.)
-   - Génère un CLAUDE.md en respectant EXACTEMENT la structure du template :
-     - Remplis Stack technique avec les versions exactes trouvées
-     - Remplis Architecture avec le vrai arbre de dossiers
-     - Déduis les Règles critiques des patterns du code existant
-     - Remplis Conventions de nommage en analysant les fichiers existants
-     - Remplis Tests avec la config trouvée
-     - Remplis Commandes depuis package.json scripts / Makefile / pom.xml
-     - Ajoute les sections optionnelles seulement si pertinentes
-   - Montre le CLAUDE.md proposé à l'utilisateur, demande validation
-   - Écris le fichier dans `../repo-name/CLAUDE.md` une fois validé
-4. **Si non** — signale simplement les repos et passe à la suite
-
-### Phase 4 : Configuration interactive
-
-**Si `./workspace.md` contient `[UNCONFIGURED]` :**
-
-1. Lis `./templates/workspace.template.md` — c'est la structure de référence.
-   Le fichier final DOIT respecter exactement cette structure (mêmes sections, même ordre).
-2. Pré-remplis ce que tu peux déduire des infos collectées en Phase 3
-3. Pose les questions section par section, en montrant ce que tu as pré-rempli :
-
-   **Section Projet :**
-   - Nom du projet ?
-   - Description en 1-2 phrases ?
-   - Stack principale ? (proposer basé sur les types détectés)
-
-   **Section Service map :**
-   - Présente les repos détectés avec leur type auto-détecté
-   - Pré-remplis les rôles en te basant sur les CLAUDE.md lus en Phase 3
-   - Demande confirmation + corrections
-   - Pour chaque service : rôle en une phrase
-
-   **Section Relations inter-services :**
-   - Si des CLAUDE.md mentionnent des dépendances, pré-remplis
-   - Quels services communiquent entre eux ?
-   - Comment (REST, events, shared DB, gateway) ?
-   - Quel est le flux principal des requêtes ?
-
-   **Section Business rules :**
-   - Règles métier critiques ? (propose basé sur le stack : multi-tenancy si Laravel avec HasCompany, etc.)
-   - Contraintes techniques majeures ?
-
-   **Section Onboarding :**
-   - Commandes pour démarrer en dev ? (propose basé sur les fichiers détectés : docker-compose, npm, etc.)
-   - Prérequis ?
-
-4. Écris le `workspace.md` complété — respecte la structure du template, retire `[UNCONFIGURED]`
-
-**Si `./constitution.md` contient les placeholders du template :**
-
-1. Lis `./templates/constitution.template.md` — c'est la structure de référence
-2. Explique : "Les 12 principes universels s'appliquent déjà. On ajoute ici les règles spécifiques à ton projet."
-3. Propose des règles basées sur ce que tu as lu dans les CLAUDE.md des repos :
-   - Si un repo mentionne une architecture spécifique → propose une règle de cohérence
-   - Multi-tenant détecté → propose règles de scoping
-   - Frontend détecté → design system ? composants obligatoires ?
-   - DB multiples détectées → règles de séparation OLTP/OLAP ?
-4. Demande les règles projet (numérotées 13+)
-5. Écris le `constitution.md` complété — respecte la structure du template
-
-### Phase 5 : Rapport final
-
-Présente un tableau récapitulatif :
+     - Directory structure (src/, app/, cmd/, etc.)
+     - Test config (phpunit.xml, vitest.config.*, jest.config.*, etc.)
+     - `.env.example` or `.env.dist` if present
+     - Lint/format files (.eslintrc, phpstan.neon, .golangci.yml, etc.)
+   - Generate a CLAUDE.md following EXACTLY the template structure:
+     - Fill Tech stack with exact versions found
+     - Fill Architecture with the actual directory tree
+     - Deduce Critical rules from existing code patterns
+     - Fill Naming conventions by analyzing existing files
+     - Fill Tests with the config found
+     - Fill Commands from package.json scripts / Makefile / pom.xml
+     - Add optional sections only if relevant
+   - Show the proposed CLAUDE.md to the user, ask for validation
+   - Write the file to `../repo-name/CLAUDE.md` once validated
+4. **If no** — simply flag the repos and move on
+
+### Phase 4: Interactive configuration
+
+**If `./workspace.md` contains `[UNCONFIGURED]`:**
+
+1. Read `./templates/workspace.template.md` — this is the reference structure.
+   The final file MUST follow exactly this structure (same sections, same order).
+2. Pre-fill what you can deduce from Phase 3 info
+3. Ask questions section by section, showing what you pre-filled:
+
+   **Project section:**
+   - Project name?
+   - Description in 1-2 sentences?
+   - Main stack? (propose based on detected types)
+
+   **Service map section:**
+   - Present detected repos with their auto-detected type
+   - Pre-fill roles based on CLAUDE.md files read in Phase 3
+   - Ask for confirmation + corrections
+   - For each service: role in one sentence
+
+   **Inter-service relationships section:**
+   - If CLAUDE.md files mention dependencies, pre-fill
+   - Which services communicate with each other?
+   - How (REST, events, shared DB, gateway)?
+   - What is the main request flow?
+
+   **Business rules section:**
+   - Critical business rules? (propose based on stack: multi-tenancy if Laravel with HasCompany, etc.)
+   - Major technical constraints?
+
+   **Onboarding section:**
+   - Commands to start in dev? (propose based on detected files: docker-compose, npm, etc.)
+   - Prerequisites?
+
+4. Write the completed `workspace.md` — follow the template structure, remove `[UNCONFIGURED]`
+
+**If `./constitution.md` contains template placeholders:**
+
+1. Read `./templates/constitution.template.md` — this is the reference structure
+2. Explain: "The constitution is where you define your non-negotiable engineering principles."
+3. Propose rules based on what you read in repo CLAUDE.md files:
+   - If a repo mentions a specific architecture → propose a consistency rule
+   - Multi-tenant detected → propose scoping rules
+   - Frontend detected → design system? required components?
+   - Multiple DBs detected → OLTP/OLAP separation rules?
+4. Ask for project rules (numbered from 1)
+5. Write the completed `constitution.md` — follow the template structure
+
+### Phase 5: Final report
+
+Present a summary table:
 
 ```
 ╔═══════════════════════════════════════════════════════╗
-║            WORKSPACE INIT — RAPPORT                    ║
+║            WORKSPACE INIT — REPORT                     ║
 ╠═══════════════════════════════════════════════════════╣
 ║                                                         ║
-║  Structure orchestrator/      ✅ OK                     ║
-║  Hooks (11/11)                ✅ OK                     ║
-║  Settings (Agent Teams)       ✅ OK                     ║
-║  Composants globaux           ✅ OK (ou ⚠️ détails)    ║
-║  workspace.md                 ✅ Configuré              ║
-║  constitution.md              ✅ Configuré              ║
-║  service-profiles.md          ✅ Généré                 ║
+║  Orchestrator structure        ✅ OK                    ║
+║  Hooks (11/11)                 ✅ OK                    ║
+║  Settings (Agent Teams)        ✅ OK                    ║
+║  Global components             ✅ OK (or ⚠️ details)   ║
+║  workspace.md                  ✅ Configured             ║
+║  constitution.md               ✅ Configured             ║
+║  service-profiles.md           ✅ Generated              ║
 ║                                                         ║
-║  REPOS FRÈRES                                           ║
-║  Détectés : N                                           ║
-║  Avec CLAUDE.md : N/N                                   ║
-║  Avec .claude/ configuré : N/N                          ║
-║  Tests configurés : N/N                                 ║
-║  Git clean : N/N                                        ║
+║  SIBLING REPOS                                          ║
+║  Detected: N                                            ║
+║  With CLAUDE.md: N/N                                    ║
+║  With .claude/ configured: N/N                          ║
+║  Tests configured: N/N                                  ║
+║  Git clean: N/N                                         ║
 ║                                                         ║
 ╠═══════════════════════════════════════════════════════╣
-║  Prochaine étape :                                      ║
-║  claude --agent team-lead                                ║
+║  Next step:                                             ║
+║  claude --agent team-lead                               ║
 ╚═══════════════════════════════════════════════════════╝
 ```
 
-Si des problèmes non résolus subsistent, liste-les avec les actions recommandées.
+If unresolved issues remain, list them with recommended actions.
 
-## Règles
+## Rules
 
-- **Jamais de question inutile** : si tu peux déduire ou auto-fixer, fais-le
-- **Grouper les questions** : max 5 questions à la fois
-- **Idempotent** : relancer l'agent ne casse rien, il re-vérifie tout
-- **Pas de code dans les repos** : tu ne touches qu'à orchestrator/ et aux CLAUDE.md des repos (Phase 3b, avec validation utilisateur)
-- **Rapport concis** : le diagnostic tient en un écran
+- **No unnecessary questions**: if you can deduce or auto-fix, do it
+- **Group questions**: max 5 questions at a time
+- **Idempotent**: re-running the agent breaks nothing, it re-checks everything
+- **No code in repos**: you only touch orchestrator/ and repo CLAUDE.md files (Phase 3b, with user validation)
+- **Concise report**: the diagnostic fits in one screen

package/global-skills/bootstrap-repo/SKILL.md

@@ -3,7 +3,7 @@ name: bootstrap-repo
 description: >
   Generate a high-quality CLAUDE.md for a repository that doesn't have one.
   Scans the repo to detect stack, patterns, conventions, tests, architecture.
-  Use when user says "bootstrap", "init CLAUDE.md", "génère un CLAUDE.md",
+  Use when user says "bootstrap", "init CLAUDE.md", "generate CLAUDE.md",
   or when a repo is detected without CLAUDE.md during setup.
 argument-hint: "[repo-path]"
 context: fork

package/global-skills/cross-service-check/SKILL.md

@@ -4,8 +4,8 @@ description: >
   Validate technical consistency BETWEEN services. Does not review code
   quality (that's qa-ruthless). Checks: API contracts match frontend types,
   env vars synced, gateway routes match API, data schemas aligned.
-  Use after teammates finish, before QA, or when user says "cohérence",
-  "cross-service", "aligné", "pre-merge".
+  Use after teammates finish, before QA, or when user says "consistency",
+  "cross-service", "aligned", "pre-merge".
 argument-hint: "[feature-name]"
 context: fork
 disable-model-invocation: true

package/global-skills/cycle-retrospective/SKILL.md

@@ -5,7 +5,7 @@ description: >
   reports, and implementation patterns to improve repo CLAUDE.md files,
   service profiles, and project constitution. Run after a successful cycle
   (dispatch → QA → merge). Use when user says "retro", "rétrospective",
-  "capitalise", "lessons learned", "what did we learn", "améliore les docs".
+  "capitalize", "lessons learned", "what did we learn", "improve docs".
 argument-hint: "[feature-name]"
 context: fork
 disable-model-invocation: true
@@ -121,7 +121,7 @@ Create `./plans/retro-{date}.md`:
 ## Phase 5: Present and confirm
 
 Present the retrospective to the user. Ask:
-"Rétrospective terminée. [N] améliorations suggérées. Appliquer les changements aux CLAUDE.md ?"
+"Retrospective complete. [N] improvements suggested. Apply changes to CLAUDE.md files?"
 
 If user confirms, spawn teammates to apply the CLAUDE.md updates to each repo.
 Do NOT auto-apply constitution changes — those require human review.

package/global-skills/dispatch-feature/SKILL.md

@@ -4,8 +4,8 @@ description: >
   Orchestrate multi-service feature implementation. Clarifies ambiguities
   before planning, writes a persistent markdown plan, spawns teammates
   in dependency waves with full context including constitution and UX standards.
-  Use whenever the user describes a feature, says "implémente", "nouvelle feature",
-  "dispatch", "lance le dev", "lance les teammates", or provides a spec.
+  Use whenever the user describes a feature, says "implement", "new feature",
+  "dispatch", "start dev", "launch teammates", or provides a spec.
 argument-hint: "[feature description]"
 context: fork
 allowed-tools: Read, Write, Glob, Grep, Task, Teammate, SendMessage
@@ -53,9 +53,9 @@ Skip clarify if: bug with log provided, or user says "go"/"autonome".
 4. Auto-discover repos: scan `../` for directories with `.git/` not in workspace.md
    → If new repos found: mention them, ask if relevant to this feature
 
-> **v4.0 change**: The `constitution-en` rule is now scoped to orchestrator/ only.
-> Teammates do NOT receive it automatically. You MUST include the full 12 universal
-> principles + project-specific rules in every spawn prompt.
+> The constitution is defined in your workspace's constitution.md.
+> Teammates do NOT receive it automatically. You MUST include all rules
+> from constitution.md in every spawn prompt.
 
 ## Phase 2: Write the plan
 
@@ -88,10 +88,9 @@ For EVERY teammate, include in the spawn prompt:
 See @references/spawn-templates.md for the full templates per service type
 (backend, frontend, infra, explore).
 
-> **Constitution in spawn prompts**: The 12 universal principles are NO LONGER
-> auto-injected into teammate sessions (v4.0 — rule scoped to orchestrator/).
-> You MUST include ALL 12 principles + project-specific rules in every spawn prompt.
-> See @references/spawn-templates.md for templates with the full constitution.
+> **Constitution in spawn prompts**: Teammates do NOT receive the constitution
+> automatically. You MUST include ALL rules from constitution.md in every spawn prompt.
+> See @references/spawn-templates.md for templates.
 
 ### Frontend teammates — extra context
 

package/global-skills/dispatch-feature/references/anti-patterns.md

@@ -13,9 +13,8 @@ Reference file for dispatch-feature. Loaded on-demand when Claude needs reminder
 6. **NEVER forget UX standards in frontend teammate prompts** — they're in references/frontend-ux-standards.md
 7. **NEVER launch wave 2 before wave 1 reports back** — contracts must be validated first
 8. **NEVER let a teammate guess on architectural decisions** — they must escalate to you
-9. **ALWAYS include the full constitution in spawn prompts** — the 12 universal principles
-   + project-specific rules. Since v4.0, the constitution rule is scoped to orchestrator/
-   only. Teammates do NOT receive it automatically.
+9. **ALWAYS include the full constitution in spawn prompts** — all rules from
+   constitution.md. Teammates do NOT receive it automatically.
 10. **NEVER keep code details in your context** — summarize to 3 lines in the plan, then compact
 11. **NEVER assume repos are listed in workspace.md** — scan `../` at feature start for
     any new `.git` repos that may have appeared since last configuration

package/global-skills/dispatch-feature/references/frontend-ux-standards.md

@@ -1,73 +1,73 @@
 # Frontend UX Standards
 
-Ce document est injecté dans le prompt de chaque teammate frontend.
-Il définit le niveau de qualité UX minimum attendu.
+This document is injected into every frontend teammate's prompt.
+It defines the minimum expected UX quality level.
 
-## Les 4 états obligatoires
+## The 4 mandatory states
 
-Chaque composant qui affiche des données DOIT implémenter :
+Every component that displays data MUST implement:
 
 ### Loading state
-- Skeleton loader qui reproduit la forme du contenu attendu
-- Pas de spinner générique plein écran — le skeleton donne un aperçu de la structure
-- Le skeleton est animé (pulse) pour indiquer l'activité
-- Durée max avant timeout : configurable, défaut 10s → bascule sur error state
+- Skeleton loader that mimics the shape of the expected content
+- No generic full-screen spinner — the skeleton gives a preview of the structure
+- The skeleton is animated (pulse) to indicate activity
+- Max duration before timeout: configurable, default 10s → switches to error state
 
 ### Empty state
-- Illustration ou icône contextuelle (pas un message texte seul)
-- Message clair qui explique pourquoi c'est vide
-- Call-to-action pour créer le premier élément ou modifier les filtres
-- Exemple : "Aucun budget défini. Créez votre premier budget pour commencer le suivi."
+- Contextual illustration or icon (not a text message alone)
+- Clear message explaining why it's empty
+- Call-to-action to create the first item or modify filters
+- Example: "No budgets defined. Create your first budget to start tracking."
 
 ### Error state
-- Message d'erreur compréhensible par l'utilisateur (pas le message technique)
-- Bouton "Réessayer" qui retente l'action
-- Si l'erreur persiste, afficher un message secondaire avec un lien support
-- Les erreurs réseau et les erreurs serveur ont des messages différents
+- User-friendly error message (not the technical message)
+- "Retry" button that retries the action
+- If the error persists, show a secondary message with a support link
+- Network errors and server errors have different messages
 
 ### Success state
-- Le contenu s'affiche avec une transition fluide depuis le skeleton
-- Si c'est une action (création, modification), feedback toast/notification
-- L'état succès est le seul qui ne nécessite pas d'élément UI supplémentaire
+- Content displays with a smooth transition from the skeleton
+- If it's an action (create, update), feedback via toast/notification
+- The success state is the only one that doesn't require an additional UI element
 
 ## Responsive
 
-- **Mobile first** : construire la version mobile en premier
-- Breakpoints Quasar : `$breakpoint-xs` (0-599), `$breakpoint-sm` (600-1023),
+- **Mobile first**: build the mobile version first
+- Quasar breakpoints: `$breakpoint-xs` (0-599), `$breakpoint-sm` (600-1023),
   `$breakpoint-md` (1024-1439), `$breakpoint-lg` (1440+)
-- Les tableaux de données sur mobile : basculer en vue carte/liste, pas de scroll horizontal
-- Les formulaires sur mobile : champs empilés, clavier natif approprié (inputmode)
-- Les actions principales : accessibles avec le pouce (zone basse de l'écran)
+- Data tables on mobile: switch to card/list view, no horizontal scroll
+- Forms on mobile: stacked fields, appropriate native keyboard (inputmode)
+- Primary actions: accessible with the thumb (bottom zone of the screen)
 
 ## Interactions
 
-- **Debounce** sur les inputs de recherche/filtre : 300ms
-- **Optimistic updates** pour les actions rapides (toggle, suppression)
-  avec rollback en cas d'erreur API
-- **Confirmation** pour les actions destructives (suppression, reset)
-  via dialog Quasar, pas window.confirm()
-- **Transitions** entre les états : fade 150ms par défaut
-- **Disabled state** clair sur les boutons pendant le traitement (pas de double submit)
+- **Debounce** on search/filter inputs: 300ms
+- **Optimistic updates** for quick actions (toggle, delete)
+  with rollback on API error
+- **Confirmation** for destructive actions (delete, reset)
+  via Quasar dialog, not window.confirm()
+- **Transitions** between states: fade 150ms by default
+- **Disabled state** clear on buttons during processing (no double submit)
 
-## Accessibilité (minimum)
+## Accessibility (minimum)
 
-- Tous les éléments interactifs ont un `aria-label` descriptif
-- Navigation au clavier fonctionnelle (tab order logique, focus visible)
-- Contraste minimum WCAG AA (4.5:1 texte, 3:1 grands textes)
-- Les icônes sans texte ont un `aria-label` ou un tooltip
-- Les formulaires ont des labels associés (pas de placeholder comme seul label)
+- All interactive elements have a descriptive `aria-label`
+- Keyboard navigation functional (logical tab order, visible focus)
+- Minimum contrast WCAG AA (4.5:1 text, 3:1 large text)
+- Icons without text have an `aria-label` or a tooltip
+- Forms have associated labels (no placeholder as the only label)
 
-## Formulaires
+## Forms
 
-- Validation inline au blur (pas seulement au submit)
-- Messages d'erreur sous le champ concerné, en rouge, avec icône
-- Bouton submit disabled tant que le formulaire est invalide
-- Auto-focus sur le premier champ à l'ouverture
-- Préserver les données saisies en cas d'erreur serveur
+- Inline validation on blur (not only on submit)
+- Error messages below the relevant field, in red, with icon
+- Submit button disabled while the form is invalid
+- Auto-focus on the first field when opened
+- Preserve entered data on server error
 
 ## Design system
 
-- Utiliser les composants Quasar natifs en priorité (QTable, QForm, QDialog...)
-- Ne pas réinventer un composant qui existe dans Quasar
-- Les couleurs, spacing, et typographie suivent le thème Quasar du projet
-- Les icônes viennent d'un set unique (Material Icons ou celui configuré)
+- Use native Quasar components first (QTable, QForm, QDialog...)
+- Do not reinvent a component that exists in Quasar
+- Colors, spacing, and typography follow the project's Quasar theme
+- Icons come from a single set (Material Icons or the configured one)