refacil-sdd-ai 2.0.0 → 2.0.2

package/README.md

@@ -67,7 +67,7 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
 | `/refacil:propose` | Crear propuesta de cambio (proposal + specs + design + tasks) |
 | `/refacil:apply` | Implementar las tasks del cambio propuesto |
 | `/refacil:test` | Generar tests unitarios desde los artefactos |
-| `/refacil:verify` | Validar implementacion vs specs |
+| `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
 | `/refacil:review` | Review con checklist de calidad del equipo |
 | `/refacil:archive` | Archivar cambio completado |
 | `/refacil:up-code` | Subir codigo a rama de desarrollo (con validacion de ramas protegidas) |
@@ -83,6 +83,8 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
 /refacil:apply
 /refacil:test
 /refacil:verify
+# → Si hay correcciones: verify pregunta si aplicarlas automaticamente
+# → Si aprueba: aplica fixes y re-verifica (max 2 rondas)
 /refacil:review
 /refacil:archive
 /refacil:up-code
@@ -118,7 +120,7 @@ refacil-sdd-ai init          →  Skills en .claude/ y .cursor/
 /refacil:propose             →  Artefactos en openspec/changes/
 /refacil:apply               →  Codigo implementado
 /refacil:test                →  Tests generados
-/refacil:verify              →  Validacion PASS/FAIL
+/refacil:verify              →  Validacion PASS/FAIL (puede aplicar fixes con aprobacion)
 /refacil:review              →  Review con checklist
 /refacil:archive             →  Cambio archivado
 /refacil:up-code             →  Push a rama de desarrollo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "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/apply/SKILL.md

@@ -111,6 +111,7 @@ Al terminar la implementacion de OpenSpec, agrega este resumen:
  Siguientes pasos:
  1. /refacil:test — Generar tests unitarios
  2. /refacil:verify — Validar implementacion vs specs
+    (si encuentra correcciones, te ofrece aplicarlas automaticamente)
 ```
 
 ## Reglas

package/skills/guide/SKILL.md

@@ -51,6 +51,17 @@ FLUJO PARA NUEVO FEATURE:
    Valida que la implementacion cumple con las specs.
    Revisa completitud, correccion y coherencia.
 
+   Si encuentra correcciones necesarias (CRITICAL o WARNING):
+   - Te muestra el reporte con los issues encontrados
+   - Te pregunta si quieres que aplique las correcciones automaticamente
+   - Si aceptas: aplica SOLO los fixes necesarios y re-verifica
+   - Maximo 2 rondas de correccion automatica
+   - Si despues de 2 rondas quedan issues, los lista para correccion manual
+   - Si no aceptas: lista los issues para que los corrijas manualmente
+     y luego ejecutes /refacil:verify de nuevo
+
+   Solo avanza a review cuando la verificacion pasa completamente.
+
 6. /refacil:review
    Review con el checklist de calidad del equipo.
    Evalua conformidad con specs, codigo, arquitectura, testing,

package/skills/review/SKILL.md

@@ -106,4 +106,4 @@ Correcciones necesarias:
 - Ser constructivo: no solo decir que falla, sino como corregirlo
 - No ser excesivamente estricto con N/A — si no aplica, marcarlo
 - Si todo es PASS, felicitar brevemente y sugerir `/refacil:archive`
-- Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes
+- Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes y sugerir `/refacil:verify` para aplicar correcciones con asistencia de la IA

package/skills/setup/SKILL.md

@@ -33,19 +33,31 @@ Ejecuta `openspec --version 2>&1`.
   - Verificar permisos (puede necesitar `sudo` en Linux/Mac)
   - Verificar que npm global bin esta en el PATH
 
-### Paso 3: Inicializar OpenSpec en el repo
+### Paso 3: Configurar perfil OpenSpec con todos los workflows
 
-Verifica si existe la carpeta `openspec/` en la raiz del proyecto.
+Antes de inicializar, configura el perfil global para garantizar que se instalen TODOS los workflows requeridos:
 
