Código e configurações¶
Embora os formatos tornem possível o intercâmbio, são as ferramentas que determinam quanto trabalho ele exige. Esta área reúne código e configurações para facilitar a participação e crescerá com as necessidades encontradas nos testes, desde uma busca local ou uma troca de arquivos mais simples até uma composição adequada ao ambiente de uma empresa.
Cada componente deve resolver um problema concreto de participação, identificando as operações que facilita e os requisitos para usá-lo. Para começar com um rascunho, siga o primeiro uso com IA; os recursos abaixo servem a quem deseja configurar ou programar outras operações.
O percurso de referência é operar em Open Legibility: ler questões e propostas, formular, preservar, apresentar e continuar uma contribuição. Uma configuração deve explicar quais dessas etapas facilita e quais continuam manuais. Interfaces de repositório, modelos e indexação podem ser fornecidos por ferramentas diferentes. O MCP existente não é um leitor automático de PRs.
Um agente com acesso autorizado a arquivos e Git pode começar sem MCP. O exemplo de espaço demonstra uma coleção de pacotes escolhidos, separada do cache privado. O MCP é uma opção para operações locais delimitadas, não uma exigência de uso do protocolo.
Componentes disponíveis¶
Cada entrada informa a edição, os requisitos e os testes existentes. Os guias acompanham o código desta distribuição, que pode ser consultado antes de qualquer instalação.
Core Rust e CLI¶
Preparar e verificar registros, ler rascunhos e consultar uma projeção local da genealogia.
Experimental · The Legible Protocol draft 0.4
Requisitos: Rust/Cargo; OpenSSH nos percursos de assinatura.
Limites: Os testes locais cobrem operações específicas; não certificam todas as condições da especificação.
Guia e fontes · Código · Contribuir para este componente
Testes existentes: protocol/reference/legible-core/tests.
Biblioteca Python¶
Importar, buscar e exportar rascunhos, além de usar operações do core em programas Python.
Experimental · The Legible Protocol draft 0.4
Requisitos: Python e CLI Rust compilado; configuração explícita dos recursos opcionais.
Limites: Helpers de assinatura e de provedores precisam respeitar as autorizações de cada implantação.
Guia e fontes · Código · Contribuir para este componente
Testes existentes: protocol/reference/legible-py/tests.
Servidor MCP de referência¶
Permitir que um cliente MCP busque, leia, importe e prepare contribuições locais, sem assiná-las.
Experimental · The Legible Protocol draft 0.4
Requisitos: Python, CLI Rust e host MCP compatível; HTTP exige a bancada configurada.
Limites: Não oferece assinatura por tool nem modelo embutido. Compatibilidade com contas e clientes externos requer teste no ambiente real.
Guia e fontes · Código · Contribuir para este componente
Testes existentes: protocol/reference/legible-mcp/tests.
Percurso Git e OpenSSH¶
Exercitar a formalização local com ferramentas de linha de comando.
Experimental · The Legible Protocol draft 0.4
Requisitos: Git, OpenSSH e CLI Rust; a pessoa revisa e opera a assinatura.
Limites: Ed25519 simples é a linha de base. Os exemplos automatizados usam identidades fictícias.
Guia e fontes · Código · Contribuir para este componente
Testes existentes: protocol/conformance/demos/demo_f_human_signs.sh.
Agent Skill¶
Orientar a preparação e a leitura de contribuições em ambientes que aceitam skills.
Disponível · The Legible Protocol draft 0.4
Requisitos: Ambiente capaz de carregar instruções; ferramentas e permissões são configuradas separadamente.
Limites: O pacote é documental. A resposta de cada modelo precisa ser avaliada no uso.
Guia e fontes · Código · Contribuir para este componente
A avaliação do comportamento do modelo depende do ambiente de uso.
App e bancada local entre participantes¶
Experimentar o circuito de rascunhos e preparação formal com escopos separados por participante.
Experimental · The Legible Protocol draft 0.4
Requisitos: Python, CLI Rust e, para a bancada Wi-Fi, OpenSSL e confiança HTTPS nos dispositivos.
Limites: É uma prova de conceito executada pelos participantes. A conexão nativa Gemini–MCP local permanece não verificada.
Guia e fontes · Código · Contribuir para este componente
Testes existentes: protocol/adapters/legible-app/test_app.py.
Implementações que podem surgir dos testes¶
Estas são frentes de desenvolvimento, ainda não componentes prontos:
- Configuração para Hermes ou outro ambiente de agentes. Uma receita deve informar a versão do host, como carregar instruções, quais ferramentas serão acessíveis e como diagnosticar falhas. Ter um servidor MCP não basta para afirmar compatibilidade com o host.
- Indexador local independente. Pode recuperar contribuições em pastas autorizadas e reconstruir seu índice a partir dos originais. Deve preservar origem e relações e distinguir rascunhos de registros formais. Busca por texto e inferência com modelo precisam ser identificadas separadamente. O core já oferece projeção e consulta; aproveite essas operações antes de duplicá-las.
- Ambiente corporativo de referência. Pode combinar identidades, acesso às evidências, armazenamento interno e processamento local ou externo autorizado. A receita precisa documentar a composição e os testes de isolamento.
Uma necessidade pequena pode justificar uma configuração de poucas linhas. O tamanho da implementação deve acompanhar o problema encontrado no uso.
Publicar e manter um componente¶
Os códigos podem ficar em repositórios da organização LegibleProtocol no GitHub, quando estabelecida, ou em repositórios de mantenedores independentes. Uma receita pode compartilhar um repositório com outras configurações; uma ferramenta com dependências e evolução próprias pode ter o seu.
Para propor um componente, apresente o problema que resolve, a licença, a instalação e um exemplo reproduzível. Identifique a edição do protocolo, as versões testadas e quem o mantém. Explique também onde ficam os dados, quais passos cada participante precisa repetir e quem fornece o modelo se houver inferência.
Os mantenedores selecionam as entradas e atualizam o site estático. Distribuir esse código não exige operar as instalações dos usuários. O catálogo descreve capacidades e testes; a especificação define conformidade.
Um teste técnico mostra se uma operação funciona. Um relato de colaboração ajuda a entender se ela merece ser usada. Ambos podem orientar melhorias. Appoints e relações podem acompanhar o componente quando seus autores escolherem prepará-los e compartilhá-los; uma alteração de código não exige um registro próprio.
Contratos técnicos · Executar localmente e conectar MCP · Contribuir
Repositórios do projeto¶
Organização no GitHub · Repositório do protocolo — acesso por convite · Repositório do site — acesso por convite · Livros e artigos no GitHub — acesso por convite · Contato