Como funciona¶
O Legible Protocol permite registrar o que cada pessoa formulou, os critérios e escolhas que assumiu e as relações com outros trabalhos. Essas informações podem acompanhar uma entrega e ajudar quem a recebe a compreender como ela foi produzida, avaliar suas razões ou desenvolver outra solução.
O protocolo organiza declarações sobre o trabalho, enquanto os documentos, códigos, análises e demais materiais podem permanecer como evidências referenciadas. Cada participante descreve o que assume e pode registrar suas relações com outros trabalhos. Quem recebe esses registros consegue examinar as formulações e as dependências declaradas, mesmo sem ter acompanhado todo o processo de produção.
Como registrar as contribuições e suas relações?¶
O Legible define três tipos fundamentais de declaração, com funções distintas. Eles permitem registrar uma formulação, declarar em que um trabalho se apoiou e reconhecer posteriormente uma consequência recebida. A criação de um tipo de registro não exige que os outros também sejam produzidos.
Appoint — Declarar o que você formulou.¶
Um Appoint atribui uma formulação a quem a declara. Essa formulação pode ser um problema, uma hipótese ou uma solução, mesmo que ainda não tenha sido escolhida ou executada.
O trabalho detalhado, inclusive quando executado com assistência de IA, pode ser referenciado como evidência. A formulação do problema também pode ser a própria contribuição, sem depender de uma solução pronta.
Trace — Declarar em que um trabalho ou decisão se apoiou.¶
Um Trace declara em que outro trabalho uma formulação, solução ou decisão se apoiou. Seu autor identifica os materiais relacionados e explica a dependência que está afirmando. Essa relação permite acompanhar o uso de uma contribuição sem atribuir ao novo trabalho a origem de tudo o que ele incorporou.
Um documento de decisão também pode ser relacionado aos trabalhos que o fundamentaram. O Trace torna essa dependência declarada examinável, enquanto a aprovação de recursos e a autoridade para decidir permanecem nos processos organizacionais correspondentes.
Nod — Reconhecer uma consequência recebida.¶
Um Nod registra o reconhecimento de uma consequência recebida de uma contribuição anterior. A declaração é feita por quem experimentou o benefício e descreve o que reconhece, com as referências pertinentes.
Além de documentar o que aconteceu, esse reconhecimento acrescenta informações que outros participantes podem considerar em suas próprias decisões. Conhecer quem reconheceu uma contribuição, em quais circunstâncias e por qual consequência pode ajudar a avaliar onde colaborar, que trabalho desenvolver ou quais atividades sustentar.
O reconhecimento permanece situado: descreve a experiência de quem o emitiu, e cada leitor avalia sua pertinência segundo as evidências e os critérios que considera relevantes. Esse ato ocorre depois da consequência e é distinto da decisão anterior de adotar, financiar ou implementar uma proposta.
Cada declaração tem seu próprio autor.¶
Cada participante assume a declaração que faz. Formular um problema não equivale a prever quem se beneficiará dele; declarar uma dependência não fala em nome dos autores dos trabalhos relacionados. Essa distinção permite examinar separadamente o conteúdo de cada afirmação e quem a assumiu.
Uma relação entre trabalhos também pode ser declarada por alguém que não participou de sua produção. Essa pessoa pode criar um Trace, explicar a relação que identificou e apresentar as evidências em que se apoiou. O registro identifica quem fez a afirmação, sem atribuí-la automaticamente aos autores dos trabalhos relacionados.
No caso do Nod, a declaração é de quem recebeu a consequência. Uma pessoa pode reconhecer como determinado trabalho beneficiou sua atividade, mas observar um benefício recebido por outra pessoa não equivale a tê-lo recebido.
Os registros formais são assinados digitalmente. A assinatura permite verificar sua integridade e a chave que assumiu cada declaração, mas não comprova, por si só, a veracidade, originalidade ou mérito do que foi afirmado.
Quem lê continua responsável por examinar as evidências e formar seu julgamento. O protocolo também não cria uma pontuação oficial para medir quanto cada pessoa contribuiu.
Começar por um rascunho¶
Você pode preparar essas descrições como rascunhos não assinados. O primeiro passo é conferir se o documento corresponde ao que cada participante formulou ou assumiu e se preserva as dúvidas e relações pertinentes.
Na revisão, preserve a origem das formulações e descreva separadamente as escolhas de quem as utilizou. Uma pergunta não se transforma em conclusão; adotar uma proposta não significa tê-la originado. Se a IA sugerir uma alternativa, a descrição deve distinguir a sugestão recebida da decisão humana de adotá-la.
Um rascunho pode permanecer informal durante toda a sua utilização. Quando desejar formalizar, você prepara uma nova declaração assinada, que pode fazer referência ao rascunho como evidência. Guardar o registro privadamente e compartilhá-lo são decisões distintas.
Prepare o primeiro rascunho · Entenda registros e verificabilidade
Uma proposta recusada pode ajudar a formular outra¶
Preservar uma formulação e decidir utilizá-la são operações distintas. Uma proposta que não justifica um investimento pode conter um problema bem identificado, um critério de avaliação ou uma análise aproveitável em outro contexto. A decisão de não executar aquela solução não elimina o interesse dessas partes para outras leituras.
Quando a formulação permanece acessível, outro participante pode retomá-la, avaliar suas razões e desenvolver uma alternativa. O novo trabalho pode declarar o que utilizou dos anteriores, preservando tanto a origem das formulações quanto aquilo que seu próprio autor acrescentou.
Uma decisão posterior de adoção também pode ser relacionada às contribuições que a fundamentaram. O registro aponta para o documento de decisão e os trabalhos considerados, enquanto a autorização para comprometer recursos continua documentada nos processos da organização. A declaração de dependência permite examinar a relação assumida por seu autor; não substitui a verificação das autorizações e condições correspondentes.
Mas isso já não seria possível com uma boa documentação?¶
Sim. Uma documentação bem mantida também pode preservar problemas, critérios e justificativas para trabalhos futuros. O Legible acrescenta convenções comuns para que os participantes assumam declarações próprias, registrem dependências e possam transportá-las e verificá-las entre contextos diferentes.
O Legible permite que cada participante assuma sua declaração por meio de uma assinatura digital verificável. A assinatura é soberana no sentido de que pode ser realizada com uma chave sob seu controle, sem aprovação prévia de uma plataforma ou da instituição que recebe o trabalho. A declaração assinada pode ser guardada privadamente, compartilhada e verificada em outros ambientes.
Uma pessoa pode associar essa chave à identidade pela qual já é conhecida. Quem conhece essa associação pode examinar a declaração considerando também a trajetória profissional e as relações de confiança daquele autor, mesmo que seja seu primeiro registro no Legible. A chave permite verificar a assinatura; o vínculo com a pessoa é conhecido e examinado por outros meios.
O formato comum preserva essas declarações e as relações entre contribuições, mesmo quando elas surgem em momentos, ferramentas ou organizações diferentes.
As evidências podem permanecer nas ferramentas em que o trabalho foi produzido. Um registro pode apontar para uma análise, um repositório de código, um teste ou um documento de decisão. Essa referência conserva a distinção entre a declaração assumida e o material que permite examiná-la.
Quem recebe esses registros em outro ambiente pode examinar as relações sem precisar utilizar a mesma aplicação. O acesso às evidências continua dependendo de suas permissões: referenciar um relatório interno não torna seu conteúdo público.
Resultado, histórico e genealogia¶
Enquanto o resultado apresenta o trabalho entregue, o histórico conserva uma conversa em que se misturam perguntas, tentativas, instruções e sugestões. Sem uma descrição do que cada participante escolhe assumir, compreender uma decisão pode exigir que o leitor refaça essa seleção.
A genealogia cognitiva assumida descreve as contribuições que os participantes escolhem declarar: uma pergunta que mudou a análise, um critério adotado, uma correção ou uma relação com outro trabalho. Aponta para as evidências pertinentes, inclusive o resultado e suas versões.
Ela pode começar informalmente e permanecer assim. Quem formaliza assina uma declaração específica, sem transformar essa seleção em uma reconstrução completa do pensamento. O trabalho e seus registros continuam distintos; uma referência pode indicar uma evidência que permanece restrita.
O que a trajetória de cada pessoa acrescenta¶
Pessoas diferentes podem assumir uma formulação semelhante com experiências e relações diferentes. Essa trajetória pode ser conhecida pela profissão, por trabalhos anteriores ou por relações diretas, mesmo antes do primeiro registro no Legible.
Quem conhece o autor pode considerar esse contexto ao examinar a declaração. Os registros ajudam a relacionar o que ele assume aos trabalhos e consequências declaradas, mas não produzem uma reputação oficial nem reconstroem toda a sua trajetória.
Uma pergunta, um trabalho incompleto ou uma hipótese equivocada também podem ser descritos. Registrar a participação permite examiná-la; não torna correto o resultado nem exige que a pessoa tenha um histórico extenso para começar.
Git, PROV e notas com IA¶
O Legible se relaciona com recursos que já preservam trabalho e contexto: Git permite desenvolver contribuições antes de sua integração a um repositório principal; o modelo PROV do W3C descreve proveniência, incluindo participação humana; e boas notas com IA podem guardar critérios e decisões. A questão específica do protocolo é como trocar declarações de contribuição, relação e consequência entre participantes de contextos diferentes.
| Recurso | O que oferece | Como pode se relacionar com Legible |
|---|---|---|
| Git | Versões, ramificações, distribuição e integridade por endereçamento de conteúdo; commits podem ser assinados | Pode guardar registros Legible, cuja semântica não exige correspondência com commits |
| W3C PROV | Um modelo geral de entidades, atividades, agentes e relações de proveniência | Pode fundamentar um mapeamento das declarações; essa correspondência precisaria ser especificada e ainda não está implementada |
| Notas com IA | Contexto, justificativas e recuperação conforme a organização das notas e os recursos da ferramenta | Podem continuar sendo usadas; Legible acrescenta convenções comuns de intercâmbio, relações e formalização |
A diferença pretendida deve aparecer na prática: menos esforço para compreender e continuar contribuições entre contextos, com origem e relações preservadas. Isso precisa compensar o trabalho adicional de preparar e revisar os registros. A comparação adequada usa as mesmas pessoas, IA, informações e canais, incluindo boas notas bem mantidas.
Referências: fundamentos do Git, fluxos distribuídos e introdução ao PROV do W3C.
Da documentação à coordenação¶
Uma formulação preservada pode participar de decisões diferentes daquelas que motivaram sua criação. Seu interesse depende também de quem a examina, da pergunta que orienta a leitura e dos conhecimentos com os quais ela pode ser relacionada.
Por isso, o mesmo conjunto de registros pode sustentar leituras diferentes. Desenvolver uma solução, investigar suas dependências e avaliar seus riscos são questões que podem levar à consideração de partes distintas do acervo. Cada participante pode consultar os materiais acessíveis com suas próprias ferramentas e critérios, sem precisar adotar uma interpretação única do trabalho.
Para que essa possibilidade seja efetiva, as referências precisam permitir localizar os materiais pertinentes e suas condições de acesso devem estar claras. Uma formulação que não foi escolhida para determinado uso pode continuar disponível para outras leituras, desde que alguém a preserve e a mantenha acessível nas condições correspondentes.
Quando deseja formalizar, cada participante pode assinar sua própria declaração e preservar as relações com os trabalhos utilizados. Isso permite verificar o conteúdo que foi assumido e sua atribuição à chave, enquanto a identidade e a trajetória conhecidas do autor, as evidências e as condições de cada atividade ajudam o leitor a formar seu julgamento. Quem decide colaborar pode fazê-lo com uma compreensão mais clara do que os demais afirmam e do que ainda precisa ser investigado.
As ferramentas de IA podem ajudar a localizar contribuições pertinentes, comparar critérios e preparar perguntas a partir dos materiais acessíveis. O ganho procurado depende de esse auxílio reduzir o esforço necessário para compreender e desenvolver o trabalho alheio, compensando o custo de preparar e revisar os registros.
A troca pode então produzir conhecimento que ainda não estava documentado: uma pergunta pode revelar uma restrição desconhecida, um teste pode alterar um critério e a leitura de uma proposta pode levar à formulação de outro problema. Cada participante decide o que acrescentar e assumir. Esses trabalhos podem ser desenvolvidos antes de uma decisão de investimento e permanecer acessíveis para outros usos, conforme as condições em que forem preservados e compartilhados.
Para quem contribui, preservar essa participação e poder acompanhar os usos e as consequências declarados também informa a escolha de continuar colaborando. Operar em Open Legibility explica como organizar essa prática e quais condições econômicas podem sustentá-la.
Próximos passos¶
Preparar um rascunho · Compartilhar e desenvolver · Participar de um espaço · Criar um espaço
Especificação · Glossário · Artigos e livros
Exemplos de uso¶
Acompanhe uma prestadora de serviços que entrega por ciclos, uma equipe de P&D que preserva observações antes de financiar testes e uma equipe que prepara suas decisões antes das reuniões. A área de exemplos mostra o que cada pessoa declara e como usa os registros para escolher o próximo passo.
O guia de coordenação econômica desenvolve esses casos: contribuições antes da demanda, acesso aos resultados e reconhecimento escolhido depois da consequência. É uma apresentação inicial de possibilidades e hipóteses a examinar na prática.