refacil-sdd-ai 1.0.5 → 1.0.8

package/bin/cli.js

@@ -55,24 +55,50 @@ function installSkills() {
   return installed;
 }
 
+const SDD_SECTION_MARKER = '## Metodologia SDD-AI (Refacil)';
+
+function extractSddSection(templateContent) {
+  const idx = templateContent.indexOf(SDD_SECTION_MARKER);
+  if (idx === -1) return templateContent;
+  return templateContent.substring(idx);
+}
+
 function createClaudeMd() {
   const dest = path.join(projectRoot, 'CLAUDE.md');
+  const template = fs.readFileSync(path.join(packageRoot, 'templates', 'claude-md.md'), 'utf8');
+
   if (fs.existsSync(dest)) {
-    console.log('  CLAUDE.md ya existe, no se sobreescribe.');
-    return false;
+    const existing = fs.readFileSync(dest, 'utf8');
+    if (existing.includes(SDD_SECTION_MARKER)) {
+      console.log('  CLAUDE.md ya tiene la seccion SDD-AI. Sin cambios.');
+      return false;
+    }
+    const sddSection = extractSddSection(template);
+    fs.writeFileSync(dest, existing.trimEnd() + '\n\n' + sddSection + '\n');
+    console.log('  CLAUDE.md existente — seccion SDD-AI agregada al final.');
+    return true;
   }
-  const template = fs.readFileSync(path.join(packageRoot, 'templates', 'claude-md.md'), 'utf8');
+
   fs.writeFileSync(dest, template);
   return true;
 }
 
 function createCursorRules() {
   const dest = path.join(projectRoot, '.cursorrules');
+  const template = fs.readFileSync(path.join(packageRoot, 'templates', 'cursorrules.md'), 'utf8');
+
   if (fs.existsSync(dest)) {
-    console.log('  .cursorrules ya existe, no se sobreescribe.');
-    return false;
+    const existing = fs.readFileSync(dest, 'utf8');
+    if (existing.includes(SDD_SECTION_MARKER)) {
+      console.log('  .cursorrules ya tiene la seccion SDD-AI. Sin cambios.');
+      return false;
+    }
+    const sddSection = extractSddSection(template);
+    fs.writeFileSync(dest, existing.trimEnd() + '\n\n' + sddSection + '\n');
+    console.log('  .cursorrules existente — seccion SDD-AI agregada al final.');
+    return true;
   }
-  const template = fs.readFileSync(path.join(packageRoot, 'templates', 'cursorrules.md'), 'utf8');
+
   fs.writeFileSync(dest, template);
   return true;
 }
@@ -123,14 +149,14 @@ function init() {
   const count = installSkills();
   console.log(`  ${count} skills instaladas en .claude/skills/ y .cursor/skills/`);
 
-  // Create CLAUDE.md
+  // Create or update CLAUDE.md
   if (createClaudeMd()) {
-    console.log('  CLAUDE.md creado');
+    console.log('  CLAUDE.md OK');
   }
 
-  // Create .cursorrules
+  // Create or update .cursorrules
   if (createCursorRules()) {
-    console.log('  .cursorrules creado');
+    console.log('  .cursorrules OK');
   }
 
   console.log('\n  Siguientes pasos:\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "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"
@@ -31,6 +31,6 @@
     "url": ""
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.19.0"
   }
 }

package/skills/apply/SKILL.md

@@ -10,12 +10,58 @@ Este comando envuelve la funcionalidad de OpenSpec apply y agrega las convencion
 
 ## Antes de empezar
 
-Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones.
-Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+### Verificar prerequisitos
+
+1. **OpenSpec instalado**: Ejecuta `openspec --version 2>&1`. Si el comando falla o no se reconoce, informa al usuario: "OpenSpec no esta instalado. Ejecuta `/refacil:setup` para instalarlo y configurar el repositorio." y **detente**.
+
+2. **OpenSpec inicializado**: Verifica que exista la carpeta `openspec/` en la raiz del proyecto. Si no existe, informa al usuario: "OpenSpec no esta inicializado en este repositorio. Ejecuta `/refacil:setup` para configurarlo." y **detente**.
+
+3. **AGENTS.md**: Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones. Si NO existe, informa al usuario: "No se encontro AGENTS.md. Ejecuta `/refacil:setup` para generarlo." y **detente**.
 
 ## Instrucciones
 
