refacil-sdd-ai 1.0.1 → 1.0.4

package/README.md

@@ -11,12 +11,15 @@ Instala skills para **Claude Code** y **Cursor** que guian al desarrollador por
 
 ## Instalacion y Setup
 
+Se recomienda instalar **a nivel global** para no tener que instalar el paquete en cada repositorio donde se use la metodologia.
+
 ```bash
-# 1. Instalar el paquete
-npm install --save-dev refacil-sdd-ai
+# 1. Instalar de forma global (una sola vez)
+npm install -g refacil-sdd-ai
 
-# 2. Inicializar (copia skills a .claude/ y .cursor/, crea CLAUDE.md y .cursorrules)
-npx refacil-sdd-ai init
+# 2. En la raiz del repo donde quieras usar la metodologia:
+refacil-sdd-ai init
+#    Copia skills a .claude/ y .cursor/, crea CLAUDE.md y .cursorrules
 
 # 3. IMPORTANTE: Reiniciar la sesion de Claude Code o Cursor
 #    (las skills nuevas no se detectan hasta reiniciar)
@@ -24,22 +27,32 @@ npx refacil-sdd-ai init
 # 4. En Claude Code o Cursor, ejecutar:
 /refacil:setup
 #    Esto hace:
-#    - Verifica Node.js y OpenSpec
-#    - Instala OpenSpec si no esta (npm install -g @fission-ai/openspec@latest)
+#    - Verifica Node.js
+#    - Verifica OpenSpec (si no esta instalado, lo instala globalmente)
 #    - Inicializa openspec/ en el repo (openspec init --tools claude,cursor)
 #    - Crea openspec/config.yaml con idioma espanol
 #    - Genera AGENTS.md automaticamente analizando el repo
 ```
 
+### Actualizar a una nueva version
+
+```bash
+# Actualizar el paquete global
+npm update -g refacil-sdd-ai
+
+# En cada repo donde se use, re-copiar las skills actualizadas:
+refacil-sdd-ai update
+```
+
 > **Nota**: `openspec init` tambien instala sus propios comandos (`opsx:*`) en `.claude/` y `.cursor/`. Esto es normal. Los `refacil:*` y `opsx:*` coexisten sin conflicto. El equipo debe usar `refacil:*` como interfaz principal.
 
 ## Comandos del CLI
 
 ```bash
-npx refacil-sdd-ai init      # Instalar skills y crear configs
-npx refacil-sdd-ai update    # Actualizar skills a la ultima version
-npx refacil-sdd-ai clean     # Eliminar skills del repo
-npx refacil-sdd-ai help      # Ver ayuda
+refacil-sdd-ai init      # Instalar skills y crear configs en el repo actual
+refacil-sdd-ai update    # Actualizar skills a la ultima version
+refacil-sdd-ai clean     # Eliminar skills del repo
+refacil-sdd-ai help      # Ver ayuda
 ```
 
 ## Skills disponibles
@@ -89,12 +102,12 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
 
 ## Como funciona
 
-1. **`npx refacil-sdd-ai init`** copia las skills a `.claude/skills/` y `.cursor/skills/`, y crea `CLAUDE.md` + `.cursorrules`
+1. **`refacil-sdd-ai init`** copia las skills a `.claude/skills/` y `.cursor/skills/`, y crea `CLAUDE.md` + `.cursorrules`
 2. **`/refacil:setup`** (en Claude Code o Cursor) instala OpenSpec, analiza el repo y genera un `AGENTS.md` personalizado
 3. Las demas skills (`propose`, `apply`, `test`, etc.) leen `AGENTS.md` para entender las convenciones del proyecto
 
 ```
-npx refacil-sdd-ai init     →  Skills en .claude/ y .cursor/
+refacil-sdd-ai init          →  Skills en .claude/ y .cursor/
                                  CLAUDE.md y .cursorrules creados
 
 /refacil:setup               →  OpenSpec instalado
@@ -120,20 +133,14 @@ AGENTS.md                    # Generado por /refacil:setup (NO por el CLI)
 openspec/                    # Generado por /refacil:setup via OpenSpec
 ```
 
