refacil-sdd-ai 2.0.1 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -67,7 +67,7 @@ Una vez instalado, estos comandos estan disponibles en Claude Code y Cursor:
67
67
  | `/refacil:propose` | Crear propuesta de cambio (proposal + specs + design + tasks) |
68
68
  | `/refacil:apply` | Implementar las tasks del cambio propuesto |
69
69
  | `/refacil:test` | Generar tests unitarios desde los artefactos |
70
- | `/refacil:verify` | Validar implementacion vs specs |
70
+ | `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
71
71
  | `/refacil:review` | Review con checklist de calidad del equipo |
72
72
  | `/refacil:archive` | Archivar cambio completado |
73
73
  | `/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:
83
83
  /refacil:apply
84
84
  /refacil:test
85
85
  /refacil:verify
86
+ # → Si hay correcciones: verify pregunta si aplicarlas automaticamente
87
+ # → Si aprueba: aplica fixes y re-verifica (max 2 rondas)
86
88
  /refacil:review
87
89
  /refacil:archive
88
90
  /refacil:up-code
@@ -118,7 +120,7 @@ refacil-sdd-ai init → Skills en .claude/ y .cursor/
118
120
  /refacil:propose → Artefactos en openspec/changes/
119
121
  /refacil:apply → Codigo implementado
120
122
  /refacil:test → Tests generados
121
- /refacil:verify → Validacion PASS/FAIL
123
+ /refacil:verify → Validacion PASS/FAIL (puede aplicar fixes con aprobacion)
122
124
  /refacil:review → Review con checklist
123
125
  /refacil:archive → Cambio archivado
124
126
  /refacil:up-code → Push a rama de desarrollo
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "refacil-sdd-ai",
3
- "version": "2.0.1",
3
+ "version": "2.0.3",
4
4
  "description": "SDD-AI: Specification-Driven Development with AI — metodologia de desarrollo con IA usando OpenSpec, Claude Code y Cursor",
