@agent-native/core 0.77.3 → 0.77.6

package/docs/content/locales/fr-FR/template-videos.md

@@ -10,7 +10,7 @@ Un studio vidéo programmatique pour le type d'animations graphiques, de démons
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Logo reveal</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>Remotion preview</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>New track</button></div><div class='wf-box'>Title fade · 0-48 frames</div><div class='wf-box'>Logo scale · 48-120 frames</div><div class='wf-box'>Camera push · 72-144 frames</div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Révélation du logo</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>Aperçu Remotion</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>Nouvelle piste</button></div><div class='wf-box'>Fondu du titre · images 0-48</div><div class='wf-box'>Échelle du logo · images 48-120</div><div class='wf-box'>Travelling caméra · images 72-144</div></div></div>"
 }
 ```
 
@@ -18,7 +18,7 @@ Lorsque vous ouvrez le studio, vous verrez une liste de compositions sur l'écra
 
 ```an-diagram title="Animation en tant que données" summary="Une composition est un composant React ; chaque animation lit une piste afin que l'agent et la chronologie éditent les mêmes données."
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">drag, resize, scrub</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>React composition<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">glisser, redimensionner, parcourir</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Composition React<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -99,7 +99,7 @@ Sous le capot, l'agent appelle actions comme `navigate`, `save-composition` et `
 
 Le schéma côté serveur est dans `templates/videos/server/db/schema.ts` :
 
