gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

traduction

Browse Source
This commit is contained in:
gilles
2026-06-02 23:24:21 +02:00
parent 89ed5d7f86
commit e8f2b1a034
114 changed files with 17211 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
fr/changelog/best-practice/claude-subagents/changelog.md
+263
View File
@@ -0,0 +1,263 @@
# Historique du changelog du rapport Subagents
## Légende des statuts
| Status | Signification |
|--------|---------------|
| ✅ `COMPLETE (reason)` | L’action a été réalisée et résolue avec succès |
| ❌ `INVALID (reason)` | Le constat était incorrect, non applicable ou intentionnel |
| ✋ `ON HOLD (reason)` | Action différée — en attente d’une dépendance externe ou d’une décision utilisateur |
---
## [2026-02-28 03:22 PM PKT] Claude Code v2.1.63
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Agents Table | Ajouter `workflow-changelog-claude-agents-frontmatter-agent` au tableau Agents in This Repository | ✅ COMPLETE (ajouté avec model: opus, hérite de tous les outils, pas de skills/mémoire) |
| 2 | HIGH | Agents Table | Corriger la colonne skills de presentation-curator — ajouter le préfixe `presentation/` aux noms de skills | ✅ COMPLETE (mis à jour vers presentation/vibe-to-agentic-framework etc.) |
| 3 | MED | Field Documentation | Ajouter une note au champ `color` indiquant qu’il est fonctionnel mais absent du tableau frontmatter officiel | ✅ COMPLETE (note ajoutée sur le statut non officiel dans la colonne description) |
| 4 | MED | Invocation Section | Étendre la section invocation avec flag CLI --agents, commande /agents, CLI claude agents, reprise d’agent | ✅ COMPLETE (tableau de méthodes d’invocation ajouté avec 5 méthodes) |
---
## [2026-03-07 08:35 AM PKT] Claude Code v2.1.71
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Broken Link | Corriger le lien agent memory vers `reports/claude-agent-memory.md` | ✅ COMPLETE |
| 2 | HIGH | Changed Behavior | Mettre à jour la description du champ `tools` : `Task(agent_type)` → `Agent(agent_type)` (renommage v2.1.63) | ✅ COMPLETE |
| 3 | HIGH | Changed Behavior | Mettre à jour la section invocation : Task tool → Agent tool (renommage v2.1.63) | ✅ COMPLETE (titre, exemple de code et note de renommage mis à jour) |
| 4 | HIGH | Example Update | Mettre à jour l’exemple complet : `Task(monitor, rollback)` → `Agent(monitor, rollback)` | ✅ COMPLETE |
| 5 | HIGH | Built-in Agent | Ajouter l’agent `Bash` au tableau Official Claude Agents (model: inherit, objectif : commandes terminal dans contexte séparé) | ✅ COMPLETE (ajouté au tableau) |
| 6 | HIGH | Agents Table | Ajouter `workflow-concepts-agent` au tableau Agents in This Repository (model: opus, color: green) | ✅ COMPLETE |
| 7 | HIGH | Agents Table | Ajouter `workflow-claude-settings-agent` au tableau Agents in This Repository (model: opus, color: yellow) | ✅ COMPLETE |
| 8 | MED | Built-in Agent | Corriger le modèle `statusline-setup` : `inherit` → `Sonnet` | ✅ COMPLETE |
| 9 | MED | Built-in Agent | Corriger le modèle `claude-code-guide` : `inherit` → `Haiku` | ❌ NOT APPLICABLE (retiré du tableau) |
| 10 | MED | Agents Table | Corriger la couleur `weather-agent` : `teal` → `green` | ✅ COMPLETE |
| 11 | MED | Invocation | Ajouter le flag CLI `--agent <name>` au tableau des méthodes d’invocation | ✅ COMPLETE (ajouté comme première ligne) |
| 12 | MED | Changed Behavior | Mettre à jour le texte ligne 147 : "Task tool" → "Agent tool" dans l’en-tête Official Claude Agents | ✅ COMPLETE (l’utilisateur a réécrit l’en-tête) |
| 13 | MED | Cross-File | Mettre à jour CLAUDE.md : références `Task(...)` → `Agent(...)` (lignes 50-53, 61) | ✅ COMPLETE (section orchestration et description du champ tools mises à jour) |
---
## [2026-03-12 12:17 PM PKT] Claude Code v2.1.74
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-13 04:21 PM PKT] Claude Code v2.1.74
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-15 12:50 PM PKT] Claude Code v2.1.76
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-17 12:42 PM PKT] Claude Code v2.1.77
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-18 11:41 PM PKT] Claude Code v2.1.78
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-19 11:56 AM PKT] Claude Code v2.1.79
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 13 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-20 08:35 AM PKT] Claude Code v2.1.80
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | New Field | Ajouter le champ `effort` au tableau Frontmatter Fields (chaîne, optionnel — surcharge du niveau d’effort : `low`, `medium`, `high`, `max`) | ✅ COMPLETE (ajouté entre `background` et `isolation`, compteur 14→15) |
---
## [2026-03-21 09:07 PM PKT] Claude Code v2.1.81
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 15 champs frontmatter et les 6 agents intégrés correspondent.
---
## [2026-03-23 09:49 PM PKT] Claude Code v2.1.81
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 15 champs frontmatter (14 officiels + 1 non officiel `color`) et les 6 agents intégrés correspondent.
---
## [2026-03-25 08:07 PM PKT] Claude Code v2.1.83
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 15 champs frontmatter (14 officiels + 1 non officiel `color`) et les 6 agents intégrés correspondent.
**Élément à surveiller :** `initialPrompt` a été ajouté dans le changelog v2.1.83 mais n’apparaît pas encore dans le tableau des champs frontmatter pris en charge par la doc officielle. Lorsqu’il y apparaîtra, le rapport devra être mis à jour.
---
## [2026-03-26 01:01 PM PKT] Claude Code v2.1.84
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | New Field | Ajouter `initialPrompt` au tableau Frontmatter Fields (chaîne, optionnel — soumis automatiquement comme premier tour utilisateur quand l’agent s’exécute comme agent de session principal via `--agent` ou le paramètre `agent`) | ✅ COMPLETE (ajouté entre `isolation` et `color`, compteur 15→16) |
---
## [2026-03-27 06:28 PM PKT] Claude Code v2.1.85
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter (15 officiels + 1 non officiel `color`) et les 6 agents intégrés correspondent.
---
## [2026-03-28 06:00 PM PKT] Claude Code v2.1.86
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter (15 officiels + 1 non officiel `color`) et les 6 agents intégrés correspondent.
---
## [2026-04-01 12:26 PM PKT] Claude Code v2.1.89
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter (15 officiels + 1 non officiel `color`) et les 6 agents intégrés correspondent.
---
## [2026-04-02 09:11 PM PKT] Claude Code v2.1.90
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Removed Agent | Retirer `Bash` du tableau Official Claude Agents — la doc officielle liste 5 agents intégrés, `Bash` n’en fait pas partie | ✅ COMPLETE (ligne Bash retirée, renumérotation 6→5 agents) |
| 2 | LOW | Field Docs | Mettre à jour la description du champ `color` — retirer la note "absent from official frontmatter table" ; `color` apparaît maintenant dans le tableau officiel | ✅ COMPLETE (note non officielle retirée de la description) |
---
## [2026-04-03 08:30 PM PKT] Claude Code v2.1.91
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | LOW | Field Docs | Mettre à jour la description du champ `permissionMode` — ajouter `auto` comme valeur valide (doc officielle : `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`) | ✅ COMPLETE (`auto` ajouté entre `acceptEdits` et `dontAsk`) |
---
## [2026-04-04 10:43 PM PKT] Claude Code v2.1.92
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-08 09:34 PM PKT] Claude Code v2.1.96
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | LOW | Field Docs | Mettre à jour la description du champ `model` — ajouter la prise en charge des IDs de modèle complets (ex. `claude-opus-4-6`) en plus des alias | ✅ COMPLETE (description alignée sur la doc officielle) |
| 2 | LOW | Field Docs | Mettre à jour la description du champ `effort` — ajouter le qualificatif `max (Opus 4.6 only)` | ✅ COMPLETE (note Opus 4.6 only ajoutée à l’option max) |
| 3 | LOW | Field Docs | Mettre à jour la description du champ `color` — remplacer `(e.g., green, magenta)` par les valeurs valides explicites : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan` | ✅ COMPLETE (description par exemples remplacée par la liste exhaustive) |
---
## [2026-04-09 11:34 PM PKT] Claude Code v2.1.97
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-11 06:10 PM PKT] Claude Code v2.1.101
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-13 08:02 PM PKT] Claude Code v2.1.101
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-14 11:14 PM PKT] Claude Code v2.1.107
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-16 08:16 PM PKT] Claude Code v2.1.110
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-18 07:53 PM PKT] Claude Code v2.1.114
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-24 12:27 AM PKT] Claude Code v2.1.118
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-26 01:10 PM PKT] Claude Code v2.1.119
Aucune dérive détectée — le rapport est entièrement synchronisé avec la documentation officielle. Les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-04-29 12:49 AM PKT] Claude Code v2.1.121
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent. Une mise à jour de valeur d’énumération hors périmètre a été appliquée à la demande de l’utilisateur.
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | LOW | Field Docs | Mettre à jour la description du champ `effort` — ajouter `xhigh` entre `high` et `max` pour correspondre à la liste officielle de valeurs enum | ✅ COMPLETE (`xhigh` inséré ligne 33 ; miroir du motif v2.1.91 où `auto` avait été ajouté à `permissionMode`) |
---
## [2026-05-01 03:30 PM PKT] Claude Code v2.1.126
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-05-12 11:38 PM PKT] Claude Code v2.1.139
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-05-21 12:05 AM PKT] Claude Code v2.1.145
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-05-25 04:26 PM PKT] Claude Code v2.1.150
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-06-01 12:02 AM PKT] Claude Code v2.1.158
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-06-01 11:38 AM PKT] Claude Code v2.1.159
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
---
## [2026-06-02 11:37 AM PKT] Claude Code v2.1.160
Aucune dérive détectée sur les deux dimensions suivies — les 16 champs frontmatter et les 5 agents intégrés correspondent.
fr/changelog/best-practice/claude-subagents/verification-checklist.md
+75
View File
@@ -0,0 +1,75 @@
# Checklist de vérification — Rapport Subagents
Les règles s’accumulent dans le temps. Chaque exécution workflow-changelog DOIT exécuter TOUTES les règles à la profondeur indiquée. Quand un nouveau type de dérive est trouvé et qu’une règle existante aurait dû le détecter (mais n’existait pas ou était trop superficielle), ajouter une nouvelle règle ici.
## Niveaux de profondeur
| Depth | Signification | Exemple |
|-------|---------------|---------|
| `exists` | Vérifier si une section/table/fichier existe | "Le rapport a-t-il un tableau Memory Scopes ?" |
| `presence-check` | Vérifier si un élément précis est présent ou absent | "Le champ `color` est-il dans le tableau Frontmatter Fields ?" |
| `content-match` | Comparer les valeurs réelles mot à mot avec la source | "La description du champ `model` correspond-elle à la doc officielle ?" |
| `field-level` | Vérifier que chaque champ individuel est comptabilisé | "Chaque champ frontmatter de la doc officielle apparaît-il dans le tableau ?" |
| `cross-file` | Une même valeur doit correspondre entre plusieurs fichiers | "La section agent de CLAUDE.md correspond-elle à la liste des champs du rapport ?" |
---
## 1. Frontmatter Fields Table
Règles vérifiant le tableau Frontmatter Fields contre la documentation officielle.
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 1A | Field Completeness | Pour chaque champ frontmatter d’agent dans la doc officielle, vérifier sa présence dans le tableau Frontmatter Fields du rapport | field-level | sub-agents reference page | 2026-02-28 | Checklist initiale — éviter de manquer de nouveaux champs |
| 1B | Field Types | Pour chaque champ du tableau, vérifier que la colonne Type correspond à la doc officielle | content-match | sub-agents reference page | 2026-02-28 | Les erreurs de type créent de la confusion |
| 1C | Required Status | Pour chaque champ, vérifier que la colonne Required correspond à la doc officielle | content-match | sub-agents reference page | 2026-02-28 | Un mauvais statut required casse les agents |
| 1D | Field Descriptions | Pour chaque champ, vérifier que la colonne Description reflète précisément le comportement officiel | content-match | sub-agents reference page | 2026-02-28 | Descriptions obsolètes trompeuses |
## 2. Memory Scopes
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 2A | Scope Completeness | Vérifier que tous les scopes mémoire de la doc officielle apparaissent dans le tableau Memory Scopes | field-level | sub-agents reference page | 2026-02-28 | De nouveaux scopes peuvent être ajoutés |
| 2B | Storage Locations | Pour chaque scope, vérifier que la colonne Storage Location correspond à la doc officielle | content-match | sub-agents reference page | 2026-02-28 | Mauvais chemins = perte de données |
## 3. Examples
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 3A | Minimal Example | Vérifier que l’exemple minimal utilise seulement les champs requis avec une syntaxe valide | content-match | sub-agents reference page | 2026-02-28 | L’exemple minimal doit rester minimal |
| 3B | Full-Featured Example | Vérifier que l’exemple complet démontre TOUS les champs frontmatter disponibles | field-level | sub-agents reference page | 2026-02-28 | L’exemple complet doit montrer chaque champ |
## 4. Scope & Priority
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 4A | Priority Order | Vérifier que le tableau Scope and Priority liste tous les emplacements d’agents dans le bon ordre de priorité | content-match | sub-agents reference page + CLI reference page | 2026-02-28 | Un mauvais ordre crée des bugs de résolution |
| 4B | Invocation Methods | Vérifier que le tableau des méthodes d’invocation liste TOUTES les méthodes : `--agent`, `--agents`, `/agents`, `claude agents`, Agent tool et reprise d’agent | field-level | CLI reference page + sub-agents reference page | 2026-03-07 | Le flag CLI `--agent` manquait |
## 5. Cross-File Consistency
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 5A | CLAUDE.md Sync | Vérifier que la section Subagent Definition Structure de CLAUDE.md liste les mêmes champs que le tableau Frontmatter Fields du rapport | cross-file | CLAUDE.md vs report | 2026-02-28 | CLAUDE.md peut dériver du rapport |
## 6. Process
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 6A | Source Credibility Guard | Ne signaler une dérive que si elle est confirmée par des sources officielles ; les blogs tiers servent seulement de pistes | content-match | official docs only | 2026-02-28 | Évite les faux positifs issus de blogs |
## 7. Agent Tables
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 7A | Built-in Agent Completeness | Vérifier que le tableau "Official Claude Agents" liste tous les types d’agents intégrés avec modèle, outils et description corrects | field-level | sub-agents reference page + changelog | 2026-02-28 | Il manquait `claude-code-guide` et `statusline-setup` |
| 7B | Repository Agent Completeness | Scanner `.claude/agents/**/*.md` et vérifier que chaque agent apparaît dans "Agents in This Repository" avec modèle, couleur, outils, skills et mémoire | field-level | `.claude/agents/**/*.md` file frontmatter | 2026-02-28 | Les agents du dépôt étaient maintenus manuellement |
| 7C | Repository Agent Links | Vérifier que chaque nom d’agent dans le tableau a un lien cliquable vers le bon fichier `.md` | exists | resolved file path from `best-practice/` | 2026-02-28 | Les liens doivent rester valides après déplacements |
## 8. Hyperlinks
| # | Category | Check | Depth | Compare Against | Added | Origin |
|---|----------|-------|-------|-----------------|-------|--------|
| 8A | Local File Links | Vérifier que tous les liens relatifs vers fichiers existent | exists | local filesystem | 2026-02-28 | Des déplacements de fichiers peuvent casser les liens |
| 8B | External URL Links | Vérifier que toutes les URLs externes retournent des pages valides | exists | HTTP response | 2026-02-28 | Les pages de docs externes peuvent changer |
| 8C | Cross-File Reference Links | Vérifier que les liens vers d’autres rapports existent | exists | local filesystem | 2026-02-28 | Les rapports peuvent être déplacés ou renommés |