Initial commit: monorepo Naturcalabacera reservas (apps/api + apps/web + packages/shared)

directivas/start_dev_server.md

@@ -0,0 +1,23 @@
+# Directiva: Iniciar Servidor de Desarrollo
+
+## Objetivo
+Iniciar el servidor de desarrollo local para la aplicación web actual (Vite/Next.js/etc.) asegurando que se ejecute en un puerto disponible y se mantenga activo.
+
+## Entradas (Inputs)
+- `package.json` (para verificar script `dev`)
+- `.env` (opcional, para variables de entorno)
+
+## Salidas (Outputs)
+- Salida estándar del proceso (logs del servidor).
+- URL local de acceso (ej: `http://localhost:5173`).
+
+## Lógica de Ejecución (Paso a Paso)
+1. Verificar que `node_modules` esté instalado. Si no, ejecutar `npm install`.
+2. Identificar el comando de inicio en `package.json` (usualmente `npm run dev`).
+3. Ejecutar el comando de inicio.
+4. (Opcional) Detectar puertos ocupados y permitir cambio de puerto si es compatible.
+
+## Restricciones y Casos Borde (Memoria)
+- [ ] El proceso debe ser persistente (no terminar inmediatamente).
+- [ ] Si `npm` falla, verificar versiones de node o dependencias.
+- [ ] Capturar output para mostrar al usuario la URL.