76 lines
6.7 KiB
Markdown
76 lines
6.7 KiB
Markdown
# 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 |
|