refacil-sdd-ai 2.0.6 → 2.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "2.0.6",
+  "version": "2.0.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/apply/SKILL.md

@@ -16,28 +16,32 @@ Lee `SKILL.md` en `.claude/skills/refacil-prereqs/` o `.cursor/skills/refacil-pr
 
 ### Paso 0: Verificar que existan artefactos SDD
 
-Busca carpetas en `openspec/changes/` que contengan los artefactos requeridos: `proposal.md`, `specs.md`, `design.md`, `tasks.md`.
+Por cada carpeta bajo `openspec/changes/` (excluye `archive/` si aplica), comprueba:
 
-- **Si `openspec/changes/` no existe o esta vacia**: Informa al usuario:
-  ```
-  No hay cambios propuestos. Antes de implementar necesitas definir los artefactos SDD.
-  Ejecuta: /refacil:propose "descripcion del cambio"
-  ```
-  **Detente.**
+| Artefacto | Requisito |
+|-----------|-----------|
+| `proposal.md` | Obligatorio en la raiz del cambio |
+| `design.md` | Obligatorio en la raiz del cambio |
+| `tasks.md` | Obligatorio en la raiz del cambio |
+| **Especificacion** | **`specs.md` en la raiz** **O** al menos un `.md` bajo `specs/` del cambio (recursivo, ej. `specs/foo/spec.md`) |
+
+OpenSpec a veces solo genera el arbol `specs/**/*.md`; eso **cumple** la fila de especificacion. Ver `OPENSPEC-DELTAS.md` (seccion **Specs: archivo unico vs arbol**).
+
+- **Si `openspec/changes/` no existe o no hay cambios activos**: informa que ejecute `/refacil:propose` y **detente**.
 
-- **Si hay carpetas pero les faltan artefactos** (falta proposal.md, specs.md, design.md o tasks.md): Informa al usuario:
+- **Si falta proposal, design o tasks**, o **no hay ni `specs.md` ni ningun `.md` bajo `specs/`**:
   ```
   El cambio en openspec/changes/[nombre]/ esta incompleto.
-  Faltan: [lista de artefactos faltantes]
+  Faltan: [lista]
   Ejecuta: /refacil:propose para completar los artefactos antes de implementar.
   ```
   **Detente.**
 
-- **Si hay multiples cambios activos**: Lista las carpetas y pregunta cual implementar.
+- **Multiples cambios activos**: lista carpetas y pregunta cual implementar.
 
-- **Si los 4 artefactos existen**: Continua al siguiente paso.
+- **Antes de implementar**: lee **toda** la especificacion relevante — si hay `specs.md` y ademas `specs/**/*.md`, lee **ambos**; si hay contradiccion, pregunta al usuario.
 
-**IMPORTANTE**: Este comando NUNCA genera artefactos SDD. Si no existen, el usuario debe usar `/refacil:propose`. La separacion entre planificacion e implementacion es fundamental en la metodologia SDD-AI.
+**IMPORTANTE**: Este comando NUNCA genera artefactos SDD. Si no existen, el usuario debe usar `/refacil:propose`.
 
 ### Paso 1: Validar rama de trabajo
 
@@ -104,7 +108,7 @@ Al terminar la implementacion de OpenSpec, agrega este resumen:
 
 ## Reglas
 
-- NUNCA implementar codigo sin los 4 artefactos SDD completos (proposal.md, specs.md, design.md, tasks.md)
+- NUNCA implementar codigo sin proposal, design, tasks y **especificacion** (`specs.md` y/o `specs/**/*.md` segun la tabla del Paso 0)
 - NUNCA generar artefactos SDD desde este comando — eso es responsabilidad exclusiva de `/refacil:propose`
 - SIEMPRE leer los artefactos completos antes de escribir codigo
 - Si `openspec/changes/` no tiene cambios activos o estan incompletos, informar y redirigir a `/refacil:propose`

package/skills/archive/SKILL.md

@@ -38,7 +38,7 @@ Despues de que OpenSpec archive, verifica que `openspec/specs/` fue actualizada:
 
 1. Revisa si hay archivos nuevos o modificados en `openspec/specs/`
 2. Si la sincronizacion no ocurrio (OpenSpec la salto o fallo), ejecuta manualmente la sincronizacion:
-   - Lee el `specs.md` del cambio archivado
+   - Lee la especificacion del cambio archivado: `specs.md` si existe **y** todos los `.md` bajo `specs/` de esa carpeta (misma regla que `refacil:apply`)
    - Busca el spec principal relevante en `openspec/specs/`
    - Si existe, integra los cambios (ADDED → agregar, MODIFIED → actualizar, REMOVED → eliminar)
    - Si NO existe, crea un spec principal nuevo con nombre descriptivo

package/skills/bug/SKILL.md

@@ -156,7 +156,7 @@ describe('Bug Fix: [descripcion corta]', () => {
 
 Si el bug es significativo, preguntar al usuario si quiere documentarlo en OpenSpec:
 - Crear carpeta en `openspec/changes/fix-[nombre]/`
-- Generar proposal.md y specs.md con los detalles del bug y fix
+- Generar `proposal.md`, `design.md`, `tasks.md` y especificacion (`specs.md` y/o `specs/**/*.md`, misma regla que `refacil:propose`)
 
 ## Reglas
 

package/skills/prereqs/OPENSPEC-DELTAS.md

@@ -15,12 +15,26 @@ Lee este archivo **ademas** de la skill `openspec-*` que indique el comando `ref
 - Tasks con estimacion de esfuerzo **S / M / L**.
 - Design alineado a **patrones existentes** del repo (desde `AGENTS.md` o exploracion acotada).
 
