specleap-framework 2.1.7 → 2.1.9

package/CHANGELOG.md

@@ -7,6 +7,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.9] - 2026-04-30
+
+### Added
+
+- **Interactive base-folder prompt during `npx specleap-framework@latest`.** The installer now asks where to install before copying anything. Previously it dropped the `specleap-framework/` folder silently into the user's current working directory, leaving them unsure of the final location.
+
+#### How it works
+
+- `bin/specleap` (the entry point invoked by `npx`) now accepts an optional CLI argument with the base folder, e.g. `npx specleap-framework@latest ~/Downloads`. If the argument is omitted, an interactive bilingual prompt asks for the base folder, with the current working directory as default.
+- The folder name is **always** `specleap-framework` (not configurable). If the user wants a different name, they rename it after install with `mv`.
+- The base path supports `~`, `~/relative`, plain relative paths, and absolute paths. The resolved path is shown back to the user before copying.
+- If the resolved target already exists, the installer aborts with a clear bilingual message instead of silently overwriting.
+- The installer creates the base folder if it does not exist.
+
+### Changed
+
+- **Final summary of `setup.sh` now prints the absolute install path prominently.** Block at the end of the installer reads `📍 SpecLeap instalado en: <ruta>` (or `📍 SpecLeap installed at: <path>` in English). Reported by Styng during v2.1.8 testing — after a long setup, the path was effectively lost in the scrollback.
+- **Next-steps list now starts with `cd "<install_path>"`** so the user knows how to reach the project regardless of where they ran `npx` from.
+
+### Notes
+
+- Backwards compatible: existing scripts that depend on `setup.sh` running from the project root still work — the env var `SPECLEAP_INSTALL_PATH` is set by `bin/specleap` but `setup.sh` falls back to `pwd` if absent.
+- The folder-name decision (always `specleap-framework`) keeps documentation, generated paths and tutorials consistent across users.
+
+## [2.1.8] - 2026-04-26
+
+### Fixed
+
+- **`setup.sh` token validation no longer aborts on the first wrong input.** Both the GitHub and the Asana token prompts now retry up to 3 times before asking the user whether to retry the round again or cancel the installation. Empty input doesn't consume an attempt (it's almost always a paste/typo, not a real failure). Reported by Styng during a manual test where pasting a partial Asana token killed the installer outright with no recovery path.
+
+#### Behavioural details
+
+- 3 attempts per round, then the installer prints the actual count and asks `[R]eintentar / [C]ancelar` (Spanish) or `[R]etry / [C]ancel` (English) depending on the chosen language.
+- Choosing `R` (default) resets the attempt counter and lets the user try 3 more times — useful when they realise mid-prompt that they grabbed the wrong token.
+- Choosing `C` exits cleanly with code 1 and the message `Instalación cancelada por el usuario` / `Installation cancelled by user`.
+- After every invalid token, a tip is printed reminding the user about required scopes (GitHub: `repo`, `workflow`) or token format (Asana: Personal Access Token).
+- Empty token input prints a localised reminder of the expected format and re-prompts without spending an attempt.
+
+No changes to the validation logic itself (still calls `https://api.github.com/user` and `https://app.asana.com/api/1.0/workspaces`), so behaviour with valid tokens is unchanged.
+
 ## [2.1.7] - 2026-04-25
 
 ### Added

package/README.md

@@ -20,7 +20,7 @@
 
 SpecLeap convierte cualquier IDE con asistente de IA en un entorno de desarrollo spec-first. Combina un contrato de proyecto inmutable, agentes conversacionales especializados, 34 Agent Skills profesionales y un pipeline de validación en tres capas para entregar código consistente y probado sin improvisación.
 
-**Versión actual:** 2.1.7 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.9 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 

package/bin/specleap

