v0.7.1 — Opción 'Todas las herramientas' + limpieza

Added

• Opción "Todas las herramientas (30+)" en el select de IA: si el usuario usa herramientas menos comunes (Antigravity, OpenClaw, Gemini, etc.) puede seleccionar "Todas" y se pasa --tools all a openspec init, generando skills para las 30+ herramientas soportadas.

Changed

• Removido "Primera utilidad publicada. M4 Lite en progreso." del README.
• ROADMAP reescrito: lista de logros actuales en vez de fases rígidas.

---

Changelog completo: v0.7.0...v0.7.1

v0.7.0 — Spec-Driven Development integrado

Added

• Spec-Driven Development integrado con OpenSpec: todos los proyectos generados ahora incluyen OpenSpec pre-configurado. El scaffolder pregunta qué herramientas de IA usás (Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, Codex) e instala los skills y slash commands correspondientes.
  • Flujo /opsx:propose → /opsx:apply → /opsx:archive listo para usar desde el día 1.
  • Estructura openspec/ pre-armada en el template como fallback si openspec init falla (sin internet, npm caído, etc.).
  • @fission-ai/openspec agregado como devDependency en los proyectos generados.
  • AGENTS.md actualizado con sección SDD: specs como fuente de verdad, delta specs, flujo explore→propose→apply→archive.
  • README de los proyectos generados incluye sección "Desarrollo por Especificaciones".
  • Nuevo flag --no-openspec para saltear la inicialización de OpenSpec.
  • Próximos pasos en el CLI ahora incluye /opsx:propose "tu primera feature".

Changed

• OpenSpec init se ejecuta antes de git init para que los skills y comandos queden en el commit inicial.
• README principal del repo actualizado con tabla comparativa (Spec-Driven Development: Ninguno vs OpenSpec integrado).

Fixed

• Detección de entorno no interactivo (non-TTY): en CI, pipes o cualquier entorno sin terminal interactiva, el multiselect de herramientas IA se salta automáticamente y usa los defaults (Claude Code + Cursor). Antes, el CLI se colgaba esperando input que nunca llegaba.
• CI con --no-openspec: el workflow de GitHub Actions ahora usa --no-openspec en los tests de generación para evitar descargar @fission-ai/openspec innecesariamente en cada run.

Tests

• 64 tests automáticos (9 nuevos de OpenSpec).
• CI verde en los 4 package managers: npm, pnpm, yarn, bun.
• Tests verifican: estructura openspec/ copiada, config.yaml presente, specs/ y changes/archive/ creados, devDependency en package.json de ambos templates, runOpenSpecInit exportado y manejo de errores.

---

Changelog completo: v0.6.2...v0.7.0

v0.6.2 — Dotfiles Fix

Fixed

• El scaffolding ahora copia dotfiles: el cp() en copy-template.ts no tenía el flag dotfiles: true, por lo que archivos ocultos como .env.example, .gitignore y .eslintrc del template se ignoraban silenciosamente al generar un proyecto nuevo. Ahora está corregido.

Notas

• Workaround de tipos: Node.js soporta la opción dotfiles en fs.cp() desde v16, pero @types/node v22 no la incluye en CopyOptions. Se agregó un cast de tipos para mantener el build limpio sin impacto en runtime.

---

Changelog completo: v0.6.1...v0.6.2

Release v0.6.0: The AI-Native & API Edition

Esta es la actualización más grande de create-stack-next hasta la fecha. Concluimos oficialmente la Fase 2 (Flexibilidad Interna y DX) e introdujimos un soporte nativo revolucionario para el desarrollo asistido por Inteligencia Artificial y la creación ágil de Backends puros.

🌟 Novedades Principales

🤖 Proyectos AI-Native desde el Minuto Cero

Todos los proyectos generados por el CLI ahora nacen con un flujo de trabajo listo para agentes de IA (como OpenClaw o Cursor).

• Prompt de Kickoff: El archivo AGENTS.md incluye un texto pre-configurado para que le ordenes a la IA que asuma el rol de Arquitecto y empiece a programar.
• Documentación Dinámica: Inyectamos los esqueletos ROADMAP.md, AGENT_TASKS.md y HANDOFF.md para evitar la "amnesia contextual" típica de los LLMs.
• Decisiones Registradas (ADRs): Se fuerza contractualmente a las IAs a dejar constancia de cambios arquitectónicos en docs/decisions.md.

⚡ Nuevo Template: API Backend (--template api)

¿Querés construir un Backend sin el peso del Frontend? Introducimos el flag --template api, que genera un proyecto optimizado de Next.js App Router puro (Route Handlers).

• Drizzle ORM + SQLite: Tipado impecable y ultra veloz para entornos Serverless (@libsql/client).
• Validación con Zod: Esquemas listos para proteger tus payloads.
• Arquitectura Robusta: Middleware de autenticación (Bearer/API Key), utilidades para Respuestas y Errores HTTP unificadas (ApiError, successResponse).
• Testing en Memoria: Configurado con node-mocks-http y Vitest para probar endpoints directamente en milisegundos sin levantar puertos.

🎨 Experiencia de Desarrollador (DX) Renovada

