specleap-framework 2.1.12 → 2.1.13

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.13] - 2026-05-01
+
+### Fixed
+
+- **Confusion between the two install flows.** Reported by Styng during testing: with `git clone … && bash setup.sh`, the installer was not asking the carpeta-base / folder-name prompts that `bin/specleap` (the npx entry point) does ask. That looked like a regression but it's by design — the prompts live in `bin/specleap` (Node), not in `setup.sh` (bash). When the user clones with git they already chose where the code lives, and the second positional argument of `git clone` is the canonical way to set a custom folder name. The fix is making the difference obvious in docs and in runtime.
+
+#### Changes
+
+- `setup.sh` now prints a bilingual heads-up at the very start (before the language step) when the current folder is named `specleap-framework` (the `git clone` default) AND the script was invoked without `bin/specleap` having set `SPECLEAP_INSTALL_PATH`. The user gets a one-second pause, an explanation of how to clone with a custom name (`git clone <url> mi-proyecto`), and a [S/n] confirmation before continuing. If they cancel, the script exits 0 cleanly.
+- `README.md`: rewrote the "Instalación Rápida" section as two clearly-labeled options (Opción A: vía npx — interactive prompts; Opción B: vía git clone — direct, name controlled by `git clone <url> <nombre>`) plus a comparison table so the reader picks intentionally.
+- `SETUP.md`: replicated the same comparison upfront in the Quick Start section, with full examples for each path.
+
+### Notes
+
+- No code-path change in the actual installation logic. `bin/specleap` keeps its prompts; `setup.sh` runs the same setup it always ran. Only documentation and a single pre-check in `setup.sh` change.
+- The pre-check in `setup.sh` is opt-out (Enter or `S` to continue), so users who really want a folder named `specleap-framework` aren't forced to do anything extra.
+
 ## [2.1.12] - 2026-04-30
 
 ### 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.12 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
