Initial commit

commands/doc/load.md

@@ -0,0 +1,5 @@
+---
+description: Charge la documentation Symfony depuis son site web dans des fichiers markdown locaux
+---
+
+You must use the Skill tool to invoke the "doc-loader" skill with "symfony" as argument.

commands/doc/question.md

@@ -0,0 +1,155 @@
+---
+allowed-tools: [Read, Grep, Glob, Bash]
+description: Interroger la documentation Symfony locale pour répondre à une question
+argument-hint: <question>
+model: claude-sonnet-4-5-20250929
+---
+
+# Interrogation de la Documentation Symfony
+
+Répondre à une question technique sur Symfony en utilisant la documentation locale présente dans `docs/symfony/`.
+
+## Purpose
+Fournir des réponses précises et contextualisées aux questions Symfony 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/symfony/` - Chemin vers la documentation locale
+- SEARCH_KEYWORDS: Mots-clés extraits de la question pour la recherche
+
+## Relevant Files
+- `docs/symfony/` - Documentation Symfony locale
+- `docs/symfony/README.md` - Index de la documentation chargée
+
+## Workflow
+
+### Étape 1: Vérification de la documentation locale
+- Vérifier l'existence de `docs/symfony/`
+- Si le répertoire n'existe pas ou est vide :
+  - Informer l'utilisateur
+  - Suggérer d'exécuter `/load:doc:symfony` pour charger la documentation
+  - Arrêter l'exécution avec message explicite
+- Si la documentation existe :
+  - Lire `docs/symfony/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 :
+  - "routing" → chercher dans routing.md, controller.md
+  - "doctrine" → chercher dans doctrine.md, database.md
+  - "form" → chercher dans forms.md, validation.md
+  - "security" → chercher dans security.md, authentication.md
+
+### Étape 3: Recherche dans la documentation
+- Utiliser Grep pour rechercher les mots-clés dans `docs/symfony/`
+- 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 PHP/YAML/Twig 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
+```markdown
+## 📚 Réponse : [Sujet principal]
+
+### Concept
+- Explication principale
+- Points clés
+
+### Exemple de Code
+[Bloc de code si disponible]
+
+### Documentation de Référence
+- 📄 `docs/symfony/[fichier].md` - [Section]
+- 📄 Autres fichiers pertinents
+
+### Voir Aussi
+- Concepts connexes
+- Autres commandes utiles
+```
+
+## Error Handling
+- **Documentation manquante** : Message clair + suggestion `/load:doc:symfony`
+- **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
+```bash
+/symfony:doc:question "Comment créer une route ?"
+```
+**Résultat attendu** :
+- Recherche dans routing.md, controller.md
+- Exemples d'annotations/attributs PHP 8
+- Exemples YAML
+- Références aux fichiers sources
+
+### Exemple 2 - Question sur composant
+```bash
+/symfony:doc:question "Comment utiliser les formulaires avec validation ?"
+```
+**Résultat attendu** :
+- Recherche forms.md, validation.md
+- Exemples de FormType
+- Contraintes de validation
+- Intégration Doctrine
+
+### Exemple 3 - Question avancée
+```bash
+/symfony:doc:question "Quelle est la différence entre les voters et les guards ?"
+```
+**Résultat attendu** :
+- Recherche security.md, voters.md, guard.md
+- Comparaison conceptuelle
+- Cas d'usage appropriés
+- Exemples des deux approches
+
+## 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 `/load:doc:symfony`
+- Supporte toutes les versions de Symfony présentes dans `docs/symfony/`
+- Peut être étendue pour supporter d'autres frameworks avec le même pattern