@@ -3,48 +3,137 @@
 const { spawn, execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
+const readline = require('readline');
+const os = require('os');
 
-// Directorio del paquete npm (donde están todos los archivos)
+// Nombre fijo de la carpeta destino. NO es configurable: si el usuario
+// quiere otro nombre, renombra la carpeta a posteriori con `mv`.
+const FOLDER_NAME = 'specleap-framework';
+
+// Directorio del paquete npm (donde están todos los archivos a copiar)
 const packageDir = path.join(__dirname, '..');
 
-// Directorio donde el usuario ejecutó npx (su directorio de trabajo)
-const userCwd = process.cwd();
+// Resolver una ruta base introducida por el usuario:
+// - "~" o "~/algo" → expande a $HOME
+// - relativa → se resuelve contra cwd
+// - absoluta → se queda igual
+function resolveBasePath(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return process.cwd();
+  if (trimmed === '~') return os.homedir();
+  if (trimmed.startsWith('~/')) return path.join(os.homedir(), trimmed.slice(2));
+  if (path.isAbsolute(trimmed)) return trimmed;
+  return path.resolve(process.cwd(), trimmed);
+}
 
-// Carpeta de destino
-const targetDir = path.join(userCwd, 'specleap-framework');
+// Pregunta interactiva al usuario por la carpeta base.
+// Bilingüe en el prompt porque el idioma de SpecLeap se elige más tarde
+// dentro de setup.sh — aquí todavía no lo sabemos.
+function askBasePath(defaultBase) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
 
-console.log('\n🚀 Copiando SpecLeap Framework...\n');
+    console.log('');
+    console.log('📁 ¿En qué carpeta base instalar SpecLeap?');
+    console.log('   Where do you want to install SpecLeap?');
+    console.log('');
+    console.log(`   Se creará / Will create: <base>/${FOLDER_NAME}`);
+    console.log(`   Default: ${defaultBase}`);
+    console.log('');
+    console.log('   Ejemplos / Examples:');
+    console.log('     ~/Downloads        →  ~/Downloads/specleap-framework');
+    console.log('     ~/Desktop/work     →  ~/Desktop/work/specleap-framework');
+    console.log('     .                  →  ./specleap-framework');
+    console.log('     (Enter)            →  default arriba');
+    console.log('');
 
-// Verificar si ya existe
-if (fs.existsSync(targetDir)) {
-  console.error(`❌ Error: El directorio '${targetDir}' ya existe.`);
-  console.error('   Por favor elimínalo primero o ejecuta desde otro directorio.\n');
-  process.exit(1);
+    rl.question('Carpeta base / Base folder: ', (answer) => {
+      rl.close();
+      resolve(resolveBasePath(answer));
+    });
+  });
 }
 
