> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driftless.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes Audit, Architect y Librarian

> Agentes del lado del servidor que mantienen honesto el contexto de tu equipo, lo hacen crecer y cuidan el grafo. Ellos proponen; un owner/admin agrega el resultado a la knowledge.

Driftless puede correr tres agentes especializados sobre tu codebase y tu grafo de knowledge. No reemplazan a un revisor. Revisan y hacen crecer el **contexto registrado** de tu equipo: los `gotchas`, `decisions` e `invariants` que tu equipo escribió. Cada uno **propone**; un owner/admin **agrega el resultado a la knowledge**.

* **El Auditor** mantiene honesto el contexto existente cuando el código cambia.
* **El Architect** hace crecer el contexto donde falta.
* **El Librarian** cuida el propio grafo de knowledge, como asesor.

## El Auditor

Cuando un pull request (o el drift) toca archivos que ancla un topic **reviewed**, el Auditor lee el cambio y el código actual, y lo compara afirmación por afirmación contra lo que el equipo registró.

* **Contradice una afirmación** → abre una Edición sugerida, citando el archivo/línea y el *porqué* de que la afirmación ahora esté mal (por ejemplo *"este diff elimina el chequeo de idempotencia que exige el invariant de `billing-flow`"*).
* **No está seguro** → marca una pregunta (sin patch) para que un humano la mire. Nunca fabrica una edición con falsa seguridad.
* **Sin impacto** → no hace nada. El silencio es el resultado común y correcto.

Solo audita contra **Knowledge** (`reviewed`). Una Nota es una idea sin mergear, nunca algo que se deba hacer cumplir.

## El Architect

En las áreas nuevas de un PR y en un barrido nocturno, el Architect busca **áreas de código que ningún topic cubre** y sugiere topics nuevos: agrupados por concepto, con un anchor angosto (5-40 archivos), sostenidos en el código que leyó, y enlazados a decisiones existentes donde tenga sentido. Se inclina a sugerir de menos: un hueco que se escapa sale barato, un topic spam erosiona la confianza.

## El Librarian

El Librarian cuida el propio grafo de knowledge. En un barrido semanal recorre el vault y produce un **reporte** de sugerencias: topics para promover, duplicados para fusionar, huecos que vale la pena llenar. En v1 es un **asesor**: nunca ejecuta un promote o un archive por su cuenta. Un humano actúa sobre el reporte.

La única excepción es opt-in. Con `librarian_autovouch` activado (experimental, apagado por defecto), un promote de alta confianza de un draft **escrito por un humano** puede auto-aplicarse. Todo lo demás queda como sugerencia.

## Cómo corren: BYOM

Los agentes corren **del lado del servidor en Driftless** usando **tu API key de OpenCode** (bring-your-own-model). OpenCode cobra la inferencia; Driftless nunca sirve tu key de vuelta hacia afuera. Se queda solo del lado del servidor.

* **Solo lectura.** Los agentes leen y razonan; nunca ejecutan, editan ni escriben código.
* **Solo proponen.** Todo lo que producen estos agentes autónomos aterriza como una **Nota** o una **Edición sugerida** en tu cola de revisión. Nunca mergean. Mergear a Knowledge es un acto de owner/admin, y estos agentes autónomos nunca mergean su propio trabajo (la separación de poderes se mantiene). Eso es distinto de *tu propio* agente (CLI/MCP, actuando bajo tu identidad), al que sí le puedes pedir de forma explícita que corra un merge en tu nombre.

## Configúralos

En el dashboard: **Settings → Agents**.

1. Pega tu **API key de OpenCode**.
2. Elige un **modelo**, o una lista de prioridad separada por comas (por ejemplo `opencode/claude-sonnet-4-6, opencode/big-pickle`); el runner rota al siguiente ante un error de rate-limit o de crédito.
3. Activa el **Auditor**, el **Architect** y el **Librarian**. `librarian_autovouch` es un interruptor aparte, experimental y apagado por defecto.

Cada agente está apagado hasta que lo habilitas: una corrida ocurre solo cuando el workspace tiene una key de modelo configurada y el toggle de ese agente está encendido. Si no, la corrida registra un `no_op` y no hace nada.

## Mira lo que hicieron

La pantalla **Agent Activity** es el registro de transparencia: cada corrida, el trigger (PR / nocturno), el modelo, los tokens usados, las propuestas creadas, y un resumen sin código de lo que el agente concluyó, incluyendo las corridas `no-op` (una señal sana: el agente miró y no encontró nada que cambiar).