guia

Deixe seu repositório pronto para agentes em três comandos.

Tradução assistida por agentes de IA. Em caso de divergência, prevalece a página em inglês. Se você encontrar algum problema no texto, abra uma issue ou envie um pull request.

O selo que provavelmente trouxe você até aqui identifica um repositório cuja camada de contexto permite iniciar um agente. Ela foi validada e pontuada na máquina de quem mantém o repositório, com resultado autodeclarado. Para deixar seu repositório pronto para agentes, bastam os três comandos abaixo.

O que o selo atesta ↓

leji start abre uma camada de contexto existente. Portanto, se o repositório ainda não tiver uma, será preciso adotá-la primeiro. A etapa 02 cuida disso; quem já tem um leji.json pode ir direto para a etapa 03. O início rápido mostra o caminho mais completo, da adoção de um repositório existente à pontuação do nível que ele declara.

01 · Instale a CLI

npm install -g @leji-org/leji

02 · Adote o repositório

leji adopt

03 · Entre na camada de contexto

leji start

O que acabou de acontecer

  • leji start abriu um host de agente detectado a partir da raiz do repositório, com uma única instrução: leia primeiro o perfil de boot, para que o contexto de abertura dele seja o da equipe, não o que ele inferiu da árvore. Isso é uma instrução, não uma verificação; o leji aponta o agente para o arquivo e nunca confere se ele o leu. Sem nenhum host detectado, ou em uma execução por script, nada é aberto e o comando exibe a linha a executar.
  • Antes de iniciar, leji start exibiu um bloco de Setup para este clone: se a CLI do Leji declarada pelo repositório está disponível aqui na versão exigida pela linha de especificação da camada, se o servidor MCP está registrado para o host que ele escolheu, se um .mcp.json compartilhado está commitado e se o hook de pre-commit está instalado. Cada lacuna vem acompanhada do comando que a corrige, e nenhuma delas impede a entrada.
  • A verificação da camada em si é separada: leji validate cuida dos schemas e das regras de lint, leji conformance verifica o nível que ela declara. Ambos rodam a partir do pacote que você acabou de instalar, na sua própria máquina, sem nenhum serviço no meio.
  • As ferramentas não abrem nenhuma conexão por conta própria, e não há conta, registro nem serviço hospedado por trás delas. Você mesmo inicia tudo o que acessa a rede: as buscas de federação entram em contato com o repositório que você nomeou, e a etapa de dependência em leji init e leji adopt roda o seu próprio gerenciador de pacotes depois da sua confirmação explícita. O agente iniciado pelo Leji é o mesmo que você já usa, com o comportamento de rede próprio dele.

O que o selo atesta

O selo é gerado localmente: leji badge pontua o repositório com leji conformance, grava o SVG correspondente ao nível verificado naquela execução offline e exibe uma linha de markdown que o embute.

leji badge

Para uma camada de contexto verificada no nível governed, o selo é este:

Leji 1.0 · governed · self-attested Leji 1.0 governed

A linha de markdown que o embute em um README:

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

Os níveis são core, indexed, governed e federated, cada um incluindo o anterior. O checklist de conformidade mostra o que cada nível exige de uma equipe, e todos eles podem ser alcançados apenas com a especificação aberta e as ferramentas de referência.

Portanto, o que importa é o resultado da verificação, não a imagem: rode leji conformance no mesmo repositório e confira o relatório. Confiança explica quem mantém o Leji, o que a linha 1.0 promete e o que acontece se a curadora desaparecer.