O que é
Um vault Obsidian com toda a documentação operacional do meu homelab. Inventário de aplicações, configurações de DNS, status de infraestrutura, logs de operações, referências de credenciais.
Não é um wiki estático. Os agentes de IA consultam e atualizam esse vault como parte do fluxo de trabalho deles.
Por que Obsidian
Markdown puro. Sem banco de dados, sem vendor lock-in. Funciona offline, sincroniza via Git, e qualquer agente consegue ler e escrever sem adaptador especial.
Wikilinks conectam tudo. Uma nota de aplicação linka para o DNS, que linka para o servidor, que linka para o monitoramento. O agente navega essas conexões para entender contexto antes de agir.
O que os agentes fazem com o vault
Fez um deploy? O agente cria uma nota em operações/ com data, o que mudou e resultado. Nova aplicação no ar? Atualiza aplicações/ com URL, status e repositório. Antes de mexer em DNS, lê dns/ para entender o estado atual e evitar conflitos. Se o status de uma app muda, atualiza todas as notas que referenciam ela.
Estrutura
Organizado por domínio, não por tipo de documento:
aplicações/com repo, URL, status, stack de cada appdns/com registros por provedor e domínioinfraestrutura/com servidores, databases, serviçosmonitoramento/com dashboards, alertas, métricasoperações/com log de tudo que foi feito e quando
O que aprendi
Documentação que ninguém atualiza morre em semanas. Quando o agente atualiza automaticamente depois de cada operação, a documentação fica sempre fresca. O vault também funciona como memória de longo prazo. Os agentes não precisam lembrar o que fizeram ontem. Está tudo escrito.
Convenções que fazem funcionar: frontmatter YAML em toda nota, wikilinks para navegação, commit automático após cada alteração, push para GitLab como backup.