Especificar el contexto
En esta página
El contexto marca la diferencia
La calidad de las respuestas de grok-build-0.1 depende directamente de la calidad del contexto que proporciones. Un prompt vago genera una respuesta genérica. Un prompt con el contexto adecuado produce una respuesta que puedes aplicar inmediatamente a tu código.
El problema de los prompts sin contexto
Veamos un ejemplo concreto. Preguntas:
«Mejora el manejo de errores»
El modelo no sabe:
- En qué archivo debe trabajar
- Qué tipo de errores estás gestionando
- Cuáles son tus códigos de error existentes
- Cómo es la estructura de tu proyecto
- Qué dependencias estás utilizando
Generará una respuesta genérica con bloques try/catch estándar que probablemente no encajen con tu arquitectura.
Cómo especificar el contexto eficazmente
Menciona los archivos relevantes
Editores como Cline y Cursor te permiten hacer referencia a archivos usando @. Utiliza esta función de forma consistente:
«Mis códigos de error están definidos en @errors.ts. Úsalos como referencia para añadir el manejo de errores apropiado en @sql.ts, donde estoy realizando consultas»
Ahora el modelo ve los archivos reales, entiende tus convenciones y produce código coherente con tu base de código.
Describe la estructura del proyecto
Cuando trabajas en un proyecto nuevo o en una parte del código que el modelo aún no conoce, describe brevemente la estructura:
«El proyecto usa Express con TypeScript. Las rutas están en src/routes/, los servicios en src/services/ y los tipos en src/types/. Estoy trabajando en el servicio de autenticación».
Especifica las dependencias
Si tu código utiliza bibliotecas específicas, menciónalas:
«Estoy usando Zod para validación, Drizzle para el ORM y Pino para el registro de eventos. Añade validación al esquema de entrada en @api/users.ts»
Excluye lo irrelevante
Excluir lo que no es relevante es tan importante como incluir el contexto correcto. Si haces referencia a 15 archivos para un cambio sencillo, el modelo puede perderse. Céntrate en los archivos directamente implicados.
Ejemplos de antes y después
Generación de pruebas
Sin contexto: «Escribe pruebas para mi función de validación»
Con contexto: «Escribe pruebas con Vitest para la función validateUser en @src/validators/user.ts. Los datos de prueba están en @tests/fixtures/users.json. Usa el mismo patrón que en @tests/validators/product.test.ts»
Refactorización
Sin contexto: «Refactoriza este código para que quede más limpio»
Con contexto: «Extrae la lógica de reintentos en @src/api/client.ts (líneas 45-78) a un helper reutilizable en @src/utils/retry.ts. Los demás clientes de API en @src/api/ también deberían poder usarlo»
Puntos clave
- Haz referencia siempre a los archivos relevantes con
@ - Describe la estructura del proyecto cuando sea necesario
- Menciona las dependencias y convenciones que utilizas
- Excluye la información irrelevante para evitar ruido
- Cuanto más preciso sea el contexto, más directamente podrás aplicar la respuesta