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

directivas/directiva_ejemplo.md

@@ -0,0 +1,23 @@
+# Directiva Base (Ejemplo)
+
+## Objetivo
+Describir el propósito de esta tarea. (Ej: "Obtener leads de Google Maps" o "Generar ideas de contenido").
+
+## Entradas (Inputs)
+- Lista de variables o archivos necesarios.
+- Ej: `inputs/keywords.txt`
+
+## Salidas (Outputs)
+- Archivos generados y su formato.
+- Ej: `.tmp/leads.json`
+
+## Lógica de Ejecución (Paso a Paso)
+1. Cargar configuración desde `.env`.
+2. Leer entradas.
+3. Procesar datos (detallar algoritmos o lógica clave).
+4. Guardar resultados temporales en `.tmp/`.
+5. Generar salida final.
+
+## Restricciones y Casos Borde (Memoria)
+- [ ] **Restricción 1:** No hacer X porque falla Y.
+- [ ] **Restricción 2:** La API tiene un límite de Z req/min.

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.