Grafo de Conhecimento
O grafo de conhecimento armazena relacionamentos estruturados entre entidades no seu projeto. Diferente de memórias planas, ele captura como as coisas se conectam — quais serviços dependem de quê, quem é dono de quais componentes e como decisões de arquitetura evoluem.
Conceitos fundamentais
Fatos (triplas)
Cada relacionamento é uma tripla sujeito - predicado - objeto.
Confiança
Cada fato tem uma pontuação de confiança (0-1). Fatos de alta confiança são verdades estabelecidas; pontuações mais baixas indicam suposições ou decisões iniciais que podem mudar.
Validade temporal
Fatos podem ser invalidados sem exclusão. A linha do tempo preserva o histórico — você pode ver o que era verdadeiro quando, não apenas o que é verdadeiro agora.
Exemplo de uso
Adicionando fatos
# Record architecture decisions as facts
kg_add
subject: "backend"
predicate: "uses"
object: "PostgreSQL"
confidence: 0.95
# Track ownership
kg_add
subject: "auth-module"
predicate: "owned-by"
object: "backend-team"
Consultando relacionamentos
# What does the backend use?
kg_query
entity: "backend"
direction: "outgoing"
> backend uses PostgreSQL (0.95)
> backend uses Express (0.90)
> backend deployed-on Docker (0.95)
Visualizando linha do tempo
# See how decisions evolved
kg_timeline
entity: "database"
> 2026-03-01 database considered MongoDB
> 2026-03-05 database decided PostgreSQL
> 2026-03-01 MongoDB consideration invalidated
Casos de uso
Mapeamento de arquitetura
Acompanhe quais serviços usam quais tecnologias, como componentes se conectam e o que depende de quê.
Histórico de decisões
Registre por que escolhas foram feitas e como elas evoluíram. Nunca rediscuta uma decisão já tomada.
Propriedade da equipe
Mapeie quem é dono de quais módulos, serviços e domínios. Útil para grandes bases de código.
Rastreamento de dependências
Entenda o impacto antes de fazer mudanças. Consulte o que depende de um componente antes de modificá-lo.
Endpoints da API
O grafo de conhecimento tem 5 ferramentas dedicadas e endpoints REST correspondentes. Veja a referência completa da API para detalhes de requisição/resposta. REST API →
kg_add— Adicionar um fato (sujeito - predicado - objeto)kg_query— Consultar relacionamentos de entidadeskg_invalidate— Marcar um fato como não mais verdadeirokg_timeline— Ver histórico de fatos para uma entidadekg_stats— Estatísticas do grafo (contagem de entidades, contagem de fatos)