# Instrucciones para el agente: Virtual Workspace: trabaja con repositorios relacionados en una sesión

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/filipealva/virtual-workspace (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/claude-virtual-workspace

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala en Claude Code

```sh
/plugin marketplace add https://github.com/filipealva/virtual-workspace
/plugin install virtual-workspace@filipealva
```

### Paso 2: crea un espacio de prueba

Reinicia la sesión y usa `/virtual-workspace`. Proporciona dos repositorios de prueba y una carpeta superior. Revisa los scripts generados antes de la preparación inicial (bootstrap) y evita la publicación opcional del espacio si no la necesitas.

## Comprobación

Comprueba `workspace.conf`, los enlaces y el estado de cada repositorio. Crea un worktree de prueba con el procedimiento oficial y verifica que apunta a la rama esperada.

## Si algo falla

Si falta configuración de un cliente, revisa `assistant-support.sh` y la guía del README. No limpies worktrees hasta comprobar si conservan cambios propios.