refacil-sdd-ai 3.0.3 → 4.0.0

package/skills/update/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: refacil:update
+description: Detectar y aplicar migraciones pendientes de la metodologia SDD-AI al proyecto actual
+user-invocable: true
+---
+
+# refacil:update — Migraciones de la Metodologia
+
+Detecta el estado actual del repo y aplica solo lo que este pendiente. No repite pasos de instalacion (OpenSpec, hooks, skills).
+
+## Paso 1: Detectar migraciones pendientes
+
+Evalua cada condicion y marca si aplica:
+
+| # | Condicion detectada | Migracion |
+|---|---|---|
+| 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 |
+
+Si ninguna condicion aplica: informar al usuario que todo esta al dia y salir sin cambios.
+
+## Paso 2: Confirmar con el usuario
+
+Mostrar la lista de migraciones detectadas y pedir confirmacion antes de aplicar cualquier cambio.
+
+## Paso 3: Aplicar migraciones confirmadas
+
+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/`:
+   - 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 -->`
+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.
+   - Los demas archivos se crean **solo si hay contenido relevante que redistribuir**. No crear archivos vacios:
+     - `.agents/architecture.md` — modulos, servicios, flujos principales, patrones clave.
+     - `.agents/stack.md` — dependencias, variables de entorno, bases de datos, integraciones.
+     - `.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:
+   - Primera linea: descripcion breve del proyecto.
+   - Por cada archivo en `.agents/`: nombre del area + enlace relativo + cuando leerlo (una frase).
+   - 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.
+
+### Migracion 2 y 3 — CLAUDE.md / .cursorrules → indice minimo
+
+Sobreescribir con exactamente este contenido:
+
+**CLAUDE.md:**
+```
+# CLAUDE.md
+
+Contexto completo del proyecto: ver `AGENTS.md`.
+Si no existe, ejecuta `/refacil:setup`.
+```
+
+**`.cursorrules`:**
+```
+# Cursor Rules
+
+Contexto completo del proyecto: ver `AGENTS.md`.
+Si no existe, ejecuta `/refacil:setup`.
+```
+
+## Paso 4: Resumen
+
+Informar que archivos se crearon o modificaron. Mencionar que el bloque `compact-guidance` se sincronizara automaticamente en el proximo SessionStart.
+
+## Reglas
+
+- Solo aplica lo que este pendiente — no toca archivos que ya cumplen el patron.
+- No inventa contenido: distribuye lo que ya existe en AGENTS.md sin agregar ni eliminar informacion.
+- No ejecuta pasos de OpenSpec, hooks ni instalacion de skills.
+- Extensible: futuras versiones de la metodologia agregaran filas a la tabla del Paso 1 sin cambiar la estructura de la skill.

package/templates/methodology-guide.md

@@ -1,45 +1,52 @@
-Instrucciones completas del proyecto: ver `AGENTS.md`. Si falta, ejecuta `/refacil:setup`.
-
-## Metodologia SDD-AI (Refacil)
-
-Skills identicas en `.claude/skills/refacil-*/` (Claude Code) y `.cursor/skills/refacil-*/` (Cursor). Instaladas por `refacil-sdd-ai init`.
-
-| Comando | Descripcion |
-|---------|-------------|
-| `/refacil:setup` | Instalar OpenSpec y generar AGENTS.md |
-| `/refacil:guide` | Guia interactiva — que comando usar |
-| `/refacil:explore` | Explorar el codebase sin cambios |
-| `/refacil:propose` | Crear propuesta de cambio |
-| `/refacil:apply` | Implementar tasks del cambio |
-| `/refacil:test` | Generar tests unitarios |
-| `/refacil:verify` | Validar implementacion vs specs |
-| `/refacil:review` | Review con checklist de calidad |
-| `/refacil:archive` | Archivar cambio completado |
-| `/refacil:up-code` | Subir codigo y crear PR |
-| `/refacil:bug` | Flujo guiado de bugfix |
-
-Flujo: `setup` → `propose` → `apply` → `test` → `verify` → `review` → `archive` → `up-code`
-
-## Bus entre agentes (refacil-bus)
-
-Canal local de texto plano entre sesiones de Claude Code / Cursor corriendo en distintos repos. Evita que el dev haga de transcriptor manual entre sus propios agentes.
-
-| Comando | Descripcion |
-|---------|-------------|
-| `/refacil:join <sala>` | Crear o unirse a una sala. La primera vez genera un bloque de presentacion en `AGENTS.md`. |
-| `/refacil:say "..."` | Anuncio a toda la sala. |
-| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida a otra sesion. `--wait N` bloquea hasta respuesta o N seg. |
-| `/refacil:reply "..."` | Responde la ultima pregunta dirigida (autocompleta `correlationId`). |
-| `/refacil:attend` | Modo escucha activa: recibe preguntas y el LLM las responde, luego re-invoca para seguir escuchando. |
-| `/refacil:inbox` | Ver mensajes nuevos desde la ultima lectura. |
-
-Uso tipico: antes de arrancar una tarea que puede requerir contexto de otros repos, el dev pone al agente de cada otro repo en `/refacil:attend`. Despues, en su repo de trabajo, el LLM puede pedir contexto con `/refacil:ask @<repo> "..." --wait` y recibir la respuesta automaticamente sin que el dev salte entre ventanas.
-
-CLI util para el dev: `refacil-sdd-ai bus view` (abre UI web en el navegador), `bus watch <session>` (panel en terminal), `bus status`, `bus rooms`. No consumen tokens.
-
-## Eficiencia de tokens (automatica)
-
-- El hook `check-update` en `SessionStart` sincroniza el bloque `compact-guidance` en `AGENTS.md`.
-- El bloque define reglas de salida compacta (lectura por rango, busqueda acotada, tests/logs resumidos).
-- Si `AGENTS.md` aun no existe, la sincronizacion se omite sin error.
-- No editar manualmente el contenido entre marcadores `compact-guidance`; se sobreescribe automaticamente.
+Instrucciones completas del proyecto: ver `AGENTS.md`. Si falta, ejecuta `/refacil:setup`.
+
+## Metodologia SDD-AI (Refacil)
+
+Skills identicas en `.claude/skills/refacil-*/` (Claude Code) y `.cursor/skills/refacil-*/` (Cursor). Instaladas por `refacil-sdd-ai init`.
+
+| Comando | Descripcion |
+|---------|-------------|
+| `/refacil:setup` | Instalar OpenSpec y generar AGENTS.md |
+| `/refacil:guide` | Guia interactiva — que comando usar |
+| `/refacil:explore` | Explorar el codebase sin cambios |
+| `/refacil:propose` | Crear propuesta de cambio |
+| `/refacil:apply` | Implementar tasks del cambio |
+| `/refacil:test` | Generar tests unitarios |
+| `/refacil:verify` | Validar implementacion vs specs |
+| `/refacil:review` | Review con checklist de calidad |
+| `/refacil:archive` | Archivar cambio completado |
+| `/refacil:up-code` | Subir codigo y crear PR |
+| `/refacil:bug` | Flujo guiado de bugfix |
+| `/refacil:update` | Migrar documentacion al patron actual (.agents/) |
+
+Flujo: `setup` → `propose` → `apply` → `test` → `verify` → `review` → `archive` → `up-code`
+
+## Bus entre agentes (refacil-bus)
+
+Canal local de texto plano entre sesiones de Claude Code / Cursor corriendo en distintos repos. Evita que el dev haga de transcriptor manual entre sus propios agentes.
+
+| Comando | Descripcion |
+|---------|-------------|
+| `/refacil:join <sala>` | Crear o unirse a una sala. La primera vez genera un bloque de presentacion en `AGENTS.md`. |
+| `/refacil:say "..."` | Anuncio a toda la sala. |
+| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida a otra sesion. `--wait N` bloquea hasta respuesta o N seg. |
+| `/refacil:reply "..."` | Responde la ultima pregunta dirigida (autocompleta `correlationId`). |
+| `/refacil:attend` | Modo escucha activa: recibe preguntas y el LLM las responde, luego re-invoca para seguir escuchando. |
+| `/refacil:inbox` | Ver mensajes nuevos desde la ultima lectura. |
+
+Uso tipico: antes de arrancar una tarea que puede requerir contexto de otros repos, el dev pone al agente de cada otro repo en `/refacil:attend`. Despues, en su repo de trabajo, el LLM puede pedir contexto con `/refacil:ask @<repo> "..." --wait` y recibir la respuesta automaticamente sin que el dev salte entre ventanas.
+
+CLI util para el dev: `refacil-sdd-ai bus view` (abre UI web en el navegador), `bus watch <session>` (panel en terminal), `bus status`, `bus rooms`. No consumen tokens.
+
+## Estructura de documentacion del proyecto
+
+El detalle del proyecto vive en `.agents/` — un archivo `.md` por area (summary, architecture, stack, testing, commands...).
+`AGENTS.md` es el indice: una linea por archivo indicando que contiene y cuando leerlo.
+`CLAUDE.md` y `.cursorrules` son indices minimos que solo apuntan a `AGENTS.md` — no contienen detalle de proyecto.
+
+## Eficiencia de tokens (automatica)
+
+- El hook `check-update` en `SessionStart` sincroniza el bloque `compact-guidance` en `AGENTS.md`.
+- El bloque define reglas de salida compacta (lectura por rango, busqueda acotada, tests/logs resumidos).
+- Si `AGENTS.md` aun no existe, la sincronizacion se omite sin error.
+- No editar manualmente el contenido entre marcadores `compact-guidance`; se sobreescribe automaticamente.