Introdução

O Pathrule é a camada de inteligência para os seus agentes de programação.

Ele guarda o que um projeto, um desenvolvedor e uma equipe aprenderam, vincula esse conhecimento a caminhos no código e entrega o que cada tarefa precisa ao agente de programação que você já usa. Project Intelligence reúne como uma base de código funciona: as decisões, restrições, exigências de verificação, correções e procedimentos que um repositório acumula em torno do seu código. User Intelligence reúne como você prefere trabalhar, armazenado na sua máquina. Team Intelligence, no Pathrule Cloud, analisa as evidências da equipe e as transforma em padrões que só chegam aos agentes depois que uma pessoa os verifica.

O Pathrule não é um modelo de código, uma IDE nem um runtime de agentes. Claude Code, Codex, Cursor, GitHub Copilot, Windsurf e outros clientes compatíveis com MCP continuam sendo os motores de execução, cada um com seu próprio provedor de modelo. O Pathrule é o ponto de partida deles, e é por isso que trocar de agente não zera o que se sabe sobre o trabalho.

Para ver a arquitetura completa em um só lugar, leia a visão geral da arquitetura.

O que você escreve e o que o Pathrule faz com isso

São três tipos de conteúdo que a sua equipe escreve de forma intencional. Eles são entradas e formam a superfície de autoria: é o que uma pessoa edita e discute, não o que um agente recebe.

• Memória: uma nota curta em Markdown que registra uma decisão, uma pegadinha de schema, um postmortem ou uma convenção. Fica associada a um caminho do espaço de trabalho, de modo que só aparece quando o trabalho acontece ali perto.
• Regra: uma restrição que o assistente precisa seguir ao trabalhar em um escopo. As regras têm uma prioridade (alta, média, baixa) que define com que força elas aparecem. Uma regra acompanha o trabalho como contexto; uma regra cuja restrição executável foi aprovada por uma pessoa também pode bloquear uma edição correspondente nos clientes cujos hooks oferecem suporte a isso.
• Skill: um procedimento nomeado que o assistente pode invocar em vez de deduzir os passos de novo. É útil para tarefas recorrentes, como reenviar um webhook, regenerar uma fixture ou executar um checklist de release.

O que o Pathrule não faz: analisar ou enviar o seu código-fonte automaticamente. O que ele lê de um checkout é restrito e bem definido. Em um espaço de trabalho no Cloud, na primeira vez que um agente pede contexto aprofundado, o runtime local lê caminhos de arquivos do histórico recente do git para aprender quais arquivos mudam juntos, e nomes de arquivos perto do topo da árvore de pastas para reconhecer as tecnologias em uso. Os pares de caminhos de arquivos e algumas memórias curtas sobre tecnologias são salvos no espaço de trabalho, gravados sem pedir confirmação; conteúdos, diffs e mensagens de commit não são lidos para isso. No modo Cloud, o início de cada prompt é enviado para priorizar o conhecimento, e o pathrule snapshot, quando você ou o seu agente o executam, envia uma visão geral do projeto. O que o Pathrule calcula lista exatamente o que é lido e o que é guardado.

O que um agente recebe é mais enxuto do que esses documentos. Para uma determinada tarefa, o Pathrule seleciona as entradas que se aplicam ao caminho e à solicitação, define a prioridade delas e as encaixa dentro de um orçamento por prompt; o que não cabe é listado pelo título, para que o agente possa buscá-lo de forma deliberada. Uma regra chega como exigência e uma correção lembrada chega como conselho, em vez de virem como dois parágrafos com o mesmo peso. Agent IR descreve o conteúdo desse pacote entregue.

E o que ele deriva

Esses três tipos são o que a sua equipe escreve. Eles são a menor parte do que a camada guarda.

