# Instrucciones para el agente: Archify: convierte ideas y sistemas en diagramas interactivos

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/tt-a1i/archify (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/archify-diagrams

---

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

Comprueba que tu arnés admite skills, puede ejecutar Node.js y puede escribir el HTML de salida. Para instalar con la [CLI skills actual](https://github.com/vercel-labs/skills/blob/main/package.json), verifica Node.js ≥22.20.0 y npm/npx.

### Paso 1: instala la skill

Lee el README y revisa el ámbito global de su comando oficial:

```bash
npx skills add tt-a1i/archify -g
```

Selecciona tu arnés en el instalador. Si prefieres otro ámbito o una prueba temporal, consulta las alternativas del README.

### Paso 2: pide un caso pequeño

Pide al agente: «Usa Archify para mostrar una petición web: el navegador llama a la API, la API consulta Redis y, si falta el dato, consulta PostgreSQL y rellena la caché». Es la situación del ejemplo oficial, expresada en español.

### Paso 3: revisa y comparte el HTML

Haz que el agente ejecute el recorrido de validación de la skill y entregue el archivo. Ábrelo en el navegador y comprueba nodos y conexiones antes de compartirlo. Si parte del diagrama describe un repositorio, exige enlaces a archivos que hayas podido contrastar.

## Comprobación

Comprueba que el HTML abre y que el recorrido de caché representa el caso correcto. Prueba los detalles interactivos presentes en la salida y distingue validación de formato de verificación del contenido.

## Si algo falla

Si la skill no aparece, revisa arnés y destino del instalador. Si faltan relaciones, corrige primero la representación de origen y vuelve a validar; no repares solo la apariencia del HTML.

Fuente: [documentación del proyecto](https://github.com/tt-a1i/archify/blob/81c6be8d87090670c45d08a8f97f9d29c5af0bec/README.md).