¿Qué hace Habilidad de Investigación?
Investiga un problema técnico de manera eficiente y persiste lo aprendido para que el equipo nunca vuelva a investigar el mismo tema dos veces.
1. Definir el alcance del tema
Extrae del mensaje del usuario (pregunta solo si realmente no está claro):
- Slug del tema: nombre de carpeta en kebab-case, p.ej.
bluetooth-audio-routing - Stack: plataforma/lenguaje/framework
- Síntoma: comportamiento observado vs esperado
- Conocido: hipótesis ya probadas
2. Preparar el workspace
Ejecuta scripts/init-research.sh {tema-slug} para crear la carpeta de documentación.
3. Lanzar 3 agentes por defecto en paralelo
Cada agente recibe un enfoque de una línea más el contexto compartido. Lee reference/agent-prompts.md cuando necesites la redacción exacta del prompt.
- Análisis del código base (Agente explorador) — encontrar código relevante, lagunas, referencias archivo:línea.
- Teoría de causa raíz (agente web) — por qué ocurre a nivel de SO/framework/protocolo.
- Soluciones y validación (agente web) — APIs nativas, librerías, correcciones confirmadas por la comunidad.
Inicia el 4º/5º agente opcional solo si el usuario lo solicita explícitamente para comparación de librerías o análisis profundo de API multiplataforma.
4. Sintetizar
Crea exactamente estos dos archivos:
docs/{tema}/NOTAS.md— hallazgos en bruto, fragmentos, URLs, observaciones rápidas.docs/{tema}/RESEARCH_CONSOLIDADO.md— documento maestro estructurado.
Usa reference/consolidated-template.md solo cuando necesites la plantilla completa.
Los archivos de detalle opcionales (03_android_api.md, 04_librerias.md, etc.) se crean solo cuando los hallazgos lo justifican.
5. Finalizar
Ejecuta scripts/finalize-research.sh {tema-slug} para validar que el documento maestro existe y añade una fila de iteración. Luego informa al usuario:
- Causa raíz (con archivo:línea si aplica)
- Top 3 hallazgos no obvios
- Archivos creados
- Próximo paso sugerido
Mantén el informe del chat conciso; el detalle vive en la documentación.