5.2 KiB
5.2 KiB
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.txtpour la liste canonique des URLs - Date added : 2026-03-02
- Origin : l’URL Permissions
/iamredirigeait 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-taskscorrigé 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 :
/simplifyrenommé en/code-reviewen v2.1.147 — événement visible seulement dans le changelog, manqué par les checks de listing docs