Una confesión: la mayor parte de este boilerplate se construyó con IA sentada a nuestro lado. 🤩
No como truco - como un flujo real. Y la razón por la que funcionó tan bien es que diseñamos Stardrive para ser amigable con los LLMs desde el primer commit.
Te explico qué significa eso - y cómo puedes usarlo para construir webs impactantes en tiempo récord.
💔 El problema con los proyectos “listos para IA”
Probablemente lo has intentado. Abres un repo, arrancas tu agente de IA favorito (Copilot, Claude, Codex, Cursor - elige tu veneno) y le pides que “añada una página de blog”.
Lo que pasa después suele ser un desastre.
El agente adivina las convenciones. Inventa una estructura de carpetas. Duplica lógica que ya existe. Se salta el setup de i18n. Hardcodea textos que deberían ir en archivos de traducción. Y pasas la siguiente hora limpiando detrás de él.
El problema no es la IA. El problema es que la mayoría de los proyectos no le dicen a la IA cómo funcionan.
Y se pone peor. Cuando arrancas desde un repo vacío, a la IA no le faltan solo instrucciones - le falta todo el arnés. No hay convención de routing, así que inventa una. No hay sistema de i18n, así que hardcodea cadenas. No hay límite de seguridad, así que pone secretos donde no debe. No hay patrón de accesibilidad, así que se salta las etiquetas ARIA. Cada uno de esos huecos se convierte en una mala decisión arquitectónica con la que vas a convivir (y refactorizar) más tarde.
La IA no es vaga ni tonta. Simplemente opera sin guardrails. Y construir esos guardrails mientras la IA ya está generando código es una pesadilla - persigues un objetivo en movimiento. 😓
🩹 Lo que Stardrive hace distinto
Tomamos un enfoque diferente. Stardrive trae instrucciones explícitas para cualquier LLM que lo toque.
En la raíz encontrarás:
AGENTS.md- el punto de entrada. Le dice al agente en qué modo está (mantenimiento del boilerplate vs. construcción de un proyecto), dónde encontrar las guías de setup y qué convenciones seguir.STARDRIVE_AGENT_MODE.md- una sola palabra clave que cambia el comportamiento del agente..ai/SETUP.md,.ai/CONFIG_GUIDE.md,.ai/PLAN.md- un flujo de onboarding guiado que construye una checklist viva para tu proyecto.CLAUDE.mdy.github/copilot-instructions.md- para que distintos agentes arranquen todos desde el mismo contexto.
Encima, el propio código sigue patrones consistentes: los componentes son gruesos y bien nombrados, los textos de i18n viven en sitios predecibles, las convenciones de estilos están documentadas y hay un árbol de decisiones claro para cuándo usar HTML plano, VanillaJS, SolidJS o algo más pesado.
¿El resultado? Cuando apuntas un agente a Stardrive, sabe al instante qué hacer. Sin adivinar. Sin supervisión.
Pero aquí viene la mayor ventaja: todo el cableado ya está hecho. El routing, el i18n, los límites de seguridad, los patrones de accesibilidad, la plomería de SEO, la estrategia de caché, las convenciones de componentes - todo está en su sitio antes de que la IA escriba una sola línea. Los guardrails no son algo que construyes a la vez que la IA. Ya están ahí, horneados en la base.
Esa es la diferencia real. Cuando empiezas de cero, tú y la IA pasan la mayor parte del tiempo construyendo el arnés - discutiendo sobre estructura, corrigiendo errores arquitectónicos, encajando convenciones a posteriori sobre código ya generado. Con Stardrive, esa fase simplemente no existe. El arnés está listo. Así que tú y la IA se centran en lo divertido: funciones reales. 🚀
🛠️ Cómo usarlo de verdad
Aquí va un flujo típico:
- Clonar y configurar. Recorre el flujo de setup - el agente te guía, hace las preguntas correctas y escribe un
PLAN.md. - Pedir funciones. “Añade una página de precios.” “Traduce la página about al italiano.” “Conecta un formulario de newsletter.” El agente sigue las convenciones y produce código que encaja.
- Revisar y publicar. Ejecuta
npm run checkpara lintar y comprobar tipos. Previsualiza en local. Despliega.
Eso es todo. El boilerplate gestiona routing, i18n, SEO, accesibilidad, datos estructurados, caché - todo lo que normalmente devora tu tiempo. Tú te enfocas en el contenido y las funciones reales.
🔒 Seguridad incluida
Algo que nos importa mucho: el código generado por IA puede introducir problemas de seguridad si no tienes cuidado. Stardrive lo mitiga:
- Sin secretos en el frontend (Astro es un framework frontend - el trabajo sensible va en un backend de verdad).
- Cabeceras de seguridad sensatas y defaults compatibles con CSP.
- Límites claros sobre qué debe y qué no debe vivir en este repo.
Al agente se le dice, en lenguaje llano, dónde están esos límites. Así es mucho menos probable que haga algo tonto.
🚀 La conclusión
Construir una web con IA no tiene que significar “esperar que el agente no rompa nada”. Con la base adecuada, es un flujo genuinamente rápido y agradable.
Stardrive es esa base. Clónalo, apunta a tu agente y ve a construir algo impactante. 🎉