-- Si ya existe: "OpenSpec ya inicializado. OK"
-- Si no existe, ejecuta:
+```bash
+openspec config set profile custom
+openspec config set workflows "explore,new,continue,apply,ff,sync,archive,bulk-archive,verify,onboard"
+```
+
+Verifica que la configuracion quedo correcta:
+```bash
+openspec config list
+```
+
+Debe mostrar `profile: custom` y los 10 workflows listados.
+
+### Paso 4: Inicializar OpenSpec en el repo
+- ejecuta:
   ```bash
   openspec init --tools claude,cursor
   ```
 
 **IMPORTANTE**: `openspec init` tambien instala sus propios comandos (`opsx:*`) en `.claude/` y `.cursor/`. Esto es normal y esperado. Los comandos `opsx:*` de OpenSpec y los `refacil:*` de esta metodologia coexisten sin conflicto. Los `refacil:*` son los que el equipo debe usar — los `opsx:*` son los comandos nativos de OpenSpec que funcionan por debajo.
 
-### Paso 4: Configurar OpenSpec
+### Paso 5: Configurar OpenSpec
 
 Verifica si existe `openspec/config.yaml`.
 
@@ -60,13 +72,13 @@ language: spanish
 
 **Si ya existe**, verifica que tenga `language: spanish`. Si no lo tiene, sugiere agregarlo.
 
-### Paso 5: Generar AGENTS.md
+### Paso 6: Generar AGENTS.md
 
 **Este es el paso mas importante.** Analiza el repositorio automaticamente para generar un `AGENTS.md` personalizado.
 
 Verifica si ya existe `AGENTS.md` en la raiz. Si existe, pregunta al usuario si quiere regenerarlo. Si no quiere, salta este paso.
 
-#### 5.1 Analizar el repositorio
+#### 6.1 Analizar el repositorio
 
 Lee estos archivos si existen (no falles si alguno no existe, simplemente omitelo):
 - `package.json` — nombre, scripts, dependencias (tech stack)
