Pular para o conteúdo
Pathrule

documentação

Quem é a referência para quê

Os perfis de membros da equipe dão a cada pessoa um retrato, baseado em evidências, das áreas em que ela trabalha, um escopo de decisão declarado que ela mesma escreve e um bloco curto da equipe compilado naquilo que todo agente lê primeiro, para que o assistente indique o colega certo em vez de decidir por ele.

Nesta página

Um assistente que conhece sua base de código ainda pode errar feio em uma coisa: decidir algo que não cabia a ele decidir. Ele renomeia um campo público, muda uma regra de preço, reestrutura um módulo, e faz isso sem fazer ideia de que alguém da equipe é a referência para aquela área e teria respondido em uma frase.

Os perfis de membros da equipe fecham essa lacuna. Cada pessoa da sua organização ganha um perfil que responde a uma única pergunta, quem é a referência para qual área, e uma versão curta dessa resposta é compilada naquilo que todo agente lê antes da primeira chamada de ferramenta.

Um perfil pertence à equipe, não a um repositório

O perfil tem escopo de organização e independe do espaço de trabalho. Quem é a referência em pagamentos continua sendo a referência em pagamentos, seja o trabalho no repositório da API, no app mobile ou em um serviço que nem existia no mês passado. Amarrar o perfil a um único espaço de trabalho significaria restabelecer o mesmo fato em cada repositório, e é assim que um diretório fica desatualizado.

Duas metades, e só uma delas é inferida

Um perfil tem uma metade derivada e uma metade declarada, e essa divisão é intencional.

Derivada: as áreas em que você realmente trabalha. O Pathrule já registra uma entrada curta para cada trabalho feito e já sabe quem escreveu qual memória e qual regra em qual caminho. Essas duas contagens, trabalho registrado em um caminho e conhecimento escrito naquele caminho, são a evidência. Nada mais é lido: nem o seu código, nem as suas mensagens de commit, nem quanto tempo algo levou. A janela é móvel, então uma área que você deixou para trás vai sumindo do seu perfil em vez de te acompanhar por anos.

Declarada: o seu escopo de decisão. Este é digitado pela pessoa e nunca derivado. Autoridade sobre uma decisão de produto não decorre de mexer em arquivos, e um sistema que a inferisse a partir de contagens de atividade estaria inventando essa autoridade. Quem mais mexeu no código de cobrança no mês passado pode ser justamente a última pessoa que deveria decidir uma regra de preço. Por isso o Pathrule pergunta em vez de adivinhar.

A mesma regra vale para o seu nome de exibição, seus pronomes e sua disponibilidade: suas próprias palavras, no seu próprio registro.

Você vê o seu próprio perfil e pode corrigi-lo

Você pode ler exatamente o que um agente recebe sobre você e sua equipe: o bloco da equipe é a seção Team no final dos arquivos de instruções que o Pathrule escreve para os seus clientes, como CLAUDE.md ou AGENTS.md.

Uma lista derivada não é a palavra final. Quando uma pessoa escreve a própria lista de áreas ou tags, a dela prevalece sobre a derivada, e é a existência dessa lista que marca a resposta como corrigida em vez de inferida, de modo que nada a sobrescreve silenciosamente na próxima derivação.

Quem garante esse limite é o banco de dados, não a interface. Uma pessoa pode escrever no próprio registro de perfil e no de mais ninguém.

O que o agente realmente recebe

Não a tabela de perfis. Um bloco curto, anexado aos arquivos de instruções que seus agentes leem primeiro, que em essência tem esta cara:

  • o nome da equipe e a pessoa a quem o arquivo pertence, com algumas das áreas dela
  • alguns colegas, cada um com a única área em que é a referência
  • os escopos de decisão declarados, mantidos em uma lista curta
  • uma instrução: chamar o usuário pelo nome e, quando uma decisão tocar a área de outra pessoa, indicar o responsável em vez de decidir por ele

Essa última linha é a razão de ser do recurso inteiro. Uma lista de nomes sem instrução é um dado que o agente passa direto. Por isso o espaço da instrução é reservado antes de qualquer outra medição, e se o bloco fosse acabar só com a instrução e ninguém para indicar, ele é descartado por completo em vez de ser enviado como ruído.

O que o bloco não pode dizer

O bloco aceita nomes, caminhos, tags e um escopo declarado. Não existe campo para afirmações sobre desempenho, velocidade, qualidade ou senioridade, e o texto livre tem tamanho limitado e é condensado em uma única linha. Isso é estrutural, não uma diretriz de revisão: um arquivo de instruções compilado não tem como ganhar aqui um parágrafo de opinião sobre um colega, porque não há por onde uma frase dessas passar.

Ele também é pequeno de propósito, um orçamento pequeno e fixo que inclui o título. Quando há mais a dizer do que o orçamento permite, linhas inteiras são descartadas a partir da ponta de menor valor, em vez de uma frase ser cortada ao meio, para que um bloco reduzido continue sendo algo sobre o qual o agente consegue agir. Um bloco, uma vez por arquivo, nunca um segundo.

Por que ele vai no arquivo compilado

O Pathrule tem dois jeitos de chegar a um agente: os arquivos de instruções compilados, lidos uma vez no início de uma sessão, e o hook por turno, que no Claude Code e no Codex chega ao modelo a cada prompt. O hook é o canal certo para o que muda de acordo com o pedido. Este bloco não muda de acordo com o pedido, então pagar por ele em cada prompt de uma sessão longa seria pagar muitas vezes por um único fato constante.

Ele fica bem no final do arquivo por um motivo relacionado. Um prefixo de instruções em cache é invalidado a partir do primeiro byte alterado, e a composição da equipe muda com muito mais frequência do que o conhecimento do seu espaço de trabalho. Manter o bloco volátil por último deixa tudo acima dele idêntico byte a byte quando alguém entra na equipe.

A visibilidade é definida por pessoa e, por padrão, o perfil fica visível para a sua equipe. Um perfil definido como privado é removido de toda leitura voltada à equipe, incluindo o bloco compilado, então nenhum agente da equipe fica sabendo em que essa pessoa é a referência. A escolha fica no mesmo registro que o perfil e o banco de dados a aplica a todas as consultas, então não existe nenhuma tela por onde um perfil privado vaze porque alguém esqueceu de filtrar.