-### Paso 1: Delegar a OpenSpec apply
+### Paso 1: Validar rama de trabajo
+
+Ejecuta `git branch --show-current` para obtener la rama actual.
+
+#### Ramas protegidas: `master`, `main`, `develop`, `dev`, `testing`, `qa`
+
+- **Si la rama es cualquier rama protegida** (`master`, `main`, `develop`, `dev`, `testing`, `qa`):
+
+  Informa al usuario que no se pueden hacer cambios directamente en esa rama y **pidele el numero de tarea de Jira**:
+  ```
+  Estas en la rama '[nombre-rama]' que es una rama protegida.
+  No se deben hacer cambios directamente aqui.
+
+  Cual es el numero de tarea de Jira para este cambio? (ejemplo: RF-5088)
+  ```
+
+  **Crear la rama siempre desde develop/dev actualizado:**
+  1. **Verificar working directory limpio**: Ejecuta `git status --porcelain`. Si hay cambios sin commitear (archivos modificados o sin trackear), informa al usuario:
+     ```
+     Hay cambios sin commitear en la rama actual.
+     Para cambiar de rama de forma segura, necesito guardarlos temporalmente con git stash.
+     Quieres que haga git stash antes de continuar?
+     ```
+     - Si acepta: ejecuta `git stash push -m "stash-automatico-refacil"` y continua. Al final del proceso (despues de crear la rama), ejecuta `git stash pop` para restaurar los cambios.
+     - Si no acepta: **detente**.
+  2. Detecta cual existe en el repo: `develop` o `dev` (ejecuta `git branch --list develop dev`)
+  3. Cambia a esa rama: `git checkout develop` (o `dev`)
+  4. Actualiza: `git pull origin develop` (o `dev`)
+  5. Determina el nombre de la nueva rama:
+     - Si el usuario entrego el numero de Jira (ej: `RF-5088`): la rama sera `feature/RF-5088`
+     - Si el usuario no tiene tarea de Jira: usa un nombre descriptivo corto basado en el cambio activo en openspec/changes/ (ej: `feature/agregar-filtro-productos`). Pero **recomienda crear la tarea en Jira** para trazabilidad.
+  6. Verifica que la rama no exista ya: `git branch --list [nombre-rama]`
+     - Si ya existe, informa al usuario y pregunta si quiere cambiarse a esa rama existente o elegir otro nombre.
+  7. Crea la rama: `git checkout -b [nombre-rama]`
+  8. Si se hizo stash en el paso 1, ejecuta `git stash pop` para restaurar los cambios.
+
+  Si el usuario no acepta crear rama, **detente**.
+
+- **Si la rama es cualquier otra** (feature/, fix/, hotfix/, refactor/, etc.):
+  La rama es valida. Continua con el siguiente paso sin interrumpir.
+
+### Paso 2: Delegar a OpenSpec apply
 
 Ejecuta internamente las instrucciones de la skill `openspec-apply-change` que esta instalada en `.claude/skills/openspec-apply-change/SKILL.md` (o `.cursor/skills/openspec-apply-change/SKILL.md`).
 
@@ -27,7 +73,7 @@ Lee esa skill y sigue sus instrucciones pasandole el argumento del usuario: **$A
 - No hacer refactors no solicitados en codigo existente
 - Si una task es ambigua, preguntar antes de implementar
 
-### Paso 2: Resumen y siguiente paso (aporte Refacil)
+### Paso 3: Resumen y siguiente paso (aporte Refacil)
 
 Al terminar la implementacion de OpenSpec, agrega este resumen:
 

package/skills/archive/SKILL.md

