refacil-sdd-ai 4.2.4 → 4.4.0

package/skills/setup/SKILL.md

@@ -1,207 +1,151 @@
 ---
 name: refacil:setup
-description: Verificar e instalar OpenSpec, generar AGENTS.md y configurar el repositorio para la metodologia SDD-AI
+description: Configure the repository for SDD-AI — refacil-sdd layout, AGENTS.md / .agents/, IDE indexes, and methodology hooks
 user-invocable: true
 ---
 
-# refacil:setup — Configuracion del Repositorio
+# refacil:setup — Repository Configuration
 
-Guia al desarrollador **paso a paso**. Tras cada paso, informa resultado; si falla, **detente** y da el error. Fallos de instalacion o PATH: ver [troubleshooting.md](troubleshooting.md) en esta skill (`refacil-setup`).
+Guides the developer **step by step**. After each step, report the result; if it fails, **stop** and give the error. Installation or PATH failures: see [troubleshooting.md](troubleshooting.md) in this skill (`refacil-setup`).
 
-## Proceso
+## Process
 
-### Paso 1: Node.js
+### Step 1: Node.js
 
-`node --version` >= 20.19.0. Si no: indicar requisito y detener.
+`node --version` >= 20.19.0. If not: indicate the requirement and stop.
 
-### Paso 2: OpenSpec
+### Step 2: Verify refacil-sdd-ai
 
 ```bash
-openspec --version 2>&1
+refacil-sdd-ai --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**.
+Verify the CLI is installed. If it fails: `npm install -g refacil-sdd-ai`, re-verify. If it still fails: indicate the user to install Node.js >= 20.19.0 and retry.
 
-### 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:
+Verify the `sdd` subcommand is available:
 
 ```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));
-console.log('Workflows configurados:',c.workflows.join(', '));
-"
-openspec config list
+refacil-sdd-ai sdd 2>&1 || true
 ```
 
-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
-
-```bash
-openspec init --tools claude,cursor
-```
+Confirm that the subcommands `status`, `mark-reviewed`, `tasks-update`, and `archive` appear in the help.
 
-`openspec init` instala `opsx:*` en `.claude/` y `.cursor/`; convive con `refacil:*` — el equipo usa **refacil:*** como interfaz principal.
+### Step 3: Create changes directory
 
-`openspec init` no elimina skills ni commands de instalaciones anteriores. Después del init, ejecuta este script para limpiar todo lo sobrante:
+If `refacil-sdd/changes/` does not exist, create it:
 
 ```bash
