okf-gem · o grafo
Um grafo de conhecimento em markdown é o conhecimento do seu projeto guardado como um diretório de arquivos markdown simples. Cada arquivo é uma ideia. Os links que você já escreve entre eles são as conexões. Juntos, esses arquivos e links formam um grafo que você abre e explora, sem banco de dados para rodar e nada para declarar.
Cada conceito é um arquivo markdown com um pouco de YAML no topo. Um arquivo é um nó no grafo, então a imagem cresce junto com o seu conhecimento: adicione um arquivo, adicione um nó. Você lê e edita como markdown comum, e os seus agentes leem os mesmos arquivos do mesmo lugar.
Um link markdown simples de um arquivo para outro é uma aresta. Você não declara o grafo em lugar nenhum; ele emerge dos links que você escreve enquanto documenta. Linkar bem é tudo o que ele é, e a forma que você recebe de volta é um mapa honesto de como o seu projeto realmente se conecta.
O mesmo grafo vem de duas formas, e você escolhe a cada momento.
okf serverSuba o grafo localmente e navegue por ele: nós coloridos por tipo, backlinks, busca full-text, uma camada de índices que você liga. Ele lê os seus arquivos do disco, então uma edição aparece no próximo clique.
Como o graph server funcionaokf renderAsse o grafo inteiro em um único arquivo HTML autocontido e hospede em qualquer lugar que sirva arquivos estáticos: GitHub Pages, um object store, um link que você manda por e-mail. Sem servidor, sem instalação, um duplo-clique abre.
Como o okf render funcionaOs arquivos que os seus agentes leem para se manterem precisos viram uma página que o seu time inteiro navega e busca. Uma fonte, dois públicos, sem uma segunda cópia para manter em dia. Quando o raciocínio por trás de uma decisão vive no grafo, ele sobrevive a quem o escreveu, e a próxima sessão começa a partir dele em vez de adivinhar.