-```an-schema title="Video data model" summary="SQL-backed compositions plus design systems and nestable folders, each with a framework shares table."
+```an-schema title="Modèle de données vidéo" summary="Compositions adossées à SQL, ainsi que des systèmes de conception et des dossiers imbriqués, chacun avec une table de partage de cadre."
 {
   "entities": [
     {
@@ -110,7 +110,7 @@ Le schéma côté serveur est dans `templates/videos/server/db/schema.ts` :
         { "name": "id", "type": "text", "pk": true },
         { "name": "title", "type": "text" },
         { "name": "type", "type": "text" },
-        { "name": "data", "type": "text", "note": "Full composition JSON blob" },
+        { "name": "data", "type": "text", "note": "Composition complète JSON blob" },
         { "name": "created_at", "type": "text" },
         { "name": "updated_at", "type": "text" }
       ]
@@ -138,7 +138,7 @@ Le schéma côté serveur est dans `templates/videos/server/db/schema.ts` :
     {
       "id": "folder_memberships",
       "name": "folder_memberships",
-      "note": "Many-to-many join",
+      "note": "Plusieurs à plusieurs se joignent",
       "fields": [
         { "name": "folder_id", "type": "text", "fk": "folders.id" },
         { "name": "composition_id", "type": "text", "fk": "compositions.id" }

package/docs/content/locales/fr-FR/tracking.md

@@ -21,7 +21,7 @@ track(
 
 ```an-diagram title="Un appel track(), chaque fournisseur" summary="Les appelants du serveur et du client accèdent au même registre, qui diffuse chaque événement en parallèle à tous les fournisseurs actifs."
 {
-  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Server code<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Browser code<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
+  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Code serveur<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Code navigateur<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, lancer sans attendre</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
   "css": ".trk{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.trk .diagram-col{display:flex;flex-direction:column;gap:8px}.trk .diagram-arrow{font-size:22px;line-height:1}.trk .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -102,11 +102,11 @@ Les appels de suivi sont déclenchés et oubliés : ils reviennent immédiateme
 
 `track()` fonctionne également à partir du code du navigateur/de l'application. Importez le jumeau client de `@agent-native/core/client` et appelez-le de la même manière : il POST l'événement sur la route du framework sur `POST /_agent-native/track`, qui le transmet aux **mêmes** fournisseurs côté serveur enregistrés (PostHog, Mixpanel, Amplitude, webhook). Aucune analyse SDK n'est envoyée au navigateur et aucune clé de fournisseur n'est exposée côté client.
 
-```an-api title="The client tracking route"
+```an-api title="Le parcours de suivi des clients"
 {
   "method": "POST",
   "path": "/_agent-native/track",
-  "summary": "Forward a browser event to the registered server-side providers",
+  "summary": "Transférer un événement de navigateur aux fournisseurs côté serveur enregistrés",
   "auth": "Session required + same-origin/CSRF marker (set automatically by the client helper). Not an open analytics relay.",
   "params": [
     { "name": "name", "in": "body", "type": "string", "required": true, "description": "Event name. Capped at 200 characters." },

package/docs/content/locales/fr-FR/using-your-agent.md

@@ -1,17 +1,17 @@
 ---
 title: "Utiliser votre agent"
-description: "La boucle quotidienne du travail avec l'agent : il voit ce que vous regardez, vous le dirigez, l'intégrez, passez à UI-light et co-éditez à côté de lui."
+description: "La boucle quotidienne du travail avec l'agent : il voit ce que vous regardez, vous le dirigez, l'intégrez, passez à UI légère et co-éditez à côté de lui."
 ---
 
 # Utiliser votre agent
 
 L'idée déterminante derrière l'agent natif est que l'agent et le UI sont des **partenaires égaux** — voir [What Is Agent-Native?](/docs/what-is-agent-native) pour le pourquoi. Cette section concerne l'autre moitié de cette promesse : ce que l'on ressent en travaillant réellement avec l'agent une fois qu'il est ancré à côté de votre application.
 
-Il existe une ligne directe simple. L'agent **voit** ce que vous regardez, vous le **dirigez** vers ce que vous voulez, vous pouvez l'**intégrer** n'importe où, vous pouvez devenir entièrement **UI-light** lorsque cela vous convient le mieux, et vous pouvez **co-éditer** les mêmes documents en même temps. Chacun d'entre eux est une page de cette section.
+Il existe une ligne directe simple. L'agent **voit** ce que vous regardez, vous le **dirigez** vers ce que vous voulez, vous pouvez l'**intégrer** n'importe où, vous pouvez devenir entièrement **UI légère** lorsque cela vous convient le mieux, et vous pouvez **co-éditer** les mêmes documents en même temps. Chacun d'entre eux est une page de cette section.
 
 ```an-diagram title="La boucle du quotidien" summary="Cinq façons de travailler avec un agent ancré — chacune constitue une page de cette section."
 {
-  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI-light</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Co-edit</span><small class=\"diagram-muted\">live, side by side</small></div></div>",
+  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI légère</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Coéditer</span><small class=\"diagram-muted\">en direct, côte à côte</small></div></div>",
   "css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
 }
 ```
@@ -49,7 +49,7 @@ L'agent n'est pas une application distincte vers laquelle vous accédez. Il est
 → [**Drop-in Agent**](/docs/drop-in-agent) : montez les `<AgentPanel>`, `<AgentSidebar>` et `sendToAgentChat()` dans n'importe quelle application React.
 → [**Agent Surfaces**](/docs/agent-surfaces) : choisissez si le flux de travail doit être sans tête, axé d'abord sur le chat, intégré ou une application complète.
 
-## Vous pouvez passer au UI-light {#ui-light}
+## Vous pouvez passer au UI légère {#ui-light}
 
 Toutes les applications n'ont pas besoin d'un tableau de bord complet. Lorsque l'agent _est_ le produit, vous pouvez ignorer la plupart des UI personnalisés : ouvrez l'application, demandez ce que vous voulez et laissez l'agent faire le reste. L'agent dispose toujours de sa surface de gestion (historique, espace de travail, paramètres), mais l'interaction principale est la conversation plutôt que les clics.
 
@@ -67,5 +67,5 @@ Lorsque vous et l'agent travaillez sur le même document, vous ne vous relayez p
 - [**Agent Mentions**](/docs/agent-mentions) — dirigez-le avec les mentions `@`
 - [**Voice Input**](/docs/voice-input) — dirigez-le en parlant
 - [**Drop-in Agent**](/docs/drop-in-agent) : intégrez-le dans n'importe quelle application React
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) — passez à UI-light lorsque l'agent est le produit
+- [**Pure-Agent Apps**](/docs/pure-agent-apps) — passez à UI légère lorsque l'agent est le produit
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — co-éditez ensemble le même document

package/docs/content/locales/fr-FR/voice-input.md

@@ -21,7 +21,7 @@ Le choix du fournisseur est stocké dans l'état de l'application sous `voice-tr
 
 ```an-diagram title="Solution de secours du fournisseur de transcription vocale" summary="Le compositeur enregistre l'audio, puis parcourt les fournisseurs de serveur dans l'ordre, en passant au navigateur Web Speech API uniquement lorsqu'aucun fournisseur de serveur n'est disponible."
 {
-  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Mic button<br><small class=\"diagram-muted\">records webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">default when Builder connected</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
+  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Bouton micro<br><small class=\"diagram-muted\">enregistre en webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">par défaut quand Builder est connecté</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
   "css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -43,17 +43,17 @@ Définissez `GEMINI_API_KEY`, `GROQ_API_KEY` ou `OPENAI_API_KEY` en tant que var
 ```an-callout
 {
   "tone": "info",
-  "body": "**Credential resolution order:** the route checks the user's own encrypted secret first, then the shared deployment key. A power user with their own key always overrides the shared one. If neither exists, the route returns a 400 the composer recognizes and silently falls back to browser Web Speech."
+  "body": "**Ordre de résolution des informations d'identification :** la route vérifie d'abord le secret chiffré de l'utilisateur, puis la clé de déploiement partagée. Un utilisateur expérimenté disposant de sa propre clé remplace toujours celle partagée. Si aucun des deux n'existe, la route renvoie un 400 que le compositeur reconnaît et revient silencieusement au navigateur Web Speech."
 }
 ```
 
 ## L'itinéraire {#route}
 
-```an-api title="Voice transcription route"
+```an-api title="Parcours de transcription vocale"
 {
   "method": "POST",
   "path": "/_agent-native/transcribe-voice",
-  "summary": "Transcribe a recorded audio clip into prompt text",
+  "summary": "Transcrire un clip audio enregistré en texte d'invite",
   "auth": "Active session (Better Auth cookie). Same-origin only.",
   "description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
   "params": [

package/docs/content/locales/fr-FR/what-is-agent-native.md

@@ -26,13 +26,13 @@ C'est l'expérience pour laquelle l'agent natif est conçu. Voici maintenant pou
 
 La plupart des équipes montent une progression, un peu comme une échelle, et la plupart arrêtent un échelon trop tôt.
 
-### Rung 1 – un seul appel LLM (l'anti-modèle) {#rung-one}
+### Échelon 1 – un seul appel LLM (l'anti-modèle) {#rung-one}
 
 Une zone de texte envoie une invite, l'IA renvoie une chaîne et vous l'affichez. Peut-être avec une roulette. Il n'y a aucun moyen pour l'utilisateur de corriger sa trajectoire, aucun moyen pour l'IA d'agir, aucun moyen de voir ce qui s'est passé ou pourquoi.
 
 Vous voyez cela partout : des "fonctionnalités IA" qui sont essentiellement un bouton "Résumer" intégré à un produit SaaS. Ils ont l’air impressionnants dans les démos et brisent dès que la réalité devient compliquée. Ce n'est pas un produit ; c'est un jouet.
 
-### Rung 2 : une conversation avec des outils {#rung-two}
+### Échelon 2 : une conversation avec des outils {#rung-two}
 
 Maintenant, l'IA peut _faire des choses_. Il dispose d'outils — « brouillon d'e-mail », « rechercher des contacts », « exécuter une requête » — et d'une interface de discussion où il fonctionne devant vous, affichant les appels et les résultats des outils au fur et à mesure. Voici à quoi ressemblent les Claude, ChatGPT et Cursor sous le capot.
 
@@ -52,7 +52,7 @@ Il s'agit de l'échelon 3. Il s'agit d'un agent natif.
 
 ```an-diagram title="Le principe de l'échelle" summary="La plupart des équipes s'arrêtent au niveau 1 ou 2. L'agent natif est le niveau 3 : une véritable application et un véritable agent sur une surface d'action partagée."
 {
-  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Échelon 3 · agent-native</span><strong>Agent + UI comme partenaires égaux</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Échelon 2</span><strong>Un chat avec des outils</strong><small class=\"diagram-muted\">L’agent peut agir, mais ce n’est encore qu’une fenêtre de chat. Pas de tableaux de bord, listes ou raccourcis.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Échelon 1</span><strong>Un seul appel LLM</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
   "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
 }
 ```
@@ -91,7 +91,7 @@ C'est le principe déterminant.
 
 ```an-diagram title="Un système, deux façons d'entrer" summary="L'agent et l'interface utilisateur écrivent dans les mêmes actions et dans la même base de données. Quoi que l’un fasse, l’autre le voit."
 {
-  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">base de données SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clics, formulaires, raccourcis</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">langage naturel · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">base de données SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">L’UI se met à jour en direct</div></div>",
   "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ Si vous créez ou étendez une application native d'agent, voici le modèle cent
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "5", "label": "Surface de l'outil", "note": "`description` est ce que l'agent lit pour décider quand l'appeler comme outil." },
     { "lines": "6", "label": "Contrat typé", "note": "Un zod `schema` valide les entrées de **chaque** surface — agent, UI, HTTP, MCP et A2A." },
-    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+    { "lines": "7-10", "label": "Une mise en œuvre", "note": "Le corps `run` est la seule source de vérité. Le bouton de l'interface utilisateur et l'outil d'agent exécutent tous deux exactement cela." }
   ]
 }
 ```

package/docs/content/locales/fr-FR/workspace-connections.md

@@ -18,7 +18,7 @@ Les connexions à l'espace de travail constituent la primitive de structure pour
 
 ```an-diagram title="Connectez-vous une fois, accordez des applications, réutilisez les informations d'identification" summary="Une connexion contient des métadonnées de fournisseur (jamais de secrets) et des informations d'identification qui pointent vers le coffre-fort. Les subventions par application le débloquent. Les applications lisent un seul état de préparation."
 {
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, status, scopes, config &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
+  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, statut, périmètres, configuration &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
   "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
 }
 ```
@@ -58,32 +58,32 @@ await upsertWorkspaceConnectionGrant({
 });
 ```
 
-```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+```an-schema title="Le modèle de connexion" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
 {
   "entities": [
     {
       "id": "conn",
       "name": "workspace_connections",
-      "note": "Named provider account. Never stores secret values.",
+      "note": "Compte de fournisseur nommé. Ne stocke jamais de valeurs secrètes.",
       "fields": [
         { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
-        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "provider", "type": "string", "note": "identifiant de fournisseur stable, par ex. mou" },
         { "name": "label", "type": "string" },
         { "name": "accountId", "type": "string", "nullable": true },
         { "name": "accountLabel", "type": "string", "nullable": true },
         { "name": "status", "type": "string", "note": "e.g. connected" },
         { "name": "scopes", "type": "string[]", "nullable": true },
-        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "config", "type": "json", "nullable": true, "note": "configuration sûre et non secrète" },
         { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
       ]
     },
     {
       "id": "grant",
       "name": "workspace_connection_grants",
-      "note": "Per-app permission to use a connection.",
+      "note": "Autorisation par application d'utiliser une connexion.",
       "fields": [
         { "name": "connectionId", "type": "string", "fk": "conn.id" },
-        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+        { "name": "appId", "type": "string", "note": "par ex. cerveau, analytique" }
       ]
     }
   ],
@@ -208,7 +208,7 @@ Réponses des métadonnées du fournisseur de connexion Workspace : "De quel fo
 
 ```an-diagram title="Magasin de connexions et coffre-fort" summary="Le coffre-fort possède la valeur secrète. La connexion possède les métadonnées du fournisseur ainsi que les credentialRefs (pointeurs). Au moment de l'exécution, l'application résout la référence via une connexion accordée et lit la valeur dans le coffre-fort."
 {
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">App action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">never returned to the agent or UI</small></div></div></div>",
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Store de connexions</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">statut, périmètres, configuration</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Action d’app</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">jamais renvoyé à l’agent ou à l’UI</small></div></div></div>",
   "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/fr-FR/workspace-management.md

@@ -11,7 +11,7 @@ Ce guide couvre l'aspect opérationnel de l'exécution d'un espace de travail na
 
 ```an-diagram title="Deux plans de gouvernance" summary="Git régit le code ; Dispatch régit l'exécution. Ils sont complémentaires : ne se reproduisent pas l’un dans l’autre."
 {
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git / GitHub</span><strong>Code governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR review</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
+  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git et GitHub</span><strong>Gouvernance du code</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">Revue de PR</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
   "css": ".gov{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.gov .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.gov .gov-list{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}"
 }
 ```
@@ -64,16 +64,16 @@ Le fichier CODEOWNERS de GitHub attribue automatiquement les réviseurs aux PR e
 # Framework core — affects every app; platform team reviews all changes
 packages/core/                     @your-org/platform-team
 
-# Dispatch control plane — secrets, integrations, workspace resources
+# Plan de contrôle Dispatch — secrets, intégrations, ressources de l'espace de travail
 templates/dispatch/                @your-org/platform-team
 
-# Per-app ownership — each team reviews their own app
+# Propriété par application : chaque équipe examine sa propre application
 templates/mail/                    @your-org/mail-team
 templates/analytics/               @your-org/analytics-team
 templates/calendar/                @your-org/calendar-team
 # ... add an entry per app
 
-# Workspace-level config — broad review since it affects everyone
+# Configuration au niveau de l'espace de travail – examen approfondi car cela affecte tout le monde
 .github/                           @your-org/platform-team
 package.json                       @your-org/platform-team
 pnpm-workspace.yaml                @your-org/platform-team
@@ -132,7 +132,7 @@ Lors de l'examen des PR dans cet environnement :
 
 L'application [Dispatch](/docs/dispatch) est le plan de contrôle d'exécution de l'espace de travail. Il complète la gouvernance au niveau Git avec la gouvernance d'exécution :
 
-| Inquiétudes                               | Git / GitHub                        | Expédition                                                                 |
+| Inquiétudes                               | Git et GitHub                       | Expédition                                                                 |
 | ----------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------- |
 | Qui peut modifier le code                 | CODEOWNERS, protection des branches | —                                                                          |
 | Qui peut accéder aux secrets              | —                                   | Règle de Vault, subventions, workflow de demande                           |

package/docs/content/locales/fr-FR/workspace.md

@@ -13,7 +13,7 @@ Le twist : **il s'agit de lignes SQL, pas de fichiers du système de fichiers.*
 
 ```an-diagram title="Un espace de travail Claude-Code, mais stocké dans SQL" summary="La même couche de personnalisation (instructions, compétences, mémoire, agents, tâches, MCP) sauf que chaque fichier est une ligne dans une base de données mutualisée partagée."
 {
-  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native workspace</span><small class=\"diagram-muted\">rows in one base de données SQL</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">one codebase, many users, scoped <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
+  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Espace de travail agent-native</span><small class=\"diagram-muted\">rows in one base de données SQL</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">une base de code, plusieurs utilisateurs, avec périmètres <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
   "css": ".ws-map{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ws-map .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:220px}.ws-map .ws-files,.ws-map .ws-rows{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0}.ws-map .diagram-arrow{font-size:24px}"
 }
 ```
@@ -53,7 +53,7 @@ Ces chemins s'appliquent aux trois étendues : espace de travail, organisation
 
 ```an-diagram title="Trois scopes, un fichier efficace" summary="Le runtime résout le même chemin dans l’espace de travail, l’application et les étendues personnelles en lecture : l’étendue la plus spécifique l’emporte."
 {
-  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">company-wide defaults from Dispatch</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Organization / app</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
+  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">valeurs par défaut d’entreprise depuis Dispatch</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Organisation / application</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
   "css": ".ws-stack{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.ws-stack .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px;min-width:280px}.ws-stack .diagram-arrow{font-size:20px;align-self:center}.ws-stack code{font-size:.85em}.ws-stack .diagram-box{align-self:center;margin-top:4px}"
 }
 ```
@@ -74,7 +74,7 @@ Modifiez le comportement de l'agent en 60 secondes.
 3. Enregistrez, passez à **Chat**, demandez n'importe quoi : l'agent suit immédiatement la nouvelle règle.
 
 ```an-callout
-{ "tone": "info", "body": "No restart, no redeploy. `AGENTS.md` is read at the start of every turn, so an edit you save now changes the agent's behavior on the very next message." }
+{ "tone": "info", "body": "Pas de redémarrage, pas de redéploiement. `AGENTS.md` est lu au début de chaque tour, donc une modification que vous enregistrez modifie désormais le comportement de l'agent au message suivant." }
 ```
 
 **Prochaines étapes, quand vous le souhaitez :**
@@ -96,10 +96,10 @@ Le chemin détermine la manière dont l'agent utilise une ressource (voir le tab
 Un pack de démarrage utile pour un nouvel espace de travail :
 
 ```text
-context/company.md              # what the company does, ICP, products, links
-context/brand.md                # voice, visual identity, spelling, forbidden usage
-context/messaging.md            # positioning, value props, proof points, objections
-instructions/guardrails.md      # compliance, escalation, and approval rules
+context/company.md              # ce que fait l'entreprise, ICP, produits, liens
+context/brand.md                # voix, identité visuelle, orthographe, usage interdit
+context/messaging.md            # positionnement, accessoires de valeur, points de preuve, objections
+instructions/guardrails.md      # règles de conformité, d'escalade et d'approbation
 skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
 agents/<slug>.md                # reusable custom agent profiles
 ```
@@ -119,7 +119,7 @@ Gardez les fichiers `context/` courts et factuels : quelques puces que l'agent
 ```text
 <!-- context/brand.md -->
 
-# Brand
+# Marque
 
 - Voice: direct, warm, concrete
 - Use: "workspace", "agent", "team"
@@ -183,18 +183,18 @@ Les utilisateurs peuvent modifier ces fichiers de mémoire directement dans l'on
 
 Chacune de ces surfaces (`AGENTS.md`, skills, mémoire, agents personnalisés, serveurs MCP) correspond à la même forme de ressource sous-jacente : un `path` + `scope` + `content`, adressé et résolu de la même manière.
 
-```an-schema title="The workspace resource model" summary="One resource shape backs every workspace file. The runtime keys it by path and scope and resolves the effective value on read."
+```an-schema title="Le modèle de ressources de l'espace de travail" summary="Une forme de ressource soutient chaque fichier d’espace de travail. Le runtime le classe par chemin et portée et résout la valeur effective lors de la lecture."
 {
   "entities": [
     {
       "id": "resource",
       "name": "workspace resource",
-      "note": "A single file in a user's workspace — instructions, skill, memory, agent, MCP config, or job.",
+      "note": "Un seul fichier dans l'espace de travail d'un utilisateur : instructions, compétence, mémoire, agent, configuration MCP ou tâche.",
       "fields": [
         { "name": "path", "type": "string", "note": "Canonical path, e.g. AGENTS.md, skills/<slug>/SKILL.md" },
-        { "name": "scope", "type": "workspace | shared | personal", "note": "Which level this row lives at" },
+        { "name": "scope", "type": "workspace | shared | personal", "note": "À quel niveau se trouve cette rangée" },
         { "name": "owner", "type": "string", "nullable": true, "note": "u:<email> for personal scope" },
-        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML body" }
+        { "name": "content", "type": "text", "note": "Corps Markdown / JSON / YAML" }
       ]
     }
   ]
@@ -221,12 +221,12 @@ Les agents personnalisés utilisent le thème principal YAML ainsi que les instr
 {
   "filename": "agents/design.md",
   "language": "markdown",
-  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# Role\n\nYou are a focused design agent.\n\n## Responsibilities\n\n- Review layouts and interaction flows\n- Suggest stronger visual direction\n- Be concise and opinionated",
+  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# Rôle\n\nYou est un agent de conception ciblé.\n\n## Responsabilités\n\n- Examiner les mises en page et les flux d'interaction\n- Suggérer une direction visuelle plus forte\n- Être concis et opiniâtre",
   "annotations": [
-    { "lines": "2", "label": "@mention handle", "note": "`name` is what appears in the `@`-dropdown and what the main agent delegates to." },
-    { "lines": "3-4", "label": "When to delegate", "note": "The `description` is what the orchestrator reads to decide this profile fits a task." },
-    { "lines": "5", "label": "Model", "note": "`inherit` reuses the main agent's model. Override only when the profile clearly needs a different one." },
-    { "lines": "6", "note": "`tools: inherit` for now — the field is reserved for future per-agent tool policies." }
+    { "lines": "2", "label": "@mention handle", "note": "`name` est ce qui apparaît dans la liste déroulante `@` et à quoi l'agent principal délègue." },
+    { "lines": "3-4", "label": "Quand déléguer", "note": "`description` est ce que l'orchestrateur lit pour décider que ce profil correspond à une tâche." },
+    { "lines": "5", "label": "Modèle", "note": "`inherit` réutilise le modèle de l'agent principal. Remplacez uniquement lorsque le profil en a clairement besoin d’un autre." },
+    { "lines": "6", "note": "`tools: inherit` pour l'instant — le champ est réservé aux futures politiques d'outils par agent." }
   ]
 }
 ```
@@ -303,21 +303,21 @@ Points de terminaison REST montés automatiquement :
 L'agent utilise ces actions intégrés. Vous pouvez également les appeler depuis votre propre actions :
 
 ```bash
-# List all resources
+# Répertorier toutes les ressources
 pnpm action resource-list --scope all
 
-# Read a resource
+# Lire une ressource
 pnpm action resource-read --path "skills/my-skill/SKILL.md"
 
-# Read inherited workspace context managed by Dispatch
+# Lire le contexte d'espace de travail hérité géré par Dispatch
 pnpm action resource-read --scope workspace --path "context/brand.md"
 
 # Show workspace -> organization/app -> personal precedence for a path
 pnpm action resource-effective --path "context/brand.md"
 
-# Write a resource
-pnpm action resource-write --path "notes/meeting.md" --content "# Meeting Notes..."
+# Écrire une ressource
+pnpm action resource-write --path "notes/meeting.md" --content "# Notes de réunion..."
 
-# Delete a resource
+# Supprimer une ressource
 pnpm action resource-delete --path "notes/old.md"
 ```