-node -e "
-const fs=require('fs');
-const path=require('path');
-const requiredSkills=new Set(['openspec-propose','openspec-explore','openspec-apply-change','openspec-archive-change','openspec-verify-change']);
-const requiredCmdsOpsx=new Set(['apply.md','archive.md','explore.md','propose.md','verify.md']);
-const requiredCmdsCursor=new Set(['opsx-apply.md','opsx-archive.md','opsx-explore.md','opsx-propose.md','opsx-verify.md']);
-// Skills sobrantes
-for(const base of ['.claude/skills','.cursor/skills']){
-  if(!fs.existsSync(base)) continue;
-  for(const d of fs.readdirSync(base)){
-    if(d.startsWith('openspec-') && !requiredSkills.has(d)){
-      fs.rmSync(path.join(base,d),{recursive:true,force:true});
-      console.log('Eliminada skill:',path.join(base,d));
-    }
-  }
-}
-// Commands sobrantes — .claude/commands/opsx/ (archivos .md)
-const claudeCmds='.claude/commands/opsx';
-if(fs.existsSync(claudeCmds)){
-  for(const f of fs.readdirSync(claudeCmds)){
-    if(f.endsWith('.md') && !requiredCmdsOpsx.has(f)){
-      fs.rmSync(path.join(claudeCmds,f),{force:true});
-      console.log('Eliminado command:',path.join(claudeCmds,f));
-    }
-  }
-}
-// Commands sobrantes — .cursor/commands/ (archivos opsx-*.md)
-const cursorCmds='.cursor/commands';
-if(fs.existsSync(cursorCmds)){
-  for(const f of fs.readdirSync(cursorCmds)){
-    if(f.startsWith('opsx-') && f.endsWith('.md') && !requiredCmdsCursor.has(f)){
-      fs.rmSync(path.join(cursorCmds,f),{force:true});
-      console.log('Eliminado command:',path.join(cursorCmds,f));
-    }
-  }
-}
-"
+mkdir -p refacil-sdd/changes
 ```
 
-### Paso 5: `openspec/config.yaml`
-
-Si no existe, crear con `language: spanish` (y comentario de terminos tecnicos en ingles). Si existe, asegurar `language: spanish`.
+Inform the user that SDD artifacts will be stored in `refacil-sdd/changes/<change-name>/`.
 
-### Paso 6: Generar `.agents/` y `AGENTS.md`
+### Step 4: Generate `.agents/` and `AGENTS.md`
 
-Analiza el repo y genera la estructura de documentacion. Si ya existen, pregunta si regenerar.
+Analyze the repo and generate the documentation structure. If they already exist, ask whether to regenerate.
 
-**6.1 Analisis** — Lee si existen: `package.json`, `tsconfig*.json`, `nest-cli.json`, `angular.json`, `README.md`, eslint, jest, `ls` raiz, Docker, `.env.example`.
+**4.1 Analysis** — Read if they exist: `package.json`, `tsconfig*.json`, `nest-cli.json`, `angular.json`, `README.md`, eslint, jest, `ls` root, Docker, `.env.example`.
 
-**6.2 Arquitectura obligatoria: carpeta `.agents/` + indice `AGENTS.md`**
+**4.2 Mandatory architecture: `.agents/` folder + `AGENTS.md` index**
 
-Siempre genera esta estructura — nunca un archivo monolitico:
+Always generate this structure — never a monolithic file:
 
-Crea la carpeta `.agents/` con un archivo `.md` por area tematica. Archivos tipicos (adaptar al proyecto real):
-- `.agents/summary.md` — descripcion breve, tabla (lenguaje, framework, tests, package manager), scripts esenciales con una frase, reglas criticas condensadas (Siempre / Nunca / Preguntar, max 5 bullets cada bloque).
-- `.agents/architecture.md` — modulos, servicios, flujos principales, patrones clave.
-- `.agents/stack.md` — dependencias, variables de entorno, bases de datos, integraciones.
-- `.agents/testing.md` — estrategia, comandos, convenciones, fixtures.
-- `.agents/commands.md` — comandos de desarrollo, alias, scripts de CI/CD.
+Create the `.agents/` folder with one `.md` file per thematic area. Typical files (adapt to the actual project):
+- `.agents/summary.md` — brief description, table (language, framework, tests, package manager), essential scripts with one sentence each, critical rules condensed (Always / Never / Ask, max 5 bullets each block).
+- `.agents/architecture.md` — modules, services, main flows, key patterns.
+- `.agents/stack.md` — dependencies, environment variables, databases, integrations.
+- `.agents/testing.md` — strategy, commands, conventions, fixtures.
+- `.agents/commands.md` — development commands, aliases, CI/CD scripts.
 
-Un monorepo puede agregar `.agents/services.md`; una libreria puede combinar testing en stack. Adaptar segun el proyecto.
+A monorepo may add `.agents/services.md`; a library may combine testing in stack. Adapt to the project.
 
-`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. 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).
+`AGENTS.md` is the **pure index** — it does not contain project detail, only:
+1. One line describing the project.
+2. For each file in `.agents/`: area name + relative link + when to read that file (one sentence).
+3. Section `## SDD-AI Methodology` with the complete table of `refacil:*` commands — always in `AGENTS.md`, never in `.agents/`. If it already exists, overwrite it with the updated content; if not, create it.
+4. `compact-guidance` block (auto-managed by `refacil-sdd-ai`, do not edit).
 
