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 +1 -1
- package/skills/setup/SKILL.md +51 -18
package/package.json
CHANGED
package/skills/setup/SKILL.md
CHANGED
|
@@ -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:
|
|
36
|
+
### Paso 3: Configurar perfil OpenSpec con todos los workflows
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
Antes de inicializar, configura el perfil global para garantizar que se instalen TODOS los workflows requeridos:
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
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
|
|
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
|
|
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
|
-
####
|
|
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
|
-
####
|
|
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
|
-
####
|
|
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
|
-
####
|
|
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
|
|
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
|
|
206
|
+
### Paso 8: Resumen final
|
|
176
207
|
|
|
177
208
|
```
|
|
178
209
|
=== refacil:setup completado ===
|
|
179
|
-
Node.js:
|
|
180
|
-
OpenSpec:
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
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
|