refacil-sdd-ai 2.2.1 → 2.6.0

package/skills/test/SKILL.md

@@ -8,34 +8,20 @@ user-invocable: true
 
 Eres un asistente de testing que genera pruebas unitarias de alta calidad, adaptandose al stack tecnologico del proyecto.
 
-## Antes de empezar
-
-Lee `SKILL.md` en `.claude/skills/refacil-prereqs/` o `.cursor/skills/refacil-prereqs/` (misma skill en Claude Code y Cursor) y aplica el **perfil `openspec`** antes de continuar.
+**Prerequisitos**: perfil `openspec` de `refacil-prereqs/SKILL.md` + comando de tests segun `METHODOLOGY-CONTRACT.md §3`.
 
 ### Detectar stack tecnologico
 
-**IMPORTANTE**: Este skill NO asume ningun stack. Antes de generar tests, detecta automaticamente:
-
-1. **Lenguaje**: Lee `package.json`, `pom.xml`, `build.gradle`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `Gemfile`, o los archivos fuente para determinar el lenguaje principal.
-
-2. **Framework de testing**: Busca la configuracion de tests existente:
-   - JavaScript/TypeScript: `jest.config.*`, `vitest.config.*`, `.mocharc.*`, `karma.conf.*`, seccion `jest` en `package.json`
-   - Python: `pytest.ini`, `pyproject.toml` (seccion `[tool.pytest]`), `setup.cfg`
-   - Java/Kotlin: `pom.xml` (JUnit/Mockito), `build.gradle` (dependencias de test)
-   - Go: archivos `_test.go` existentes
-   - Rust: archivos con `#[cfg(test)]`
-   - Otro: busca archivos de test existentes para inferir patron
-
-3. **Patrones existentes**: Busca tests existentes en el proyecto (`*.spec.*`, `*.test.*`, `test_*`, `*_test.*`) y analiza:
-   - Estructura de archivos (donde se ubican los tests)
-   - Convencion de nombrado
-   - Como se hacen los mocks/stubs
-   - Framework de assertions usado
-   - Setup/teardown patterns
+NO asumir stack. Antes de generar tests, detecta:
 
-4. **Script de ejecucion**: Identifica como se ejecutan los tests (`npm test`, `pytest`, `go test`, `cargo test`, `mvn test`, etc.)
+| Fuente | Que buscar |
+|---|---|
+| Lenguaje | `package.json`, `pom.xml`, `build.gradle`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `Gemfile` |
+| Framework de tests | JS/TS: `jest.config.*`, `vitest.config.*`, `.mocharc.*`, campo `jest` en `package.json`. Python: `pytest.ini`, `[tool.pytest]` en `pyproject.toml`. Java: `pom.xml`/`build.gradle`. Go: `*_test.go`. Rust: `#[cfg(test)]` |
+| Patrones del proyecto | Tests existentes (`*.spec.*`, `*.test.*`, `test_*`, `*_test.*`): ubicacion, nombrado, mocks, assertions, setup/teardown |
+| Comando de ejecucion | `METHODOLOGY-CONTRACT.md §3` |
 
-Si existe [testing-patterns.md](testing-patterns.md) en esta misma carpeta de skill, usalo como **referencia adicional**, pero **siempre prioriza los patrones reales detectados en el proyecto**. Si los patrones del proyecto difieren de testing-patterns.md, sigue los del proyecto.
+Si existe `testing-patterns.md` junto a esta skill, usalo como referencia secundaria. Los patrones reales del proyecto siempre tienen prioridad.
 
 ## Instrucciones
 
@@ -88,6 +74,7 @@ Si el usuario pasa un archivo: `/refacil:test src/mi-archivo.ext`
 ## Reglas
 
 - **NUNCA hardcodear un stack** — siempre detectar del proyecto real
+- Resolver y ejecutar el comando de tests segun `METHODOLOGY-CONTRACT.md` §3
 - Cada criterio de aceptacion (CA-XX) debe tener al menos 1 test
 - Cada criterio de rechazo (CR-XX) debe tener al menos 1 test
 - Coverage minimo del 80% en archivos nuevos

package/skills/up-code/SKILL.md

@@ -7,13 +7,9 @@ user-invocable: true
 # refacil:up-code — Integrar Codigo y Publicar Cambios
 
 Sube los cambios al repositorio remoto y genera el PR para integracion.