-**Contenido obligatorio de `## Metodología SDD-AI`** (insertar literalmente, antes del bloque `compact-guidance`):
+**Mandatory content of `## SDD-AI Methodology`** (insert literally, before the `compact-guidance` block):
 
 ```markdown
-## Metodología SDD-AI
+## SDD-AI Methodology
 
-| Comando | Descripcion |
+| Command | Description |
 |---------|-------------|
-| `/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 |
+| `/refacil:setup` | Install and configure the methodology in the repo |
+| `/refacil:guide` | View flow guide and choose next step |
+| `/refacil:explore` | Explore the codebase without modifying files |
+| `/refacil:propose` | Create a change proposal (proposal, specs, design, tasks) |
+| `/refacil:apply` | Implement the tasks of an approved proposal |
+| `/refacil:test` | Run and review tests for the current change |
+| `/refacil:verify` | Verify implementation against the specs |
+| `/refacil:review` | Quality audit of the implemented code |
+| `/refacil:archive` | Archive the change and sync specs to the historical record |
+| `/refacil:up-code` | Update existing code to current patterns |
+| `/refacil:bug` | Create a fix proposal for a detected bug |
+| `/refacil:update` | Migrate documentation to the current methodology pattern |
+| `/refacil:join` | Join the cross-repo bus (first service setup) |
+| `/refacil:say` | Send a message to another agent via bus |
+| `/refacil:ask` | Make a query to another agent and wait for response |
+| `/refacil:reply` | Reply to a query received via bus |
+| `/refacil:attend` | Attend and respond to pending bus messages |
+| `/refacil:inbox` | View pending messages on the 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.
+**4.3 Fallback** — If the analysis fails: create `.agents/summary.md` with minimal summary + refacil table + TODOs, and `AGENTS.md` as an index pointing to that single file.
 
-**6.4** — Muestra el resultado al usuario; si aprueba, escribe los archivos.
+**4.4** — Show the result to the user; if they approve, write the files.
 
-**6.5 Bloque compact-guidance**:
-- `refacil-sdd-ai` inyecta en `AGENTS.md` un bloque entre marcadores `compact-guidance` con reglas de salida compacta.
-- Se sincroniza automaticamente en cada `SessionStart`. No editar el contenido entre marcadores.
+**4.5 compact-guidance block**:
+- `refacil-sdd-ai` injects into `AGENTS.md` a block between `compact-guidance` markers with compact output rules.
+- Automatically synced on each `SessionStart`. Do not edit the content between markers.
 
-### Paso 6b: Sobreescribir `CLAUDE.md` y `.cursorrules`
+### Step 4b: Overwrite `CLAUDE.md` and `.cursorrules`
 
-Siempre **sobreescribe** ambos archivos aunque ya existan — son indices delgados hacia `AGENTS.md`, no deben contener detalle de proyecto.
+Always **overwrite** both files even if they already exist — they are thin indexes toward `AGENTS.md`, they must not contain project detail.
 
-**`CLAUDE.md`** — indice minimo, sin contenido de proyecto:
+**`CLAUDE.md`** — minimal index, no project content:
 
 ```
 # CLAUDE.md
 
-Contexto completo del proyecto: ver `AGENTS.md` (indice) y `.agents/` (detalle por area).
-Si `AGENTS.md` no existe, ejecuta `/refacil:setup`.
+Full project context: see `AGENTS.md` (index) and `.agents/` (detail by area).
+If `AGENTS.md` does not exist, run `/refacil:setup`.
 ```
 
-**`.cursorrules`** — contenido identico con header `# Cursor Rules`.
+**`.cursorrules`** — identical content with header `# Cursor Rules`.
 
-Todo el detalle de proyecto, stack, reglas y comandos `refacil:*` vive en `.agents/` y se indexa desde `AGENTS.md`. No duplicar nada en CLAUDE.md ni en .cursorrules.
+All project detail, stack, rules and `refacil:*` commands live in `.agents/` and are indexed from `AGENTS.md`. Do not duplicate anything in CLAUDE.md or .cursorrules.
 
-### Paso 7: Archivos de exclusion de contexto
+### Step 5: Context exclusion files
 
-`refacil-sdd-ai init` crea o actualiza automaticamente `.claudeignore` y `.cursorignore` con entradas estandar (node_modules/, dist/, logs, binarios, secretos, etc.).
+`refacil-sdd-ai init` automatically creates or updates `.claudeignore` and `.cursorignore` with standard entries (node_modules/, dist/, logs, binaries, secrets, etc.).
 
-Si los archivos ya existen, solo se agregan las entradas faltantes — no se sobreescribe contenido personalizado.
+If the files already exist, only missing entries are added — custom content is not overwritten.
 
