# Instrucciones para el agente: Claude Coordinator: organiza trabajo delegado y continuidad de sesiones

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: avanzado
- Proyecto: https://github.com/dennisonbertram/claude-coordinator (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/claude-coordinator

---

## 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 desde el repositorio conocido

Comprueba Bash, Git y Claude Code. El README muestra `claude plugin install claude-coordinator`, pero ese nombre necesita un catálogo que una máquina limpia puede no tener. Usa su alternativa desde código:

```bash
git clone https://github.com/dennisonbertram/claude-coordinator
cd claude-coordinator
./install.sh
```

El [instalador](https://github.com/dennisonbertram/claude-coordinator/blob/main/install.sh) copia agentes a `~/.claude/agents/` y puede reemplazar definiciones del mismo nombre: revisa ese destino antes. Intenta enlazar el lanzador en un directorio de PATH; los agentes instalados también se pueden cargar desde `claude --agent coordinator`.

### Paso 2: prepara una prueba y sus validadores

La validación estructurada necesita una de las alternativas que documenta el README: `ajv-cli`, `check-jsonschema` o el paquete Python `jsonschema`. Comprueba que una está disponible antes de exigir evidencias validadas.

Lee State Layers e Initialize project state. Si deseas probar el estado del proyecto, entra en un repositorio temporal y ejecuta por ruta absoluta el `install.sh` descargado con `--init-project`. Crea `docs/context/`, `docs/plans/` y `.coord/`; conserva una única referencia de tareas si tu equipo ya tiene otra.

### Paso 3: abre el coordinador

Desde ese proyecto temporal:

```bash
claude --agent coordinator
```

Pide una inspección de lectura de un archivo de prueba, con resultado esperado y sin modificar código.

## Comprobación

Comprueba qué agente recibe la tarea, dónde escribe estado y qué evidencia devuelve. En una sesión nueva confirma que reconstruye el objetivo desde el contexto preparado. Una salida JSON no se considera validada hasta pasar `bin/coord-validate` con el esquema del rol correspondiente, según el README.

## Si algo falla

Si no se descubre el coordinador, revisa `~/.claude/agents/coordinator.md` y abre una sesión nueva. Si el validador termina con código 2, revisa su dependencia de validación. Si aparecen dos registros de tareas, resuelve la integración antes de continuar.

Fuente: [README oficial](https://github.com/dennisonbertram/claude-coordinator#installation). Procedimiento documental; no se ha ejecutado aquí.