+### Specs: archivo unico vs arbol `specs/` (compatibilidad Refacil)
+
+OpenSpec puede indicar `specs/**/*.md` y crear **un archivo por capability** (ej. `specs/product-amount-percentile/spec.md`). Los comandos **refacil:*** deben soportar **ambas** formas:
+
+| Forma | Validacion |
+|-------|------------|
+| **A** | `specs.md` en la raiz del cambio (`openspec/changes/<id>/specs.md`) |
+| **B** | Sin `specs.md`, pero existe al menos un `.md` bajo `openspec/changes/<id>/specs/` (recursivo) |
+
+- **Si OpenSpec solo genera B:** no es error. **No hace falta** duplicar obligatoriamente en `specs.md` salvo que el equipo quiera un indice unico para humanos.
+- **Si coexisten A y B:** lee **ambos**; si hay contradiccion clara entre `specs.md` y los fragmentos, **pregunta al usuario** cual manda antes de `apply`.
+- Al cerrar **propose**, en el resumen de revision lista **todas** las rutas de spec (archivo raiz y/o cada `specs/**.md`).
+
 ## apply — `openspec-apply-change`
 
 - Respetar **estrictamente** `AGENTS.md`.
 - No agregar funcionalidad fuera del alcance de las specs aprobadas.
 - No refactorizar codigo no relacionado con el cambio.
 - Si una task es ambigua, **preguntar** antes de implementar.
+- **Especificacion**: aplica la tabla del Paso 0 de `refacil:apply` (`specs.md` y/o `specs/**/*.md`); no asumas que solo existe `specs.md` en la raiz.
 
 ## archive — `openspec-archive-change`
 

package/skills/propose/SKILL.md

@@ -36,7 +36,7 @@ Si $ARGUMENTS ya es claro, no preguntes de nuevo.
 Despues de que OpenSpec genere los artefactos, presenta al usuario un resumen claro para su revision:
 
 1. **Proposal**: Objetivo, alcance y justificacion del cambio
-2. **Specs**: Criterios de aceptacion y rechazo — verificar que cubran todos los escenarios
+2. **Specs**: Criterios de aceptacion y rechazo — listar **rutas reales**: `specs.md` y/o cada `specs/**/spec.md` (OpenSpec puede usar solo el arbol `specs/`)
 3. **Design**: Archivos a crear/modificar y patrones a usar — verificar que se alineen con la arquitectura
 4. **Tasks**: Lista de tareas con estimacion — verificar que el desglose sea correcto y completo
 
@@ -46,7 +46,7 @@ Pregunta explicitamente:
 === Revision requerida ===
 Los artefactos estan listos para tu revision:
  - openspec/changes/[nombre]/proposal.md
- - openspec/changes/[nombre]/specs.md
+ - Especificacion: openspec/changes/[nombre]/specs.md y/o openspec/changes/[nombre]/specs/**/*.md (listar archivos)
  - openspec/changes/[nombre]/design.md
  - openspec/changes/[nombre]/tasks.md
 
@@ -69,7 +69,7 @@ Siguiente paso: ejecuta /refacil:apply para implementar las tasks.
 
 ## Reglas
 
-- **NUNCA escribir, modificar o generar codigo fuente** en esta fase — solo artefactos SDD (proposal.md, specs.md, design.md, tasks.md)
+- **NUNCA escribir, modificar o generar codigo fuente** en esta fase — solo artefactos SDD: `proposal.md`, `design.md`, `tasks.md`, y especificacion en `specs.md` y/o `specs/**/*.md` (convencion OpenSpec)
 - Aunque el usuario pase una descripcion completa y detallada en $ARGUMENTS, la salida es EXCLUSIVAMENTE artefactos de planificacion
 - Si el usuario pide que tambien implemente, responder: "La implementacion se hace con `/refacil:apply` despues de aprobar los artefactos."
 - Siempre explorar el codebase ANTES de generar artefactos (para que el design sea realista)

package/skills/test/SKILL.md

@@ -46,7 +46,7 @@ Si el usuario ejecuta `/refacil:test` sin argumentos:
 1. **Buscar cambio activo**: Lista carpetas en `openspec/changes/` y pregunta cual testear si hay mas de uno.
 
 2. **Leer artefactos**:
-   - `specs.md` — Extraer criterios de aceptacion (CA-XX) y criterios de rechazo (CR-XX)
+   - **Especificacion**: lee `specs.md` si existe **y** todos los `.md` bajo `specs/` del cambio (recursivo). De ahi extrae criterios de aceptacion (CA-XX) y rechazo (CR-XX).
    - `design.md` — Identificar componentes y archivos creados/modificados
    - `tasks.md` — Identificar archivos implementados