claude-code-best-practice/fr/GLOSSAIRE.md

Glossaire & conventions de traduction (EN → FR)

Ce dossier fr/ est une traduction française du repo, en miroir de l'arborescence d'origine. Il est destiné à la lecture ; les fichiers de configuration réels restent dans .claude/ à la racine (en anglais).

Règles générales

1. Ne jamais traduire : les blocs de code, les clés YAML de frontmatter (name:, description:, allowed-tools:…), les chemins de fichiers, les noms de commandes (/weather-orchestrator), les noms d'outils (Bash, Edit, Agent), les drapeaux CLI (--model) et les identifiants techniques.
2. Conserver la structure Markdown : titres, tableaux, liens, badges, images, HTML inline.
3. Adapter les liens internes : un lien ../best-practice/claude-skills.md depuis fr/tips/ doit pointer vers ../best-practice/claude-skills.md dans fr/ (le miroir), ou vers l'original si non encore traduit. Par défaut on pointe vers le miroir fr/.
4. Les liens vers les assets (images, SVG) pointent vers l'original via chemin relatif remontant (../../!/...), on ne duplique pas les binaires.
5. Tutoiement (« tu ») pour s'adresser au lecteur ; ton pédagogique, direct et professionnel.
6. Garder les dates au format d'origine du titre de fichier, mais traduire les dates en clair dans le corps (« March 10, 2026 » → « 10 mars 2026 »).

Terminologie de référence

Anglais	Français retenu
skill	skill (invariant — terme produit)
subagent / agent	sous-agent / agent
hook	hook (invariant)
command (slash command)	commande (slash)
settings	paramètres / réglages
best practice	bonne pratique
harness	harnais (d'exécution)
context window	fenêtre de contexte
test time compute	calcul à l'inférence (test time compute)
prompt	prompt (invariant)
frontmatter	frontmatter (invariant)
progressive disclosure	divulgation progressive
code review	revue de code
pull request (PR)	pull request (PR)
token	token (invariant)
token savings	économie de tokens
workflow	workflow (invariant)
orchestrator	orchestrateur
permission mode	mode de permissions
background task	tâche en arrière-plan
worktree	worktree (invariant Git)
changelog	journal des changements
report	rapport
tip	astuce / tip

Périmètre traduit

Périmètre complet : toute la prose du repo, y compris les .md de .claude/ (agents, skills, commands), reproduits dans le miroir fr/. Ces copies FR sont purement documentaires et inertes : Claude Code ne découvre les composants actifs que depuis .claude/ à la racine, jamais depuis fr/.claude/.

Non traduits : binaires/assets (images, SVG, sons), fichiers HTML de presentation/ (volumineux et non textuels au sens prose).