---
description: Suivre les changements du rapport des sous-agents Claude Code et trouver ce qui doit être mis à jour
argument-hint: [number of versions to check, default 10]
---

# Workflow Changelog — Rapport Subagents

Tu es un coordinateur pour le projet claude-code-best-practice. Ta mission consiste à lancer un agent de recherche, attendre ses résultats et présenter un rapport sur la dérive du rapport **Subagents Reference** (`best-practice/claude-subagents.md`).

Ce workflow vérifie exactement **deux types de dérive** :
1. **Champs de frontmatter** — tout champ ajouté ou supprimé dans la documentation officielle
2. **Sous-agents officiels** — tout agent intégré ajouté ou supprimé

**Versions à vérifier :** `$ARGUMENTS` (par défaut : 10 si vide ou non numérique)

Il s’agit d’un workflow **lire puis rapporter**. Lance l’agent, fusionne les constats et produis un rapport. N’agis que si l’utilisateur approuve.

---

## Phase 1 : lancer l’agent de recherche

Lance `workflow-claude-subagents-agent` avec ce prompt :

> Research the claude-code-best-practice project for subagents report drift. Check the last $ARGUMENTS versions (default: 10).
>
> Fetch these 2 external sources:
> 1. Sub-agents Reference: https://code.claude.com/docs/en/sub-agents
> 2. Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
>
> Then read the local report (`best-practice/claude-subagents.md`).
>
> Check for exactly two things:
> 1. **Frontmatter fields**: Compare the official docs' supported frontmatter fields table against the report's Frontmatter Fields table. Flag any fields that were added or removed.
> 2. **Official sub-agents**: Compare the official docs' built-in subagents list against the report's official agents table. Flag any agents that were added or removed.

---

## Phase 2 : lire les entrées précédentes du changelog

**Pendant que l’agent s’exécute**, lis `changelog/best-practice/claude-subagents/changelog.md` pour obtenir les 25 dernières entrées. Analyse les actions prioritaires afin d’identifier :
- **Éléments récurrents** — problèmes déjà apparus et encore non résolus
- **Nouveaux éléments** — problèmes apparaissant pour la première fois
- **Éléments résolus** — problèmes signalés précédemment et désormais corrigés

---

## Phase 3 : générer le rapport

**Attends que l’agent termine.** Produis un rapport avec ces sections :

1. **Frontmatter Field Changes** — Champs ajoutés ou supprimés dans la documentation officielle par rapport à notre rapport
2. **Official Sub-agent Changes** — Agents intégrés ajoutés ou supprimés par rapport à notre tableau

Termine par un tableau récapitulatif priorisé **Action Items**. Chaque élément doit inclure une colonne `Status` indiquant `NEW`, `RECURRING (first seen: <date>)` ou `RESOLVED` :

```markdown
Priority Actions:
#  | Type           | Action                              | Status
1  | New Field      | Add <field> to frontmatter table    | NEW
2  | Removed Field  | Remove <field> from table           | RECURRING (first seen: <date>)
3  | New Agent      | Add <agent> to official agents table | NEW
4  | Removed Agent  | Remove <agent> from table           | NEW
```

Inclus aussi une section **Resolved Since Last Run** listant les éléments des exécutions précédentes qui ne sont plus des problèmes.

---

## Phase 3.5 : ajouter le résumé au changelog

**Cette phase est OBLIGATOIRE — exécute-la toujours avant de présenter le rapport à l’utilisateur.**

Lis le fichier `changelog/best-practice/claude-subagents/changelog.md` existant, puis **ajoute** (ne remplace PAS) une nouvelle entrée à la fin. Le format de l’entrée doit être exactement :

```markdown
---

## [<YYYY-MM-DD HH:MM AM/PM PKT>] Claude Code v<VERSION>

| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH/MED/LOW | <type> | <action description> | <status> |
| ... | ... | ... | ... | ... |
```

**Format de statut — DOIT utiliser l’un de ces trois formats :**
- `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

Le `(reason)` est obligatoire et doit expliquer brièvement ce qui a été fait ou pourquoi.

**Règles d’ajout :**
- Toujours ajouter — ne jamais écraser ou remplacer les entrées précédentes
- La date et l’heure correspondent à l’exécution de la commande en Pakistan Standard Time (PKT, UTC+5) ; obtiens-les avec `TZ=Asia/Karachi date "+%Y-%m-%d %I:%M %p PKT"`. La version vient des constats de l’agent
- Si `changelog/best-practice/claude-subagents/changelog.md` n’existe pas ou est vide, crée-le avec le tableau Status Legend (voir le haut du fichier), puis la première entrée
- Chaque entrée est séparée par `---`
- **Inclure uniquement les éléments de priorité HIGH, MEDIUM ou LOW** — omettre les éléments de priorité NONE

---

## Phase 3.6 : mettre à jour le badge Last Updated

**Cette phase est OBLIGATOIRE — exécute-la toujours immédiatement après la Phase 3.5, avant de présenter le rapport.**

Mets à jour le badge "Last Updated" en haut de `best-practice/claude-subagents.md`. Exécute `TZ=Asia/Karachi date "+%b %d, %Y %-I:%M %p PKT"` pour obtenir l’heure, encode-la pour URL (espaces en `%20`, virgules en `%2C`) et remplace la portion date du badge. Mets aussi à jour la version Claude Code dans le badge si elle a changé.

**Ne journalise PAS les mises à jour de badge comme action items dans le changelog ou le rapport.** La synchronisation du badge est une routine de chaque exécution, pas un constat.

---

## Phase 4 : proposer d’agir

Après avoir présenté le rapport (et confirmé que le changelog et le badge ont été mis à jour), demande à l’utilisateur :

1. **Execute all actions** — Appliquer tous les changements
2. **Execute specific actions** — L’utilisateur choisit les numéros à exécuter
3. **Just save the report** — Aucun changement

Pendant l’exécution :
- **Nouveaux champs** : ajouter au tableau Frontmatter Fields avec le type, le statut obligatoire et la description corrects depuis la documentation officielle
- **Champs supprimés** : confirmer avec l’utilisateur avant suppression
- **Nouveaux agents** : ajouter au tableau des agents officiels avec #, nom, modèle, outils et description corrects
- **Agents supprimés** : confirmer avec l’utilisateur avant suppression

---

## Règles critiques

1. **Ne jamais deviner** les versions ou dates — utiliser les données de l’agent
2. **Croiser les nombres de champs** — le nombre de champs du rapport doit correspondre à la documentation officielle
3. **Croiser les nombres d’agents** — le nombre d’agents du rapport doit correspondre à la documentation officielle
4. **Ne pas auto-exécuter** — toujours présenter le rapport d’abord
5. **TOUJOURS ajouter au changelog** — la Phase 3.5 est obligatoire. Ne jamais la sauter. Ne jamais écraser les entrées précédentes.
6. **TOUJOURS mettre à jour le badge Last Updated** — la Phase 3.6 est obligatoire. Ne jamais la sauter.
7. **Comparer avec les exécutions précédentes** — lire les 25 dernières entrées du changelog et marquer chaque action item comme NEW, RECURRING ou RESOLVED.
