refacil-sdd-ai 4.0.0 → 4.0.1

package/README.md

@@ -356,7 +356,7 @@ Bus local (WebSocket sobre `127.0.0.1`) para que los agentes de distintos repos
 
 **Observador puro** (0 tokens): `refacil-sdd-ai bus watch <session>` o `refacil-sdd-ai bus view` para la UI web.
 
-> **Diagramas, escenarios y pitch**: ver [`refacil-bus-diagrams.md`](./refacil-bus-diagrams.md) — incluye arquitectura, flujo con attend, flujo sin attend, tabla comparativa de impacto y guia de decision visual (Mermaid).
+> **Diagramas, escenarios y pitch**: ver `refacil-bus-diagrams.md` (incluido en el paquete) — incluye arquitectura, flujo con attend, flujo sin attend, tabla comparativa de impacto y guia de decision visual (Mermaid).
 >
 
 ### Limitaciones conocidas

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "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/prereqs/OPENSPEC-DELTAS.md

@@ -8,7 +8,7 @@ Lee este archivo **ademas** de la skill `openspec-*` que indique el comando `ref
 
 - Respuestas al usuario y artefactos bajo `openspec/`: **español**; terminos tecnicos (API, REST, nombres de tipos, etc.) en **ingles**.
 
-## propose — `openspec-ff-change`
+## propose — `openspec-propose`
 
 - Criterios de aceptacion: formato **Dado / Cuando / Entonces**.
 - Incluir **criterios de rechazo** (edge cases) en specs.

package/skills/propose/SKILL.md

@@ -6,7 +6,7 @@ user-invocable: true
 
 # refacil:propose — Propuesta de Cambio
 
-Este comando envuelve la funcionalidad de OpenSpec fast-forward (ff) y agrega las convenciones del equipo.
+Este comando envuelve la funcionalidad de OpenSpec propose y agrega las convenciones del equipo.
 
 **Prerequisitos**: perfil `openspec` de `refacil-prereqs/SKILL.md` + reglas de `METHODOLOGY-CONTRACT.md`.
 
@@ -23,7 +23,7 @@ Si $ARGUMENTS ya es claro, no preguntes de nuevo.
 
 ### Paso 2: Delegar a OpenSpec ff (fast-forward)
 
-1. Lee `openspec-ff-change/SKILL.md` en `.claude/skills/` o `.cursor/skills/`.
+1. Lee `openspec-propose/SKILL.md` en `.claude/skills/` o `.cursor/skills/`.
 2. Lee `OPENSPEC-DELTAS.md` en la carpeta `refacil-prereqs` (misma ruta dual que en prereqs).
 3. Ejecuta la skill OpenSpec siguiendo sus instrucciones y aplicando los deltas Refacil para generar los artefactos (proposal, specs, design, tasks) en una sola pasada.
 

package/skills/setup/SKILL.md

@@ -16,17 +16,31 @@ Guia al desarrollador **paso a paso**. Tras cada paso, informa resultado; si fal
 
 ### Paso 2: OpenSpec
 
-`openspec --version 2>&1`. Si falla: ofrecer `npm install -g @fission-ai/openspec@latest`, re-verificar. Si sigue fallando: **troubleshooting.md**.
+```bash
+openspec --version 2>&1
+```
+
+Version minima requerida: **1.3.0**. Si falla o es inferior: `npm install -g @fission-ai/openspec@latest`, re-verificar. Si sigue fallando: **troubleshooting.md**.
 
-### Paso 3: Perfil OpenSpec
+### Paso 3: Configurar todos los workflows de OpenSpec
+
+`openspec config set workflows` no acepta arrays por CLI. La unica forma de configurar los workflows es editando el archivo de config directamente:
 
 ```bash
