refacil-sdd-ai 2.9.0 → 2.9.1

package/package.json

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

@@ -25,9 +25,29 @@ Eres un guia **breve**: eliges el siguiente comando; el detalle de cada flujo es
 6. Review de calidad → `/refacil:review`
 7. Subir codigo y crear PR → `/refacil:up-code`
 8. Configurar repo → `refacil-sdd-ai init` (global + por repo) y `/refacil:setup`
+9. Coordinar con otros repos (sin copy/paste manual) → ver bloque **Bus entre agentes** abajo
 
 > **Nota**: `/refacil:up-code` verifica que el review este aprobado (`.review-passed`). Si falta y hay un solo cambio pendiente, lanza `/refacil:review` automaticamente (sin re-ejecutar si no hay cambios nuevos). Si hay multiples cambios sin review, pide seleccion explicita. Toda integracion a ramas protegidas (incluyendo `testing`) requiere PR. Nunca se hacen ajustes directos en `master` o `main`. La validacion de rama se hace en `/refacil:apply` o `/refacil:bug`, no en `up-code`.
 
+## Bus entre agentes (refacil-bus)
+
+Para cuando el dev tiene varias ventanas de Claude Code / Cursor abiertas (una por repo) y necesita que los agentes se consulten entre si sin que el dev sea el transcriptor manual:
+
+| Comando | Cuando usarlo |
+|---------|---------------|
+| `/refacil:join <sala>` | Primer paso: une esta sesion a una sala (crea el bloque de presentacion en `AGENTS.md` si falta). |
+| `/refacil:say "..."` | Anuncio a toda la sala. |
+| `/refacil:ask @<repo> "..." [--wait N]` | Pregunta dirigida a otro agente. Con `--wait N` bloquea hasta respuesta o N seg. |
+| `/refacil:reply "..."` | Responde la ultima pregunta dirigida a esta sesion. |
+| `/refacil:attend` | Deja esta sesion escuchando el bus: cuando llegue una pregunta dirigida, la respondes y vuelves a escuchar. |
+| `/refacil:inbox` | Ver mensajes nuevos desde la ultima lectura. |
+
+**Patron tipico**: antes de una tarea que puede necesitar contexto de otros repos, el dev va a las otras ventanas y dice *"atiende el bus"*. Luego en su repo de trabajo, `/refacil:ask @<otro-repo> "..." --wait 180` trae la respuesta automatica sin saltar entre ventanas.
+
+Para supervision: `refacil-sdd-ai bus view` (UI web) o `refacil-sdd-ai bus watch <session>` (terminal). No consumen tokens.
+
+Detalle completo en el README de refacil-sdd-ai (seccion `refacil-bus`).
+
 ## Tips (una linea por herramienta)
 
 - **Claude Code:** comandos `/refacil:*` en el chat.

package/templates/methodology-guide.md

@@ -20,6 +20,23 @@ Skills identicas en `.claude/skills/refacil-*/` (Claude Code) y `.cursor/skills/
 
 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`.