-Informa el resultado al usuario:
-- **Creados**: ambos archivos fueron creados desde cero.
-- **Actualizados**: se agregaron entradas faltantes.
-- **Sin cambios**: ya tenian todas las entradas.
+Inform the user of the result:
+- **Created**: both files were created from scratch.
+- **Updated**: missing entries were added.
+- **No changes**: they already had all the entries.
 
-Si el usuario quiere personalizar exclusiones adicionales, puede editarlos directamente despues del setup.
+If the user wants to customize additional exclusions, they can edit them directly after setup.
 
-### Paso 8: Verificar skills
+### Step 6: Verify skills
 
-- 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.
+- Refacil: `refacil-*` folders under `.claude/skills/` and `.cursor/skills/`. If not: `refacil-sdd-ai init` + restart session.
+- Verify `sdd` subcommand: `refacil-sdd-ai sdd 2>&1 || true` — must show subcommands `status`, `mark-reviewed`, `tasks-update`, `archive`.
 
-### Paso 9: Resumen final
+### Step 7: Final summary
 
 ```
-=== refacil:setup completado ===
- Node.js / OpenSpec / perfil / openspec/ / config / AGENTS.md / CLAUDE.md / .cursorrules / .claudeignore / .cursorignore / skills OK
+=== refacil:setup completed ===
+ Node.js / refacil-sdd-ai / refacil-sdd/changes/ / AGENTS.md / CLAUDE.md / .cursorrules / .claudeignore / .cursorignore / skills OK
 
- Reiniciar sesion Claude Code o Cursor si es la primera instalacion de skills.
- El siguiente paso es revisar el flujo disponible.
- Quieres que continue con /refacil:guide?
+ Restart Claude Code or Cursor session if this is the first skills installation.
+ The next step is to review the available flow.
+ Do you want me to continue with /refacil:guide?
 ```
 
-## Reglas
+## Rules
 
-- **Continuidad del flujo**: si el usuario confirma afirmativamente ("si", "ok", "dale", "continua", etc.) la pregunta de continuidad del Paso 9, invocar inmediatamente el **Skill tool** con `skill: "refacil:guide"`. No describirlo en texto ni esperar que el usuario escriba `/refacil:guide`. (Ver `METHODOLOGY-CONTRACT.md §5`.)
+- **Flow continuity**: if the user confirms affirmatively ("yes", "ok", "go", "continue", etc.) the continuity question in Step 7, immediately invoke the **Skill tool** with `skill: "refacil:guide"`. Do not describe it in text or wait for the user to type `/refacil:guide`. (See `METHODOLOGY-CONTRACT.md §5`.)

package/skills/setup/troubleshooting.md