• @clack/prompts: La terminal ahora luce espectacular con spinners en tiempo real, colores semánticos, manejo limpio de cancelaciones (Ctrl+C) y un bloque estilizado de "Próximos pasos".
• Soporte de Workspaces (Monorepos): El CLI ahora detecta mágicamente si lo estás ejecutando dentro de un Turborepo o pnpm workspace y desactiva de manera inteligente el git init para no anidar repositorios de forma accidental.

🛠️ Mejoras Internas y Correcciones

• CI/CD Pipeline: Agregamos un flujo de trabajo de GitHub Actions nativo para validar Linting, Tipos y Playwright tests automáticamente en el repositorio central.
• Tests Re-arquitecturados: Los tests de Vitest ahora discriminan el directorio src/ del directorio de plantillas template/, evitando colisiones fantasma.
• Fix: Resolución del infame error ERESOLVE de npm install fijando la dependencia de React de forma armónica para Next.js 15.

---

Nota para los contribuidores: Asegúrense de usar npm run test:run para verificar las adiciones, ya que ahora el proyecto cuenta con 55 tests automáticos en verde. ¡A disfrutar creando!

v0.5.0 — Fase 1 (Robustez Absoluta) 🚀

Release Notes: v0.5.0 — Fase 1 (Robustez Absoluta) 🚀

Esta versión marca la finalización de la Fase 1 del Roadmap, enfocada íntegramente en hacer el CLI create-stack-next a prueba de balas frente a cualquier condición del entorno local.

✨ Novedades

Inicialización Git Inteligente y Robusta

Antes, el CLI podía fallar si no tenías configurado tu nombre o email en Git globalmente. Ahora:

• Detectamos si git está instalado en el sistema. Si no lo está, saltamos este paso con un aviso amigable y continuamos la generación del proyecto.
• Si Git está instalado pero user.name o user.email no están configurados, usamos valores genéricos de fallback (create-stack-next y noreply@create-stack-next) para garantizar que el "initial commit" se cree exitosamente, y te recordamos por consola cómo configurarlo para tus próximos commits.

Manejo Amigable de Directorios Destino

¿Creaste una carpeta vacía y entraste antes de correr el comando? Antes el CLI fallaba porque el directorio ya existía.
Ahora el CLI es más inteligente: acepta directorios existentes siempre y cuando estén vacíos (ignorando archivos inofensivos del sistema como .DS_Store o Thumbs.db). Además, validamos permisos de escritura de antemano para evitar fallos a la mitad de la copia.

Salida de Consola Dinámica

El bloque final de "Próximos pasos" ahora lee qué package manager elegiste (--pm pnpm, yarn, bun, etc.) y te muestra los comandos exactos que debés correr, en lugar de mostrar siempre npm run dev.

---

🤖 Para los Agentes IA (AI-Native)

Nuevo: AGENT_TASKS.md

Como pioneros en el Desarrollo Dirigido por IA, agregamos un archivo maestro en la raíz del proyecto llamado AGENT_TASKS.md. Funciona como una guía de proceso viva y granular ("sprint plan") para cualquier agente (OpenClaw, Cursor, Claude) que trabaje en las entrañas del CLI. Estandariza el flujo de trabajo (contexto → ADR → implementación → tests → changelog) y documenta las decisiones de diseño aprobadas.

ADRs Documentados

Hemos empezado a registrar todas las Decisiones Arquitectónicas (ADRs) en docs/decisions.md (ej. D002 a D004) para mantener la persistencia de memoria entre diferentes sesiones de agentes IA.

---

🛠️ Bajo el capó: Tests y Refactorización

Reescribimos la base para ser infinitamente más testeable y segura:

• Test Suite Multiplicada: Pasamos de 13 a 44 tests unitarios (un aumento de cobertura de 3.4x).
• Verificación Exhaustiva: Ahora nuestros tests verifican que el 100% de los archivos del template se copien de forma íntegra, incluyendo dotfiles (.openclaw, .github, etc.) y estructuras anidadas.
• Refactor de CLI: Desacoplamos las validaciones internas (como validateProjectName) permitiendo testeos directos en lugar de depender de simulaciones. Todo el código pasó por un formateo completo usando Biome.

---

Siguiente parada: Fase 2 (Flexibilidad Interna y DX), donde traeremos soporte avanzado para Monorepos (Workspaces) y un pulido visual extremo para la terminal. ¡Sigamos construyendo! 🛠️

v0.3.0 — AI-native + tests del scaffolder

Esta es la primera release note de create-stack-next. Después de cerrar M2 (AI-native) y agregar tests al scaffolder, queríamos dejar registro de lo que se logró.

Qué trae esta versión

• Cierre de M2 (AI-native):
  • npm run agent
  • .openclaw/ + .agents/ + docs/
  • 4 templates de prompts
• Tests del scaffolder (16 tests pasando)
• README completamente reescrito

El detalle que nos importa

Una de las decisiones que más nos importó fue escribir toda la documentación en español. Sabemos que la mayoría de las herramientas de este estilo están pensadas primero en inglés. Queríamos que quien esté en LATAM pueda usar create-stack-next sin tener que traducir mentalmente decisiones, prompts o convenciones.

AI agents integrados

Además de la documentación en español, esta versión incluye integración pensada para trabajar con AI agents:

• AGENTS.md (agnóstico)
• .openclaw/ y .agents/ con prompts listos para usar
• Comando npm run agent

Repo

https://github.com/gonzoblasco/create-stack-next

Gracias por probarlo. Cualquier feedback es bienvenido.