Sugestões e autoauditoria

O conhecimento da equipe envelhece. Caminhos são renomeados, marcos são entregues, versões fixadas de dependências ficam defasadas, uma regra deixa de corresponder a qualquer coisa. A resposta do Pathrule é a tarefa de atualização: uma sinalização em uma memória ou regra que parece desatualizada, com um motivo em linguagem simples, que o seu próprio assistente corrige sob o seu controle.

A propriedade mais importante: uma tarefa de atualização apenas sugere. O Pathrule nunca edita nem exclui suas memórias, regras ou skills por conta própria.

O que a autoauditoria verifica

A auditoria acontece onde a defasagem é percebida: no próprio trabalho. Um assistente que está lendo o seu código é o primeiro a ver que uma memória descreve um arquivo que mudou de lugar, ou que uma regra contradiz o que o código faz hoje. Quando isso acontece durante o trabalho normal, ele sinaliza a entrada com a ferramenta MCP pathrule_request_refresh, indicando a memória ou regra e por que ela parece errada. Motivos comuns:

• Defasagem. A entrada descreve um estado que não corresponde mais ao código, por exemplo, um arquivo citado mudou de lugar ou não existe mais.
• Contradiz o código. A entrada diz uma coisa e o código claramente faz outra.
• Duplicata. Outra memória ou regra já cobre o mesmo assunto de forma melhor.
• Específica demais. A entrada só se aplica a um caso que deixou de existir há muito tempo.
• Pouco clara. Não é possível entender o que a entrada pede.

A sinalização é idempotente: sinalizar a mesma entrada duas vezes retorna a mesma tarefa, então sessões repetidas não acumulam duplicatas. Os assistentes são orientados a sinalizar apenas defasagens que realmente perceberam, sem sair procurando por elas.

Nada do seu código-fonte é armazenado em uma tarefa de atualização. Ela identifica a entrada e traz o motivo; o assistente que fizer a correção depois lê o código atual com as próprias ferramentas de arquivo.

Revisando sugestões

Uma tarefa de atualização é um pedido de decisão, não uma ação. Em um espaço de trabalho do Pathrule Cloud, você pode trabalhar com elas pelo terminal:

pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied

list mostra as tarefas pendentes do espaço de trabalho atual, claim retorna o briefing completo de uma tarefa e a marca como em andamento, e resolve a encerra como applied ou rejected. Um assistente faz o mesmo via MCP com pathrule_list_pending_refreshes, pathrule_get_refresh_brief e pathrule_resolve_refresh.

Para cada tarefa, você pode deixar o seu assistente aplicar a correção (veja abaixo), editar a entrada você mesmo ou rejeitar a tarefa quando a entrada ainda estiver correta.

Correção pelo seu assistente

O Pathrule não corrige o seu conhecimento automaticamente. Peça ao seu assistente para resolver as tarefas de atualização pendentes. Ele então:

1. Lista as tarefas pendentes e assume uma, o que a marca como em andamento para que outra sessão não a pegue ao mesmo tempo.
2. Examina o código atual e a entrada sinalizada com as próprias ferramentas de acesso a arquivos.
3. Redige a atualização e a grava pelas ferramentas de escrita do Pathrule. Informar o id da tarefa junto com a atualização encerra a tarefa como aplicada.
4. Caso contrário, marca a tarefa explicitamente como aplicada ou rejeitada.

Você mantém o controle nas duas pontas: a correção é feita pelo seu próprio assistente, e a alteração é uma edição versionada comum que você pode revisar. Consulte a referência de ferramentas MCP para ver as ferramentas de atualização que o assistente usa.

Nada é irreversível

Uma correção é uma edição versionada normal. Toda alteração mantém o seu histórico e, em um espaço de trabalho do Pathrule Cloud, uma entrada excluída permanece no arquivo do espaço de trabalho até ser excluída permanentemente, e um proprietário ou administrador pode restaurá-la nas configurações do console web. No VS Code, uma exclusão oferece Undo na hora. Se uma correção se mostrar errada, você pode revertê-la como qualquer outra edição.