@@ -10,8 +10,13 @@ Este comando envuelve la funcionalidad de OpenSpec archive (que internamente lla
 
 ## Antes de empezar
 
-Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones.
-Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+### Verificar prerequisitos
+
+1. **OpenSpec instalado**: Ejecuta `openspec --version 2>&1`. Si el comando falla o no se reconoce, informa al usuario: "OpenSpec no esta instalado. Ejecuta `/refacil:setup` para instalarlo y configurar el repositorio." y **detente**.
+
+2. **OpenSpec inicializado**: Verifica que exista la carpeta `openspec/` en la raiz del proyecto. Si no existe, informa al usuario: "OpenSpec no esta inicializado en este repositorio. Ejecuta `/refacil:setup` para configurarlo." y **detente**.
+
+3. **AGENTS.md**: Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones. Si NO existe, informa al usuario: "No se encontro AGENTS.md. Ejecuta `/refacil:setup` para generarlo." y **detente**.
 
 ## Instrucciones
 

package/skills/bug/SKILL.md

@@ -64,7 +64,48 @@ Presenta la correccion propuesta:
 
 Espera aprobacion del usuario antes de implementar.
 
-### Paso 5: Implementar el fix
+### Paso 5: Validar rama de trabajo (antes de escribir codigo)
+
+**ANTES de implementar cualquier cambio**, ejecuta `git branch --show-current` para obtener la rama actual.
+
+#### Ramas protegidas: `master`, `main`, `develop`, `dev`, `testing`, `qa`
+
+- **Si la rama es cualquier rama protegida** (`master`, `main`, `develop`, `dev`, `testing`, `qa`):
+
+  Informa al usuario que no se pueden hacer cambios directamente en esa rama y **pidele el numero de tarea de Jira**:
+  ```
+  Estas en la rama '[nombre-rama]' que es una rama protegida.
+  No se deben hacer cambios directamente aqui.
+
+  Cual es el numero de tarea de Jira para este fix? (ejemplo: RF-5088)
+  ```
+
+  **Crear la rama siempre desde develop/dev actualizado:**
+  1. **Verificar working directory limpio**: Ejecuta `git status --porcelain`. Si hay cambios sin commitear (archivos modificados o sin trackear), informa al usuario:
+     ```
+     Hay cambios sin commitear en la rama actual.
+     Para cambiar de rama de forma segura, necesito guardarlos temporalmente con git stash.
+     Quieres que haga git stash antes de continuar?
+     ```
+     - Si acepta: ejecuta `git stash push -m "stash-automatico-refacil"` y continua. Al final del proceso (despues de crear la rama), ejecuta `git stash pop` para restaurar los cambios.
+     - Si no acepta: **detente**.
+  2. Detecta cual existe en el repo: `develop` o `dev` (ejecuta `git branch --list develop dev`)
+  3. Cambia a esa rama: `git checkout develop` (o `dev`)
+  4. Actualiza: `git pull origin develop` (o `dev`)
+  5. Determina el nombre de la nueva rama:
+     - Si el usuario entrego el numero de Jira (ej: `RF-5088`): la rama sera `fix/RF-5088`
+     - Si el usuario no tiene tarea de Jira: usa un nombre descriptivo corto del bug (ej: `fix/error-calculo-total`). Pero **recomienda crear la tarea en Jira** para trazabilidad.
+  6. Verifica que la rama no exista ya: `git branch --list [nombre-rama]`
+     - Si ya existe, informa al usuario y pregunta si quiere cambiarse a esa rama existente o elegir otro nombre.
+  7. Crea la rama: `git checkout -b [nombre-rama]`
+  8. Si se hizo stash en el paso 1, ejecuta `git stash pop` para restaurar los cambios.
+
+  Si el usuario no acepta crear rama, **detente**.
+
+- **Si la rama es cualquier otra** (feature/, fix/, hotfix/, etc.):
+  La rama es valida. Continua sin interrumpir.
+
+### Paso 6: Implementar el fix
 
 Con aprobacion del usuario:
 
@@ -72,7 +113,7 @@ Con aprobacion del usuario:
 2. Verifica que el cambio es minimo y enfocado
 3. No hacer refactors adicionales
 
-### Paso 6: Tests de regresion
+### Paso 7: Tests de regresion
 
 Genera tests que:
 
@@ -93,7 +134,7 @@ describe('Bug Fix: [descripcion corta]', () => {
 });
 ```
 
-### Paso 7: Verificar
+### Paso 8: Verificar
 
 1. Ejecuta `npm test` — todos los tests deben pasar
 2. Muestra resumen del fix
@@ -112,7 +153,7 @@ describe('Bug Fix: [descripcion corta]', () => {
  2. /refacil:up-code — Subir los cambios a tu rama de desarrollo
 ```
 
-### Paso 8 (opcional): Crear artefactos OpenSpec
+### Paso 9 (opcional): Crear artefactos OpenSpec
 
 Si el bug es significativo, preguntar al usuario si quiere documentarlo en OpenSpec:
 - Crear carpeta en `openspec/changes/fix-[nombre]/`

package/skills/explore/SKILL.md

@@ -10,9 +10,13 @@ Este comando envuelve la funcionalidad de OpenSpec explore y agrega contexto del
 
 ## Antes de empezar
 
-Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones del repositorio. Usa esa informacion como contexto durante la exploracion.
+### Verificar prerequisitos
 
-Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+1. **OpenSpec instalado**: Ejecuta `openspec --version 2>&1`. Si el comando falla o no se reconoce, informa al usuario: "OpenSpec no esta instalado. Ejecuta `/refacil:setup` para instalarlo y configurar el repositorio." y **detente**.
+
+2. **OpenSpec inicializado**: Verifica que exista la carpeta `openspec/` en la raiz del proyecto. Si no existe, informa al usuario: "OpenSpec no esta inicializado en este repositorio. Ejecuta `/refacil:setup` para configurarlo." y **detente**.
+
+3. **AGENTS.md**: Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones del repositorio. Usa esa informacion como contexto durante la exploracion. Si NO existe, informa al usuario: "No se encontro AGENTS.md. Ejecuta `/refacil:setup` para generarlo." y **detente**.
 
 ## Instrucciones
 

package/skills/guide/SKILL.md

@@ -39,8 +39,9 @@ FLUJO PARA NUEVO FEATURE:
    La IA NO continua hasta que apruebes explicitamente.
 
 3. /refacil:apply
-   Implementa las tasks aprobadas en el paso anterior.
-   La IA escribe el codigo siguiendo el plan.
+   Valida que NO estes en una rama protegida (master, main, develop, dev, testing, qa).
+   Si estas en una, te pide el numero de tarea de Jira y crea la rama desde develop.
+   Luego implementa las tasks aprobadas siguiendo el plan.
 
 4. /refacil:test
    Genera tests unitarios basados en las specs y el design.
@@ -52,14 +53,16 @@ FLUJO PARA NUEVO FEATURE:
 
 6. /refacil:review
    Review con el checklist de calidad del equipo.
-   Evalua codigo, arquitectura, testing, seguridad y performance.
+   Evalua conformidad con specs, codigo, arquitectura, testing,
+   seguridad, performance y reglas especificas del proyecto.
 
 7. /refacil:archive
    Archiva el cambio completado. Mueve artefactos a archive/.
 
 8. /refacil:up-code
    Sube los cambios a tu rama de desarrollo.
-   Valida que NO estes en ramas protegidas (master, main, develop, testing, qa).
+   Valida que NO estes en ramas protegidas (master, main, develop, dev, testing, qa).
+   Si necesita crear rama, te pide el numero de tarea de Jira.
 ```
 
 ### Opcion 2: Bug fix
@@ -73,6 +76,8 @@ FLUJO PARA BUG FIX:
    - La IA investiga la causa raiz en el codebase
    - Te presenta hipotesis para confirmar
    - Propone la correccion y espera tu aprobacion
+   - Valida rama: si estas en rama protegida, te pide el numero
+     de tarea de Jira y crea la rama desde develop
    - Implementa el fix y genera tests de regresion
    - Ejecuta los tests para verificar
 
@@ -118,10 +123,11 @@ FLUJO PARA REVIEW:
    Evalua la implementacion contra el checklist del equipo:
    - Conformidad con specs
    - Calidad de codigo y patrones
-   - Arquitectura DDD
+   - Arquitectura (segun convenciones de AGENTS.md)
    - Testing (coverage >= 80%)
    - Seguridad (OWASP top 10)
    - Performance (N+1, async, indices)
+   - Reglas especificas del proyecto (de AGENTS.md)
 
    Genera un reporte PASS/FAIL/N/A por cada item.
 ```
@@ -134,8 +140,9 @@ FLUJO PARA SUBIR CODIGO:
 1. /refacil:up-code
    Sube tus cambios al repositorio remoto de forma segura:
    - Detecta la rama actual
-   - Valida que NO sea una rama protegida (master, main, develop, testing, qa)
-   - Si estas en rama protegida, te ayuda a crear una rama de desarrollo
+   - Valida que NO sea una rama protegida (master, main, develop, dev, testing, qa)
+   - Si estas en rama protegida, te pide el numero de tarea de Jira
+     y crea la rama desde develop
    - Ejecuta git add, commit y push
 
    Opcionalmente puedes pasar el mensaje del commit:

package/skills/propose/SKILL.md

@@ -10,10 +10,13 @@ Este comando envuelve la funcionalidad de OpenSpec fast-forward (ff) y agrega la
 
 ## Antes de empezar
 
-Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones.
-Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+### Verificar prerequisitos
 
-Verifica que exista `openspec/`. Si no existe, informa al usuario que ejecute `/refacil:setup` primero.
+1. **OpenSpec instalado**: Ejecuta `openspec --version 2>&1`. Si el comando falla o no se reconoce, informa al usuario: "OpenSpec no esta instalado. Ejecuta `/refacil:setup` para instalarlo y configurar el repositorio." y **detente**.
+
+2. **OpenSpec inicializado**: Verifica que exista la carpeta `openspec/` en la raiz del proyecto. Si no existe, informa al usuario: "OpenSpec no esta inicializado en este repositorio. Ejecuta `/refacil:setup` para configurarlo." y **detente**.
+
+3. **AGENTS.md**: Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones, arquitectura y patrones. Si NO existe, informa al usuario: "No se encontro AGENTS.md. Ejecuta `/refacil:setup` para generarlo." y **detente**.
 
 ## Instrucciones
 

package/skills/review/SKILL.md

@@ -88,6 +88,11 @@ Se especifico en las evaluaciones. No des PASS generico — justifica brevemente
  [PASS/FAIL/N/A] Sin archivos generados en commit
  [PASS/FAIL/N/A] Migraciones reversibles (si aplica)
 
+## 9. Reglas especificas del proyecto
+ [PASS/FAIL/N/A] Cumple reglas de "Siempre hacer" de AGENTS.md
+ [PASS/FAIL/N/A] No viola reglas de "Nunca hacer" de AGENTS.md
+ [PASS/FAIL/N/A] Reglas adicionales del proyecto (si aplica)
+
 ---
 RESUMEN: [X] PASS | [Y] FAIL | [Z] N/A
 VEREDICTO: APROBADO / REQUIERE CORRECCIONES

package/skills/review/checklist.md

@@ -1,5 +1,7 @@
 # Checklist de Calidad — Equipo Refacil
 
+> **IMPORTANTE**: Este checklist es generico. Antes de evaluar, lee `AGENTS.md` del proyecto para adaptar cada seccion al stack, arquitectura y convenciones reales del repositorio. Si AGENTS.md indica patrones, frameworks o reglas especificas, usalas en lugar de los ejemplos genericos de abajo.
+
 ## 1. Conformidad con Spec
 - Todos los criterios de aceptacion de la spec estan cubiertos
 - No se implemento funcionalidad fuera del alcance de la spec
@@ -7,33 +9,35 @@
 - El modelo de datos coincide con lo especificado
 
 ## 2. Calidad de Codigo
-- El codigo sigue los patrones existentes del repo (ver AGENTS.md)
+- El codigo sigue los patrones existentes del repo (consultar AGENTS.md seccion de arquitectura/convenciones)
 - No hay codigo duplicado que pueda extraerse
 - Los nombres de variables, funciones y clases son claros y descriptivos
 - No hay console.log, TODO, o codigo comentado sin razon
-- Los imports usan los alias configurados del proyecto (@core/*, @logger/*, etc.)
+- Los imports usan los alias configurados del proyecto (consultar AGENTS.md seccion de alias de rutas, si aplica)
 - No hay dependencias circulares nuevas
 
 ## 3. Arquitectura
-- Se respetan los limites de dominio (DDD)
-- Las dependencias fluyen correctamente: domain <- application <- infrastructure
-- No hay logica de negocio en la capa de infraestructura
-- Los puertos (interfaces) estan en domain, las implementaciones en infrastructure
+- Se respetan los limites y capas definidos en AGENTS.md
+- Las dependencias fluyen en la direccion correcta segun la arquitectura del proyecto
+- No hay logica de negocio en la capa de infraestructura o transporte
+- Las interfaces/puertos estan en la capa correcta segun las convenciones del repo
 - Los DTOs estan en la capa correcta
 
+> **Nota**: La arquitectura varia por proyecto (DDD, MVC, Clean Architecture, Hexagonal, etc.). Consultar AGENTS.md para saber cual aplica y evaluar en consecuencia.
+
 ## 4. Testing
-- Cada archivo nuevo/modificado tiene su .spec.ts correspondiente
+- Cada archivo nuevo/modificado tiene su archivo de test correspondiente
 - Los tests cubren los criterios de aceptacion de la spec
 - Hay tests para edge cases y escenarios de error
 - Los mocks son minimos y necesarios
 - Los tests son independientes entre si
 - Coverage >= 80% en archivos nuevos
-- npm test pasa sin errores
+- Los tests pasan sin errores (ejecutar el comando de test indicado en AGENTS.md)
 
 ## 5. Seguridad
 - No hay secrets hardcodeados (passwords, API keys, tokens)
-- Los inputs del usuario estan validados (class-validator)
-- No hay inyeccion SQL posible (queries parametrizadas con TypeORM)
+- Los inputs del usuario estan validados (usar la libreria de validacion del proyecto)
+- No hay inyeccion SQL posible (queries parametrizadas con el ORM del proyecto)
 - Los endpoints sensibles tienen autorizacion adecuada
 - No se expone informacion sensible en logs o respuestas de error
 
@@ -41,7 +45,7 @@
 - Las consultas a base de datos usan indices apropiados
 - No hay queries N+1
 - Las operaciones pesadas son asincronas donde corresponde
-- No hay memory leaks obvios (subscriptions sin unsubscribe, etc.)
+- No hay memory leaks obvios (subscriptions sin unsubscribe, listeners sin cleanup, etc.)
 
 ## 7. Mantenibilidad
 - El codigo es autoexplicativo (comentarios solo donde la logica no es obvia)
@@ -55,8 +59,7 @@
 - Las migraciones de BD (si hay) son reversibles
 - No hay breaking changes no documentados
 
-## 9. Zona Horaria (Critico)
-- Todas las fechas usan UTC
-- Se usa @core/utils/date-time.util para operaciones con fechas
-- NO se usa new Date() para comparaciones directas
-- Las columnas de BD usan TIMESTAMP WITH TIME ZONE
+## 9. Reglas especificas del proyecto
+- Consultar la seccion "Reglas criticas" de AGENTS.md
+- Evaluar contra las reglas de "Siempre hacer", "Nunca hacer" y "Preguntar primero"
+- Si AGENTS.md define reglas adicionales (ej: zona horaria, formato de fechas, naming conventions), verificar su cumplimiento

package/skills/setup/SKILL.md

@@ -107,7 +107,47 @@ Secciones obligatorias:
    - "Nunca hacer": anti-patrones especificos para el stack
    - "Preguntar primero": cambios de alto impacto que requieren confirmacion
 
-#### 5.3 Mostrar al usuario
+#### 5.3 Fallback si el analisis falla
+
+Si por cualquier razon no puedes generar un AGENTS.md completo (archivos no legibles, repo vacio, error inesperado), genera un AGENTS.md minimo con esta estructura:
+
+```markdown
+# [nombre del proyecto]
+
+> Generado por /refacil:setup — completar manualmente las secciones marcadas con TODO.
+
+## Metodologia SDD-AI
+
+| Comando | Descripcion |
+|---------|-------------|
+| `/refacil:setup` | Instalar OpenSpec y generar AGENTS.md |
+| `/refacil:guide` | Guia interactiva — que comando usar |
+| `/refacil:explore` | Explorar el codebase sin cambios |
+| `/refacil:propose` | Crear propuesta de cambio |
+| `/refacil:apply` | Implementar tasks del cambio |
+| `/refacil:test` | Generar tests unitarios |
+| `/refacil:verify` | Validar implementacion vs specs |
+| `/refacil:review` | Review con checklist de calidad |
+| `/refacil:archive` | Archivar cambio completado |
+| `/refacil:up-code` | Subir codigo a rama de desarrollo |
+| `/refacil:bug` | Flujo guiado de bugfix |
+
+## Stack tecnologico
+TODO: Completar con el stack del proyecto
+
+## Arquitectura
+TODO: Completar con la estructura del proyecto
+
+## Comandos de desarrollo
+TODO: Completar con los scripts de package.json
+
+## Reglas criticas
+TODO: Completar con las convenciones del equipo
+```
+
+Informa al usuario que el AGENTS.md fue generado con secciones TODO que debe completar manualmente o ejecutando `/refacil:setup` de nuevo.
+
+#### 5.4 Mostrar al usuario
 
 Muestra el AGENTS.md generado completo. Pregunta si quiere ajustar algo antes de guardarlo.
 

package/skills/up-code/SKILL.md

@@ -29,17 +29,34 @@ Verifica que la rama actual **NO** sea ninguna de las siguientes ramas protegida
 - `qa`
 - `dev`
 
-Si la rama actual es una rama protegida, **DETENTE** e informa al usuario:
+Si la rama actual es una rama protegida, **DETENTE** y **pide el numero de tarea de Jira**:
 
 ```
-ERROR: Estas en la rama '[nombre-rama]' que es una rama de ambiente protegida.
+ERROR: Estas en la rama '[nombre-rama]' que es una rama protegida.
 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]
+Cual es el numero de tarea de Jira para este cambio? (ejemplo: RF-5088)
 ```
 
-Pregunta al usuario si desea crear una rama de desarrollo. Si acepta, sugiere un nombre basado en los cambios pendientes y ejecuta `git checkout -b [nombre-sugerido]`.
+**Crear la rama siempre desde develop/dev actualizado:**
+1. **Verificar working directory limpio**: Ejecuta `git status --porcelain`. Si hay cambios sin commitear (archivos modificados o sin trackear), informa al usuario:
+   ```
+   Hay cambios sin commitear en la rama actual.
+   Para cambiar de rama de forma segura, necesito guardarlos temporalmente con git stash.
+   Quieres que haga git stash antes de continuar?
+   ```
+   - Si acepta: ejecuta `git stash push -m "stash-automatico-refacil"` y continua. Al final del proceso (despues de crear la rama), ejecuta `git stash pop` para restaurar los cambios.
+   - Si no acepta: **detente**.
+2. Detecta cual existe en el repo: `develop` o `dev` (ejecuta `git branch --list develop dev`)
+3. Cambia a esa rama: `git checkout develop` (o `dev`)
+4. Actualiza: `git pull origin develop` (o `dev`)
+5. Determina el nombre de la nueva rama:
+   - Si el usuario entrego el numero de Jira (ej: `RF-5088`): la rama sera `feature/RF-5088`
+   - Si el usuario no tiene tarea de Jira: usa un nombre descriptivo corto (ej: `feature/ajuste-validacion`). Pero **recomienda crear la tarea en Jira** para trazabilidad.
+6. Verifica que la rama no exista ya: `git branch --list [nombre-rama]`
+   - Si ya existe, informa al usuario y pregunta si quiere cambiarse a esa rama existente o elegir otro nombre.
+7. Crea la rama: `git checkout -b [nombre-rama]`
+8. Si se hizo stash en el paso 1, ejecuta `git stash pop` para restaurar los cambios.
 
 Si el usuario no quiere crear una rama, **detente**. No continuar con el push.
 
@@ -75,7 +92,7 @@ Ejecuta `git push -u origin [rama-actual]` para subir los cambios.
 
 ## Reglas
 
-- NUNCA hacer push a ramas protegidas: master, main, develop, testing, qa
+- NUNCA hacer push a ramas protegidas: master, main, develop, dev, testing, qa
 - Si el usuario esta en una rama protegida, SIEMPRE preguntar antes de crear una rama nueva
 - Siempre hacer push a ramas de desarrollo propias (feature/, fix/, hotfix/, refactor/, etc.)
 - No forzar push (--force) a menos que el usuario lo pida explicitamente

package/skills/verify/SKILL.md

@@ -10,8 +10,13 @@ Este comando envuelve la funcionalidad de OpenSpec verify y agrega verificacion
 
 ## Antes de empezar
 
-Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones.
-Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+### Verificar prerequisitos
+
+1. **OpenSpec instalado**: Ejecuta `openspec --version 2>&1`. Si el comando falla o no se reconoce, informa al usuario: "OpenSpec no esta instalado. Ejecuta `/refacil:setup` para instalarlo y configurar el repositorio." y **detente**.
+
+2. **OpenSpec inicializado**: Verifica que exista la carpeta `openspec/` en la raiz del proyecto. Si no existe, informa al usuario: "OpenSpec no esta inicializado en este repositorio. Ejecuta `/refacil:setup` para configurarlo." y **detente**.
+
+3. **AGENTS.md**: Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones. Si NO existe, informa al usuario: "No se encontro AGENTS.md. Ejecuta `/refacil:setup` para generarlo." y **detente**.
 
 ## Instrucciones