# Instrucciones para el agente: Graphify: consulta relaciones entre código y documentos

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/Graphify-Labs/graphify (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/graphify-local-knowledge

---

## 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 la CLI

Comprueba que tienes Python ≥3.10 y uv disponibles. Elige si registrarás la skill para el usuario o para un proyecto.

```bash
uv tool install graphifyy
graphify install
```

Como alternativa al registro anterior, desde la raíz del proyecto el README documenta el registro específico para Codex:

```bash
graphify install --project --platform codex
```

Para esa variante de Codex, comprueba antes de la extracción paralela el requisito del [README, Install → Pick your platform](https://github.com/Graphify-Labs/graphify#install): `multi_agent = true` dentro de `[features]` en `~/.codex/config.toml`. Integra la opción sin duplicar la sección ni borrar otras opciones y reinicia Codex para cargar la configuración y la skill. Registrar la skill no activa por sí solo la extracción paralela. Si tu versión no admite esa configuración, detente en esta variante y consulta la documentación correspondiente; la ruta principal de esta prueba es Claude Code.

### Paso 2: analiza un proyecto de prueba

Abre una sesión nueva de Claude Code en la raíz del proyecto y confirma que descubre la skill; después usa:

```text
/graphify .
```

En Codex el README indica que se invoca con `$graphify`. Empieza con una carpeta sin información sensible.

## Comprobación

Comprueba que el agente invoca la skill y analiza la carpeta elegida, que se genera `graphify-out/` y abre `graphify-out/graph.html`. Sigue una relación hasta los archivos originales y confirma si está marcada como extraída o inferida.

## Si algo falla

Si falta la skill, revisa la plataforma elegida durante el registro. Si falla un formato documental, consulta los extras del README y configura solo el proveedor necesario.

Fuente: [documentación oficial](https://github.com/Graphify-Labs/graphify#readme).