refacil-sdd-ai 2.0.0 → 2.0.1

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "refacil-sdd-ai",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
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"
@@ -33,19 +33,31 @@ Ejecuta `openspec --version 2>&1`.
33
33
  - Verificar permisos (puede necesitar `sudo` en Linux/Mac)
34
34
  - Verificar que npm global bin esta en el PATH
35
35
 
36
- ### Paso 3: Inicializar OpenSpec en el repo
36
+ ### Paso 3: Configurar perfil OpenSpec con todos los workflows
37
37
 
38
- Verifica si existe la carpeta `openspec/` en la raiz del proyecto.
38
+ Antes de inicializar, configura el perfil global para garantizar que se instalen TODOS los workflows requeridos:
39
39
 
40
- - Si ya existe: "OpenSpec ya inicializado. OK"
41
- - Si no existe, ejecuta:
40
+ ```bash
41
+ openspec config set profile custom
42
+ openspec config set workflows "explore,new,continue,apply,ff,sync,archive,bulk-archive,verify,onboard"
43
+ ```
44
+
45
+ Verifica que la configuracion quedo correcta:
46
+ ```bash
47
+ openspec config list
48
+ ```
49
+
50
+ Debe mostrar `profile: custom` y los 10 workflows listados.
51
+
52
+ ### Paso 4: Inicializar OpenSpec en el repo
53
+ - ejecuta:
42
54
  ```bash
43
55
  openspec init --tools claude,cursor
44
56
  ```
45
57
 
46
58
  **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.
47
59
 
48
- ### Paso 4: Configurar OpenSpec
60
+ ### Paso 5: Configurar OpenSpec
49
61
 
50
62
  Verifica si existe `openspec/config.yaml`.
51
63
 
@@ -60,13 +72,13 @@ language: spanish
60
72
 
61
73
  **Si ya existe**, verifica que tenga `language: spanish`. Si no lo tiene, sugiere agregarlo.
62
74
 
63
- ### Paso 5: Generar AGENTS.md
75
+ ### Paso 6: Generar AGENTS.md
64
76
 
65
77
  **Este es el paso mas importante.** Analiza el repositorio automaticamente para generar un `AGENTS.md` personalizado.
66
78
 
67
79
  Verifica si ya existe `AGENTS.md` en la raiz. Si existe, pregunta al usuario si quiere regenerarlo. Si no quiere, salta este paso.
68
80
 
69
- #### 5.1 Analizar el repositorio
81
+ #### 6.1 Analizar el repositorio
70
82
 
71
83
  Lee estos archivos si existen (no falles si alguno no existe, simplemente omitelo):
72
84
  - `package.json` — nombre, scripts, dependencias (tech stack)
@@ -80,7 +92,7 @@ Lee estos archivos si existen (no falles si alguno no existe, simplemente omitel
80
92
  - `Dockerfile` o `docker-compose.yml` — info de deployment
81
93
  - `.env.example` — variables de entorno
82
94
 
83
- #### 5.2 Generar el AGENTS.md
95
+ #### 6.2 Generar el AGENTS.md
84
96
 
85
97
  Con la informacion recopilada, genera un archivo `AGENTS.md` completo. El contenido debe ser en espanol con terminos tecnicos en ingles.
86
98
 
@@ -107,7 +119,7 @@ Secciones obligatorias:
107
119
  - "Nunca hacer": anti-patrones especificos para el stack
108
120
  - "Preguntar primero": cambios de alto impacto que requieren confirmacion
109
121
 
110
- #### 5.3 Fallback si el analisis falla
122
+ #### 6.3 Fallback si el analisis falla
111
123
 
112
124
  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:
113
125
 
@@ -147,13 +159,32 @@ TODO: Completar con las convenciones del equipo
147
159
 
148
160
  Informa al usuario que el AGENTS.md fue generado con secciones TODO que debe completar manualmente o ejecutando `/refacil:setup` de nuevo.
149
161
 
150
- #### 5.4 Mostrar al usuario
162
+ #### 6.4 Mostrar al usuario
151
163
 
152
164
  Muestra el AGENTS.md generado completo. Pregunta si quiere ajustar algo antes de guardarlo.
153
165
 
154
166
  Si el usuario aprueba (o no tiene cambios), escribe el archivo en la raiz del proyecto.
155
167
 
156
- ### Paso 6: Verificar skills
168
+ ### Paso 7: Verificar skills
169
+
170
+ #### 7.1 Verificar skills de OpenSpec
171
+
172
+ Verifica que existan las 10 carpetas de skills de OpenSpec en `.claude/skills/`:
173
+ - `openspec-apply-change`
174
+ - `openspec-archive-change`
175
+ - `openspec-bulk-archive-change`
176
+ - `openspec-continue-change`
177
+ - `openspec-explore`
178
+ - `openspec-ff-change`
179
+ - `openspec-new-change`
180
+ - `openspec-onboard`
181
+ - `openspec-sync-specs`
182
+ - `openspec-verify-change`
183
+
184
+ - Si las 10 existen: "Skills OpenSpec: 10/10 instaladas OK"
185
+ - Si faltan algunas: informa cuales faltan. Sugiere ejecutar de nuevo `openspec init --tools claude,cursor` o verificar el perfil con `openspec config list`.
186
+
187
+ #### 7.2 Verificar skills de Refacil
157
188
 
158
189
  Verifica que existan las carpetas `.claude/skills/refacil-*` y/o `.cursor/skills/refacil-*`.
159
190
 
@@ -172,16 +203,18 @@ Verifica que existan las carpetas `.claude/skills/refacil-*` y/o `.cursor/skills
172
203
  Luego reinicia esta sesion de Claude Code / Cursor.
173
204
  ```
174
205
 
175
- ### Paso 7: Resumen final
206
+ ### Paso 8: Resumen final
176
207
 
177
208
  ```
178
209
  === refacil:setup completado ===
179
- Node.js: [version] OK
180
- OpenSpec: [version] OK
181
- openspec/: Inicializado OK
182
- config.yaml: Configurado OK
183
- AGENTS.md: Generado OK
184
- Skills Refacil: [N] instaladas OK
210
+ Node.js: [version] OK
211
+ OpenSpec: [version] OK
212
+ Perfil workflows: custom (10 workflows) OK
213
+ openspec/: Inicializado OK
214
+ config.yaml: Configurado OK
215
+ AGENTS.md: Generado OK
216
+ Skills OpenSpec: 10/10 instaladas OK
217
+ Skills Refacil: [N] instaladas OK
185
218
 
186
219
  IMPORTANTE: Si acabas de instalar las skills por primera vez,
187
220
  debes REINICIAR la sesion de Claude Code o Cursor para que