Introducción
Cómo pedir ayuda (sin frustrarte)
Cuando te atoras, cómo desatorarte rápido — solo, con la IA o con un humano.
Atorarte es parte del proceso. Hasta los devs con años de experiencia se atoran todos los días. La diferencia no es no atorarse: es saber desatorarte rápido.
Regla de oro
Atorarte es normal. Quedarte atorado en silencio no lo es.
La gran mayoría de los bloqueos se resuelven en minutos si preguntas bien. El error más común de quien empieza es quedarse una hora peleando solo, en vez de pedir ayuda a los 10 minutos. No es "hacer trampa": es como usa un profesional.
La señal de los 15 minutos
Si llevas ~15 minutos atascado en lo mismo sin avanzar, deja de intentar variaciones al azar y sube un peldaño en la escalera de ayuda de abajo. Insistir más no lo arregla.
La escalera de ayuda
Súbela en orden. Cada peldaño resuelve la mayoría de los casos; solo pasa al siguiente si el anterior no funcionó.
- Leé el error con calma. Casi siempre el mensaje te dice qué pasó. No lo cierres de golpe. → Leer errores sin pánico
- Buscá si ya está resuelto. Revisa Errores comunes y, si hay una palabra que no entiendes, búscala en el Glosario.
- Pregúntale a Cursor. Pégale el error con contexto y deja que te explique y proponga el arreglo. → Cómo hablarle a la IA
- Pregúntale a un humano. Tu mentor o tus compañeros del curso. Cuando llegues aquí, ya traes contexto (los pasos 1-3), así que la respuesta llega mucho más rápido.
Cómo pegarle un error a Cursor para que sirva
Un error suelto ("no funciona") no le sirve a nadie, ni a la IA. Dale el panorama completo: qué hacías, qué esperabas, qué pasó y el error tal cual. Usa esta plantilla.
Estoy haciendo X (describe qué intentabas). Esperaba que pasara Y, pero en cambio pasó Z. Este es el error completo: [pega aquí el mensaje tal cual, sin recortar]. Estoy en [Mac / Windows]. ¿Qué significa este error y cómo lo arreglo paso a paso?
Cuanto más específico seas, mejor será la respuesta. Pega el error completo, no un pedacito.
Cómo pedirle ayuda a un humano (sin que te digan "faltan datos")
Cuando le escribes a tu mentor, incluye estos 5 datos. Con ellos, cualquiera puede ayudarte sin tener que interrogarte primero:
| Dato | Ejemplo |
|---|---|
| Qué intentaba | "Correr la app con yarn dev" |
| Qué esperaba | "Que abriera en el navegador" |
| Qué pasó | "La terminal se cerró y salió texto rojo" |
| Qué error salió | "Pego el mensaje completo tal cual" |
| Qué ya probé | "Reinicié la terminal y volví a instalar" |
La fórmula es simple: qué intentabas / qué esperabas / qué pasó / qué error salió / qué ya probaste. Ese último punto es oro: le ahorra a quien ayuda proponerte cosas que ya descartaste.
Nunca pegues tus secretos al pedir ayuda en público
Tus keys, contraseñas y tu archivo .env son privados. Antes de pegar cualquier cosa en un chat de grupo, foro o issue público, reemplaza los valores sensibles por XXX. Una key filtrada puede costarte dinero o comprometer tu app. → Seguridad básica
¿Encontraste un bug del propio VibeFast?
Si el problema no es tu código sino la plantilla misma (algo que ya venía y no funciona), repórtalo como un Issue en GitHub para que se pueda arreglar para todos.
Al abrir el issue, incluye lo mismo que le dirías a un humano:
- Qué intentabas hacer y en qué página o paso ibas.
- Qué esperabas y qué pasó en realidad.
- El error completo (recuerda tapar tus secretos con
XXX). - Tu sistema: Mac 🍎 o Windows 🪟.
- Si puedes, los pasos exactos para reproducirlo.
Un buen issue es medio arreglo. Entre más claro, más rápido lo resuelven.
✅ Conoces la escalera de ayuda: leer el error → buscar → preguntar a Cursor → preguntar a un humano.
✅ Tienes la plantilla para pegarle un error a Cursor con contexto útil.
✅ Sabes que jamás pegas tus keys ni tu .env en público: los reemplazas por XXX.
¿Algo tronó? → Leer errores sin pánico.