Pular para o conteúdo
Pathrule

documentação

Proposed Knowledge

Tudo o que o Pathrule ou um agente propõe e que nenhuma pessoa aprovou ainda. Como uma sugestão difere de uma descoberta, de conhecimento verificado e de uma regra, onde cada tipo de proposta fica aguardando e o que a aprovação muda para os seus agentes.

Nesta página

Proposed Knowledge é tudo o que fica aguardando uma pessoa antes que seus agentes possam confiar nele.

O Pathrule e seus agentes percebem coisas o tempo todo: uma convenção que a equipe continua seguindo, uma correção que continua funcionando, uma restrição que um parágrafo parece sugerir. Perceber algo é uma inferência, e uma inferência só vira conhecimento quando alguém responde por ela. O que é aprendido nunca é confiável automaticamente.

Cinco palavras que não são sinônimos

A diferença entre elas é o design inteiro.

O que éChega aos agentes?
DescobertaUma conclusão que um agente registrou a partir do seu código, com os arquivos em que ela se apoiaSim, como orientação a ser verificada, apenas enquanto suas fontes não mudarem
SugestãoAlgo que o Pathrule ou um agente inferiu e que ninguém aprovouNão
Conhecimento verificadoAlgo que uma pessoa aprovouSim
RegraUma restrição que uma pessoa definiu para um escopo; sua forma executável só é aplicada depois que uma pessoa a aprovaSim, como requisito
EntregaO que de fato chega ao agente para uma tarefaÉ o que chega até eles

De onde vêm as propostas e onde elas aguardam

Seu agente, configurando um projeto

Peça ao seu agente "Set up Pathrule for this project" e ele faz uma análise guiada: lê o projeto, propõe memórias, regras e skills e grava apenas as que você aprovar na conversa. Nada do que ele propõe é salvo até você autorizar.

Fora dessa análise, um agente que descobre algo que vale a pena guardar normalmente propõe isso a você antes de gravar. Quando ele grava, a gravação tem autoria registrada, é versionada e pode ser revertida.

Uma restrição anexada a uma regra

Uma regra pode carregar uma restrição executável: um padrão que uma alteração não pode conter e o que fazer no lugar. Quando um agente anexa uma restrição por meio de pathrule_write_rule ou pathrule_update_rule, ela é armazenada como proposta. Ela não é aplicada, e nenhum agente pode aprová-la. Só depois que uma pessoa a aprova o hook pré-ferramenta pode bloquear uma edição correspondente, nos clientes cujos hooks oferecem esse suporte. Veja regras como guardrails.

Team Intelligence, no Pathrule Cloud

A Team Intelligence analisa as evidências que o trabalho de uma equipe produz e propõe padrões. Um padrão passa de rascunho a sugerido, e um proprietário ou administrador da organização o verifica ou rejeita no console web, nas configurações de Team guidance da organização; uma sugestão em que ninguém age expira. Só os padrões verificados chegam aos agentes. Ela está disponível nos planos Team e Enterprise.

Suas preferências pessoais

Uma preferência que você ensina com pathrule me teach é conferida contra as suas próprias palavras antes de ser armazenada. Uma preferência que ainda não está em uso aparece em pathrule me list em "Not in use yet" e nunca chega a um agente. pathrule me explain <id> mostra em que ela se apoia, e pathrule me forget <id> a rejeita. Veja User Intelligence.

Conhecimento desatualizado

Quando um conhecimento parece desatualizado, ele pode ser sinalizado como uma tarefa de atualização, por exemplo por um agente que percebeu a divergência e chamou pathrule_request_refresh. Uma tarefa de atualização é uma proposta de mudança em um conhecimento existente, e uma pessoa ou um agente a trata com pathrule refresh ou com as ferramentas de atualização do MCP. Veja sugestões e autoauditoria.

A exceção: descobertas

As descobertas são o único tipo de conhecimento aprendido que chega aos agentes sem etapa de revisão, e isso é deliberado. Uma descoberta é orientação, não política:

  • ela só é salva depois que seus arquivos de origem são conferidos em disco,
  • ela só é entregue enquanto esses arquivos estiverem inalterados no checkout de quem a lê,
  • ela é retida quando suas fontes mudam ou quando contradiz outra descoberta,
  • e ela nunca vira, por conta própria, uma memória, uma regra ou uma skill.

Tudo o que precisa valer para todos os agentes continua sendo papel de uma regra ou de uma memória, escrita e revisada pela sua equipe.

O que a aprovação muda

A aprovação é o que transforma uma sugestão em conhecimento verificado.

  • Uma proposta aprovada da análise vira uma memória, regra ou skill comum, entregue como qualquer outra.
  • Um padrão de equipe verificado começa a chegar aos agentes nos espaços de trabalho daquela organização.
  • Uma restrição de regra aprovada passa a poder ser aplicada pelo hook pré-ferramenta nos clientes que oferecem suporte.
  • Uma proposta rejeitada continua rejeitada, então as mesmas evidências não a trazem de volta logo em seguida.

O que ele nunca faz

  • Nunca aprova nada em seu nome, e nada que precise de aprovação chega a um agente antes que uma pessoa a dê.
  • Nunca deixa um agente aprovar a própria proposta.
  • Nunca transforma uma descoberta em regra.
  • Nunca edita o que sua equipe escreveu sem que uma pessoa ou um agente esteja agindo a partir de uma proposta.

Para saber o que acontece depois que um conhecimento é aprovado, veja Agent IR e segurança e fallback.