Pular para o conteúdo
Pathrule

documentação

Como o conhecimento se acumula

O Pathrule é um ciclo, não um arquivo morto. O contexto é entregue antes do trabalho, o conhecimento é capturado durante ele em gravações que você pode ver e desfazer, o conhecimento inferido espera por uma pessoa e a priorização aprende o que ajuda.

Nesta página

É fácil enxergar o Pathrule como um lugar para arquivar memórias, regras e skills à mão. Essa é a menor parte dele. O que importa é um ciclo que roda sobre o trabalho real e melhora quanto mais a equipe o usa.

O ciclo tem três movimentos: entregar, capturar e pontuar. Eles se repetem a cada sessão.

Entregar antes do trabalho

Antes de o assistente começar a agir, a parte do conhecimento da sua equipe vinculada ao caminho já está no contexto. Você não precisa colar nada, e o assistente não precisa sair procurando. Trabalhar em /apps/api/payments traz o que está fixado ali, mais o que é herdado dos caminhos acima. No Claude Code e no Codex, um hook de prompt faz a entrega antes da primeira chamada de ferramenta; o Cursor e o GitHub Copilot recebem o conteúdo por hooks de sessão e de ferramenta, e o Windsurf pelo seu arquivo de regras e pelo MCP. Esse é o lado da entrega que a maioria das pessoas vê primeiro, e ele é explicado em Como os hooks funcionam.

Capturar durante o trabalho

O conhecimento não precisa ser escrito em um momento separado. A maior parte dele se acumula a partir do próprio trabalho.

Enquanto trabalha, o assistente fica atento ao que vale a pena guardar: uma decisão que você acabou de tomar, a correção de um problema em que ele vivia esbarrando, uma convenção que precisou ser explicada, uma pegadinha que fez perder tempo. Quando encontra algo assim, ele propõe salvar como memória, regra ou skill no caminho a que pertence e salva pelas ferramentas de gravação do Pathrule. Você também pode pedir que ele salve algo diretamente.

Duas propriedades importam aqui:

  • Você pode ver e desfazer toda gravação. Uma gravação feita por um assistente é marcada como feita por um assistente, versionada e reversível. O Pathrule não edita nem apaga seu conhecimento por conta própria: conhecimento desatualizado ou conflitante vira uma tarefa de atualização para você ou seu agente resolverem.
  • A manutenção fica perto de zero. Como a captura acompanha o trabalho normal, a base de conhecimento cresce sem a tarefa extra de escrever documentação. Você ainda pode criar conteúdo diretamente pelo CLI, pela extensão do VS Code ou por um cliente MCP sempre que quiser.

O que é gravado automaticamente e o que espera por uma pessoa

Algumas gravações acontecem sem etapa de confirmação, e elas estão listadas aqui para que nenhuma seja surpresa:

  • As gravações do próprio assistente. Normalmente o assistente propõe primeiro e salva quando você concorda. O Pathrule não acrescenta uma etapa de confirmação própria antes dessas gravações; em vez disso, torna cada uma visível e reversível.
  • O registro do trabalho. O que foi entregue, o que o assistente consultou e como foi o turno são registrados enquanto o trabalho acontece, porque alimentam a priorização. Veja o que o Pathrule calcula.
  • Uma semente única, em um espaço de trabalho no Cloud. Na primeira vez que um agente pede contexto aprofundado, o Pathrule salva os pares de caminhos de arquivos que leu no histórico recente do git, ponto de partida de arquivos que mudam juntos, e algumas memórias curtas sobre tecnologias na raiz do espaço de trabalho, reconhecidas pelos nomes dos arquivos. Conteúdo de arquivos, diffs e mensagens de commit não são lidos para isso.
  • Aprendizado do projeto. Uma descoberta a que um agente chegou lendo seu código é salva junto com os arquivos em que se baseia e compartilhada com todos os agentes do espaço de trabalho, sem etapa de revisão. Ela chega como orientação a ser verificada, nunca como regra, e só enquanto suas fontes continuam inalteradas naquele checkout; uma descoberta que se mostre errada pode ser retirada para todos de uma vez. Veja Aprendizado do projeto.

Todo o resto que foi inferido, e não escrito por uma pessoa, espera por uma:

  • A varredura do projeto que seu agente executa quando você pede para configurar o Pathrule em um projeto propõe memórias, regras e skills, e só as que você aprovar são gravadas.
  • O Team Intelligence, no Pathrule Cloud, transforma evidências da equipe em padrões sugeridos. Só as entradas verificadas por uma pessoa chegam aos agentes.
  • Correções de conhecimento desatualizado, conflitante ou duplicado não mudam nada até que uma tarefa de atualização seja resolvida, por você ou por um agente a quem você pedir isso.

Pontuar, para que o melhor apareça primeiro

A priorização decide quais candidatos relevantes aparecem para uma solicitação e em que ordem. No modo Cloud, o Pathrule também acompanha qual conhecimento realmente ajudou em trabalhos parecidos e usa isso para ordenar os resultados futuros, de modo que o mais valioso apareça primeiro. As sessões ficam focadas em vez de ruidosas, e uma entrada que um agente considere desatualizada pode ser sinalizada como tarefa de atualização para revisão. Veja Sugestões e autoauditoria para entender como isso funciona.

O aprendizado muda a ordem, não a elegibilidade. Uma entrada ainda precisa ser relevante para a solicitação atual. Uma memória que ajudou em várias migrações não pode entrar em um turno de design sem relação com elas só porque tem um bom histórico.

Como o ruído fica fora do prompt

O ciclo é seletivo de propósito. Por padrão, documentação genérica é oferecida para revisão em vez de importada como instrução ativa. Conhecimento inferido espera por uma pessoa, e toda gravação é visível e reversível. O vínculo com o caminho limita onde uma entrada pode aparecer, e a relevância para a solicitação continua valendo dentro desse escopo.

Depois disso, a entrega e o uso são medidos. Conhecimento que um agente considera desatualizado, contraditado pelo código ou duplicado é levado para revisão como tarefa de atualização. Os reparos são versionados e reversíveis, então a equipe pode melhorar o conjunto sem perder o histórico.

O resultado é um conjunto pequeno de decisões e pegadinhas específicas e revisáveis, não um despejo de documentação do repositório inteiro. Como o Pathrule comprova afirmações fortes documenta cada uma dessas barreiras.

Por que o ciclo é o produto

Um arquivo estático ou a memória nativa de uma única ferramenta conseguem fazer a entrega. O que se acumula é o ciclo: cada tarefa pode deixar a equipe um pouco mais inteligente, e a próxima sessão começa a partir disso.

Esse acúmulo não é abstrato. Cada volta do ciclo deixa algo que a próxima pode aproveitar: um registro medido do que foi entregue e de como foi o turno, evidências sobre o que ajuda em cada tipo de trabalho, uma relação entre dois arquivos que continuam mudando juntos, uma falha associada a um caminho. O que o Pathrule calcula lista cada uma dessas camadas e o que as alimenta. Entradas escritas, sozinhas, não se acumulam, porque nada nelas muda quando o trabalho dá certo ou dá errado.

Como o conhecimento fica fora de qualquer agente específico, ele é portável. As mesmas memórias, regras e skills chegam ao Claude Code, Codex, Cursor, GitHub Copilot e Windsurf pelo CLI ou pela extensão do VS Code, e a qualquer cliente MCP pelo MCP local ou pelo Remote MCP. Um recurso de memória nativo dentro de uma ferramenta não substitui isso, porque essa memória fica presa àquela ferramenta. O valor duradouro é o conhecimento acumulado da equipe, não uma regra ou um arquivo de prompt isolado.