Blog em português
Textos sobre o Open Knowledge Format e o okf-gem: conhecimento do projeto como arquivos puros no git, com curadoria por agentes e checagem por ferramenta, 100% local.
🇺🇸 Posts in EnglishSeus bundles, servidos a qualquer agente: okf-mcp 1.0.0
Até agora seus bundles precisavam de um shell: a CLI, a skill, o grafo. O okf-mcp 1.0.0 os serve a qualquer host MCP, Claude Desktop incluído, com respostas do tamanho da pergunta, não do arquivo.
Seu time deveria adotar o OKF?
Você não está avaliando uma ferramenta, está decidindo se uma prática vira padrão para pessoas que não a escolheram. Aqui está a versão honesta: quanto o OKF custa, o que ele sobrevive, e a única coisa que ele não faz, nos termos que um líder de engenharia de fato pergunta.
Bundles que você agrupa, um grafo que você lê: okf 1.12.0
Um registry que só morava no seu diretório home não dava para compartilhar, e um grafo denso recebia todo leitor com um emaranhado. A okf 1.12.0 versiona o registry ao lado do seu código e abre o grafo na espinha dele, mais uma leitura nova que diz se um diretório é um assunto ou um depósito.
Seu agente está lendo quatro vezes mais do que precisa
Um teste na suíte do okf quebra o build se responder uma pergunta custar mais que um quarto de entregar o projeto inteiro. Não um benchmark rodado uma vez para este post, uma linha na CI verde desde a versão 1.5.0. Aqui está o que ela mede, quanto dá em tokens num projeto real, e a única coisa que um contexto mais enxuto não compra.
Encontre seu caminho em um bundle grande: okf 1.11.0
Todo verbo de leitura da okf sabia falar de conceitos. Nenhum sabia falar da árvore em que esses conceitos moram. A okf 1.11.0 transforma o diretório em algo sobre o qual você pergunta, que você corta e pelo qual você filtra, e impede um bundle servido de reconstruir o índice de busca a cada request.
Busque em todos os bundles de uma vez: okf 1.10.0
Seu conhecimento está espalhado entre um manual, um serviço, um repositório em que você esteve uma hora atrás. A okf 1.10.0 deixa uma única busca alcançar todos eles a partir da página que você já está lendo, ranqueada contra o corpus inteiro em vez de quatro listas coladas.
Uma busca que você troca: okf 1.9.0
A okf 1.9.0 deixa você escolher a engine de busca. A nova é de 44 a 56 vezes mais rápida por consulta e vem desligada por padrão, porque um processo que termina paga a construção do índice por exatamente uma pergunta.
Um ganho de 50x que você não consegue gastar
O benchmark disse 50x. O padrão não se mexeu. Uma invocação de CLI constrói um índice, faz uma pergunta e termina, então a vazão que ela comprou é vazão que ela nunca vive para gastar. O que mudaria isso não é um índice mais rápido, é um processo que continua vivo.
O mapa sempre esteve no bundle. Agora o grafo o desenha.
O índice de um bundle é o único arquivo que seu autor escreveu para ser lido primeiro. Na página do grafo ele só era alcançável achando uma aba e clicando numa linha. A okf 1.9.0 transforma o mapa autorado numa camada que você desenha sobre qualquer layout, e mostra quem o escreveu no formato do nó.
Seus bundles agora têm nome: okf 1.8.0
Um caminho diz onde um bundle está. Um nome diz o que ele é. A okf 1.8.0 traz um registry: nomeie um bundle uma vez e todo verbo, o servidor e a busca o alcançam de qualquer lugar, e a página do grafo agora viaja do celular ao desktop com uma paleta de comandos em todo modo.
Seus docs já são o bundle: /okf migrate
Adotar um formato de conhecimento normalmente significa reescrever o que você já escreveu, e é por isso que a adoção empaca. O /okf migrate adota o seu Markdown no lugar, cada corpo verbatim, e os links que você já escreveu viram o grafo no dia 0.
Hospede o grafo em qualquer lugar: okf render
O okf server desenha o seu bundle como um grafo ao vivo, mas um servidor é um processo que precisa de algum lugar para rodar. O okf render escreve essa mesma página como um único arquivo HTML estático com o bundle embutido, então o grafo é hospedado no GitHub Pages ou em qualquer lugar que sirva arquivos estáticos. Novo na 1.6.0, a um interruptor de distância do servidor.
Rode o okf em qualquer lugar: a imagem Docker
O okf é Ruby puro, mas o Ruby da máquina nem sempre é o que você escolhe. A imagem Docker oficial carrega a CLI inteira, então validate, lint, search e o grafo ao vivo rodam sem instalar nada. Multi-arch, construída a partir do código, no ghcr.io.
O que é o Open Knowledge Format?
OKF é um formato aberto e neutro para manter o conhecimento do projeto como Markdown + YAML, versionado com o código e legível por pessoas e agentes no mesmo arquivo. Como um bundle funciona e como começar o seu.
Por que criei o okf-gem
Padrões são o que permite escala. Como meu workflow com agentes evoluiu de frameworks de spec para um harness bem documentado, e por que isso virou um toolkit OKF completo: skill, CLI, objetos Ruby e um grafo montável. 100% local.