+**Versión actual:** 2.1.13 · **Licencia:** MIT · **Autor:** Styng Arias ([ConceptualCreative](https://conceptualcreative.com))
 
 ---
 
@@ -44,23 +44,57 @@ SpecLeap convierte cualquier IDE con asistente de IA en un entorno de desarrollo
 
 ## Instalación Rápida
 
-### Vía npm (recomendado)
+Hay dos formas de instalar SpecLeap. Elige según tu preferencia:
+
+### Opción A: Vía npm (instalación interactiva, recomendado)
 
 ```bash
 npx specleap-framework@latest
 ```
 
-### Desde GitHub
+El instalador te **pregunta dónde quieres la carpeta y con qué nombre** antes de copiar nada. Ideal si quieres un setup guiado paso a paso.
+
+Ejemplo de lo que verás:
+
+```
+📁 ¿En qué carpeta base instalar SpecLeap?
+   Default: /Users/tu-usuario/Desktop
+Carpeta base: ~/Downloads
+
+📝 ¿Qué nombre quieres para la carpeta?
+   Default: specleap-framework
+Nombre: mi-app-tienda
+
+→ Resultado: /Users/tu-usuario/Downloads/mi-app-tienda/
+```
+
+### Opción B: Vía git clone (control directo, sin prompts)
 
 ```bash
-git clone https://github.com/ConceptualCreative/specleap-framework.git
-cd specleap-framework
+git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
+cd mi-proyecto
 bash setup.sh
 ```
 
-El instalador interactivo solicita los tokens de GitHub y Asana, instala los 34 Agent Skills en `~/.skills/` y genera la estructura base. Tiempo total: 10 a 15 minutos.
+Aquí **tú decides el nombre** pasándolo como segundo argumento de `git clone`. El setup arranca directo, sin preguntar carpeta/nombre porque ya estás dentro del repo donde quieres.
+
+Si haces `git clone <url>` sin segundo argumento, la carpeta se llamará `specleap-framework` (default de git). El setup te avisará por si querías otro nombre.
+
+### Diferencias rápidas
+
+| | Vía npm | Vía git clone |
+|---|---|---|
+| **Pregunta carpeta y nombre** | ✅ Sí, interactivo | ❌ No, lo decides con `cd` y `git clone <url> <nombre>` |
+| **Requiere Node.js** | ✅ Sí (≥ 18) | ⛔ No, solo Git + Bash |
+| **Trae los archivos** | npm los descarga | git los clona del repo |
+| **Ideal para** | Empezar rápido, no recordar el flujo de git | Devs que ya manejan git fluidamente |
+
+A partir de aquí ambos flows son idénticos: el `setup.sh` solicita los tokens de GitHub y Asana, instala los 34 Agent Skills en `~/.skills/` y genera la estructura base. Tiempo total: 10 a 15 minutos.
+
+**Requisitos previos:**
 
-**Requisitos previos:** Node.js ≥ 18, Git, Bash.
+- Vía npm → Node.js ≥ 18, Git, Bash.
+- Vía git clone → Git, Bash.
 
 ---
 

package/SETUP.md

@@ -2,23 +2,70 @@
 
 ## ⚡ Quick Start (5 minutos)
 
-### Paso 1: Clonar el repositorio
+Hay **dos formas de instalar SpecLeap**. Elige la que prefieras según cómo te resulte más cómodo trabajar.
+
+### Comparativa rápida
+
+| | Opción A: vía npx | Opción B: vía git clone |
+|---|---|---|
+| **Pregunta carpeta y nombre** | ✅ Sí, prompt interactivo | ❌ No (lo decides con `cd` y `git clone <url> <nombre>`) |
+| **Requiere** | Node.js ≥ 18, Git, Bash | Git, Bash |
+| **Cuándo usar** | Quieres setup guiado | Manejas git fluidamente |
+
+---
+
+### Opción A: vía npx (recomendado para empezar)
 
 ```bash
-git clone https://github.com/ConceptualCreative/specleap-framework.git
-cd specleap-framework
+cd ~/Downloads      # o donde quieras que vaya el proyecto
+npx specleap-framework@latest
+```
+
+El instalador te pregunta:
+1. **Carpeta base** (default = donde estás).
+2. **Nombre de la carpeta** (default = `specleap-framework`).
+
+Después continúa con el setup normal (idioma, GitHub token, Asana token, skills, CodeRabbit).
+
+**Ejemplo:**
+
 ```
+📁 ¿En qué carpeta base instalar SpecLeap?
+   Default: /Users/tu-usuario/Downloads
+Carpeta base: (Enter para usar default)
 
-### Paso 2: Ejecutar instalador
+📝 ¿Qué nombre quieres para la carpeta?
+   Default: specleap-framework
+Nombre: mi-app-tienda
+
+→ Resultado final: /Users/tu-usuario/Downloads/mi-app-tienda/
+```
+
+---
+
+### Opción B: vía git clone
 
 ```bash
-bash install.sh
+# Clona el repo con el nombre que tú quieras (segundo argumento de git clone)
+git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto
+cd mi-proyecto
+bash setup.sh
 ```
 
-**Qué hace:**
+Aquí **no hay prompts de carpeta o nombre** — ya estás dentro de `mi-proyecto/` que tú nombraste con git. El `setup.sh` arranca directo con la selección de idioma.
+
+Si haces `git clone <url>` **sin segundo argumento**, la carpeta se llamará `specleap-framework` por defecto. El setup te avisará por si esperabas otro nombre y te ofrecerá cancelar.
+
+---
+
+### Después del setup (ambas opciones)
+
+**Qué hace `setup.sh`:**
 - Selecciona idioma (Español/English)
-- Crea estructura de carpetas
-- Genera archivos base
+- Pide tokens GitHub y Asana
+- Instala los 34 Agent Skills en `~/.skills/`
+- Configura CodeRabbit
+- Crea estructura base + archivos de configuración
 
 ### Paso 3: Responder cuestionario
 

package/package.json

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

package/setup.sh

@@ -48,6 +48,38 @@ echo -e "${YELLOW}  v2.0.0 — Instalador Profesional${NC}"
 echo -e "${CYAN}${LINE}${NC}"
 echo ""
 
+# ============================================
+# PRE-CHECK: Aviso si la carpeta se llama "specleap-framework"
+# ============================================
+# Si el usuario clonó con `git clone <url>` (sin segundo argumento), la
+# carpeta se llamará "specleap-framework" por defecto. Le avisamos por si
+# quería otro nombre, antes de empezar el setup interactivo.
+# Solo aplica cuando setup.sh se ejecuta directamente (no via bin/specleap,
+# que ya pregunta nombre interactivamente). Detectamos este caso por
+# ausencia de la variable SPECLEAP_INSTALL_PATH (que solo la pone bin/specleap).
+
+CURRENT_FOLDER_NAME="$(basename "$(pwd)")"
+
+if [ -z "${SPECLEAP_INSTALL_PATH:-}" ] && [ "$CURRENT_FOLDER_NAME" = "specleap-framework" ]; then
+    echo "ℹ️  Esta carpeta se llama 'specleap-framework' (nombre por defecto de git clone)."
+    echo "   This folder is named 'specleap-framework' (git clone default)."
+    echo ""
+    echo "   Si querías otro nombre / If you wanted a different name:"
+    echo "     1) Cancela con Ctrl+C / Cancel with Ctrl+C"
+    echo "     2) Vuelve a ejecutar / Run again with:"
+    echo "        git clone https://github.com/ConceptualCreative/specleap-framework.git mi-proyecto"
+    echo "        cd mi-proyecto"
+    echo "        bash setup.sh"
+    echo ""
+    read -p "¿Continuar con el nombre 'specleap-framework'? / Continue with 'specleap-framework'? [S/n]: " CONTINUE_DEFAULT
+    if [[ "$CONTINUE_DEFAULT" =~ ^[Nn]$ ]]; then
+        echo ""
+        echo "Cancelado por el usuario / Cancelled by user."
+        exit 0
+    fi
+    echo ""
+fi
+
 # ============================================
 # PASO 1: Selección de Idioma
 # ============================================