-// Crear directorio destino
-try {
-  fs.mkdirSync(targetDir, { recursive: true });
-  
-  // Copiar todos los archivos del paquete
-  execSync(`cp -R "${packageDir}"/* "${targetDir}"/`, { stdio: 'inherit' });
-  execSync(`cp -R "${packageDir}"/.??* "${targetDir}"/ 2>/dev/null || true`, { stdio: 'ignore' });
-  
-  console.log(`✅ Archivos copiados a: ${targetDir}\n`);
-  
-} catch (err) {
-  console.error('❌ Error copiando archivos:', err.message);
-  process.exit(1);
-}
+async function main() {
+  // Argumento CLI opcional: `npx specleap-framework@latest ~/Downloads`
+  const args = process.argv.slice(2);
+  const argBase = args.find((a) => !a.startsWith('-'));
 
-// Ejecutar setup.sh DESDE el directorio copiado
-const setupPath = path.join(targetDir, 'setup.sh');
+  // Si no hay argumento, preguntar interactivamente con default = cwd
+  let basePath;
+  if (argBase) {
+    basePath = resolveBasePath(argBase);
+    console.log(`\n📁 Carpeta base: ${basePath}`);
+  } else {
+    basePath = await askBasePath(process.cwd());
+  }
 
-const setup = spawn('bash', [setupPath], {
-  stdio: 'inherit',
-  cwd: targetDir
-});
+  // Verificar que la carpeta base existe (o se puede crear)
+  if (!fs.existsSync(basePath)) {
+    try {
+      fs.mkdirSync(basePath, { recursive: true });
+      console.log(`📂 Carpeta base creada / Base folder created: ${basePath}`);
+    } catch (err) {
+      console.error(`\n❌ No se pudo crear la carpeta base / Could not create base folder: ${basePath}`);
+      console.error(`   ${err.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  // Verificar que sea un directorio (no un archivo con ese nombre)
+  const baseStat = fs.statSync(basePath);
+  if (!baseStat.isDirectory()) {
+    console.error(`\n❌ La ruta no es una carpeta / Path is not a directory: ${basePath}\n`);
+    process.exit(1);
+  }
+
+  // Construir el destino final: <basePath>/specleap-framework
+  const targetDir = path.join(basePath, FOLDER_NAME);
 
-setup.on('close', (code) => {
-  process.exit(code);
+  // No sobrescribir si ya existe
+  if (fs.existsSync(targetDir)) {
+    console.error(`\n❌ Ya existe / Already exists: ${targetDir}`);
+    console.error('   Elige otra carpeta base o elimina la existente.');
+    console.error('   Choose another base folder or delete the existing one.\n');
+    process.exit(1);
+  }
+
+  console.log(`\n🚀 Copiando SpecLeap Framework a / Copying SpecLeap Framework to:`);
+  console.log(`   ${targetDir}\n`);
+
+  // Crear destino y copiar archivos
+  try {
+    fs.mkdirSync(targetDir, { recursive: true });
+    execSync(`cp -R "${packageDir}"/* "${targetDir}"/`, { stdio: 'inherit' });
+    execSync(`cp -R "${packageDir}"/.??* "${targetDir}"/ 2>/dev/null || true`, { stdio: 'ignore' });
+    console.log(`✅ Archivos copiados / Files copied\n`);
+  } catch (err) {
+    console.error('❌ Error copiando archivos / Error copying files:', err.message);
+    process.exit(1);
+  }
+
+  // Ejecutar setup.sh DESDE el directorio copiado, exportando la ruta
+  // para que setup.sh la use en el mensaje final.
+  const setupPath = path.join(targetDir, 'setup.sh');
+
+  const setup = spawn('bash', [setupPath], {
+    stdio: 'inherit',
+    cwd: targetDir,
+    env: {
+      ...process.env,
+      SPECLEAP_INSTALL_PATH: targetDir
+    }
+  });
+
+  setup.on('close', (code) => {
+    process.exit(code);
+  });
+}
+
+main().catch((err) => {
+  console.error('\n❌ Error inesperado / Unexpected error:', err.message);
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specleap-framework",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "Spec-Driven Development Framework — Transform VSCode, Cursor, JetBrains into spec-first development machines",
   "keywords": [
     "spec-driven-development",

package/setup.sh

@@ -167,22 +167,70 @@ else
     echo ""
 fi
 
-read -p "$(echo -e ${YELLOW}GitHub Token:${NC} )" GITHUB_TOKEN
-echo ""
+# Validación con reintentos: hasta 3 intentos antes de pedir abort/reintentar
+GITHUB_USER=""
+GITHUB_ATTEMPT=0
+GITHUB_MAX_ATTEMPTS=3
 
-if [ -z "$GITHUB_TOKEN" ]; then
-    echo -e "${RED}$MSG_ERROR GitHub token is required${NC}"
-    exit 1
-fi
+while [ -z "$GITHUB_USER" ]; do
+    GITHUB_ATTEMPT=$((GITHUB_ATTEMPT + 1))
 
-# Verificar token
-echo -ne "Verificando token... "
-GITHUB_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user | grep -o '"login": "[^"]*' | cut -d'"' -f4)
+    read -p "$(echo -e ${YELLOW}GitHub Token:${NC} )" GITHUB_TOKEN
+    echo ""
 
-if [ -z "$GITHUB_USER" ]; then
-    echo -e "${RED}❌ Token inválido${NC}"
-    exit 1
-fi
+    if [ -z "$GITHUB_TOKEN" ]; then
+        if [ "$LANG" = "es" ]; then
+            echo -e "${RED}❌ Token vacío. Pega tu token de GitHub.${NC}"
+        else
+            echo -e "${RED}❌ Empty token. Paste your GitHub token.${NC}"
+        fi
+        echo ""
+        # No cuenta como intento si está vacío (probable typo / pegado mal)
+        GITHUB_ATTEMPT=$((GITHUB_ATTEMPT - 1))
+        continue
+    fi
+
+    # Verificar token contra la API de GitHub
+    echo -ne "Verificando token... "
+    GITHUB_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user | grep -o '"login": "[^"]*' | cut -d'"' -f4)
+
+    if [ -z "$GITHUB_USER" ]; then
+        echo -e "${RED}❌ Token inválido${NC}"
+        echo ""
+
+        if [ "$GITHUB_ATTEMPT" -ge "$GITHUB_MAX_ATTEMPTS" ]; then
+            if [ "$LANG" = "es" ]; then
+                echo -e "${YELLOW}⚠️  Has fallado $GITHUB_MAX_ATTEMPTS veces.${NC}"
+                read -p "$(echo -e ${YELLOW}¿[R]eintentar o [C]ancelar instalación? [R/c]:${NC} )" RETRY_CHOICE
+            else
+                echo -e "${YELLOW}⚠️  You've failed $GITHUB_MAX_ATTEMPTS times.${NC}"
+                read -p "$(echo -e ${YELLOW}[R]etry or [C]ancel installation? [R/c]:${NC} )" RETRY_CHOICE
+            fi
+
+            if [[ "$RETRY_CHOICE" =~ ^[Cc]$ ]]; then
+                if [ "$LANG" = "es" ]; then
+                    echo -e "${RED}Instalación cancelada por el usuario.${NC}"
+                else
+                    echo -e "${RED}Installation cancelled by user.${NC}"
+                fi
+                exit 1
+            fi
+            # Reset contador para nueva ronda de 3 intentos
+            GITHUB_ATTEMPT=0
+            echo ""
+            continue
+        fi
+
+        if [ "$LANG" = "es" ]; then
+            echo "Intenta de nuevo (intento $((GITHUB_ATTEMPT + 1))/$GITHUB_MAX_ATTEMPTS)."
+            echo "Verifica que el token tenga los permisos: repo, workflow."
+        else
+            echo "Try again (attempt $((GITHUB_ATTEMPT + 1))/$GITHUB_MAX_ATTEMPTS)."
+            echo "Make sure the token has the scopes: repo, workflow."
+        fi
+        echo ""
+    fi
+done
 
 echo -e "${GREEN}✅ Token válido (Usuario: $GITHUB_USER)${NC}"
 echo ""
@@ -227,65 +275,113 @@ else
     echo ""
 fi
 
-read -p "$(echo -e ${YELLOW}Asana Token:${NC} )" ASANA_TOKEN
-echo ""
-
-if [ -z "$ASANA_TOKEN" ]; then
-    echo -e "${RED}$MSG_ERROR Asana token is required${NC}"
-    exit 1
-fi
+# Validación con reintentos: hasta 3 intentos antes de pedir abort/reintentar
+ASANA_VALID=""
+ASANA_ATTEMPT=0
+ASANA_MAX_ATTEMPTS=3
 
-# Verificar token y obtener workspace
-echo -ne "Verificando token Asana... "
-ASANA_RESPONSE=$(curl -s -H "Authorization: Bearer $ASANA_TOKEN" https://app.asana.com/api/1.0/workspaces)
+while [ -z "$ASANA_VALID" ]; do
+    ASANA_ATTEMPT=$((ASANA_ATTEMPT + 1))
 
-if echo "$ASANA_RESPONSE" | grep -q '"gid"'; then
-    echo -e "${GREEN}✅ Token válido${NC}"
+    read -p "$(echo -e ${YELLOW}Asana Token:${NC} )" ASANA_TOKEN
     echo ""
-    
-    # Listar workspaces disponibles
-    if [ "$LANG" = "es" ]; then
-        echo "Workspaces disponibles:"
-    else
-        echo "Available workspaces:"
+
+    if [ -z "$ASANA_TOKEN" ]; then
+        if [ "$LANG" = "es" ]; then
+            echo -e "${RED}❌ Token vacío. Pega tu token de Asana (empieza con '0/' o '1/' o '2/').${NC}"
+        else
+            echo -e "${RED}❌ Empty token. Paste your Asana token (starts with '0/' or '1/' or '2/').${NC}"
+        fi
+        echo ""
+        ASANA_ATTEMPT=$((ASANA_ATTEMPT - 1))
+        continue
     fi
-    echo ""
-    
-    # Extraer workspaces (simple parsing)
-    WORKSPACE_COUNT=0
-    while IFS= read -r line; do
-        if echo "$line" | grep -q '"gid"'; then
-            WORKSPACE_COUNT=$((WORKSPACE_COUNT + 1))
-            WS_GID=$(echo "$line" | grep -o '"gid":"[^"]*' | cut -d'"' -f4)
-            WS_NAME=$(echo "$ASANA_RESPONSE" | grep -A1 "\"gid\":\"$WS_GID\"" | grep '"name"' | grep -o '"name":"[^"]*' | cut -d'"' -f4)
-            echo "  $WORKSPACE_COUNT) $WS_NAME (ID: $WS_GID)"
-            
-            # Guardar primer workspace como default
-            if [ $WORKSPACE_COUNT -eq 1 ]; then
-                DEFAULT_WORKSPACE_ID="$WS_GID"
+
+    # Verificar token y obtener workspace
+    echo -ne "Verificando token Asana... "
+    ASANA_RESPONSE=$(curl -s -H "Authorization: Bearer $ASANA_TOKEN" https://app.asana.com/api/1.0/workspaces)
+
+    if echo "$ASANA_RESPONSE" | grep -q '"gid"'; then
+        echo -e "${GREEN}✅ Token válido${NC}"
+        ASANA_VALID="yes"
+    else
+        echo -e "${RED}❌ Token inválido${NC}"
+        echo ""
+
+        if [ "$ASANA_ATTEMPT" -ge "$ASANA_MAX_ATTEMPTS" ]; then
+            if [ "$LANG" = "es" ]; then
+                echo -e "${YELLOW}⚠️  Has fallado $ASANA_MAX_ATTEMPTS veces.${NC}"
+                read -p "$(echo -e ${YELLOW}¿[R]eintentar o [C]ancelar instalación? [R/c]:${NC} )" RETRY_CHOICE
+            else
+                echo -e "${YELLOW}⚠️  You've failed $ASANA_MAX_ATTEMPTS times.${NC}"
+                read -p "$(echo -e ${YELLOW}[R]etry or [C]ancel installation? [R/c]:${NC} )" RETRY_CHOICE
             fi
+
+            if [[ "$RETRY_CHOICE" =~ ^[Cc]$ ]]; then
+                if [ "$LANG" = "es" ]; then
+                    echo -e "${RED}Instalación cancelada por el usuario.${NC}"
+                else
+                    echo -e "${RED}Installation cancelled by user.${NC}"
+                fi
+                exit 1
+            fi
+            ASANA_ATTEMPT=0
+            echo ""
+            continue
         fi
-    done < <(echo "$ASANA_RESPONSE" | grep '"gid"')
-    
-    echo ""
-    if [ "$LANG" = "es" ]; then
-        read -p "$(echo -e ${YELLOW}Workspace ID [Enter para usar el primero]:${NC} )" ASANA_WORKSPACE_INPUT
-    else
-        read -p "$(echo -e ${YELLOW}Workspace ID [Enter to use first]:${NC} )" ASANA_WORKSPACE_INPUT
+
+        if [ "$LANG" = "es" ]; then
+            echo "Intenta de nuevo (intento $((ASANA_ATTEMPT + 1))/$ASANA_MAX_ATTEMPTS)."
+            echo "Verifica que el token sea Personal Access Token de Asana."
+        else
+            echo "Try again (attempt $((ASANA_ATTEMPT + 1))/$ASANA_MAX_ATTEMPTS)."
+            echo "Make sure the token is an Asana Personal Access Token."
+        fi
+        echo ""
     fi
-    
-    if [ -z "$ASANA_WORKSPACE_INPUT" ]; then
-        ASANA_WORKSPACE_ID="$DEFAULT_WORKSPACE_ID"
-    else
-        ASANA_WORKSPACE_ID="$ASANA_WORKSPACE_INPUT"
+done
+
+echo ""
+
+# Listar workspaces disponibles
+if [ "$LANG" = "es" ]; then
+    echo "Workspaces disponibles:"
+else
+    echo "Available workspaces:"
+fi
+echo ""
+
+# Extraer workspaces (simple parsing)
+WORKSPACE_COUNT=0
+while IFS= read -r line; do
+    if echo "$line" | grep -q '"gid"'; then
+        WORKSPACE_COUNT=$((WORKSPACE_COUNT + 1))
+        WS_GID=$(echo "$line" | grep -o '"gid":"[^"]*' | cut -d'"' -f4)
+        WS_NAME=$(echo "$ASANA_RESPONSE" | grep -A1 "\"gid\":\"$WS_GID\"" | grep '"name"' | grep -o '"name":"[^"]*' | cut -d'"' -f4)
+        echo "  $WORKSPACE_COUNT) $WS_NAME (ID: $WS_GID)"
+
+        # Guardar primer workspace como default
+        if [ $WORKSPACE_COUNT -eq 1 ]; then
+            DEFAULT_WORKSPACE_ID="$WS_GID"
+        fi
     fi
-    
-    echo -e "${GREEN}✅ Workspace seleccionado: $ASANA_WORKSPACE_ID${NC}"
+done < <(echo "$ASANA_RESPONSE" | grep '"gid"')
+
+echo ""
+if [ "$LANG" = "es" ]; then
+    read -p "$(echo -e ${YELLOW}Workspace ID [Enter para usar el primero]:${NC} )" ASANA_WORKSPACE_INPUT
 else
-    echo -e "${RED}❌ Token inválido${NC}"
-    exit 1
+    read -p "$(echo -e ${YELLOW}Workspace ID [Enter to use first]:${NC} )" ASANA_WORKSPACE_INPUT
+fi
+
+if [ -z "$ASANA_WORKSPACE_INPUT" ]; then
+    ASANA_WORKSPACE_ID="$DEFAULT_WORKSPACE_ID"
+else
+    ASANA_WORKSPACE_ID="$ASANA_WORKSPACE_INPUT"
 fi
 
+echo -e "${GREEN}✅ Workspace seleccionado: $ASANA_WORKSPACE_ID${NC}"
+
 echo ""
 sleep 1
 
@@ -420,43 +516,63 @@ echo "   ✅ $MSG_SUCCESS"
 echo -e "${NC}${GREEN}${LINE}${NC}"
 echo ""
 
+# Ruta de instalación: viene de bin/specleap como env var SPECLEAP_INSTALL_PATH.
+# Fallback a $PWD si alguien ejecutó setup.sh directamente sin pasar por bin.
+INSTALL_PATH="${SPECLEAP_INSTALL_PATH:-$(pwd)}"
+
+if [ "$LANG" = "es" ]; then
+    echo -e "${CYAN}${BOLD}📍 SpecLeap instalado en:${NC}"
+else
+    echo -e "${CYAN}${BOLD}📍 SpecLeap installed at:${NC}"
+fi
+echo -e "   ${BOLD}${GREEN}$INSTALL_PATH${NC}"
+echo ""
+echo -e "${CYAN}${LINE}${NC}"
+echo ""
+
 echo -e "${YELLOW}${BOLD}$MSG_NEXT_STEPS${NC}"
 echo ""
 
 if [ "$LANG" = "es" ]; then
-    echo "  ${BOLD}1. Instalar CodeRabbit en GitHub:${NC}"
+    echo "  ${BOLD}1. Entra a la carpeta del proyecto:${NC}"
+    echo "     ${GREEN}cd \"$INSTALL_PATH\"${NC}"
+    echo ""
+    echo "  ${BOLD}2. Instalar CodeRabbit en GitHub:${NC}"
     echo "     ${CYAN}https://github.com/apps/coderabbitai${NC}"
     echo ""
-    echo "  ${BOLD}2. Ejecutar cuestionario (20 min):${NC}"
+    echo "  ${BOLD}3. Ejecutar cuestionario (20 min):${NC}"
     echo "     ${GREEN}./scripts/generate-contrato.sh${NC}"
     echo ""
-    echo "  ${BOLD}3. Push a GitHub:${NC}"
+    echo "  ${BOLD}4. Push a GitHub:${NC}"
     echo "     ${GREEN}git init && git add . && git commit -m 'init: SpecLeap setup'${NC}"
     echo "     ${GREEN}git push origin main${NC}"
     echo ""
-    echo "  ${BOLD}4. Abrir en tu IDE:${NC}"
+    echo "  ${BOLD}5. Abrir en tu IDE:${NC}"
     echo "     ${GREEN}code .${NC}  (VSCode)"
     echo "     ${GREEN}cursor .${NC}  (Cursor)"
     echo ""
-    echo "  ${BOLD}5. En el chat con la IA, escribe:${NC}"
+    echo "  ${BOLD}6. En el chat con la IA, escribe:${NC}"
     echo "     ${GREEN}ayuda${NC}"
     echo ""
 else
-    echo "  ${BOLD}1. Install CodeRabbit on GitHub:${NC}"
+    echo "  ${BOLD}1. Enter the project folder:${NC}"
+    echo "     ${GREEN}cd \"$INSTALL_PATH\"${NC}"
+    echo ""
+    echo "  ${BOLD}2. Install CodeRabbit on GitHub:${NC}"
     echo "     ${CYAN}https://github.com/apps/coderabbitai${NC}"
     echo ""
-    echo "  ${BOLD}2. Run questionnaire (20 min):${NC}"
+    echo "  ${BOLD}3. Run questionnaire (20 min):${NC}"
     echo "     ${GREEN}./scripts/generate-contrato.sh${NC}"
     echo ""
-    echo "  ${BOLD}3. Push to GitHub:${NC}"
+    echo "  ${BOLD}4. Push to GitHub:${NC}"
     echo "     ${GREEN}git init && git add . && git commit -m 'init: SpecLeap setup'${NC}"
     echo "     ${GREEN}git push origin main${NC}"
     echo ""
-    echo "  ${BOLD}4. Open in your IDE:${NC}"
+    echo "  ${BOLD}5. Open in your IDE:${NC}"
     echo "     ${GREEN}code .${NC}  (VSCode)"
     echo "     ${GREEN}cursor .${NC}  (Cursor)"
     echo ""
-    echo "  ${BOLD}5. In AI chat, type:${NC}"
+    echo "  ${BOLD}6. In AI chat, type:${NC}"
     echo "     ${GREEN}ayuda${NC}"
     echo ""
 fi