---
fragment_peers:
  appoint-declarar-o-que-voce-formulou: appoint-declare-what-you-formulated
  cada-declaracao-tem-seu-proprio-autor: each-declaration-has-its-own-author
  comecar-por-um-rascunho: starting-with-a-draft
  como-funciona: how-it-works
  como-registrar-as-contribuicoes-e-suas-relacoes: how-can-contributions-and-their-relationships-be-recorded
  da-documentacao-a-coordenacao: from-documentation-to-coordination
  exemplos-de-uso: usage-examples
  git-prov-e-notas-com-ia: git-prov-and-notes-with-ai
  mas-isso-ja-nao-seria-possivel-com-uma-boa-documentacao: wouldnt-good-documentation-already-make-this-possible
  nod-reconhecer-uma-consequencia-recebida: nod-recognize-a-consequence-received
  o-que-a-trajetoria-de-cada-pessoa-acrescenta: what-each-persons-history-adds
  proximos-passos: next-steps
  resultado-historico-e-genealogia: result-history-and-genealogy
  trace-declarar-em-que-um-trabalho-ou-decisao-se-apoiou: trace-declare-what-a-piece-of-work-or-decision-drew-on
  uma-proposta-recusada-pode-ajudar-a-formular-outra: a-rejected-proposal-can-help-shape-another
lang: pt
peer: en/introduction/
shared_fragments: false
title: Como funciona
---

# 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](first-draft.md) · [Entenda registros e verificabilidade](drafts.md)

## 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](https://git-scm.com/book/en/v2/Getting-Started-What-is-Git%3F),
[fluxos distribuídos](https://git-scm.com/book/en/v2/Distributed-Git-Distributed-Workflows)
e [introdução ao PROV do W3C](https://www.w3.org/TR/prov-primer/).

## 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](operate.md) explica como organizar essa prática e quais condições econômicas podem sustentá-la.

## Próximos passos

[Preparar um rascunho](first-draft.md) · [Compartilhar e desenvolver](participation.md) · [Participar de um espaço](get-started.md) · [Criar um espaço](open-space.md)

[Especificação](specification.md) · [Glossário](glossary.md) · [Artigos e livros](materials.md)

## 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](examples.md) mostra
o que cada pessoa declara e como usa os registros para escolher o próximo passo.

O [guia de coordenação econômica](economic-coordination.md) 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.