# Instrucciones para el agente: Observación de X: archivo de fuentes y síntesis de conversaciones

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
- Guía completa: https://lab.wisd.ai/hub/grok-x-search-mcp

---

## 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: delimita la muestra y comprueba el archivo

Define tema, periodo y criterios de inclusión. Esta receta exige un archivo SQLite de X CLI ya existente, poblado por una ruta cuya procedencia puedas acreditar. Aporta su ruta, cobertura y una publicación de control con texto, fecha y enlace. Comprueba que el archivo existe antes de abrirlo: una base nueva vacía no sirve como muestra.

Sigue [X CLI](/hub/x-twitter-cli) para instalar y configurar la pieza: comprueba Node.js ≥22.20.0, npm/npx y Go ≥1.26.10 en la ruta de catálogo, y aplica su ajuste de PATH antes de usar `x-twitter-pp-cli`. Configura el acceso remoto solo si vas a contrastar fuentes mediante la API.

No uses la sincronización de `tweets` para crear o ampliar esta muestra. El [código de sincronización](https://github.com/mvanhorn/printing-press-library/blob/main/library/social-and-messaging/x-twitter/internal/cli/sync.go) consulta `/2/tweets/search/webhooks`, que devuelve enlaces de webhooks. No hay una ruta documentada de archivo utilizable acreditada en este procedimiento. Si no dispones de una muestra válida, detente y explica el bloqueo; no sustituyas publicaciones por esos objetos ni una lectura remota por prueba de archivo.

### Paso 2: comprueba una búsqueda local

Sustituye la ruta y el término de control por los reales, en una carpeta de salida de la prueba:

```bash
x-twitter-pp-cli search "TERMINO_DE_CONTROL" --type tweets --data-source local --db "/ruta/al/archivo-existente.db" --limit 20 --json > muestra-control.json
```

`--data-source local` evita que `search` intente por defecto `/2/news/search`. Las opciones están definidas en el [código de search](https://github.com/mvanhorn/printing-press-library/blob/main/library/social-and-messaging/x-twitter/internal/cli/search.go). Comprueba que `muestra-control.json` contiene la publicación conocida, con texto, fecha e identificador que corresponda a su enlace real. Si falta o los resultados son otros objetos, detente. No ejecutes una sincronización para intentar resolverlo.

### Paso 3: prepara la escritura

Configura [Plain Writing](/hub/plain-writing-skill) e inicia una sesión nueva de Claude Code para que descubra la skill. Aporta un párrafo de ensayo y comprueba que `/plain-writing deslopify` conserva sus hechos.

## Monta el flujo

Repite la búsqueda local con el término del tema y guarda la salida como `muestra.json`. El límite de 20 puede truncar resultados: documenta el límite y filtra explícitamente por las fechas del periodo; el comando no aplica ese filtro temporal. Si la cobertura no basta, detente y solicita una muestra adecuada; ampliar su recopilación queda pendiente.

Entrega `muestra.json` a Plain Writing. Agrupa preguntas y argumentos, conserva enlaces, fechas y contraejemplos, y redacta el archivo de informe acordado con hallazgos, criterios de inclusión y lagunas. Guarda juntos informe y muestra para poder releer las fuentes.

## Comprobación

Contrasta tres enlaces de la muestra con sus originales, o todos si hay menos de tres. Verifica texto y fechas y que cada conclusión tenga respaldo. Una búsqueda vacía no demuestra ausencia de conversación en X.

## Si algo falla

Si el archivo no existe, no contiene publicaciones comprobables o no cubre el periodo, detente antes de redactar conclusiones. Explica qué dato falta. Esta composición de WISD se ha revisado documentalmente; no se ha ejecutado como prueba integral.

## Prompt para tu agente

Piezas: [X CLI](/hub/x-twitter-cli) · [Plain Writing](/hub/plain-writing-skill).

```text
Analiza <tema> en <periodo> dentro de <alcance autorizado>, usando solo el archivo existente de X CLI <ruta SQLite>. Antes de consultar, comprueba que existe, su procedencia y cobertura, y recupera <publicación de control: término, fecha y enlace> con search, tipo tweets y --data-source local. No uses sync de tweets para crear o ampliar el archivo: esta receta no acredita una ruta utilizable para hacerlo. Si falta el archivo, la publicación de control, texto, fechas, enlaces o cobertura suficiente, detente y explica el bloqueo; no inventes otra ruta ni redactes conclusiones. Guarda la búsqueda del tema en muestra.json junto a <archivo de salida>, filtra las fechas y declara el límite de resultados. Comprueba que Plain Writing está cargada en esta sesión y úsala para redactar hallazgos, muestra, contraejemplos y lagunas. Contrasta tres enlaces, o todos si hay menos; una búsqueda vacía no demuestra ausencia de conversación en X.
```