Em volta deles existe uma camada derivada que ninguém digita. Cada entrada também existe como uma representação calculada do seu significado, e é assim que um prompt em turco encontra uma memória em inglês que não tem nenhuma palavra em comum com ele. Cada entrega é medida: quais entradas foram enviadas, quais o assistente de fato consultou, quantas chamadas de ferramenta o turno levou e quantas falharam. Essas medições se acumulam e formam um retrato do que ajuda em cada tipo de trabalho, um grafo dos arquivos que a sua equipe altera juntos, um mapa de onde um assistente costuma travar e avaliações sobre quais entradas já foram superadas pelo código.

Tudo isso vem do que a sua equipe registrou e do que o próprio trabalho relatou sobre si mesmo, além de, em um espaço de trabalho no Cloud, caminhos de arquivos do histórico recente do git que indicam quais arquivos mudam juntos antes de a sua equipe ter registrado muito trabalho. Nada disso vem da leitura do conteúdo dos seus arquivos. Esse também é o motivo pelo qual os mesmos três arquivos guardados em um diretório não se comportam da mesma forma: um diretório não sabe o que foi entregue, o que ajudou nem quais arquivos mudam juntos. Veja o que o Pathrule calcula.

Uma inteligência, várias formas de acesso

O mesmo conhecimento pode ser acessado de todas as superfícies:

• CLI: instalação, configuração Cloud ou Local, conexão dos seus agentes de programação, leitura e criação de conhecimento pelo terminal, scripts e automação.
• Extensão do VS Code: navegue e edite o conhecimento ao lado dos seus arquivos, registre o MCP para o modo agente do GitHub Copilot e conecte outros clientes.
• Servidor MCP local: ferramentas do espaço de trabalho para todos os clientes compatíveis, instaladas com o CLI ou com a extensão do VS Code.
• Remote MCP: um endpoint MCP hospedado para clientes que se conectam via Streamable HTTP com a sua conta Pathrule.
• Pathrule Cloud: contas, organizações, espaços de trabalho, persistência e histórico gerenciados, Team Intelligence, Remote MCP e cobrança.
• Auto-hospedado para empresas: o Pathrule Cloud na sua própria conta Cloudflare, contratado por meio da equipe de vendas.

Ser independente de agente não significa que todos os agentes sejam alcançados da mesma forma. Claude Code e Codex recebem hooks que entregam contexto quando um prompt é enviado. Cursor e GitHub Copilot recebem hooks de sessão e de ferramenta. O Windsurf não tem hooks e funciona com um arquivo de regras mais MCP. A visão geral do MCP traz os detalhes de cada cliente.

Como é uma sessão na prática

1. A sua equipe escreve uma memória em um caminho do espaço de trabalho, por exemplo /apps/api/payments.
2. Você abre o Claude Code em ~/repos/main/apps/api/payments.
3. Quando você envia um prompt, o hook do Pathrule lê o recorte em cache para esse caminho e o entrega ao agente antes da primeira chamada de ferramenta.
4. O assistente vê a memória, as regras relevantes e as skills associadas a esse escopo, e se comporta como se já as conhecesse.

Não há prompt extra para escrever, nenhuma ida e volta extra ao MCP no meio da tarefa e nenhum arquivo global que cresce para sempre. Clientes sem um hook de prompt recebem o conhecimento pelos seus arquivos de instruções, por hooks de sessão e de ferramenta quando os têm, ou pelo MCP, conforme descrito no guia de cada um.

O que ler em seguida

• Visão geral da arquitetura apresenta o sistema inteiro em uma página e o vocabulário do qual o restante desta documentação depende.
• Início rápido mostra como instalar o CLI, conectar um espaço de trabalho, escrever sua primeira memória e ver o hook disparar.
• Conceitos principais explica a diferença entre memórias, regras e skills, além de como funcionam o escopo por caminho e a prioridade.
• Pathrule para VS Code aborda o trabalho com conhecimento no editor.
• Visão geral do MCP aborda as ferramentas MCP que o assistente usa para ler e escrever conteúdo.