O standard que é só uma pasta (e porque isso te devia interessar)

Há três semanas a Google publicou uma especificação que, por baixo de tudo, é uma pasta de ficheiros de texto. Nada de base de dados, nada de SDK, nada de servidor. Uma pasta com ficheiros markdown lá dentro.

Parece simples de mais para importar. Importa porque dá nome a um problema que qualquer empresa pequena já tem e que ninguém se tinha dado ao trabalho de padronizar: onde é que o teu conhecimento vive de facto, e consegue uma máquina lê-lo?

## O que é, sem rodeios

Chama-se **Open Knowledge Format**, ou OKF. Saiu do blog da Google Cloud a 12 de junho, na versão 0.1, com licença aberta. A ideia cabe numa frase: representar o conhecimento de uma organização como um conjunto de ficheiros markdown, cada um a descrever uma coisa (uma tabela, uma métrica, um procedimento), com um pequeno cabeçalho estruturado no topo e texto normal por baixo.

Se já usaste Obsidian, ou um wiki, ou até uma pasta bem arrumada no Google Drive, a forma vai parecer-te familiar. É de propósito. O markdown é aquele texto simples onde escreves `# Título` para um cabeçalho e pões um link entre parêntesis retos. Um humano lê num editor qualquer; um modelo de AI lê exatamente o mesmo ficheiro, sem tradução pelo meio.

O truque esperto está nos links. Os ficheiros ligam-se uns aos outros com links markdown normais, e isso transforma a pasta num **mapa de relações**, não numa lista solta. O agente não vê só as tuas páginas: vê como elas se ligam. É essa camada de relações que um copiar-colar cego deita fora.

A frase que destranca o resto: **o OKF padroniza o recipiente, não o significado.** Concorda no formato da caixa. Não concorda no que lá pões dentro. Guarda esta distinção, que voltamos a ela.

## O problema que resolve

Pensa em tudo o que é preciso saber para gerir um negócio e que nunca está escrito num sítio só. O significado exato de uma métrica. A regra de como dois sistemas se falam. O procedimento quando algo corre mal. A razão por que uma coisa se faz assim e não de outra maneira.

Esse conhecimento vive espalhado: um bocado num catálogo, outro num wiki, outro em comentários de código, e a maior parte na cabeça de uma ou duas pessoas. Quando montas um assistente de AI para responder a "como calculo isto?", ele tem de coser a resposta a partir destes retalhos, cada um no seu formato. A Google chama-lhe o problema de *montagem de contexto*, e a observação por trás do OKF é boa: toda a gente que constrói um agente está a resolver o mesmo problema do zero. O que falta não é mais uma ferramenta. É um formato comum.

## O retrato honesto (a parte que separa perceber de repetir)

Aqui é onde a maioria dos artigos sobre o OKF se atrapalha, por entusiasmo. Três coisas que o OKF **não** é:

**Não é SEO.** Isto vai tentar quem trabalha em pesquisa, e é uma armadilha. O OKF não é um sinal de ranking. A pesquisa da Google não vai buscar a tua pasta para te posicionar melhor. É um formato de conhecimento interno para agentes, não um sinal de publicação web. Um bundle não te mexe no tráfego esta semana nem na próxima.

**Não resolve o significado, só o formato.** Esta é a crítica séria, e é justa. Há uma diferença entre concordar no *layout* (pastas, ficheiros, um campo obrigatório) e concordar no *sentido* (o que cada tipo de coisa quer dizer, o que cada relação significa). O OKF v0.1 resolve o primeiro e deixa o segundo em aberto, de propósito. Na prática, duas pastas podem ser as duas perfeitamente válidas e não partilhar vocabulário nenhum: uma escreve `type: tabela`, outra escreve `type: table` para a mesma coisa. Os links dizem que dois conceitos se relacionam, mas não dizem como. Isto vai ter de ser resolvido, e já há trabalho nesse sentido: a 19 de junho formou-se um grupo comunitário para mapear o OKF em standards da web, com um perfil que lhe acrescenta semântica formal por cima. Mas hoje, na v0.1, o recipiente está padronizado e o sentido fica com quem escreve.

**Não é sem riscos.** Uma base de conhecimento que um agente pode atualizar sozinho é também uma porta de entrada. Se o agente escreve a partir de fontes que não controlas, a pasta passa a ser um vetor para instruções maliciosas escondidas no texto que ele engole. Convém pensar cedo em quem, e o quê, tem permissão para escrever lá dentro.

E há a ressalva de sempre com a Google: o formato é mesmo aberto e não exige conta nenhuma, mas as ferramentas de referência são todas feitas em casa (o gerador usa o modelo deles, a fonte de exemplo é a base de dados deles, o caminho óbvio de ingestão é o produto deles). A gravidade do ecossistema ainda puxa para a Google Cloud, mesmo quando a licença não puxa.

## Da trincheira

É aqui que isto deixa de ser teoria. Não escrevo sobre o OKF porque li a especificação. Escrevo porque vivo o problema que ela nomeia.

Opero, há mais de uma década, um diretório norte-americano de dois lados, com um modelo de dados que está longe de ser trivial. E quase tudo o que explica como as peças encaixam, as regras, as ligações entre sistemas, a razão de cada decisão de arquitetura, vive em dois sítios: na minha cabeça e em ficheiros de configuração dispersos. Se eu desaparecesse amanhã, esse conhecimento ia comigo. Sou, à letra, o "engenheiro sénior cujo conhecimento está por capturar" de que a Google fala, exceto que a organização inteira sou eu.

O OKF dá-me uma pergunta concreta e desconfortável: e se esse saber fosse uma pasta versionada, legível por mim e por uma máquina, em vez de viver só onde vive hoje? Descrever as minhas próprias tabelas, métricas e ligações num bundle é exatamente o cenário para que o formato foi desenhado, só que à escala de quem trabalha sozinho, não de uma equipa de dados.

Não digo o nome do produto, de propósito. Num artigo como este o nome não acrescenta nada: o que convence é o detalhe do problema, não a marca. E isto vale para qualquer negócio, não só para o meu.

E não é preciso operar um diretório para ter este problema. Imagina um museu de arte no Porto. A equipa coordena-se por WhatsApp. As horas de abertura vivem num Word que alguém atualiza de vez em quando. Os termos de um empréstimo de uma obra estão num PDF de 2019, no email de alguém que já saiu. O inventário está num Excel, a política de visitas escolares noutro, e o site corre num painel que ninguém sabe bem quem administra. O conhecimento existe todo. Está é espalhado por meia dúzia de ferramentas que não se falam.

No dia em que esse museu quiser pôr um assistente no site, ou um ajudante interno para a equipa de sala, bate na parede: não há fonte de verdade onde o assistente se apoie. Inventa horários, cita mal os termos de um empréstimo, contradiz a política de grupos.

O que o OKF lhes daria não é tecnologia mágica. É uma disciplina com um formato: alguém senta-se e transforma aquilo tudo numa pasta legível, um ficheiro para a bilheteira, um para cada exposição, um para cada empréstimo, ligados entre si. E mesmo que nunca cheguem a montar o chatbot, o simples ato de construir essa pasta obriga-os à consolidação que nunca fizeram. Esse é o verdadeiro produto.

## A visão de longo prazo

Então vale a pena? Aqui é preciso separar duas coisas que toda a gente mistura.

O formato não é urgente. É uma versão 0.1, um alvo em movimento, e daqui a um ou dois anos isto não vai ter esta cara. Se hoje puseres o teu conhecimento em markdown numa pasta e amanhã o mundo convergir para json, ou para um esquema de base de dados, a migração é trivial. Ninguém que perceba do assunto te vai dizer que uma v0.1 é obrigatória.

Mas a prática por baixo é urgente, e nisso não há discórdia nenhuma. Ninguém que entenda o terreno duvida de que as organizações precisam de libertar, consolidar e organizar o seu conhecimento numa fonte de verdade única. O OKF é apenas uma tentativa precoce de padronizar a forma que isso pode ter. O museu do Porto precisava desse trabalho muito antes de a Google publicar seja o que for, e vai continuar a precisar quando o OKF for substituído por outra coisa qualquer.

É por isso que o mais interessante do OKF não é a profundidade técnica, que é propositadamente pouca. É ter dado nome a uma camada que faltava, e ter tornado visível um trabalho que a maioria das empresas anda a adiar. O formato é acessório. A disciplina é que conta.

E se calhar é isso que vale a pena guardar: o futuro do conhecimento de uma organização pode não ser um motor de busca mais esperto nem um wiki melhor. É a decisão, que já podias tomar hoje, de parar de deixar o teu saber espalhado por ferramentas que não se falam.