guía

Su repositorio, listo para agentes en tres comandos.

Traducción asistida por agentes de IA. Ante cualquier diferencia, prevalece la página en inglés. Si encuentra algún problema en el texto, abra un issue o envíe un pull request.

La insignia que probablemente le ha traído hasta aquí identifica un repositorio cuya capa de contexto permite arrancar un agente. La validación y la puntuación se realizan en la máquina de quien lo mantiene, y la conformidad es autodeclarada. Para dejar su propio repositorio listo para agentes hacen falta los tres comandos siguientes.

Qué atestigua la insignia ↓

leji start abre una capa de contexto existente, así que los repositorios que aún no tengan una deben adoptarla primero. Eso es lo que hace el paso 02; si ya hay un leji.json, vaya directamente al paso 03. El inicio rápido explica el proceso completo, desde adoptar un repositorio existente hasta puntuar el nivel que declara.

01 · Instale la CLI

npm install -g @leji-org/leji

02 · Adopte el repositorio

leji adopt

03 · Entre en la capa de contexto

leji start

Qué acaba de pasar

  • leji start lanzó un host de agente detectado desde la raíz del repositorio, con una sola instrucción: leer primero el perfil de arranque, de modo que su contexto inicial es el del equipo y no lo que hubiera inferido del árbol de archivos. Eso es una instrucción, no una comprobación: leji señala el archivo al agente y nunca verifica que lo haya leído. Si no detecta ningún host, o en una ejecución automatizada, no lanza nada e imprime la línea que hay que ejecutar.
  • Antes de lanzarlo, leji start mostró un bloque de preparación para este clon: si la CLI de Leji declarada por el repositorio está disponible en la versión que necesita la línea de especificación de la capa, si el servidor MCP está registrado para el host que eligió, si hay un .mcp.json compartido confirmado, y si el hook de pre-commit está instalado. Cada carencia se notifica junto con el comando para resolverla, pero ninguna impide continuar.
  • Comprobar la capa en sí es otra cosa: leji validate para los esquemas y las reglas de lint, leji conformance para el nivel que declara. Ambos se ejecutan desde el paquete que acaba de instalar, en su propia máquina, sin ningún servicio de por medio.
  • El utillaje no abre ninguna conexión por su cuenta: detrás no hay cuenta, registro ni servicio alojado. Lo que llega a la red lo invoca usted mismo: las descargas de federación contactan con el repositorio que usted nombró, y el paso de dependencias de leji init y leji adopt ejecuta su propio gestor de paquetes con su sí explícito. El agente que lanza leji es el que usted ya ejecuta, con su propio comportamiento de red.

Qué atestigua la insignia

La insignia se genera localmente: leji badge puntúa el repositorio con leji conformance, escribe el SVG del nivel que esa ejecución offline verificó, e imprime una línea de markdown que lo incrusta.

leji badge

Para una capa de contexto verificada en el nivel governed, la insignia es esta:

Leji 1.0 · governed · self-attested Leji 1.0 governed

La línea de markdown que la incrusta en un README:

[![Leji 1.0 · governed · self-attested](leji-badge.svg)](https://leji.org/agent-ready/)

Los niveles son core, indexed, governed y federated, cada uno contenido en el siguiente. La lista de conformidad dice qué pide cada nivel a un equipo, y todos ellos son alcanzables solo con la especificación abierta y el utillaje de referencia.

Por tanto, lo importante es el resultado de la comprobación, no la imagen: ejecute leji conformance en el mismo repositorio y consulte lo que indica. Confianza explica quién mantiene Leji, qué promete la línea 1.0 y qué pasa si el custodio desaparece.