-openspec config set profile custom
-openspec config set workflows "explore,new,continue,apply,ff,sync,archive,bulk-archive,verify,onboard"
+node -e "
+const fs=require('fs');
+const {execSync}=require('child_process');
+const p=execSync('openspec config path',{encoding:'utf8'}).trim();
+const c=JSON.parse(fs.readFileSync(p,'utf8'));
+c.profile='custom';
+c.workflows=['propose','explore','apply','archive','verify'];
+fs.writeFileSync(p,JSON.stringify(c,null,2));
+console.log('Workflows configurados:',c.workflows.join(', '));
+"
 openspec config list
 ```
 
-Debe verse `profile: custom` y los 10 workflows.
+Debe verse `profile: custom` y exactamente estos 5 workflows: `propose`, `explore`, `apply`, `archive`, `verify` — los unicos que usan los comandos `refacil:*`.
 
 ### Paso 4: Init en el repo
 
@@ -36,6 +50,25 @@ openspec init --tools claude,cursor
 
 `openspec init` instala `opsx:*` en `.claude/` y `.cursor/`; convive con `refacil:*` — el equipo usa **refacil:*** como interfaz principal.
 
+`openspec init` no elimina skills de instalaciones anteriores. Después del init, elimina las carpetas sobrantes que no pertenezcan al conjunto requerido (`openspec-propose`, `openspec-explore`, `openspec-apply-change`, `openspec-archive-change`, `openspec-verify-change`):
+
+```bash
+node -e "
+const fs=require('fs');
+const path=require('path');
+const required=new Set(['openspec-propose','openspec-explore','openspec-apply-change','openspec-archive-change','openspec-verify-change']);
+for(const base of ['.claude/skills','.cursor/skills']){
+  if(!fs.existsSync(base)) continue;
+  for(const d of fs.readdirSync(base)){
+    if(d.startsWith('openspec-') && !required.has(d)){
+      fs.rmSync(path.join(base,d),{recursive:true,force:true});
+      console.log('Eliminada:',path.join(base,d));
+    }
+  }
+}
+"
+```
+
 ### Paso 5: `openspec/config.yaml`
 
 Si no existe, crear con `language: spanish` (y comentario de terminos tecnicos en ingles). Si existe, asegurar `language: spanish`.
@@ -62,7 +95,35 @@ Un monorepo puede agregar `.agents/services.md`; una libreria puede combinar tes
 `AGENTS.md` es el **indice puro** — no contiene detalle de proyecto, solo:
 1. Una linea de descripcion del proyecto.
 2. Por cada archivo en `.agents/`: nombre del area + enlace relativo + cuando leer ese archivo (una frase).
-3. Bloque `compact-guidance` (auto-gestionado por `refacil-sdd-ai`, no editar).
+3. Seccion `## Metodología SDD-AI` con la tabla completa de comandos `refacil:*` — siempre en `AGENTS.md`, nunca en `.agents/`. Si ya existe, sobreescribirla con el contenido actualizado; si no existe, crearla.
+4. Bloque `compact-guidance` (auto-gestionado por `refacil-sdd-ai`, no editar).
+
+**Contenido obligatorio de `## Metodología SDD-AI`** (insertar literalmente, antes del bloque `compact-guidance`):
+
+```markdown
+## Metodología SDD-AI
+
+| Comando | Descripcion |
+|---------|-------------|
+| `/refacil:setup` | Instalar y configurar la metodologia en el repo |
+| `/refacil:guide` | Ver guia de flujo y elegir siguiente paso |
+| `/refacil:explore` | Explorar el codebase sin modificar archivos |
+| `/refacil:propose` | Crear propuesta de cambio (proposal, specs, design, tasks) |
+| `/refacil:apply` | Implementar las tasks de una propuesta aprobada |
+| `/refacil:test` | Ejecutar y revisar tests del cambio actual |
+| `/refacil:verify` | Verificar implementacion contra las specs |
+| `/refacil:review` | Auditoria de calidad del codigo implementado |
+| `/refacil:archive` | Archivar el cambio y sincronizar specs al historico |
+| `/refacil:up-code` | Actualizar codigo existente a patrones actuales |
+| `/refacil:bug` | Crear propuesta de fix para un bug detectado |
+| `/refacil:update` | Migrar documentacion al patron actual de la metodologia |
+| `/refacil:join` | Unirse al bus cross-repo (primer setup del servicio) |
+| `/refacil:say` | Enviar mensaje a otro agente via bus |
+| `/refacil:ask` | Hacer consulta a otro agente y esperar respuesta |
+| `/refacil:reply` | Responder a una consulta recibida via bus |
+| `/refacil:attend` | Atender y responder mensajes pendientes del bus |
+| `/refacil:inbox` | Ver mensajes pendientes en el bus |
+```
 
 **6.3 Fallback** — Si el analisis falla: crear `.agents/summary.md` con resumen minimo + tabla refacil + TODOs, y `AGENTS.md` como indice apuntando a ese unico archivo.
 
