# Instrucciones para el agente: Code Context Engine: prepara un índice local para búsquedas del agente

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/elara-labs/code-context-engine (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/code-context-engine

---

## 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: inicializa dentro del proyecto

Comprueba que tienes uv/uvx, Python ≥3.11 y un compilador C disponibles; el README exige el compilador para las gramáticas de tree-sitter. Desde la raíz del proyecto, el README publica esta vía en un paso:

```bash
uvx --from "code-context-engine[local]" cce init
```

### Paso 2: revisa la conexión

Inspecciona los cambios de configuración que propone el inicializador y conserva los servidores MCP existentes. Recarga el cliente si lo necesita y solicita una búsqueda sobre una función conocida. La instalación mediante `uvx` es temporal: para probar desde terminal la CLI sin depender de una instalación global, usa `uvx --from "code-context-engine[local]" cce search "auth flow"`, adaptando la consulta a una función que exista. Es el subcomando de búsqueda del README dentro del mismo entorno temporal. Compara los fragmentos y sus rutas con el archivo real.

## Comprobación

Comprueba la conexión MCP y compara el fragmento encontrado con el archivo real. Haz una modificación pequeña y verifica que el contexto sigue actualizado.

## Si algo falla

Si el agente no encuentra código, revisa la raíz indexada y las exclusiones. Si sigue usando lecturas completas, distingue su elección de herramientas de un error del servidor.