specleap-framework 2.2.0 → 2.2.1

package/.commands/compliance.md

@@ -9,7 +9,7 @@
 ## Qué dimensiones se auditan
 
 1. **Version** — El `package.json.version` coincide con el último tag de git.
-2. **Skills** — El número de carpetas en `~/.skills/` coincide con los counters declarados en `CLAUDE.md`, `README.md` y `.quality/baselines/baseline.json`.
+2. **Skills** — El número de carpetas en `~/.claude/skills/` (o `~/.skills/` si es instalación legacy) coincide con los counters declarados en `CLAUDE.md`, `README.md` y `.quality/baselines/baseline.json`.
 3. **i18n** — Todas las claves de `.specleap/i18n/es.json` existen en `.specleap/i18n/en.json` y viceversa.
 4. **Hooks** — `.claude/hooks/spec-guard.sh` existe, tiene shebang, es ejecutable y está referenciado en `.claude/settings.json.template`.
 5. **Baseline** — `.quality/baselines/baseline.json.repo_snapshot` no difiere >20% de los counters reales del repo.

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.1] - 2026-05-22
+
+### Fixed
+
+- **Bug crítico: los Agent Skills no se cargaban en Claude Code.** `scripts/install-skills.sh` instalaba en `$HOME/.skills/`, que es un path obsoleto que Claude Code dejó de monitorizar. El path canónico que auto-descubre Claude Code es `$HOME/.claude/skills/`. Resultado del bug: todos los usuarios de SpecLeap (incluido Styng) tenían los 34 Agent Skills instalados pero **invisibles** para el runtime — ninguno se activaba por contexto. Detectado tras consultar la doc oficial de Claude Code: solo lee skills de `~/.claude/skills/` (user-level) y `.claude/skills/` (project-level).
+  - **Fix**: `scripts/install-skills.sh` ahora instala en `$HOME/.claude/skills/`. Si detecta una instalación legacy en `$HOME/.skills/` (de versiones ≤ 2.2.0), crea un symlink desde el path canónico apuntando al legacy. Así los usuarios existentes no tienen que mover archivos ni reinstalar — solo ejecutar `bash scripts/install-skills.sh` una vez para que el symlink se cree.
+  - **Migración manual** (alternativa al symlink automático): `ln -s ~/.skills ~/.claude/skills`.
+  - **Verificación**: tras el fix, decirle "Hola" a Claude Code dentro del proyecto y pedir algo que dispare un skill conocido (ej: "qué debo verificar antes de cerrar un ticket") debe activar `verification-before-completion`.
+
+### Changed
+
+- **`CLAUDE.md`, `README.md`, `SETUP.md`, `scripts/README.md`, `.commands/compliance.md`** actualizados para reflejar el path canónico `~/.claude/skills/` y documentar la compatibilidad con instalaciones legacy.
+
 ## [2.2.0] - 2026-05-02
 
 ### Changed

package/CLAUDE.md

@@ -172,7 +172,7 @@ Read and follow these standards for ALL code:
 
 ## Agent Skills (Progressive Disclosure)
 
-If **20 Agent Skills TIER 1** are installed (`~/.skills/`), they activate automatically:
+If **Agent Skills TIER 1 + TIER 2 (34 total)** are installed (`~/.claude/skills/`, path that Claude Code auto-discovers), they activate automatically:
 
 ### Activation Triggers
 

package/README.md

@@ -96,7 +96,7 @@ bash setup.sh
 | **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.
+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 `~/.claude/skills/` y genera la estructura base. Tiempo total: 10 a 15 minutos.
 
 **Requisitos previos:**
 
