# LogBrew para agentes
Esta página explica cómo los agentes deben leer LogBrew sin depender del estado del navegador, contexto oculto ni acceso privado al panel.

## Primera lectura segura
```bash
logbrew status --json
```

## Contexto para asistente de IA
Da a un agente el mapa público de LogBrew antes de que edite tu app o el comando de configuración.

Prompt de configuración IA

```text
Lee https://logbrew.co/llms.txt y luego elige la tarjeta SDK correcta en https://logbrew.co/en/docs#docs-sdk-choice-title. Usa npm install @logbrew/sdk @logbrew/node solo para un servicio server-side Node.js; para Next.js, React, iOS, Android o React Native usa la tarjeta elegida y el prompt de Add Project. Pide al usuario con sesión iniciada que abra Add Project y coloque credenciales solo en el entorno de la app correspondiente. Para server-side Node.js, la variable de entorno es LOGBREW_SERVER_API_KEY. Ejecuta node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs solo para servicios Node y luego verifica con logbrew logs info --json. No pidas credenciales en el chat ni en commits.
```

# Mapa de tareas para agentes
Usa este orden cuando un asistente ayude a un desarrollador a configurar LogBrew o leer señales privadas.

## Paso 1: Lee el mapa público
Carga el índice público de rutas antes de cambiar código de la app para que el asistente empiece con contexto actual de LogBrew.

```bash
curl -L https://logbrew.co/llms.txt
```

Next: Usa los espejos Markdown enlazados para contexto público más profundo.

## Paso 2: Elige la tarjeta SDK
Lee primero el selector de SDK antes de instalar nada y luego usa Copiar prompt de instalación en Add Project para que el asistente siga la plataforma elegida.

```bash
curl -L https://logbrew.co/en/docs.md
```

Next: Pide al usuario con sesión iniciada que abra Add Project, copie el prompt de configuración con IA y no ponga credenciales de ingest en el chat.

## Paso 3: Comprueba el status local
Confirma alcance de API y fuente de auth antes de leer proyectos, logs, incidencias, acciones, trazas o versiones privadas.

```bash
logbrew status --json
```

Next: Sigue el campo next seguro para tokens en lugar de adivinar.

## Paso 4: Verifica la primera señal
Después de que la configuración envíe una señal SDK segura, lee un resultado con alcance y mantén tokens, cookies y datos de proyecto fuera de prompts.

```bash
logbrew logs info --json
```

Next: Usa lecturas de incidencias, acciones, trazas, versiones y proyectos solo cuando auth esté lista.

## Usa URL públicas predecibles
Los agentes deben encontrar contexto público de LogBrew mediante páginas localizadas estables, espejos Markdown, llms.txt, robots.txt y sitemap.xml.

- Usa /en/agents.md cuando el texto plano sea la entrada más segura.
- Usa /en/docs.md para contexto de comandos y rutas de API.
- Usa /llms.txt para descubrir recursos públicos legibles para agentes.

## Empieza con status seguro para tokens
La CLI debe indicar a los agentes si la auth local, el alcance de la API y los pasos de recuperación están listos sin exponer material de token.

- Ejecuta logbrew status --json antes de leer proyectos.
- Sigue los siguientes pasos del JSON y la salida humana en lugar de adivinar.
- Mantén el material de token fuera de prompts, logs, capturas y páginas públicas.

## Prefiere lecturas específicas por recurso
Los agentes deben leer logs, incidencias, acciones, trazas, versiones y proyectos con el mismo vocabulario de recursos que usan las personas.

- Usa filtros de versión, entorno, proyecto, traza, severidad, estado, nombre y usuario.
- Usa rutas de detalle de incidencia y traza cuando el identificador sea conocido.
- Usa espejos Markdown para contexto público y la API autenticada para datos privados de proyecto.

## Mantén los datos privados detrás de auth
Las superficies públicas para agentes deben seguir legibles, mientras los datos de panel y proyecto quedan protegidos por auth del backend y metadatos noindex.

- No leas datos del panel sin una sesión de usuario válida.
- No publiques nombres privados de proyecto, tokens, trazas ni detalles de despliegue.
- Usa páginas públicas para aprendizaje general y rutas autenticadas para datos de usuario con alcance.

## Public agent links
- Agents: https://logbrew.co/es/agents
- Agents Markdown: https://logbrew.co/es/agents.md
- Docs Markdown: https://logbrew.co/es/docs.md
- Home Markdown: https://logbrew.co/es/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml