Pular para conteúdo
Nesta página

Criar um espaço de Legibilidade Aberta

Um espaço de Legibilidade Aberta permite guardar o que cada participante assume no trabalho e criar condições para que outros possam lê-lo e desenvolvê-lo.

Sem acesso ao site, anexe apenas o guia de primeiro uso. Ele inclui o formato completo dos rascunhos e, num apêndice opcional, o modelo abaixo.

Ver o modelo de apresentação · Organizar os arquivos · Condições de participação

Pode começar apenas com você e seus registros privados; ao abrir a colaboração, explique o contexto, o que pode ser consultado e como apresentar novas formulações, preservando autoria, relações e evidências antes da decisão de utilizá-las.

O espaço pode acompanhar um setor, um produto, uma empresa ou uma ideia ainda individual, recebendo contribuições externas ou permanecendo no ambiente interno. Antes de escolher pastas e repositórios, procure compreender que colaboração você quer tornar possível e se ela já encontra lugar num espaço existente.

Comece com a sua IA

Envie o link desta página ou use a instrução acima para que a IA explique o Legible com um exemplo e ajude a compreender sua situação. A conversa avança uma pergunta por vez, usando cada resposta antes de recomendar uma forma de uso, sem exigir que você já conheça os formatos ou tenha planejado a organização do espaço.

Você pode começar só com seu trabalho e escolher depois com quem compartilhá-lo. Este percurso ajuda a criar seu espaço; a manutenção do protocolo tem outro guia.

Escolha o alcance antes de organizar os arquivos

Se o objetivo é aproximar o que atendimento, produto e engenharia sabem, um espaço contínuo do produto pode ser mais útil que uma pasta para cada incidente; se é desenvolver uma ideia ainda sem colaboradores, você pode começar com seu próprio trabalho. Para receber contribuições externas, apresente o contexto e distinga o que pode circular do que precisa continuar interno.

A IA deve ajudar a compreender o que você gostaria de tornar possível, quem poderia participar e se já existe um espaço adequado. Faz isso pela conversa, usando cada resposta para escolher a pergunta seguinte.

Ao ouvir que “as observações do atendimento se perdem antes de chegar ao produto”, a IA pode pedir um caso recente antes de recomendar uma pasta compartilhada. O relato permite investigar se a observação não foi registrada, ficou difícil de encontrar ou deixou de circular depois de não entrar no planejamento, distinguindo problemas que podem exigir soluções diferentes.

Com essa compreensão, a IA apresenta sua leitura como hipótese, esclarece as dúvidas relevantes e recomenda um alcance, explicando por quê. Depois ajuda a preparar a apresentação, orienta onde salvá-la e como convidar alguém. Se não puder criar pastas ou configurar permissões, explica as ações que você precisa realizar, sem afirmar que as executou. Para um objetivo e recursos já informados, usa essas informações e avança.

Uma página de apresentação, um local de preservação e um percurso de participação podem bastar. Você pode aproveitar um repositório existente ou separar o espaço do código da organização, para que contribuir não exija copiar um projeto inteiro.

Decida o necessário para a primeira troca

Para a primeira troca, combine quem poderá ler, onde a contribuição será preservada, por qual canal será apresentada e como consultar as respostas, distinguindo o acesso aos registros, às evidências e seu processamento por IA. A ferramenta deve perguntar apenas o que falta para a próxima operação, deixando chaves, indexadores e infraestrutura corporativa para quando forem necessários.

O exemplo de espaço para baixar reúne README, condições de participação, política Git e quatro rascunhos fictícios com seus manifestos. É um ensaio local, não um espaço real já publicado.

Apresente o contexto e o que pode ser acrescentado

Apresente o que a organização faz, quais questões consegue compartilhar e que informações estão disponíveis, descrevendo o problema e suas incertezas antes de prescrever uma entrega. Assim, quem conhece uma condição de uso pode contribuir mesmo sem saber implementar a solução, e outro participante pode identificar um problema que ainda não havia sido formulado.

Informe como apresentar essas contribuições, inclusive quando elas não correspondem a nenhuma questão publicada. Trabalhos já definidos também podem ser desenvolvidos nesse espaço; não é preciso reabrir todas as decisões.

Um modelo de apresentação adaptável

O texto abaixo pode compor uma página do seu site ou o README do repositório. Substitua as indicações pelas condições reais do espaço antes de disponibilizá-lo. Ele é um modelo editorial, não uma nova especificação de dados ou termos jurídicos.

Nosso espaço de Open Legibility

Compartilhamos aqui questões sobre [contexto]. Você pode acrescentar uma observação, formular outro problema, questionar uma premissa ou desenvolver uma solução parcial, sem precisar de uma tarefa atribuída.

Para começar: leia [apresentação das questões] e [condições de acesso e reutilização]. Consulte as instruções de participação do Legible Protocol em https://lp-dev-7m4q9x2k.pages.dev/pt/get-started/ com sua IA; sem acesso ao site, forneça o arquivo legible-participar-pt.txt disponível junto das instruções do espaço. Ou prepare sua contribuição em um editor. Revise o que deseja declarar e escolha o que compartilhar.

Onde preservar e apresentar: [repositório ou coleção] guarda o acervo mantido por nós. Apresente sua proposta por [canal disponível]. Você também pode preservá-la em uma origem própria, respeitando os direitos e as condições aplicáveis. O percurso começa com rascunhos; a formalização é uma escolha própria.

Como considerar outras propostas: consulte [acervo] e [propostas em discussão]. A versão principal do repositório contém apenas o que foi incorporado. Seus critérios de busca podem revelar algo que ainda não usamos.

Como continuamos: [responsáveis e prática de acompanhamento] explicam como examinamos propostas. A incorporação ao nosso acervo e a decisão de utilizar, financiar ou contratar têm condições próprias. Quando reconhecermos uma consequência recebida, poderemos registrá-la em um Nod.

Direitos e contato: [licenças, limites de divulgação e canal para dúvidas ou correções]. Compartilhe apenas material que possa disponibilizar nesse ambiente. Não inclua evidências restritas nem dados pessoais desnecessários.

Modelo para o seu espaço
Ver o Markdown para copiar manualmente

Se oferecer o percurso sem internet, disponibilize também uma cópia atual do anexo indicado. O link completo funciona fora deste site, mas sua existência não substitui o arquivo no uso offline.

Organize o repositório e a leitura

A apresentação do espaço explica o contexto e indica onde consultar o acervo. As condições de participação descrevem o que pode ser compartilhado, por qual canal apresentar uma proposta e como acompanhar respostas.

Você pode usar uma pasta compartilhada, um repositório existente ou uma coleção separada do código da organização. No percurso Git, o README apresenta o espaço e o arquivo CONTRIBUTING.md descreve a participação. A convenção de armazenamento dos registros é .legible/; os documentos de contexto continuam sendo documentos comuns.

Guarde os rascunhos privados fora do acervo compartilhado e transfira apenas as versões escolhidas. As evidências restritas precisam de armazenamento com permissões próprias. Uma pasta ignorada pelo Git não protege arquivos que já entraram no histórico.

O exemplo para baixar mostra essa organização com arquivos fictícios. Para usar os componentes de referência, siga os procedimentos de exportação, Git e compartilhamento de registros assinados.

Combine condições de participação

Defina quais materiais podem ser reutilizados, quem pode acessar registros e evidências e quais provedores podem processá-los. O serviço Git, o servidor ou o sistema de arquivos aplica as permissões configuradas; o campo visibility apenas declara uma condição no registro. Git também pode expor nomes e e-mails de commits, além dos próprios arquivos.

Num espaço misto, mantenha evidências internas em outro repositório ou armazenamento com acesso próprio. Publique no acervo externo apenas as declarações autorizadas e suas referências. Outro branch, um arquivo apagado da versão atual ou uma regra .gitignore não isolam conteúdo que já entrou no histórico distribuído. Confira com dados fictícios o que alguém externo consegue recuperar antes de abrir o acesso.

Contribuição, autorização de uso, contratação e reconhecimento são decisões distintas. As condições efetivas da relação e as obrigações aplicáveis continuam importando. O modelo não exige cessão de direitos, trabalho gratuito ou promessa de pagamento. Escolha as licenças adequadas a seus materiais; as licenças do projeto Legible não se estendem automaticamente ao seu espaço.

Reduza o esforço conforme o uso

Comece com os recursos que seus participantes conseguem usar. No chat móvel, selecione arquivos e referências e confira o resultado antes de enviar. Em ambientes com ferramentas, um agente pode auxiliar consultas, preparação, validação e comparação de alterações. Autorizações para publicação e assinatura continuam específicas.

Um índice pode ajudar a encontrar contexto sem carregar toda a genealogia na IA. Não precisa ser global nem central: cada participante ou organização pode indexar as fontes às quais tem acesso. Modelo, custo, atualização e limites precisam estar claros. O catálogo distingue componentes existentes e propostas.

Avalie a continuidade

Verifique se alguém consegue apresentar uma contribuição antes de seleção, encontrar uma proposta não incorporada e desenvolvê-la sem apagar sua origem. Observe também quem faz o trabalho de preparação e leitura, quanto custa e se há razões para continuar contribuindo. Compare com o fluxo habitual usando acesso semelhante a pessoas, modelos, informações e tempo.

Operar em Open Legibility · Compartilhar e desenvolver

Ler esta página em Markdown