-Toda integracion a ramas protegidas requiere PR — sin excepciones (incluye `testing`).
-NUNCA se hacen ajustes directos en `master` o `main`.
+Aplica la politica de ramas e integracion definida en `refacil-prereqs/METHODOLOGY-CONTRACT.md` (sin excepciones).
 
-## Antes de empezar
-
-Lee `SKILL.md` en `.claude/skills/refacil-prereqs/` o `.cursor/skills/refacil-prereqs/` (misma skill en Claude Code y Cursor) y aplica el **perfil `agents`** antes de continuar.
-Lee `METHODOLOGY-CONTRACT.md` en `refacil-prereqs` para reglas transversales del flujo.
+**Prerequisitos**: perfil `agents` de `refacil-prereqs/SKILL.md` + reglas de `METHODOLOGY-CONTRACT.md` (politica de ramas aplica sin excepciones).
 
 ## Instrucciones
 
@@ -21,7 +17,7 @@ Lee `METHODOLOGY-CONTRACT.md` en `refacil-prereqs` para reglas transversales del
 
 Ejecuta `git branch --show-current` para obtener el nombre de la rama.
 
-- Si la rama actual es protegida (`master`, `main`, `develop`, `dev`, `testing`, `qa`), **detente** e informa al usuario:
+- Si la rama actual es protegida (segun `METHODOLOGY-CONTRACT.md`), **detente** e informa al usuario:
   ```
   No se puede subir codigo desde una rama protegida ([nombre]).
   La validacion de rama se hace en /refacil:apply o /refacil:bug antes de escribir codigo.
@@ -103,7 +99,6 @@ A que rama quieres crear el PR? (recomendado: testing)
 
 ## Reglas
 
-- NUNCA hacer push directo a ramas protegidas: master, main, develop, dev, testing, qa
-- Si la rama actual es protegida, **detener** — la validacion de rama se hace en `/refacil:apply` o `/refacil:bug`, no aqui
-- Toda integracion a cualquier rama protegida requiere PR
+- Respetar estrictamente la politica de ramas protegidas e integracion por PR del `METHODOLOGY-CONTRACT.md`
+- Si la rama actual es protegida, **detener** — la validacion/cambio de rama se hace en `/refacil:apply` o `/refacil:bug`, no aqui
 - No forzar push (--force) a menos que el usuario lo pida explicitamente

package/skills/verify/SKILL.md

@@ -8,10 +8,7 @@ user-invocable: true
 
 Este comando envuelve la funcionalidad de OpenSpec verify y agrega verificacion de tests.
 
-## Antes de empezar
-
-Lee `SKILL.md` en `.claude/skills/refacil-prereqs/` o `.cursor/skills/refacil-prereqs/` (misma skill en Claude Code y Cursor) y aplica el **perfil `openspec`** antes de continuar.
-Lee `METHODOLOGY-CONTRACT.md` en `refacil-prereqs` para reglas transversales del flujo.
+**Prerequisitos**: perfil `openspec` de `refacil-prereqs/SKILL.md` + reglas de `METHODOLOGY-CONTRACT.md`.
 
 ## Instrucciones
 

package/templates/compact-guidance.md

@@ -0,0 +1,45 @@
+<!-- AUTO-GENERADO por refacil-sdd-ai. No edites entre los marcadores; el contenido se refresca en cada sesion. -->
+
+## Eficiencia de tokens
+
+Reglas para minimizar el consumo de contexto al trabajar en este repositorio.
+
+**Lectura de archivos**
+- Usa `Read` con `offset` y `limit` cuando conozcas la zona relevante del archivo.
+- No leas archivos de mas de 500 lineas completos; segmenta por rango.
+- Para descubrir estructura del repo: usa `Glob` en lugar de `ls -R` o `find`.
+- No releas el archivo completo si ya leiste el bloque relevante; continua desde ese contexto.
+- Antes de leer un archivo largo, ubica simbolos con busqueda y luego lee solo rangos candidatos.
+
+**Busqueda**
+- Usa `Grep` con `head_limit` en vez de dump crudo.
+- Cuando solo necesites ubicaciones, usa `output_mode: "files_with_matches"`.
+- Acota siempre con `glob` o `type` para no escanear de mas.
+
+**Git (via Bash)**
+- Historial: `git log --oneline -20` por defecto; amplia solo si es insuficiente.
+- Diffs: empieza con `git diff --stat`; pide el diff completo solo del archivo que vas a tocar.
+- Status: `git status -s` (short format).
+- Show: `git show --stat` antes del full.
+
+**Tests**
+- Reporta solo failures; no enumeres los passes en el output visible.
+- Si el runner tiene modo silencioso o summary (`jest --silent --reporters=summary`, `pytest -q`), usalo.
+- Si el runner es verboso por defecto, redirige: `2>&1 | tail -80`.
+
+**Logs y errores**
+- No pegues stack traces enteros; extrae solo el frame relevante con el mensaje.
+- Resume logs repetidos: "(N ocurrencias de <mensaje>)".
+- Para archivos de log: `tail -100` o filtra por nivel ERROR/WARN.
+
+**Build y lint**
+- `tsc`, `eslint`, `biome`: agrupa errores por archivo o por regla; no enumeres linea por linea.
+- Construccion exitosa: confirma con una sola linea, no pegues el output completo.
+- Si hay muchos errores similares: muestra un ejemplo y el conteo.
+
+**Docker y contenedores**
+- `docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Image}}"`.
+- `docker logs --tail 100` siempre; nunca logs completos.
+
+**Regla general**
+Cuando dudes entre verbosidad y concision, elige concision. El usuario puede pedir detalle bajo demanda.