@@ -80,7 +92,7 @@ Lee estos archivos si existen (no falles si alguno no existe, simplemente omitel
 - `Dockerfile` o `docker-compose.yml` — info de deployment
 - `.env.example` — variables de entorno
 
-#### 5.2 Generar el AGENTS.md
+#### 6.2 Generar el AGENTS.md
 
 Con la informacion recopilada, genera un archivo `AGENTS.md` completo. El contenido debe ser en espanol con terminos tecnicos en ingles.
 
@@ -107,7 +119,7 @@ Secciones obligatorias:
    - "Nunca hacer": anti-patrones especificos para el stack
    - "Preguntar primero": cambios de alto impacto que requieren confirmacion
 
-#### 5.3 Fallback si el analisis falla
+#### 6.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:
 
@@ -126,7 +138,7 @@ Si por cualquier razon no puedes generar un AGENTS.md completo (archivos no legi
 | `/refacil:propose` | Crear propuesta de cambio |
 | `/refacil:apply` | Implementar tasks del cambio |
 | `/refacil:test` | Generar tests unitarios |
-| `/refacil:verify` | Validar implementacion vs specs |
+| `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
 | `/refacil:review` | Review con checklist de calidad |
 | `/refacil:archive` | Archivar cambio completado |
 | `/refacil:up-code` | Subir codigo a rama de desarrollo |
@@ -147,13 +159,32 @@ 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
+#### 6.4 Mostrar al usuario
 
 Muestra el AGENTS.md generado completo. Pregunta si quiere ajustar algo antes de guardarlo.
 
 Si el usuario aprueba (o no tiene cambios), escribe el archivo en la raiz del proyecto.
 
-### Paso 6: Verificar skills
+### Paso 7: Verificar skills
+
+#### 7.1 Verificar skills de OpenSpec
+
+Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/` y `.cursor/skills/`:
+- `openspec-apply-change`
+- `openspec-archive-change`
+- `openspec-bulk-archive-change`
+- `openspec-continue-change`
+- `openspec-explore`
+- `openspec-ff-change`
+- `openspec-new-change`
+- `openspec-onboard`
+- `openspec-sync-specs`
+- `openspec-verify-change`
+
+- Si las 10 existen: "Skills OpenSpec: 10/10 instaladas OK"
+- Si faltan algunas: informa cuales faltan. Sugiere ejecutar de nuevo `openspec init --tools claude,cursor` o verificar el perfil con `openspec config list`.
+
+#### 7.2 Verificar skills de Refacil
 
 Verifica que existan las carpetas `.claude/skills/refacil-*` y/o `.cursor/skills/refacil-*`.
 
@@ -172,16 +203,18 @@ Verifica que existan las carpetas `.claude/skills/refacil-*` y/o `.cursor/skills
   Luego reinicia esta sesion de Claude Code / Cursor.
   ```
 
-### Paso 7: Resumen final
+### Paso 8: Resumen final
 
 ```
 === refacil:setup completado ===
- Node.js:        [version] OK
- OpenSpec:        [version] OK
- openspec/:       Inicializado OK
- config.yaml:     Configurado OK
- AGENTS.md:       Generado OK
- Skills Refacil:  [N] instaladas OK
+ Node.js:         [version] OK
+ OpenSpec:         [version] OK
+ Perfil workflows: custom (10 workflows) OK
+ openspec/:        Inicializado OK
+ config.yaml:      Configurado OK
+ AGENTS.md:        Generado OK
+ Skills OpenSpec:  10/10 instaladas OK
+ Skills Refacil:   [N] instaladas OK
 
  IMPORTANTE: Si acabas de instalar las skills por primera vez,
  debes REINICIAR la sesion de Claude Code o Cursor para que

package/skills/test/SKILL.md

@@ -77,6 +77,9 @@ Si el usuario ejecuta `/refacil:test` sin argumentos:
     Coverage archivos nuevos: [X]%
     Coverage minimo requerido: 80%
     Estado: CUMPLE / NO CUMPLE
+
+   Siguiente paso: /refacil:verify — Validar implementacion vs specs
+   (si encuentra correcciones, te ofrece aplicarlas automaticamente)
    ```
 
 ### Modo 2: Tests para archivo especifico (con argumento)

package/skills/verify/SKILL.md

@@ -58,13 +58,44 @@ Correcciones necesarias:
 2. [issues de tests]
 ```
 
-### Paso 4: Siguiente paso
+### Paso 4: Resultado y siguiente paso
 
-- Si APROBADO: "Ejecuta `/refacil:review` para el review con checklist del equipo."
-- Si REQUIERE CORRECCIONES: "Corrige los issues listados y ejecuta `/refacil:verify` de nuevo."
+#### Si APROBADO (sin issues CRITICAL ni WARNING):
+
+"Ejecuta `/refacil:review` para el review con checklist del equipo."
+
+#### Si REQUIERE CORRECCIONES (hay issues CRITICAL o WARNING):
+
+Presenta las correcciones necesarias y pregunta al usuario:
+
+```
+RESULTADO: REQUIERE CORRECCIONES
+
+Correcciones necesarias:
+1. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
+2. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
+
+Quieres que aplique estas correcciones? (si/no)
+- Si: aplicare los fixes y re-verificare automaticamente
+- No: puedes corregirlos manualmente y ejecutar /refacil:verify de nuevo
+```
+
+**Si el usuario acepta:**
+
+1. Aplica SOLO las correcciones listadas — no agregar funcionalidad nueva, no refactorizar codigo no relacionado, no cambiar nada fuera del alcance de los issues reportados.
+2. Si hay tests que necesitan ajuste por las correcciones, ajustarlos tambien.
+3. Muestra un resumen breve de los archivos modificados.
+4. Re-ejecuta automaticamente la verificacion completa (vuelve al Paso 1) para confirmar que las correcciones resolvieron los issues.
+5. Si la re-verificacion encuentra nuevos issues, repite este ciclo (maximo 2 rondas de correccion automatica). Si despues de 2 rondas aun hay issues, lista los pendientes para correccion manual.
+
+**Si el usuario no acepta:**
+
+Lista los issues para que el usuario los corrija manualmente. Sugiere ejecutar `/refacil:verify` de nuevo cuando termine.
 
 ## Reglas
 
-- NO modificar codigo durante la verificacion
+- Durante la fase de verificacion (Pasos 1-3): NO modificar codigo, solo analizar y reportar
+- Las correcciones SOLO se aplican en el Paso 4, despues del reporte completo y con aprobacion explicita del usuario
+- Las correcciones deben ser quirurgicas: solo lo necesario para resolver los issues reportados
 - Ser estricto con los criterios de la spec
-- Si algo no esta en la spec pero parece necesario, mencionarlo como observacion, no como fallo
+- Si algo no esta en la spec pero parece necesario, mencionarlo como SUGGESTION (observacion), no como CRITICAL/WARNING