Compétence de Recherche
Investiguez un problème technique efficacement et persistez ce que vous apprenez afin que l'équipe ne réinvestigue jamais le même sujet deux fois.
1. Cadrer le sujet
Extrayez du message de l'utilisateur (ne demandez que si ce n'est vraiment pas clair) :
- Identifiant du sujet : nom de dossier en kebab-case, ex.
bluetooth-audio-routing - Stack : plateforme/langage/framework
- Symptôme : comportement observé vs attendu
- Connu : hypothèses déjà essayées
2. Préparer l'espace de travail
Exécutez scripts/init-research.sh {identifiant-sujet} pour créer le dossier de documentation.
3. Lancer 3 agents par défaut en parallèle
Chaque agent reçoit une orientation d'une ligne plus le contexte partagé. Lisez reference/agent-prompts.md
quand vous avez besoin du libellé exact du prompt.
- Analyse du code (Agent d'exploration) — trouver le code pertinent, les lacunes, les références fichier:ligne.
- Théorie de la cause racine (Agent web) — pourquoi cela se produit au niveau OS/framework/protocole.
- Solutions et validation (Agent web) — API natives, bibliothèques, correctifs confirmés par la communauté.
Déclenchez un 4ème/5ème agent facultatif uniquement si l'utilisateur demande explicitement une comparaison de bibliothèques ou une exploration approfondie d'API multiplateforme.
4. Synthétiser
Créez exactement ces deux fichiers :
docs/{sujet}/NOTAS.md— résultats bruts, extraits, URL, observations rapides.docs/{sujet}/RESEARCH_CONSOLIDADO.md— document structuré principal.
Utilisez reference/consolidated-template.md uniquement quand vous avez besoin du modèle complet.
Les fichiers de détail facultatifs (03_api_android.md, 04_bibliotheques.md, etc.) ne sont créés que lorsque
les résultats les justifient.
5. Finaliser
Exécutez scripts/finalize-research.sh {identifiant-sujet} pour valider que le document principal existe et ajouter
une ligne d'itération. Ensuite, faites un rapport à l'utilisateur :
- Cause racine (avec fichier:ligne si applicable)
- Top 3 des découvertes non évidentes
- Fichiers créés
- Prochaine étape suggérée
Gardez le rapport de chat concis ; les détails vivent dans la documentation.