db.md

db.md é um padrão aberto (Apache-2.0, formato v0.4) que trata uma pasta de arquivos markdown como um banco de dados. Cada registro é um arquivo markdown com frontmatter YAML para campos estruturados e [[wiki-links]] para relacionamentos. Um único arquivo DB.md declara esquemas, políticas e instruções para o agente. Não há daemon, nem banco de dados vetorial, nem linguagem de consulta — a recuperação semântica é feita por um agente de IA ampliando sua busca em linguagem natural. O kit de ferramentas de referência é um binário Rust (dbmd) que oferece operações determinísticas: busca via ripgrep embutido, consulta/filtragem por frontmatter, escrita com caminhos fragmentados por data automáticos, validação contra esquemas declarados, grafo de backlinks e extração de texto de PDF, docx, xlsx, epub e html. Um pequeno harness integrado (ask/do/build) opera o armazenamento a partir de solicitações em inglês simples contra um modelo configurado pelo usuário — local via Ollama, LM Studio ou llama.cpp, ou API via Anthropic, OpenAI ou OpenRouter. O verbo também funciona como permissão: ask não tem ferramentas de escrita, do escreve através de verbos padrão com verificações de esquema e exclusões cientes de links, build adiciona edições de arquivos do workspace. A estrutura do armazenamento separa sources/ (evidências mantidas como recebidas — e-mails, PDFs, notas) de records/ (conteúdo criado pelo agente), com um campo meta-type distinguindo fatos atômicos, estado operacional e síntese. Índices derivados (index.md para navegação, index.jsonl para leituras estruturadas) não são autoritativos e são totalmente reconstruíveis a partir dos arquivos. O loop interativo é O(changed), não O(store), com desempenho medido na faixa de 10 mil arquivos em CI e um teste opcional de um milhão de arquivos com metas publicadas. As medidas de segurança incluem ausência de telemetria ou atualização automática, nenhum SDK de IA embutido, instaladores que dividem a autoridade entre bytes e digest, atestados assinados de proveniência de build verificáveis via gh attestation verify, publicação confiável via OIDC e dependências auditadas em CI com avisos do RustSec. Sincronização opcional está disponível através do protocolo link.md para um hub escolhido pelo usuário, com acesso permissionado, escritas baseadas em propostas para revisão e sem sobrescritas silenciosas. O repositório inclui cinco armazenamentos de exemplo completos (wiki de pesquisa, rastreador de operações, segundo cérebro, base de conhecimento de agência, CRM), uma crate de biblioteca (dbmd-core) para construir ferramentas personalizadas e um arquivo canônico Agent Skill para integração com harness. O formato e o kit de ferramentas são versionados independentemente, com uma política aditiva para que os armazenamentos existentes continuem validando através das atualizações de formato.