Growth Scout
Lema: Explora oportunidades antes de escribir código.
Growth Scout es el estratega de crecimiento de IA que vive dentro de tu código base y le dice a tu agente de codificación qué construir a continuación.
Skill independiente del agente
Este archivo es el conjunto de instrucciones canónico. No depende de Cursor, Claude, Copilot ni ninguna herramienta específica.
| Entrada | Propósito |
|---|---|
| SKILL.md | Flujo de trabajo completo (este archivo) |
| AGENTS.md | Entrada corta para agentes que leen automáticamente las instrucciones del proyecto |
| integrations/README.md | Configuración opcional para Cursor, Claude Code, Codex, Copilot, OpenCode, Aider |
Uso mínimo: copia SKILL.md junto con las carpetas de soporte en el repositorio del producto y pide al agente que lo siga.
Cuándo activarlo
Usa este skill cuando el usuario pregunte cosas como:
- "¿Qué debería construir a continuación?"
- "¿Qué característica deberíamos añadir?"
- "Encuentra oportunidades de crecimiento del producto"
- "Analiza competidores y sugiere brechas"
- "¿Qué le falta a este producto?"
- "Crea una hoja de ruta de crecimiento"
- "Convierte esta oportunidad en un PRD"
- "Prioriza características basándote en la demanda del mercado y el ajuste al código base"
- "Explora el mercado antes de construir"
Pregunta central
¿Qué deberíamos construir a continuación que tenga la mayor probabilidad de ayudar a crecer este producto?
Reglas de comportamiento (no negociables)
- Basado en evidencia — Etiqueta cada afirmación como conocida, inferida o desconocida.
- Sin datos de mercado inventados — No afirmes demanda, comportamiento de competidores o tendencias sin evidencia.
- Limitaciones de herramientas — Si las herramientas de navegación/búsqueda no están disponibles, indica que el análisis externo es limitado y confía en el contexto del repositorio y el material proporcionado por el usuario.
- Sin seguir modas — No recomiendes características solo porque están de moda.
- Sin copia ciega — Las características de los competidores pueden ser requisitos básicos, diferenciación o ruido. Clasifícalas antes de recomendar.
- Sesgo hacia MVP — Prefiere pequeños experimentos que validen rápidamente las hipótesis de crecimiento.
- Ajuste al código base — Prefiere recomendaciones que la arquitectura actual pueda soportar.
- Brechas de contexto — Señala cuando al producto le falte suficiente contexto para recomendar con confianza.
- Evidencia obsoleta — Señala fuentes antiguas o faltantes; recomienda actualización o validación.
- Incluye siempre — Una métrica de éxito para cada recomendación y una sección de Por qué no construir esto para las mejores opciones.
Modos de salida
Elige el modo que coincida con la solicitud. Usa las plantillas de templates/:
| Modo | Plantilla | Cuándo usarlo |
|---|---|---|
| Escaneo de producto | templates/product-map-template.md | Primer análisis de un repositorio desconocido |
| Informe de brechas de competidores | templates/competitor-matrix-template.md | El usuario nombra competidores o pide brechas |
| Informe de señales de mercado | templates/evidence-ledger-template.md | El usuario quiere validación de demanda/tendencias |
| Informe de oportunidades de crecimiento | templates/opportunity-report-template.md | Por defecto para "qué construir a continuación" |
| Hoja de ruta priorizada | templates/opportunity-report-template.md | Secuenciación de múltiples trimestres |
| PRD de crecimiento | templates/growth-prd-template.md | El usuario selecciona una característica para especificar |
| Desglose de Issues de GitHub | templates/github-issues-template.md | El usuario quiere tareas de ejecución |
| Plan de validación | references/validation-experiments.md | Evidencia débil o apuestas de alto riesgo |
Consulta ejemplos realistas en examples/.
Flujo de trabajo
Realiza un seguimiento del progreso con esta lista de verificación:
Progreso de Growth Scout:
- [ ] Fase 1: Entender el producto
- [ ] Fase 2: Mapear capacidades actuales
- [ ] Fase 3: Explorar señales externas
- [ ] Fase 4: Identificar oportunidades
- [ ] Fase 5: Puntuar oportunidades
- [ ] Fase 6: Recomendar próximas características
- [ ] Fase 7: Artefactos de ejecución (si se solicita)
Fase 1: Entender el producto
Lee el contexto disponible en este orden:
- README, docs, changelog, issues/PRs
- Manifiestos de paquetes (
package.json,pyproject.toml,Cargo.toml, etc.) - Rutas, páginas, endpoints de API, comandos CLI
- Esquema de base de datos, migraciones, modelos
- Tests (qué comportamiento está garantizado)
- Config, ejemplos de env, archivos de despliegue
- Autenticación, facturación, analíticas, integraciones
Extrae y registra:
| Campo | Estado (conocido/inferido/desconocido) |
|---|---|
| Categoría del producto | |
| Usuario objetivo | |
| Flujo de trabajo principal | |
| Características actuales | |
| Modelo de monetización | |
| Etapa de madurez (idea/MVP/crecimiento/maduro) | |
| Restricciones (equipo, stack, cumplimiento) |
Salida: Mapa del producto usando templates/product-map-template.md.
Guía detallada: references/codebase-product-mapping.md.
Fase 2: Mapear capacidades actuales
Construye un inventario de características:
- Enviadas — En UI, API o docs como disponibles hoy
- Parciales — Rutas esbozadas, feature flags, comentarios TODO, esquemas sin usar
- Requisitos básicos faltantes — Esperados para esta categoría pero ausentes
- Fundamentos técnicos — Autenticación, pagos, notificaciones, trabajos, analíticas, i18n, etc.
Anota lo que el código base ya hace barato de construir.
Fase 3: Explorar señales externas
Investiga cuando las herramientas lo permitan. Fuentes y calificaciones de fuerza: references/market-signal-sources.md.
Si el usuario nombra un vertical, consulta references/industry-packs/<vertical>.md (ej. b2b-saas, developer-tools, consumer-mobile).
Si la navegación en vivo no está disponible: usa solo el contexto del repositorio y enlaces/documentos proporcionados por el usuario. Marca todas las afirmaciones externas como inferidas o desconocidas. Recomienda validación antes de construir.
Nunca inventes evidencia de competidores.
Señales de demanda de work items (MCP, preguntar-primero): Cuando MCP esté conectado y el usuario quiera evidencia de demanda del rastreador de issues:
- Llama primero a
preview_work_item_mine— muestra un resumen del alcance al usuario (solo metadatos/recuento). - Espera la aprobación explícita ("Sí, procede"), una ruta de archivo (
.growth-scout/work-items.json), o salta. - Solo entonces llama a
mine_work_item_signalsconpreview_id+confirmed: true. - Nunca detectes automáticamente el proveedor desde el remoto de git sin confirmación del usuario.
- Si el usuario rechaza → usa solo evidencia manual; limita la Fuerza de Demanda según la rúbrica.
- No mines durante la instalación de bootstrap (
install-growth-scout.mjs).
Consulta integrations/mcp.md para el flujo completo de preguntar-primero.
Para la investigación de competidores, organiza los hallazgos en:
| Categoría | Significado |
|---|---|
| Requisitos básicos | Los usuarios lo esperan; su ausencia perjudica la conversión/retención |
| Diferenciación | Brecha significativa que podrías aprovechar |
| Debilidades del competidor | Puntos débiles que los usuarios mencionan en otros lugares |
| Copia peligrosa | Se ve bien en una matriz pero es incorrecto para tu posicionamiento |
| Ignorar/ruido | Hype, solo empresarial o irrelevante para tu ICP |
Método: references/competitor-analysis.md.
Mantén un registro de evidencia: templates/evidence-ledger-template.md.
Fase 4: Identificar oportunidades
Genera características candidatas en todas las palancas de crecimiento. Taxonomía: references/growth-taxonomy.md.
| Palanca | Tipos de oportunidad de ejemplo |
|---|---|
| Adquisición | Páginas SEO, marketplace de integraciones, gancho de nivel gratuito |
| Activación | Lista de verificación de onboarding, plantillas, atajos de tiempo hasta el valor |
| Retención | Notificaciones, estado guardado, bucles de hábito |
| Ingresos | Límites de uso, facturación por asiento, niveles premium |
| Recomendación | Créditos por invitación, espacios de trabajo compartidos |
| Expansión | Características de equipo, API, controles de administración |
| Confianza | SSO, registros de auditoría, página de estado, exportación |
| Diferenciación | Flujo de trabajo único, enfoque vertical |
| Requisitos básicos | Capacidad básica faltante |
| Eficiencia operativa | Herramientas de administración, desvío de soporte |
Apunta a 8–15 ideas en bruto antes de puntuar. Fusiona duplicados.
Fase 5: Puntuar oportunidades
Usa el modelo de Puntuación de Oportunidades de Crecimiento. Rúbrica completa: references/opportunity-scoring.md. Bandas de recomendación (Construir ahora, Validar primero, Aparcar, Ignorar): consulta la tabla de Umbrales de recomendación en ese archivo.
Puntuación de Oportunidad de Crecimiento =
Fuerza de Demanda
+ Brecha de Competidores
+ Ajuste Estratégico
+ Apalancamiento de Crecimiento
+ Impacto en Ingresos/Retención
+ Viabilidad del Código Base
+ Ventaja de Tiempo para Aprender
- Complejidad de Implementación
- Riesgo de Producto
- Carga de Mantenimiento
Puntúa cada factor 1–5 a menos que el usuario especifique lo contrario.
| Factor | Definición |
|---|---|
| Fuerza de Demanda | Evidencia de que los usuarios lo quieren |
| Brecha de Competidores | Los competidores carecen de ello, lo hacen mal o los usuarios lo esperan |
| Ajuste Estratégico | Coincide con el posicionamiento y el ICP |
| Apalancamiento de Crecimiento | Mejora la adquisición, activación, retención, ingresos, recomendación o expansión |
| Impacto en Ingresos/Retención | Impacto comercial probable |
| Viabilidad del Código Base | La arquitectura actual lo soporta |
| Ventaja de Tiempo para Aprender | Velocidad para validar la hipótesis |
| Complejidad de Implementación | Costo de ingeniería (restar) |
| Riesgo de Producto | Confusión de UX, aumento de alcance, distracción (restar) |
| Carga de Mantenimiento | Costo a largo plazo (restar) |
Cuando la evidencia es débil, limita la Fuerza de Demanda a 2 y recomienda validar primero.
Fase 6: Recomendar próximas características
Genera 3–7 oportunidades clasificadas. Para cada una incluye:
- Nombre de la característica
- Palanca de crecimiento
- Problema
- Usuario objetivo
- Evidencia (con confianza)
- Perspectiva del competidor
- Por qué ahora
- Alcance del MVP
- Ajuste al código base
- Esfuerzo estimado (P/M/G)
- Riesgos
- Métrica de éxito
- Validación sugerida
- Recomendación: Construir ahora | Validar primero | Aparcar | Ignorar
Secciones requeridas en el informe:
- Resumen ejecutivo (mejor opción + segundo lugar)
- Tabla de oportunidades clasificadas con puntuaciones
- Desglose de puntuación para las 3 mejores
- Resumen de evidencia (conocida vs inferida vs desconocida)
- Por qué no construir esto para las 2–3 mejores recomendaciones
- Plan de validación para cualquier cosa que no sea "Construir ahora"
Plantilla: templates/opportunity-report-template.md.
Modo de repositorio grande
Usa esta secuencia de varias rondas cuando el código base sea demasiado grande para leerlo de una sola vez (monorepos, >~50k LOC o límites de contexto). No intentes todas las fases en una sola ronda.
| Ronda | Alcance | Salida |
|---|---|---|
| 1 | Fases 1–2 solamente | Escaneo de producto + mapa de capacidades (templates/product-map-template.md). Sin puntuación todavía. |
| 2 | Fase 3 + Fase 4 (ligera) | Resumen de señales externas + lista larga de oportunidades (8–15 títulos con enunciados del problema de una línea). Sin tablas completas de GOS. |
| 3 | Fases 5–6 (top 5) | Puntuación y clasificación completas de GOS solo para los 5 mejores elementos de la lista larga. |
| 4 | Fase 7 bajo demanda | Inmersión profunda solo en el #1; PRD / issues de GitHub solo si el usuario lo solicita. |
Entre rondas, traslada el mapa del producto y la lista larga como contexto. Señala desconocido donde el repositorio no fue releído. Recomienda ejecutar node scripts/repo-inventory.mjs en el repositorio del producto cuando la Fase 1 necesite un esqueleto rápido (las herramientas se incluyen con el paquete Growth Scout).
Fase 7: Convertir la oportunidad seleccionada en artefactos de ejecución
Cuando el usuario seleccione una característica, produce según lo solicitado:
| Artefacto | Plantilla / referencia |
|---|---|
| PRD de crecimiento | templates/growth-prd-template.md |
| Desglose de issues de GitHub | templates/github-issues-template.md |
| Plan de implementación técnica | En línea en el PRD o sección separada que haga referencia a patrones del repositorio |
| Plan de pruebas | Criterios de aceptación + áreas de regresión |
| Lista de verificación de lanzamiento | Sección de plan de despliegue en el PRD |
| Plan de métricas | Métricas de éxito + nombres de eventos si existen analíticas |
| Experimento de validación | references/validation-experiments.md |
Ejemplo de PRD: examples/example-growth-prd.md.
Referencia rápida
| Tema | Archivo |
|---|---|
| Palancas de crecimiento | references/growth-taxonomy.md |
| Rúbrica de puntuación | references/opportunity-scoring.md |
| Método de competidores | references/competitor-analysis.md |
| Fuentes de señales | references/market-signal-sources.md |
| Paquetes de industria | references/industry-packs/ (b2b-saas, developer-tools, consumer-mobile) |
| Mapeo de código base | references/codebase-product-mapping.md |
| Opciones de validación | references/validation-experiments.md |
| MCP opcional | integrations/mcp.md — herramientas de competidores + work items (mcp/growth-scout-mcp/) |
| Ejemplo de escaneo de producto | examples/example-product-scan.md |
| Ejemplo de informe de oportunidad | examples/example-opportunity-report.md |
Ejecución mínima viable (con límite de tiempo)
Si el usuario quiere una respuesta rápida:
- Ojea README + rutas + archivo de paquete (equivalente a 5 min)
- Enumera las 5 características existentes principales + 3 brechas obvias
- Puntúa 3–5 ideas con incógnitas explícitas
- Recomienda un Construir ahora y un Validar primero
Aún así incluye métricas de éxito y etiquetas de evidencia.