-## Actualizar
-
-Cuando se publique una nueva version del paquete:
-
-```bash
-npm update refacil-sdd-ai
-npx refacil-sdd-ai update    # Re-copia skills sin tocar AGENTS.md ni configs
-```
-
 ## Desinstalar
 
 ```bash
-npx refacil-sdd-ai clean     # Elimina skills de .claude/ y .cursor/
-npm uninstall refacil-sdd-ai
+# Eliminar skills del repo actual
+refacil-sdd-ai clean
+
+# Desinstalar paquete global (opcional)
+npm uninstall -g refacil-sdd-ai
 ```
 
 ## Tecnologias

package/bin/cli.js

@@ -171,8 +171,8 @@ function help() {
     help      Muestra esta ayuda
 
   Flujo completo:
-    1. npm install --save-dev refacil-sdd-ai
-    2. npx refacil-sdd-ai init
+    1. npm install -g refacil-sdd-ai
+    2. refacil-sdd-ai init
     3. REINICIAR sesion de Claude Code o Cursor
     4. Ejecutar: /refacil:setup (instala OpenSpec + genera AGENTS.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "SDD-AI: Specification-Driven Development with AI — metodologia de desarrollo con IA usando OpenSpec, Claude Code y Cursor",
   "bin": {
     "refacil-sdd-ai": "./bin/cli.js"

package/skills/guide/SKILL.md

@@ -142,13 +142,24 @@ FLUJO PARA SUBIR CODIGO:
 ```
 CONFIGURACION:
 
+Pre-requisito (una sola vez, instalacion global):
+  npm install -g refacil-sdd-ai
+
+En cada repo nuevo:
+  refacil-sdd-ai init
+  (reiniciar sesion de Claude Code o Cursor)
+
 1. /refacil:setup
    Verifica e instala todo lo necesario:
    - Node.js >= 20.19.0
-   - OpenSpec
+   - OpenSpec (si no esta instalado, lo instala globalmente)
    - Inicializacion del repo
    - Configuracion de convenciones
    - Verificacion de AGENTS.md y skills
+
+Actualizar a nueva version:
+  npm update -g refacil-sdd-ai
+  refacil-sdd-ai update   (en cada repo)
 ```
 
 ## Tips

package/skills/setup/SKILL.md

@@ -121,7 +121,14 @@ Verifica que existan las carpetas `.claude/skills/refacil-*` y/o `.cursor/skills
 - Si NO existen: informa al usuario:
   ```
   Las skills de Refacil no estan instaladas.
-  Ejecuta en la terminal: npx refacil-sdd-ai init
+
+  Si ya tienes refacil-sdd-ai instalado globalmente:
+    refacil-sdd-ai init
+
+  Si no lo tienes instalado globalmente:
+    npm install -g refacil-sdd-ai
+    refacil-sdd-ai init
+
   Luego reinicia esta sesion de Claude Code / Cursor.
   ```
 

package/skills/up-code/SKILL.md

@@ -27,12 +27,13 @@ Verifica que la rama actual **NO** sea ninguna de las siguientes ramas protegida
 - `develop`
 - `testing`
 - `qa`
+- `dev`
 
 Si la rama actual es una rama protegida, **DETENTE** e informa al usuario:
 
 ```
 ERROR: Estas en la rama '[nombre-rama]' que es una rama de ambiente protegida.
-No se puede hacer push directo a ramas protegidas (master, main, develop, testing, qa).
+No se puede hacer push directo a ramas protegidas (master, main, develop, testing, qa, dev).
 
 Crea una rama de desarrollo primero:
   git checkout -b feature/[nombre-descriptivo]
@@ -59,9 +60,7 @@ Ejecuta `git status` para verificar si hay cambios para subir.
 
 ### Paso 5: Push a remoto
 
-1. Verifica si la rama ya tiene tracking remoto ejecutando `git rev-parse --abbrev-ref @{upstream} 2>/dev/null`.
-2. Si **tiene** tracking remoto (el comando retorna algo como `origin/[rama]`): ejecuta `git push` (sin flags adicionales).
-3. Si **NO tiene** tracking remoto (el comando falla o retorna vacio): ejecuta `git push -u origin [rama-actual]` para establecer el tracking.
+Ejecuta `git push -u origin [rama-actual]` para subir los cambios.
 
 ### Paso 6: Confirmar