5
5
  "bin": {
6
6
  "refacil-sdd-ai": "./bin/cli.js"
@@ -111,6 +111,7 @@ Al terminar la implementacion de OpenSpec, agrega este resumen:
111
111
  Siguientes pasos:
112
112
  1. /refacil:test — Generar tests unitarios
113
113
  2. /refacil:verify — Validar implementacion vs specs
114
+ (si encuentra correcciones, te ofrece aplicarlas automaticamente)
114
115
  ```
115
116
 
116
117
  ## Reglas
@@ -51,6 +51,17 @@ FLUJO PARA NUEVO FEATURE:
51
51
  Valida que la implementacion cumple con las specs.
52
52
  Revisa completitud, correccion y coherencia.
53
53
 
54
+ Si encuentra correcciones necesarias (CRITICAL o WARNING):
55
+ - Te muestra el reporte con los issues encontrados
56
+ - Te pregunta si quieres que aplique las correcciones automaticamente
57
+ - Si aceptas: aplica SOLO los fixes necesarios y re-verifica
58
+ - Maximo 2 rondas de correccion automatica
59
+ - Si despues de 2 rondas quedan issues, los lista para correccion manual
60
+ - Si no aceptas: lista los issues para que los corrijas manualmente
61
+ y luego ejecutes /refacil:verify de nuevo
62
+
63
+ Solo avanza a review cuando la verificacion pasa completamente.
64
+
54
65
  6. /refacil:review
55
66
  Review con el checklist de calidad del equipo.
56
67
  Evalua conformidad con specs, codigo, arquitectura, testing,
@@ -106,4 +106,4 @@ Correcciones necesarias:
106
106
  - Ser constructivo: no solo decir que falla, sino como corregirlo
107
107
  - No ser excesivamente estricto con N/A — si no aplica, marcarlo
108
108
  - Si todo es PASS, felicitar brevemente y sugerir `/refacil:archive`
109
- - Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes
109
+ - Si hay FAILs criticos (seguridad, tests), marcar como bloqueantes y sugerir `/refacil:verify` para aplicar correcciones con asistencia de la IA
@@ -138,7 +138,7 @@ Si por cualquier razon no puedes generar un AGENTS.md completo (archivos no legi
138
138
  | `/refacil:propose` | Crear propuesta de cambio |
139
139
  | `/refacil:apply` | Implementar tasks del cambio |
140
140
  | `/refacil:test` | Generar tests unitarios |
141
- | `/refacil:verify` | Validar implementacion vs specs |
141
+ | `/refacil:verify` | Validar implementacion vs specs (con opcion de aplicar correcciones) |
142
142
  | `/refacil:review` | Review con checklist de calidad |
143
143
  | `/refacil:archive` | Archivar cambio completado |
144
144
  | `/refacil:up-code` | Subir codigo a rama de desarrollo |
@@ -169,7 +169,7 @@ Si el usuario aprueba (o no tiene cambios), escribe el archivo en la raiz del pr
169
169
 
170
170
  #### 7.1 Verificar skills de OpenSpec
171
171
 
172
- Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/`:
172
+ Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/` y `.cursor/skills/`:
173
173
  - `openspec-apply-change`
174
174
  - `openspec-archive-change`
175
175
  - `openspec-bulk-archive-change`
@@ -77,6 +77,9 @@ Si el usuario ejecuta `/refacil:test` sin argumentos:
77
77
  Coverage archivos nuevos: [X]%
78
78
  Coverage minimo requerido: 80%
79
79
  Estado: CUMPLE / NO CUMPLE
80
+
81
+ Siguiente paso: /refacil:verify — Validar implementacion vs specs
82
+ (si encuentra correcciones, te ofrece aplicarlas automaticamente)
80
83
  ```
81
84
 
82
85
  ### Modo 2: Tests para archivo especifico (con argumento)
@@ -79,15 +79,31 @@ Ejecuta `git status` para verificar si hay cambios para subir.
79
79
 
80
80
  Ejecuta `git push -u origin [rama-actual]` para subir los cambios.
81
81
 
82
- ### Paso 6: Confirmar
82
+ ### Paso 6: Confirmar y crear PR
83
83
 
84
+ 1. Muestra el resumen del push:
84
85
  ```
85
86
  === Codigo subido ===
86
87
  Rama: [nombre-rama]
87
88
  Commit: [hash-corto] [mensaje]
88
89
  Remote: origin/[nombre-rama]
90
+ ```
91
+
92
+ 2. **Pregunta al usuario** hacia cual rama destino quiere crear el Pull Request. **No sugieras ni asumas** una rama por defecto. Simplemente pregunta:
93
+ ```
94
+ Hacia cual rama quieres crear el Pull Request?
95
+ ```
89
96
 
90
- Siguiente paso: Crear Pull Request hacia la rama destino.
97
+ 3. Una vez el usuario responda, obtén la URL del repositorio remoto con `git remote get-url origin` y determina el hosting para generar el link correcto de creación del PR:
98
+ - **GitHub** (url contiene `github.com`): `https://github.com/[owner]/[repo]/compare/[rama-destino]...[rama-actual]?expand=1`
99
+ - **Bitbucket** (url contiene `bitbucket.org`): `https://bitbucket.org/[workspace]/[repo]/pull-requests/new?source=[rama-actual]&dest=[rama-destino]`
100
+ - Si no se puede determinar el hosting, muestra ambos formatos para que el usuario elija.
101
+
102
+ Nota: para URLs SSH (`git@github.com:owner/repo.git` o `git@bitbucket.org:workspace/repo.git`), extrae owner/workspace y repo del path tras el `:`.
103
+
104
+ 4. Muestra el link al usuario:
105
+ ```
106
+ Crea tu PR aqui: [link]
91
107
  ```
92
108
 
93
109
  ## Reglas
@@ -58,13 +58,44 @@ Correcciones necesarias:
58
58
  2. [issues de tests]
59
59
  ```
60
60
 
61
- ### Paso 4: Siguiente paso
61
+ ### Paso 4: Resultado y siguiente paso
62
62
 
63
- - Si APROBADO: "Ejecuta `/refacil:review` para el review con checklist del equipo."
64
- - Si REQUIERE CORRECCIONES: "Corrige los issues listados y ejecuta `/refacil:verify` de nuevo."
63
+ #### Si APROBADO (sin issues CRITICAL ni WARNING):
64
+
65
+ "Ejecuta `/refacil:review` para el review con checklist del equipo."
66
+
67
+ #### Si REQUIERE CORRECCIONES (hay issues CRITICAL o WARNING):
68
+
69
+ Presenta las correcciones necesarias y pregunta al usuario:
70
+
71
+ ```
72
+ RESULTADO: REQUIERE CORRECCIONES
73
+
74
+ Correcciones necesarias:
75
+ 1. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
76
+ 2. [CRITICAL/WARNING] [descripcion del issue y como corregirlo]
77
+
78
+ Quieres que aplique estas correcciones? (si/no)
79
+ - Si: aplicare los fixes y re-verificare automaticamente
80
+ - No: puedes corregirlos manualmente y ejecutar /refacil:verify de nuevo
81
+ ```
82
+
83
+ **Si el usuario acepta:**
84
+
85
+ 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.
86
+ 2. Si hay tests que necesitan ajuste por las correcciones, ajustarlos tambien.
87
+ 3. Muestra un resumen breve de los archivos modificados.
88
+ 4. Re-ejecuta automaticamente la verificacion completa (vuelve al Paso 1) para confirmar que las correcciones resolvieron los issues.
89
+ 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.
90
+
91
+ **Si el usuario no acepta:**
92
+
93
+ Lista los issues para que el usuario los corrija manualmente. Sugiere ejecutar `/refacil:verify` de nuevo cuando termine.
65
94
 
66
95
  ## Reglas
67
96
 
68
- - NO modificar codigo durante la verificacion
97
+ - Durante la fase de verificacion (Pasos 1-3): NO modificar codigo, solo analizar y reportar
98
+ - Las correcciones SOLO se aplican en el Paso 4, despues del reporte completo y con aprobacion explicita del usuario
99
+ - Las correcciones deben ser quirurgicas: solo lo necesario para resolver los issues reportados
69
100
  - Ser estricto con los criterios de la spec
70
- - Si algo no esta en la spec pero parece necesario, mencionarlo como observacion, no como fallo
101
+ - Si algo no esta en la spec pero parece necesario, mencionarlo como SUGGESTION (observacion), no como CRITICAL/WARNING