@@ -104,7 +165,7 @@ Si el usuario quiere personalizar exclusiones adicionales, puede editarlos direc
 
 ### Paso 8: Verificar skills
 
-- OpenSpec: 10 carpetas bajo `.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 falta alguna: sugerir `openspec init --tools claude,cursor` o `openspec config list`.
+- OpenSpec: 5 carpetas bajo `.claude/skills/` y `.cursor/skills/`: `openspec-propose`, `openspec-explore`, `openspec-apply-change`, `openspec-archive-change`, `openspec-verify-change`. Si falta alguna: re-ejecutar el Paso 3 y luego `openspec init --tools claude,cursor`.
 - Refacil: carpetas `refacil-*` en esas rutas. Si no: `refacil-sdd-ai init` + reiniciar sesion.
 
 ### Paso 9: Resumen final

package/skills/setup/troubleshooting.md

@@ -11,10 +11,16 @@ Consulta este archivo **solo** si un paso de setup falla. No forma parte del flu
 
 - OpenSpec exige **Node >= 20.19.0**. Actualiza Node y vuelve a intentar.
 
-## `openspec init` no crea todas las skills
+## `openspec init` no crea las 5 skills requeridas
 
-- Ejecuta `openspec config list` y confirma `profile: custom` y los 10 workflows del proceso principal de setup.
-- Repite `openspec init --tools claude,cursor` desde la raiz del repo.
+- Ejecuta `openspec config list` y confirma `profile: custom` y los 5 workflows: `propose, explore, apply, archive, verify`.
+- Si faltan workflows, repite el Paso 3 del setup (script `node -e "..."`) y luego `openspec init --tools claude,cursor` desde la raiz del repo.
+- Las skills esperadas son: `openspec-propose`, `openspec-explore`, `openspec-apply-change`, `openspec-archive-change`, `openspec-verify-change`.
+
+## `openspec config set workflows` falla con error de array
+
+- El CLI de OpenSpec no acepta arrays via `config set`. Usa el script `node -e "..."` del Paso 3 para editar el JSON de configuracion directamente.
+- La ruta del archivo de config se obtiene con `openspec config path`.
 
 ## Falta `openspec/config.yaml`
 

package/skills/update/SKILL.md

@@ -17,6 +17,7 @@ Evalua cada condicion y marca si aplica:
 | 1 | `AGENTS.md` existe y no existe carpeta `.agents/` | Reestructurar en `.agents/` + reescribir como indice |
 | 2 | `CLAUDE.md` tiene mas de 5 lineas o no apunta a `AGENTS.md` | Reemplazar por indice minimo |
 | 3 | `.cursorrules` tiene mas de 5 lineas o no apunta a `AGENTS.md` | Reemplazar por indice minimo |
+| 4 | Existen skills `openspec-*` en `.claude/skills/` o `.cursor/skills/` que no estan en el conjunto requerido | Eliminar las sobrantes y reconfigurar OpenSpec |
 
 Si ninguna condicion aplica: informar al usuario que todo esta al dia y salir sin cambios.
 
@@ -31,9 +32,10 @@ Ejecutar solo las migraciones marcadas en el Paso 1.
 ### Migracion 1 — AGENTS.md → `.agents/` + indice
 
 1. Lee el contenido completo de `AGENTS.md`.
-2. Identifica y separa los **bloques gestionados** — NO deben moverse a `.agents/`:
+2. Identifica y separa el contenido que NO debe moverse a `.agents/`:
    - Bloque `compact-guidance`: entre `<!-- refacil-sdd-ai:compact-guidance:start -->` y `<!-- refacil-sdd-ai:compact-guidance:end -->`
    - Bloque de presentacion del bus: entre `<!-- refacil-bus:presentation:start -->` y `<!-- refacil-bus:presentation:end -->`
+   - Seccion `## Metodología SDD-AI`: tabla de comandos `refacil:*` — siempre permanece en `AGENTS.md`. Si existe, sobreescribirla con la tabla actualizada (ver Paso 6.2 de `refacil:setup`); si no existe, crearla.
 3. Crea la carpeta `.agents/`.
 4. Distribuye el contenido de proyecto (todo excepto los bloques gestionados) en archivos por area. Reglas:
    - **`.agents/summary.md` es siempre obligatorio** — descripcion del proyecto, tabla mini de stack, scripts esenciales, reglas criticas condensadas. Si el AGENTS.md original no tiene resumen claro, sintetizalo a partir del contenido disponible.
