78 lines
5.2 KiB
Markdown
78 lines
5.2 KiB
Markdown
# Checklist de vérification — Section README CONCEPTS
|
||
|
||
Règles pour vérifier l’exactitude du tableau CONCEPTS. Chaque règle est vérifiée à chaque exécution du workflow.
|
||
|
||
## Règles
|
||
|
||
### 1. External URL Liveness
|
||
- **Category** : URL Accuracy
|
||
- **What to check** : chaque URL externe du tableau CONCEPTS (liens docs) retourne une page valide
|
||
- **Depth** : récupérer chaque URL et confirmer qu’elle charge la page attendue (pas une redirection vers une mauvaise page)
|
||
- **Source to compare against** : `https://code.claude.com/docs/llms.txt` pour la liste canonique des URLs
|
||
- **Date added** : 2026-03-02
|
||
- **Origin** : l’URL Permissions `/iam` redirigeait vers la page Authentication au lieu de Permissions
|
||
|
||
### 2. Anchor Fragment Validity
|
||
- **Category** : URL Accuracy
|
||
- **What to check** : toute URL avec fragment d’ancre (`#section-name`) correspond à un titre réel sur la page cible
|
||
- **Depth** : récupérer la page et vérifier que le titre existe avec l’ancre attendue
|
||
- **Source to compare against** : contenu de page récupéré
|
||
- **Date added** : 2026-03-02
|
||
- **Origin** : l’ancre Rules `#modular-rules-with-clauderules` était obsolète ; section renommée en `#organize-rules-with-clauderules`
|
||
|
||
### 3. Missing Docs Pages
|
||
- **Category** : Missing Concepts
|
||
- **What to check** : chaque page de l’index officiel (`llms.txt`) représentant une fonctionnalité utilisateur a une ligne correspondante dans CONCEPTS
|
||
- **Depth** : comparer l’index complet des docs aux entrées du tableau CONCEPTS
|
||
- **Source to compare against** : `https://code.claude.com/docs/llms.txt`
|
||
- **Date added** : 2026-03-02
|
||
- **Origin** : plusieurs concepts manquaient (Agent Teams, Keybindings, Model Configuration, etc.)
|
||
|
||
### 4. Local Badge Link Validity
|
||
- **Category** : Badge Accuracy
|
||
- **What to check** : chaque chemin cible de badge dans CONCEPTS (`best-practice/*.md`, `implementation/*.md`, `.claude/*/`) pointe vers un fichier ou dossier existant
|
||
- **Depth** : utiliser Read/Glob pour vérifier l’existence
|
||
- **Source to compare against** : système de fichiers local
|
||
- **Date added** : 2026-03-02
|
||
- **Origin** : création initiale de la checklist
|
||
|
||
### 5. Description Currency
|
||
- **Category** : Description Accuracy
|
||
- **What to check** : la description de chaque concept reflète précisément la description officielle actuelle
|
||
- **Depth** : comparer la description README avec la meta description ou le premier paragraphe de la page officielle
|
||
- **Source to compare against** : contenu de la page officielle
|
||
- **Date added** : 2026-03-02
|
||
- **Origin** : description Memory incomplète sur auto memory ; emplacement MCP Servers manquant `.mcp.json`
|
||
|
||
### 6. TIPS Section URL Consistency
|
||
- **Category** : URL Accuracy
|
||
- **What to check** : lorsqu’une URL est mise à jour dans CONCEPTS ou Hot, vérifier aussi la section TIPS pour la même URL obsolète
|
||
- **Depth** : rechercher dans TIPS (lignes 125–267) chaque URL signalée dans CONCEPTS/Hot
|
||
- **Source to compare against** : sitemap llms.txt + URLs du tableau CONCEPTS
|
||
- **Date added** : 2026-04-16
|
||
- **Origin** : `web-scheduled-tasks` corrigé dans Hot (2026-04-14) mais resté obsolète dans TIPS
|
||
|
||
### 7. Beta Badge Currency
|
||
- **Category** : Badge Accuracy
|
||
- **What to check** : les concepts marqués `` dans Hot doivent encore être beta / research preview dans leur page officielle
|
||
- **Depth** : récupérer chaque page amont et vérifier une mention explicite beta/preview/experimental ; si absente, le badge README peut être obsolète
|
||
- **Source to compare against** : bannière de page officielle + texte de disponibilité générale
|
||
- **Date added** : 2026-04-26
|
||
- **Origin** : l’agent workflow-concepts a signalé des badges beta potentiellement obsolètes sur Routines, No Flicker Mode, Computer Use et Code Review
|
||
|
||
### 8. Location Column Factual Accuracy
|
||
- **Category** : Description Accuracy
|
||
- **What to check** : la colonne **Location** de chaque concept doit correspondre factuellement au mécanisme décrit par la documentation officielle
|
||
- **Depth** : pour toute valeur Location qui porte une affirmation mécaniste, récupérer la page officielle et confirmer l’affirmation contre les sections "how it works"
|
||
- **Source to compare against** : corps de la page officielle
|
||
- **Date added** : 2026-05-21
|
||
- **Origin** : Checkpointing indiquait `automatic (git-based)` alors que la doc explique que les checkpoints suivent les changements d’outils d’édition de fichiers et ne remplacent pas Git
|
||
|
||
### 9. Bundled Skill / Command Rename Tracking
|
||
- **Category** : Description Accuracy (Location column)
|
||
- **What to check** : toute commande slash ou skill intégrée nommée dans une colonne Location existe encore sous ce nom exact
|
||
- **Depth** : scanner les N dernières versions du CHANGELOG pour les événements "renamed", "removed" ou "deprecated" ; croiser avec les références actuelles commands et bundled skills
|
||
- **Source to compare against** : `https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md` + `https://code.claude.com/docs/en/commands` + `https://code.claude.com/docs/en/skills#bundled-skills`
|
||
- **Date added** : 2026-05-25
|
||
- **Origin** : `/simplify` renommé en `/code-review` en v2.1.147 — événement visible seulement dans le changelog, manqué par les checks de listing docs
|