PathruleConhecimento compartilhado e conflitos
Como o Pathrule mantém o conhecimento da equipe sincronizado em um espaço de trabalho Cloud, detecta edições sobrepostas no momento de salvar e permite resolver um conflito sem perder trabalho.
Nesta página
O Pathrule é uma camada de conhecimento compartilhada, então em algum momento duas pessoas vão editar a mesma memória, regra ou skill ao mesmo tempo. As gravações no Cloud são compartilhadas, as sobreposições são verificadas quando você salva e você decide como resolvê-las.
Como ler o estado atual
Uma memória, regra ou skill gravada em um espaço de trabalho Cloud passa a fazer parte desse espaço de trabalho compartilhado. O backend atual do Cloud não oferece uma assinatura em tempo real que envie a edição de cada colega para uma visualização aberta.
Atualize a visualização de conhecimento ou faça uma nova solicitação de conhecimento para ler o estado atual. Os hooks locais e os arquivos de instruções usam o conhecimento do espaço de trabalho já preparado; execute pathrule sync para atualizar esses arquivos e índices. Não presuma que uma sessão já preparada recebeu a edição mais recente de um colega.
Um espaço de trabalho local fica em uma única máquina. Outras pessoas só recebem as alterações dele quando você copia o conhecimento para um espaço de trabalho Cloud compartilhado.
Detecção de sobreposição ao salvar
O Pathrule não bloqueia um item enquanto alguém está com ele aberto. O bloqueio travaria a equipe por causa de edições que nunca chegam a colidir. Em vez disso, cada gravação leva um token de versão (o mesmo token descrito em Como escrever memórias), e a sobreposição só é detectada quando duas gravações partem da mesma versão inicial.
| Situação | O que acontece |
|---|---|
| Você salva e a sua versão inicial ainda é a atual | A gravação acontece normalmente |
| Você salva, mas um colega salvou uma versão mais nova depois que você começou | Um conflito, resolvido com as opções abaixo. A sua versão só é salva depois que você escolher |
Como a verificação é feita item por item, colegas que editam memórias diferentes nunca bloqueiam uns aos outros.
Como resolver um conflito
No Pathrule para VS Code, uma memória, regra ou skill é uma aba de Markdown. Quando uma gravação gera um conflito, o VS Code avisa que o conteúdo foi alterado remotamente e que a sua versão não foi salva, e oferece três opções:
| Opção | O que faz |
|---|---|
| Reload | Carrega a versão atual e descarta as suas edições não salvas. |
| Copy My Version & Reload | Primeiro copia o seu texto para a área de transferência e depois carrega a versão atual, para você reaplicar o que pretendia. |
| Keep Mine (Overwrite) | Salva a sua versão por cima da atual. Isso descarta a alteração da outra pessoa, por isso é uma escolha explícita. |
Nada é sobrescrito até você escolher uma opção. Via MCP, um assistente pode informar a última versão que leu; se houver divergência, ele recebe de volta a versão atual, lê de novo e mescla a própria alteração em vez de sobrescrever.
Histórico de alterações
Toda alteração em uma memória, regra ou skill é versionada e registrada.
- Cada alteração guarda quem a fez, quando e se veio de uma pessoa ou de um cliente de IA.
- No VS Code, a ação Info mostra a versão do item, quem o criou, quem o editou por último e a origem.
O histórico serve para dar visibilidade. Ele mostra como um item chegou ao estado atual, que é a mesma pergunta que uma tarefa de atualização ajuda a responder quando o conhecimento começa a ficar desatualizado.
O que ler em seguida
- Como escrever memórias para entender como o token de versão funciona em um único item.
- Sugestões e autoauditoria para ver como o conhecimento desatualizado ou conflitante é sinalizado.
- Visão geral do MCP para saber como clientes de IA externos leem o contexto sincronizado.