Operações de Conhecimento

Gerencie um sistema de conhecimento em várias camadas para ingestão, organização, sincronização e recuperação de conhecimento em várias fontes.

Prefira o modelo de espaço de trabalho ativo:

• o trabalho de código vive nos repositórios clonados reais
• o contexto de execução ativo vive no GitHub, Linear e arquivos de contexto de trabalho locais do repositório
• notas mais amplas voltadas para humanos podem viver em uma pasta de contexto/arquivo fora do repositório
• a memória durável entre máquinas pertence à base de conhecimento, não a um espaço de trabalho de repositório sombra

Quando Ativar

• O usuário deseja salvar informações em sua base de conhecimento
• Ingestão de documentos, conversas ou dados em armazenamento estruturado
• Sincronização de conhecimento entre sistemas (arquivos locais, memória MCP, Supabase, repositórios Git)
• Deduplicação ou organização de conhecimento existente
• O usuário diz "salve isso na BK", "sincronize o conhecimento", "o que eu sei sobre X", "ingira isso", "atualize a base de conhecimento"
• Qualquer tarefa de gerenciamento de conhecimento além da simples recordação de memória

Arquitetura de Conhecimento

Camada 1: Verdade de execução ativa

• Fontes: Issues do GitHub, PRs, discussões, notas de lançamento, issues/projetos/documentos do Linear
• Use para: o estado operacional atual do trabalho
• Regra: se algo afeta um plano de engenharia ativo, roadmap, lançamento ou atualização, prefira colocá-lo aqui primeiro

Camada 2: Memória de Código Claude (Acesso Rápido)

• Caminho: ~/.claude/projects/*/memory/
• Formato: Arquivos Markdown com frontmatter
• Tipos: preferências do usuário, feedback, contexto do projeto, referência
• Use para: contexto de acesso rápido que persiste entre conversas
• Carregado automaticamente no início da sessão

Camada 3: Servidor de Memória MCP (Grafo de Conhecimento Estruturado)

• Acesso: Ferramentas de memória MCP (create_entities, create_relations, add_observations, search_nodes)
• Use para: Busca semântica em todas as memórias armazenadas, mapeamento de relacionamentos
• Persistência entre sessões com estrutura de grafo consultável

Camada 4: Repositório da base de conhecimento / Armazenamento durável de documentos

• Use para: notas duráveis curadas, exportações de sessão, pesquisas sintetizadas, memória do operador, documentos longos
• Regra: este é o armazenamento durável preferido para contexto entre máquinas quando o conteúdo não é código de propriedade do repositório

Camada 5: Armazenamento de Dados Externo (Supabase, PostgreSQL, etc.)

• Use para: Dados estruturados, armazenamento de documentos grandes, busca de texto completo
• Bom para: Documentos muito grandes para arquivos de memória, dados que precisam de consultas SQL

Camada 6: Pasta de contexto/arquivo local

• Use para: notas voltadas para humanos, planos de jogo arquivados, organização de mídia local, documentos temporários não relacionados a código
• Regra: gravável para armazenamento de informações, mas não um espaço de trabalho de código sombra
• Não use para: alterações de código ativas ou verdade do repositório que devem viver a montante

Fluxo de Trabalho de Ingestão

Quando novo conhecimento precisa ser capturado:

1. Classificar

Que tipo de conhecimento é?

• Decisão de negócios -> arquivo de memória (tipo de projeto) + memória MCP
• Estado ativo do roadmap / lançamento / implementação -> GitHub + Linear primeiro
• Preferência pessoal -> arquivo de memória (tipo usuário/feedback)
• Informações de referência -> arquivo de memória (tipo referência) + memória MCP
• Documento grande -> armazenamento de dados externo + resumo na memória
• Conversa/sessão -> repositório da base de conhecimento + resumo curto na memória

2. Deduplicar

Verifique se este conhecimento já existe:

• Pesquise arquivos de memória por entradas existentes
• Consulte a memória MCP com termos relevantes
• Verifique se a informação já existe no GitHub ou Linear antes de criar outra nota local
• Não crie duplicatas. Atualize as entradas existentes em vez disso.

3. Armazenar

Escreva na(s) camada(s) apropriada(s):

• Sempre atualize a memória de código Claude para acesso rápido
• Use a memória MCP para capacidade de busca semântica e mapeamento de relacionamentos
• Atualize o GitHub / Linear primeiro quando a informação alterar a verdade do projeto ativo
• Faça commit no repositório da base de conhecimento para adições duráveis de longo formato

4. Indexar

Atualize quaisquer índices ou arquivos de resumo relevantes.

Operações de Sincronização

Sincronização de Conversa

Sincronize periodicamente o histórico de conversas na base de conhecimento:

• Fontes: arquivos de sessão Claude, sessões Codex, outras sessões de agente
• Destino: repositório da base de conhecimento
• Gere um índice de sessão para navegação rápida
• Faça commit e push

Sincronização de Estado do Espaço de Trabalho

Espelhe a configuração e os scripts importantes do espaço de trabalho na base de conhecimento:

• Gere mapas de diretórios
• Redija configurações confidenciais antes de fazer commit
• Acompanhe as alterações ao longo do tempo
• Não trate a base de conhecimento ou a pasta de arquivo como o espaço de trabalho de código ativo

Sincronização GitHub / Linear

…