@@ -139,7 +139,7 @@ El prefijo `/` está reservado por Claude Code para sus propios slash commands (
 
 ## Agent Skills
 
-SpecLeap instala **34 Agent Skills profesionales** en `~/.skills/` durante el setup. Se activan automáticamente cuando el contexto lo requiere.
+SpecLeap instala **34 Agent Skills profesionales** en `~/.claude/skills/` (path canónico que Claude Code auto-descubre) durante el setup. Se activan automáticamente cuando el contexto lo requiere.
 
 ### TIER 1 — 20 skills base
 

package/SETUP.md

@@ -69,7 +69,7 @@ bash setup.sh
 **Qué hace `setup.sh`:**
 - Selecciona idioma (Español/English)
 - Pide tokens GitHub y Asana
-- Instala los 34 Agent Skills en `~/.skills/`
+- Instala los 34 Agent Skills en `~/.claude/skills/` (path canónico que Claude Code auto-descubre)
 - Configura CodeRabbit
 - Crea estructura base + archivos de configuración
 
@@ -233,7 +233,7 @@ Instalación:
 bash scripts/install-skills.sh
 ```
 
-Se descargan e instalan 34 skills en `~/.skills/` (20 TIER 1 más 14 TIER 2):
+Se descargan e instalan 34 skills en `~/.claude/skills/` (path canónico que Claude Code auto-descubre — desde v2.2.1; instalaciones legacy en `~/.skills/` siguen funcionando vía symlink automático). 20 TIER 1 más 14 TIER 2:
 
 - **Consistencia (6):** `verification-before-completion`, `systematic-debugging`, `requesting-code-review`, `receiving-code-review`, `code-reviewer`, `debugging-wizard`
 - **Backend (6):** `laravel-specialist`, `api-designer`, `database-optimizer`, `python-pro`, `react-expert`, `typescript-pro`
@@ -247,7 +247,7 @@ Se descargan e instalan 34 skills en `~/.skills/` (20 TIER 1 más 14 TIER 2):
 Verificar lo instalado:
 
 ```bash
-ls ~/.skills/
+ls ~/.claude/skills/
 ```
 
 ---
@@ -393,7 +393,7 @@ export PATH="$PATH:$(pwd)/openspec/cli"
 
 1. Verifica instalación:
 ```bash
-ls -la ~/.skills/
+ls -la ~/.claude/skills/
 ```
 
 2. Reinicia tu IDE (VSCode/Cursor/JetBrains)
@@ -439,7 +439,7 @@ chmod +x .git/hooks/pre-commit
 - [ ] IDE abierto (VSCode/Cursor) y chat con Claude funcional
 - [ ] Comando `ayuda` ejecutado exitosamente
 - [ ] **Asana configurado en `.env`** (OBLIGATORIO)
-- [ ] **20 Agent Skills instaladas en ~/.skills/** (OBLIGATORIO)
+- [ ] **34 Agent Skills instaladas en ~/.claude/skills/** (OBLIGATORIO)
 - [ ] **Git hooks instalados** (OBLIGATORIO)
 - [ ] **CodeRabbit configurado en GitHub** (OBLIGATORIO)
 - [ ] **Repositorio pusheado a GitHub** (OBLIGATORIO)

package/package.json

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

package/scripts/README.md

@@ -43,7 +43,7 @@ git commit --no-verify -m "mensaje"
 
 ### `install-skills.sh`
 
-**Propósito:** Instalar los 34 Agent Skills del framework en `~/.skills/`.
+**Propósito:** Instalar los 34 Agent Skills del framework en `~/.claude/skills/` (path canónico que Claude Code auto-descubre). Si existe `~/.skills/` de instalaciones previas (versiones ≤ 2.2.0), se crea un symlink desde el path canónico para mantener compatibilidad.
 
 **Uso:**
 ```bash

package/scripts/install-skills.sh

@@ -1,6 +1,10 @@
 #!/bin/bash
-# SpecLeap — Instalador de Agent Skills TIER 1 + TIER 2
-# Versión 2.1.1 — 34 skills profesionales
+# SpecLeap — Instalador de Agent Skills TIER 1 + TIER 2 (34 skills profesionales)
+#
+# Path: instala en $HOME/.claude/skills/ (path canónico que Claude Code
+# auto-descubre). Si existe $HOME/.skills/ (path legacy de versiones previas
+# de SpecLeap), se crea un symlink desde el path canónico para mantener
+# compatibilidad sin mover archivos.
 
 set -e
 
@@ -85,9 +89,22 @@ INSTALLED=0
 FAILED=0
 SKIPPED=0
 
-SKILLS_DIR="$HOME/.skills"
+SKILLS_DIR="$HOME/.claude/skills"
+LEGACY_SKILLS_DIR="$HOME/.skills"
 TMP_DIR="/tmp/specleap-skills-$$"
 
+# Compatibilidad con instalaciones legacy:
+# Si el path antiguo ($HOME/.skills/) tiene skills y el path canónico
+# no existe todavía, crear symlink. Así Claude Code los ve sin tener
+# que mover archivos ni reinstalar nada.
+if [ -d "$LEGACY_SKILLS_DIR" ] && [ ! -e "$SKILLS_DIR" ]; then
+    mkdir -p "$HOME/.claude"
+    ln -s "$LEGACY_SKILLS_DIR" "$SKILLS_DIR"
+    echo -e "${YELLOW}⚠️  Detected legacy skills path $LEGACY_SKILLS_DIR${NC}"
+    echo -e "${YELLOW}   Created symlink at $SKILLS_DIR for Claude Code auto-discovery.${NC}"
+    echo ""
+fi
+
 mkdir -p "$SKILLS_DIR"
 mkdir -p "$TMP_DIR"