refacil-sdd-ai 2.1.4 → 2.1.7

package/README.md

@@ -101,7 +101,9 @@ Para mantener trazabilidad y calidad sin pasos innecesarios:
 6. `/refacil:archive`
 7. `/refacil:up-code`
 
-Si es bugfix, puedes iniciar con `/refacil:bug` y luego continuar con `up-code` (el review se ejecuta automaticamente si no se hizo).
+Si es bugfix, puedes iniciar con `/refacil:bug` y luego continuar con `/refacil:review` → `/refacil:up-code`.
+
+> **Nota**: `/refacil:up-code` verifica automaticamente que el review se haya completado. Si no se ejecuto `/refacil:review`, lo lanza automaticamente antes del push como medida de seguridad.
 
 ## Flujos de trabajo
 
@@ -115,9 +117,9 @@ Si es bugfix, puedes iniciar con `/refacil:bug` y luego continuar con `up-code`
 /refacil:verify
 # → Si hay correcciones: verify pregunta si aplicarlas automaticamente
 # → Si aprueba: aplica fixes y re-verifica (max 2 rondas)
-/refacil:review          # opcional — se ejecuta automaticamente en up-code si no se hizo
+/refacil:review
 /refacil:archive
-/refacil:up-code         # si falta review, lo ejecuta automaticamente antes del push
+/refacil:up-code
 ```
 
 ### Bug fix
@@ -127,7 +129,8 @@ Si es bugfix, puedes iniciar con `/refacil:bug` y luego continuar con `up-code`
 # → Investiga, implementa fix, genera tests de regresion
 # → Crea trazabilidad en openspec/changes/fix-[ID]-[nombre]/summary.md
 # → Pregunta por ID de ticket (ej. REF-123) para nombrar la carpeta
-/refacil:up-code         # ejecuta review automaticamente si no se hizo
+/refacil:review
+/refacil:up-code
 ```
 
 > **Nota**: En una misma rama pueden corregirse multiples bugs. Cada uno genera su propia carpeta `fix-*` con su trazabilidad independiente.
@@ -156,7 +159,7 @@ Antes de avanzar de etapa, valida estos estados:
 - `READY_FOR_VERIFY`: implementacion terminada y enfocada al alcance
 - `READY_FOR_REVIEW`: verify ejecutado y bloqueantes tratados
 - `READY_FOR_ARCHIVE`: cambio funcionalmente cerrado + review aprobado (`.review-passed`)
-- `READY_FOR_MERGE`: rama lista para PR
+- `READY_FOR_MERGE`: review aprobado (`.review-passed`), rama remota actualizada para PR
 
 ### Hooks automaticos
 
@@ -164,7 +167,7 @@ El paquete instala hooks en `.claude/settings.json` durante `init` y `update`:
 
 | Hook | Evento | Que hace |
 |------|--------|----------|
-| `check-update` | `SessionStart` | Verifica si hay nueva version del paquete en npm e informa al usuario |
+| `check-update` | `SessionStart` | Verifica si hay nueva version del paquete en npm y la instala automaticamente |
 | `check-review` | `PreToolUse` (Bash) | Intercepta `git push` y verifica que exista `.review-passed` en cada cambio activo de `openspec/changes/`. Si falta, ejecuta `/refacil:review` automaticamente |
 
 #### Flujo del hook de review
@@ -204,7 +207,8 @@ El archivo `.review-passed` contiene: veredicto, fecha, resumen, cantidad de hal
 1. **`refacil-sdd-ai init`** copia las skills a `.claude/skills/` y `.cursor/skills/`, crea `CLAUDE.md` + `.cursorrules`, y configura hooks automaticos en `.claude/settings.json`
 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
-4. Los hooks garantizan calidad automaticamente: verificacion de version al iniciar sesion y review obligatorio antes de push
+4. `/refacil:up-code` verifica que el review se haya completado antes de pushear — si falta, ejecuta `/refacil:review` automaticamente
+5. En Claude Code, los hooks agregan una capa extra: auto-actualizacion de version al iniciar sesion y bloqueo de push sin review
 
 ```
 refacil-sdd-ai init          →  Skills en .claude/ y .cursor/
@@ -221,7 +225,7 @@ refacil-sdd-ai init          →  Skills en .claude/ y .cursor/
 /refacil:review              →  Review con checklist + .review-passed si aprueba
 /refacil:bug                 →  Fix + trazabilidad en openspec/changes/fix-*/summary.md
 /refacil:archive             →  Cambio archivado
-/refacil:up-code             →  Review automatico (si falta) + push a rama de desarrollo
+/refacil:up-code             →  Verifica review (si falta lo ejecuta) + push a rama
 ```
 
 ## Que se instala en tu repo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "2.1.4",
+  "version": "2.1.7",
   "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

@@ -17,13 +17,16 @@ Eres un guia **breve**: eliges el siguiente comando; el detalle de cada flujo es
 
 ## Menu
 
-1. Feature nuevo → `/refacil:propose` luego flujo estandar hasta `/refacil:up-code`
-2. Bug → `/refacil:bug` → opcional `/refacil:review` → `/refacil:up-code`
+1. Feature nuevo → `/refacil:propose` → `/refacil:apply` → `/refacil:test` → `/refacil:verify` → `/refacil:review` → `/refacil:archive` → `/refacil:up-code`
+2. Bug → `/refacil:bug` → `/refacil:review` → `/refacil:up-code`
 3. Explorar → `/refacil:explore`
 4. Tests → `/refacil:test`
-5. Validar implementacion → `/refacil:verify` (luego `/refacil:review` si aplica)
-6. Subir codigo → `/refacil:up-code`
-7. Configurar repo → `refacil-sdd-ai init` (global + por repo) y `/refacil:setup`
+5. Validar implementacion → `/refacil:verify`
+6. Review de calidad → `/refacil:review`
+7. Subir codigo → `/refacil:up-code`
+8. Configurar repo → `refacil-sdd-ai init` (global + por repo) y `/refacil:setup`
+
+> **Nota**: `/refacil:up-code` verifica automaticamente que el review se haya completado. Si no se ejecuto `/refacil:review`, lo lanza automaticamente antes del push como medida de seguridad.
 
 ## Tips (una linea por herramienta)
 

package/skills/prereqs/METHODOLOGY-CONTRACT.md

@@ -8,8 +8,8 @@ Este archivo centraliza reglas transversales para evitar duplicacion e inconsist
 - **READY_FOR_APPLY**: artefactos SDD completos (`proposal.md`, `design.md`, `tasks.md`, especificacion en `specs.md` y/o `specs/**/*.md`) y aprobacion explicita del usuario.
 - **READY_FOR_VERIFY**: implementacion terminada, sin cambios fuera de alcance.
 - **READY_FOR_REVIEW**: verify ejecutado, issues criticos resueltos o explicitamente aceptados por el usuario.
-- **READY_FOR_ARCHIVE**: tasks completas o excepciones aprobadas, verificacion ejecutada, cambio funcionalmente cerrado.
-- **READY_FOR_MERGE**: review aprobado y rama remota actualizada para PR.
+- **READY_FOR_ARCHIVE**: review aprobado (`.review-passed` existe), tasks completas o excepciones aprobadas, cambio funcionalmente cerrado.
+- **READY_FOR_MERGE**: review aprobado (`.review-passed` existe), rama remota actualizada para PR. `/refacil:up-code` verifica automaticamente el review antes del push — si falta, lo ejecuta.
 
 ## 2) Politica AGENTS.md