@@ -43,9 +45,10 @@ Ejecutar solo las migraciones marcadas en el Paso 1.
      - `.agents/testing.md` — estrategia de tests, comandos, convenciones, fixtures.
      - `.agents/commands.md` — comandos de desarrollo, alias, scripts de CI/CD.
    - Adaptar al tipo de proyecto: un monorepo puede necesitar `.agents/services.md`; una libreria simple puede combinar testing y stack en un solo archivo. Usar el mismo criterio que `/refacil:setup`.
-5. Reescribe `AGENTS.md` como indice puro preservando los bloques gestionados al final:
+5. Reescribe `AGENTS.md` como indice puro en este orden:
    - Primera linea: descripcion breve del proyecto.
    - Por cada archivo en `.agents/`: nombre del area + enlace relativo + cuando leerlo (una frase).
+   - Seccion `## Metodología SDD-AI` con la tabla actualizada de comandos `refacil:*` (ver Paso 6.2 de `refacil:setup` para el contenido exacto).
    - Bloques gestionados que ya existian (compact-guidance, bus presentation) al final, intactos.
    - Si no existian, el bloque compact-guidance se re-inyectara automaticamente en el proximo SessionStart.
 
@@ -69,6 +72,27 @@ Contexto completo del proyecto: ver `AGENTS.md`.
 Si no existe, ejecuta `/refacil:setup`.
 ```
 
+### Migracion 4 — Skills OpenSpec sobrantes
+
+Conjunto requerido: `openspec-propose`, `openspec-explore`, `openspec-apply-change`, `openspec-archive-change`, `openspec-verify-change`.
+
+1. Detecta las carpetas `openspec-*` presentes en `.claude/skills/` y `.cursor/skills/`.
+2. Identifica las sobrantes (las que no estan en el conjunto requerido).
+3. Reconfigura OpenSpec con solo los 5 workflows necesarios:
+   ```bash
+   node -e "
+   const fs=require('fs');
+   const {execSync}=require('child_process');
+   const p=execSync('openspec config path',{encoding:'utf8'}).trim();
+   const c=JSON.parse(fs.readFileSync(p,'utf8'));
+   c.profile='custom';
+   c.workflows=['propose','explore','apply','archive','verify'];
+   fs.writeFileSync(p,JSON.stringify(c,null,2));
+   "
+   ```
+4. Elimina las carpetas sobrantes de `.claude/skills/` y `.cursor/skills/`.
+5. Ejecuta `openspec init --tools claude,cursor` para dejar el estado limpio.
+
 ## Paso 4: Resumen
 
 Informar que archivos se crearon o modificaron. Mencionar que el bloque `compact-guidance` se sincronizara automaticamente en el proximo SessionStart.