Interrogation de la Documentation Claude Code

Répondre à une question technique sur Claude Code en utilisant la documentation locale présente dans docs/claude/.

Purpose

Fournir des réponses précises et contextualisées aux questions Claude Code en s'appuyant sur la documentation officielle stockée localement, sans nécessiter d'accès web.

Variables

• QUESTION: La question technique posée par l'utilisateur
• DOCS_PATH: docs/claude/ - Chemin vers la documentation locale
• SEARCH_KEYWORDS: Mots-clés extraits de la question pour la recherche

Relevant Files

• docs/claude/ - Documentation Claude Code locale
• docs/claude/README.md - Index de la documentation chargée

Workflow

Étape 1: Vérification de la documentation locale

• Vérifier l'existence de docs/claude/
• Si le répertoire n'existe pas ou est vide :
  • Informer l'utilisateur
  • Suggérer d'exécuter /claude:doc:load pour charger la documentation
  • Arrêter l'exécution avec message explicite
• Si la documentation existe :
  • Lire docs/claude/README.md pour connaître le contenu disponible
  • Continuer vers l'étape 2

Étape 2: Analyse de la question

• Extraire les mots-clés principaux de QUESTION
• Identifier le contexte technique (composant, feature, concept)
• Exemples de mots-clés :
  • "slash command" → chercher dans commands.md, custom-commands.md
  • "agent" → chercher dans agents.md, subagents.md
  • "hook" → chercher dans hooks.md, lifecycle.md
  • "tool" → chercher dans tools.md, permissions.md

Étape 3: Recherche dans la documentation

• Utiliser Grep pour rechercher les mots-clés dans docs/claude/
• Paramètres de recherche :
  • Case insensitive (-i)
  • Afficher le contexte (3 lignes avant/après avec -C 3)
  • Limiter les résultats pertinents
• Lire les fichiers markdown pertinents identifiés
• Si aucun résultat :
  • Élargir la recherche avec des termes associés
  • Suggérer des termes de recherche alternatifs

Étape 4: Analyse et synthèse

• Extraire les sections pertinentes de la documentation
• Organiser les informations par ordre de pertinence
• Identifier :
  • Concept principal
  • Exemples de code
  • Bonnes pratiques
  • Warnings et notes importantes
  • Liens vers documentation connexe

Étape 5: Construction de la réponse

• Réponse structurée en format bullet points
• Inclure :
  • Explication concise du concept
  • Exemples de code si disponibles
  • Références aux fichiers de documentation sources
  • Liens internes vers sections connexes
• Format markdown enrichi avec :
  • Blocs de code Markdown/Python/Shell selon contexte
  • Sections info/warning si pertinent
  • Liste hiérarchique pour les étapes

Étape 6: Rapport final avec timing

• Présenter la réponse formatée
• Calculer et afficher la durée totale
• Afficher le timestamp de fin

Report Format

## 📚 Réponse : [Sujet principal]

### Concept
- Explication principale
- Points clés

### Exemple de Code
[Bloc de code si disponible]

### Documentation de Référence
- 📄 `docs/claude/[fichier].md` - [Section]
- 📄 Autres fichiers pertinents

### Voir Aussi
- Concepts connexes
- Autres commandes utiles

Error Handling

• Documentation manquante : Message clair + suggestion /claude:doc:load
• Aucun résultat trouvé : Suggérer termes alternatifs ou reformulation
• Question trop vague : Demander précisions avec exemples
• Fichiers corrompus : Signaler et suggérer rechargement

Examples

Exemple 1 - Question simple

/claude:doc:question "Comment créer une slash command ?"

Résultat attendu :

• Recherche dans commands.md, custom-commands.md
• Format de fichier de commande
• Exemples de frontmatter YAML
• Références aux fichiers sources

Exemple 2 - Question sur composant

/claude:doc:question "Comment utiliser les hooks ?"

Résultat attendu :

• Recherche hooks.md, lifecycle.md
• Types de hooks disponibles
• Exemples Python
• Cas d'usage

Exemple 3 - Question avancée

/claude:doc:question "Comment créer un agent personnalisé ?"

Résultat attendu :

• Recherche agents.md, custom-agents.md
• Configuration d'agent
• Cas d'usage appropriés
• Exemples complets

Best Practices

• Toujours vérifier la présence de la documentation avant recherche
• Privilégier la précision sur l'exhaustivité
• Citer les sources (fichiers markdown consultés)
• Fournir des exemples de code concrets
• Suggérer des commandes connexes si pertinent
• Garder les réponses concises mais complètes
• Afficher le timing au début et à la fin
• Calculer précisément la durée d'exécution

Notes

• Cette commande fonctionne 100% offline une fois la documentation chargée
• La documentation doit être rafraîchie périodiquement avec /claude:doc:load
• Supporte toutes les versions de Claude Code présentes dans docs/claude/
• Peut être étendue pour supporter d'autres frameworks avec le même pattern