6.7 KiB
6.7 KiB
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 |