# Cursor Rules

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.