@@ -1,35 +1,38 @@
-# refacil:setup — Resolucion de problemas
-
-Consulta este archivo **solo** si un paso de setup falla. No forma parte del flujo feliz.
-
-## OpenSpec: comando no encontrado tras `npm install -g`
-
-- Comprueba donde instala npm los binarios: `npm config get prefix`, luego anade `[prefix]/bin` (Linux/Mac) o `[prefix]` (Windows) al **PATH** y abre de nuevo la terminal / el IDE.
-- En Linux/Mac a veces hace falta `sudo` para install global; preferible arreglar permisos de prefijo de npm (`npm config set prefix ~/.npm-global`) antes que usar sudo.
-
-## `openspec --version` falla con error de Node
-
-- OpenSpec exige **Node >= 20.19.0**. Actualiza Node y vuelve a intentar.
-
-## `openspec init` no crea las 5 skills requeridas
-
-- 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`
-
-- Crealo manualmente con al menos:
-
-```yaml
-language: spanish
-```
-
-## Skills `refacil-*` no aparecen en el IDE
-
-- Ejecuta `refacil-sdd-ai init` en la raiz del repo y **reinicia** la sesion de Claude Code o Cursor.
+# refacil:setup — Troubleshooting
+
+Consult this file **only** if a setup step fails. It is not part of the happy path.
+
+## `refacil-sdd-ai` command not found after `npm install -g`
+
+- Check where npm installs binaries: `npm config get prefix`, then add `[prefix]/bin` (Linux/Mac) or `[prefix]` (Windows) to **PATH** and reopen the terminal / IDE.
+- On Linux/Mac `sudo` is sometimes needed for global installs; it is preferable to fix npm prefix permissions (`npm config set prefix ~/.npm-global`) instead of using sudo.
+
+## Skills `refacil-*` do not appear in the IDE
+
+- Run `refacil-sdd-ai init` at the repo root and **restart** the Claude Code or Cursor session.
+- If the skills are present in `.claude/skills/` but the IDE does not pick them up, restart the IDE (not just the session).
+
+## `refacil-sdd-ai init` creates files inside the wrong directory
+
+- Always run `refacil-sdd-ai init` from the **repo root** (where `package.json` lives), not from inside a subdirectory.
+- If you accidentally ran it from a subdirectory, delete the mistakenly created `.claude/`, `.cursor/`, `.claudeignore`, `.cursorignore`, `.cursorrules`, and `CLAUDE.md` from that subdirectory, then re-run from the correct location.
+
+## AGENTS.md is missing after init
+
+- `refacil-sdd-ai init` does not generate `AGENTS.md` automatically — it is created by `/refacil:setup` inside the IDE.
+- Run `/refacil:setup` after restarting the session.
+
+## compact-guidance block not appearing in AGENTS.md
+
+- The block is injected by the `check-update` hook (SessionStart). Restart the session to trigger it.
+- If it still does not appear, run `refacil-sdd-ai update` manually.
+
+## Hook `check-update` not running at session start
+
+- Verify the hook is registered: check `.claude/settings.json` or `.cursor/settings.json` for a `hooks.SessionStart` entry that calls `refacil-sdd-ai check-update`.
+- If missing, run `refacil-sdd-ai init` again (it is idempotent).
+
+## `refacil-sdd/` not created after using SDD commands
+
+- `refacil-sdd/` is created automatically when you first run `/refacil:propose`.
+- If you had an `openspec/` directory from a previous version, it is migrated to `refacil-sdd/` automatically on the next `refacil-sdd-ai sdd *` command or at session start via `check-update`.

package/skills/test/SKILL.md

@@ -1,94 +1,104 @@
----
-name: refacil:test
-description: Generar tests unitarios basados en los artefactos de OpenSpec o para archivos especificos — construye un briefing con CA/CR y scope de archivos, y delega al sub-agente refacil-tester para la generacion y ejecucion en contexto aislado
-user-invocable: true
----
-
-# refacil:test — Entrypoint de Generacion de Tests
-
-Este skill es un **wrapper delgado** que resuelve el scope, extrae los criterios CA/CR y la lista de archivos a testear, y delega al sub-agente `refacil-tester` con un **briefing estructurado**. El sub-agente arranca con los criterios ya extraidos — no re-lee specs desde cero.
-
-**Prerequisitos**: perfil `openspec` de `refacil-prereqs/SKILL.md` + comando de tests segun `METHODOLOGY-CONTRACT.md §3`.
-
-## Flujo
-
-### Paso 0: Resolver scope y modo
-
-**Modo file** — si `$ARGUMENTS` contiene una ruta de archivo:
-- `targetFile` = la ruta recibida. Continua al Paso 2 directamente (no se necesita briefing de specs).
-
-**Modo openspec** — si `$ARGUMENTS` esta vacio:
-- Lista las carpetas en `openspec/changes/`.
-- Si hay exactamente una carpeta activa, usarla como `changeName`.
-- Si hay multiples carpetas activas, **detente** y pide al usuario seleccionar cual testear.
-- Si no hay cambios activos, informa que ejecute `/refacil:propose` y detente.
-
-### Paso 1 (solo modo openspec): Construir briefing
-
-Antes de invocar al sub-agente, extrae el contexto clave:
-
-1. **Criterios** — lee la especificacion del cambio (`openspec/changes/<changeName>/specs.md` y/o `specs/**/*.md` si existen). Extrae la lista de criterios de aceptacion (CA-XX) y rechazo (CR-XX) con su descripcion.
-2. **Archivos a testear** — lee `openspec/changes/<changeName>/design.md`. Extrae la lista de archivos creados/modificados.
-3. **Comando de test** — lee `refacil-prereqs/METHODOLOGY-CONTRACT.md §3`. Extrae el comando exacto.
-4. **Patron de tests** — busca un archivo de test existente relevante (1 archivo de ejemplo, no multiples). Si existe `testing-patterns.md` en este directorio, incluyelo.
-
-Construye el bloque BRIEFING que incluiras en el prompt de delegacion:
-
-```
-BRIEFING:
-changeName: <nombre>
-mode: openspec
-criteria:
-  acceptance:
-    - CA-01: <descripcion>
-    - CA-02: <descripcion>
-  rejection:
-    - CR-01: <descripcion>
-filesToTest: [ruta/archivo-1.ts, ruta/archivo-2.ts, ...]
-testCommand: <comando exacto>
-testPatternFile: <ruta de un archivo de test existente como referencia, o null>
-```
-
-### Paso 2: Delegar al sub-agente refacil-tester
-
-Invoca al sub-agente `refacil-tester` pasandole el BRIEFING (modo openspec) o directamente:
-- `mode`: `openspec` o `file`
-- `changeName` / `targetFile` segun corresponda
-- BRIEFING completo (modo openspec)
-- Si el usuario pidio modo detallado explicitamente, indicaselo. Default: conciso.
-
-El sub-agente usara el briefing para generar tests directamente sin re-leer specs.
-
-Retorna UN solo mensaje con el reporte + bloque JSON fenced como ` ```refacil-test-result `.
-
-### Paso 3: Presentar el reporte y procesar resultado
-
-Muestra al usuario el **reporte** (todo lo anterior al bloque `refacil-test-result`). No muestres el bloque JSON — es metadata interna.
-
-Si el sub-agente retorno algo fuera de formato, informa al usuario: "El tester retorno un reporte no estructurado — revisa los tests manualmente." y detente.
-
-Parsea el bloque `refacil-test-result` del sub-agente:
-- **Si `passed: false`** (tests fallaron): presenta los `issues` del JSON y pregunta al usuario como quiere proceder. **No continues al Paso 4** hasta que los tests pasen.
-- **Si `passed: true`**: continua al Paso 4.
-
-### Paso 4: Continuidad del flujo (solo si tests pasaron)
-
-Agrega:
-
-```
-El siguiente paso es validar la implementacion vs specs.
-Quieres que continue con /refacil:verify?
-```
-
-## Reglas
-
-- **Siempre construye el briefing en modo openspec (Paso 1) antes de delegar** — reduce los tool calls del sub-agente.
-- **Siempre delega al sub-agente**. No repliques aqui la logica de deteccion de stack ni de generacion.
-- **No invoques con scope ambiguo**. Si hay multiples cambios activos, pide seleccion primero.
-- **No muestres el bloque JSON al usuario**. Es solo metadata interna.
-- **Continuidad del flujo**: si el usuario confirma afirmativamente ("si", "ok", "dale", "continua", etc.) la pregunta de continuidad **y los tests pasaron (`passed: true`)**, invocar inmediatamente el **Skill tool** con `skill: "refacil:verify"`. No describirlo en texto ni esperar que el usuario escriba `/refacil:verify`. (Ver `METHODOLOGY-CONTRACT.md §5`.)
-
-## Ver tambien
-
-- Sub-agente: `.claude/agents/refacil-tester.md` (fuente: `refacil-sdd-ai/agents/tester.md`)
-- Patrones de testing del proyecto: `testing-patterns.md` en este mismo directorio (si existe).
+---
+name: refacil:test
+description: Generate unit tests based on SDD artifacts or for specific files — builds a briefing with CA/CR and file scope, and delegates to the refacil-tester sub-agent for generation and execution in isolated context
+user-invocable: true
+---
+
+# refacil:test — Test Generation Entrypoint
+
+This skill is a **thin wrapper** that resolves the scope, extracts CA/CR criteria and the list of files to test, and delegates to the `refacil-tester` sub-agent with a **structured briefing**. The sub-agent starts with the criteria already extracted — it does not re-read specs from scratch.
+
+**Prerequisites**: `sdd` profile from `refacil-prereqs/SKILL.md` + test command from `METHODOLOGY-CONTRACT.md §3`.
+
+## Flow
+
+### Step 0: Resolve scope
+
+**File mode** — if `$ARGUMENTS` contains a file path:
+- `targetFile` = the received path. Continue directly to Step 2 (no spec briefing needed).
+
+**Change mode** — if `$ARGUMENTS` is empty or a change name:
+- List the folders in `refacil-sdd/changes/`.
+- If there is exactly one active folder, use it as `changeName`.
+- If there are multiple active folders, **stop** and ask the user to select which one to test.
+- If there are no active changes, inform to run `/refacil:propose` and stop.
+
+### Step 1: Build briefing (change mode only)
+
+Before invoking the sub-agent, extract the key context:
+
+1. **Criteria** — read the change specification (`refacil-sdd/changes/<changeName>/specs.md` and/or `specs/**/*.md` if they exist). Extract the list of acceptance criteria (CA-XX) and rejection criteria (CR-XX) with their descriptions.
+2. **Files to test** — read `refacil-sdd/changes/<changeName>/design.md`. Extract the list of created/modified files.
+3. **Test command** — read `refacil-prereqs/METHODOLOGY-CONTRACT.md §3`. Extract the exact command.
+4. **Test pattern** — find an existing relevant test file (1 example file, not multiple). If `testing-patterns.md` exists in this directory, include it.
+
+Build the BRIEFING block to include in the delegation prompt:
+
+```
+BRIEFING:
+changeName: <name>
+criteria:
+  acceptance:
+    - CA-01: <description>
+    - CA-02: <description>
+  rejection:
+    - CR-01: <description>
+filesToTest: [path/file-1.ts, path/file-2.ts, ...]
+testCommand: <exact command>
+testPatternFile: <path of an existing test file as reference, or null>
+```
+
+### Step 2: Delegate to the refacil-tester sub-agent
+
+Invoke the `refacil-tester` sub-agent passing it the BRIEFING (change mode) or directly:
+- `changeName` / `targetFile` as appropriate
+- Full BRIEFING (change mode)
+- If the user explicitly requested detailed mode, indicate it. Default: concise.
+
+The sub-agent will use the briefing to generate tests directly without re-reading specs.
+
+Returns ONE single message with the report + JSON block fenced as ` ```refacil-test-result `.
+
+### Step 3: Present the report and process result
+
+Show the user the **report** (everything before the `refacil-test-result` block). Do not show the JSON block — it is internal metadata.
+
+If the sub-agent returned something out of format, inform the user: "The tester returned an unstructured report — review the tests manually." and stop.
+
+Parse the `refacil-test-result` block from the sub-agent:
+- **If `passed: false`** (tests failed): present the `issues` from the JSON and ask the user how to proceed. **Do not continue to Step 4** until the tests pass.
+- **If `passed: true`**: continue to Step 4.
+
+### Step 3.5: Write memory.yaml (CA-16 — cross-skill state)
+
+After parsing the `refacil-test-result` block and only if `passed: true`:
+- Extract from the result or from the briefing: `commandsRun` (list of test commands executed), `criteriaRun` (list of CA-XX/CR-XX covered by tests), `stackDetected` (if the tester identified the stack).
+- Write or update `refacil-sdd/changes/<changeName>/memory.yaml` preserving any existing fields:
+
+```yaml
+lastStep: test
+stackDetected: <detected stack or omit>
+commandsRun:
+  - <test command used>
+criteriaRun:
+  - CA-01
+  - CR-01
+```
+
+If the file already exists, merge: update `lastStep`, `stackDetected`, `commandsRun`, `criteriaRun`; preserve fields from other steps (e.g. `touchedFiles` from apply).
+
+### Step 4: Flow continuity (only if tests passed)
+
+Add:
+
+```
+The next step is to validate the implementation against the specs.
+Do you want me to continue with /refacil:verify?
+```
+
+## Rules
+
+- **Always build the briefing in change mode (Step 1) before delegating** — reduces the sub-agent tool calls.
+- **Always delegate to the sub-agent**. Do not replicate stack detection or generation logic here.
+- **Do not invoke with ambiguous scope**. If there are multiple active changes, ask for selection first.
+- **Flow continuity**: if the user confirms affirmatively ("yes", "ok", "go", "continue", etc.) the continuity question **and tests passed (`passed: true`)**, immediately invoke the **Skill tool** with `skill: "refacil:verify"`. Do not describe it in text or wait for the user to type `/refacil:verify`. (See `METHODOLOGY-CONTRACT.md §5`.)