package/templates/{claude-md.md → methodology-guide.md}

@@ -1,11 +1,8 @@
-# CLAUDE.md
-
-Las instrucciones completas del proyecto estan en [AGENTS.md](AGENTS.md).
-Si AGENTS.md no existe, ejecuta `/refacil:setup` para generarlo automaticamente.
+Instrucciones completas del proyecto: ver `AGENTS.md`. Si falta, ejecuta `/refacil:setup`.
 
 ## Metodologia SDD-AI (Refacil)
 
-Este proyecto usa la metodologia SDD-AI en **Claude Code** y **Cursor** con el mismo conjunto de skills: estan en `.claude/skills/refacil-*/` y en `.cursor/skills/refacil-*/` (copias equivalentes; `refacil-sdd-ai init` instala ambas). Comandos disponibles:
+Skills identicas en `.claude/skills/refacil-*/` (Claude Code) y `.cursor/skills/refacil-*/` (Cursor). Instaladas por `refacil-sdd-ai init`.
 
 | Comando | Descripcion |
 |---------|-------------|
@@ -18,7 +15,14 @@ Este proyecto usa la metodologia SDD-AI en **Claude Code** y **Cursor** con el m
 | `/refacil:verify` | Validar implementacion vs specs |
 | `/refacil:review` | Review con checklist de calidad |
 | `/refacil:archive` | Archivar cambio completado |
-| `/refacil:up-code` | Subir codigo a rama de desarrollo |
+| `/refacil:up-code` | Subir codigo y crear PR |
 | `/refacil:bug` | Flujo guiado de bugfix |
 
 Flujo: `setup` → `propose` → `apply` → `test` → `verify` → `review` → `archive` → `up-code`
+
+## 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.

package/templates/cursorrules.md

@@ -1,22 +0,0 @@
-# Cursor Rules
-
-Las instrucciones completas del proyecto estan en AGENTS.md.
-Si AGENTS.md no existe, ejecuta /refacil:setup para generarlo automaticamente.
-
-## Metodologia SDD-AI (Refacil)
-
-Metodologia equivalente en Claude Code (`.claude/skills/refacil-*/`) y Cursor (`.cursor/skills/refacil-*/`). Comandos (en este IDE, bajo `.cursor/skills/refacil-*/`):
-
-- /refacil:setup — Instalar OpenSpec y generar AGENTS.md
-- /refacil:guide — Guia interactiva
-- /refacil:explore — Explorar codebase
-- /refacil:propose — Crear propuesta de cambio
-- /refacil:apply — Implementar tasks
-- /refacil:test — Generar tests unitarios
-- /refacil:verify — Validar vs specs
-- /refacil:review — Review con checklist
-- /refacil:archive — Archivar cambio
-- /refacil:up-code — Subir codigo a rama de desarrollo
-- /refacil:bug — Flujo guiado de bugfix
-
-Flujo: setup → propose → apply → test → verify → review → archive → up-code