PathruleA camada de contexto
para programação com IA.
Uma camada de contexto indexa por caminho as memórias, regras e skills de uma equipe e entrega só a parte que se aplica aos agentes que a equipe usa, antes da primeira chamada de ferramenta. Aqui estão as cinco formas como as equipes fazem isso, e como saber qual delas serve para você.
Sem camada de contexto
- O assistente abre o módulo de pedidos, lê o schema, segue os imports até preços e impostos e lê o handler de descontos para deduzir onde um cupom é aplicado.
- Ele escreve uma alteração plausível que aplica o desconto ao total do pedido. O diff compila. Está errado do jeito que a equipe já conhece.
- Um revisor percebe, explica de novo a convenção do item do pedido, e o ciclo se repete. O conhecimento continua na cabeça de uma pessoa.
- Muitos arquivos lidos, muitas chamadas de ferramenta, uma janela de entrada longa e um desvio que custa um ciclo de revisão.
Com camada de contexto
- O recorte correspondente ao caminho de pedidos chega no momento do hook, antes da primeira chamada de ferramenta. O modelo já sabe que cupons ficam no item do pedido.
- Ele aplica o desconto ao item do pedido na primeira tentativa, porque a regra estava no contexto antes de ele começar.
- Uma regra estrita pode bloquear uma alteração que coloca o desconto no lugar errado antes de ela acontecer, então a correção acontece antes da revisão, não depois.
- Uma janela de contexto curta e focada e uma alteração certeira, porque só as regras deste caminho foram injetadas.
Cinco formas de dar contexto a um agente.
- Arquivos de instruções
- escolha quando
- Uma pessoa, um repositório, poucas convenções
- o conhecimento chega
- Em todo turno, tudo
- sobrevive a uma troca de ferramenta
- Não, cada ferramenta lê o próprio arquivo
- onde falha
- Na segunda pessoa ou no segundo agente: cada ferramenta quer a própria cópia.
- API de memória
- escolha quando
- Você está construindo memória no seu próprio produto
- o conhecimento chega
- Quando algo a consulta
- sobrevive a uma troca de ferramenta
- Sim, se você controla o ponto de chamada
- onde falha
- Silenciosa por design. Uma restrição sobre a qual ninguém perguntou nunca chega.
- Busca vetorial
- escolha quando
- A resposta está escrita, em local desconhecido
- o conhecimento chega
- Quando algo a consulta
- sobrevive a uma troca de ferramenta
- Sim, mas é você quem mantém o índice
- onde falha
- Não consegue devolver uma decisão que não está em nenhum arquivo.
- Espaço de trabalho de agente
- escolha quando
- Agentes em paralelo são o gargalo
- o conhecimento chega
- Por sessão, não por caminho
- sobrevive a uma troca de ferramenta
- Não é essa a questão: ele é a ferramenta
- onde falha
- Um segundo checkout não decide qual conhecimento pertence a qual lugar.
- Camada vinculada a caminhos
- escolha quando
- Uma pessoa com vários agentes, ou uma equipe em um repositório
- o conhecimento chega
- Antes da primeira chamada de ferramenta, com o escopo do caminho
- sobrevive a uma troca de ferramenta
- Sim, o conhecimento vive fora de todas as ferramentas
- onde falha
- Exagero para uma pessoa usando um único agente.
Duas delas não são concorrentes. Uma API de memória dentro do seu produto e uma camada de contexto para seus agentes podem coexistir.
Quando você não precisa de uma.
Uma pessoa, um repositório, um agente e convenções que cabem em uma página: um CLAUDE.md versionado é a resposta certa, e uma camada de contexto é sobrecarga. O ponto de ruptura não é o tamanho do repositório, e também não é o tamanho da equipe. É o segundo agente ou a segunda pessoa, o que chegar primeiro. Um único desenvolvedor usando Claude Code e Codex no mesmo repositório já tem o problema: o que você ensina a um deles, o outro não sabe, e cada um lê um arquivo diferente.
O que uma camada de contexto carrega
- MemóriasO que a equipe aprendeuOs fatos do tipo “já tentamos isso, não funcionou” que desaparecem quando o engenheiro que os aprendeu segue em frente. Vinculados ao caminho onde se aplicam. Mais: memória persistente para agentes de programação com IA.
- RegrasO que fazer ou evitarRestrições consultivas e estritas. Os guardrails rígidos (nada de
console.logem/apps/web) e as preferências leves (prefira exports nomeados em/packages/ui). Mais: regras para agentes de programação com IA. - SkillsRoteiros de vários passosProcedimentos que a equipe já resolveu: como adicionar uma migração, como lançar uma feature flag, como rodar a revisão de segurança. Invocáveis pelo nome. Mais: skills para agentes de programação com IA.
- Indexado por caminhoO conhecimento fica perto do trabalhoToda memória, regra e skill é vinculada a um caminho. Uma regra para
/services/billingnunca dispara quando o modelo está trabalhando em/apps/mobile.
Arquivo único vs camada de contexto
- Os arquivos de instruções nativos podem ter escopo por caminho e ser compartilhados pelo controle de versão.
- O custo em tokens cresce linearmente com as regras da equipe.
- Um assistente por arquivo. A troca de ferramentas faz a equipe perder conhecimento.
- Editável por qualquer um com push. Sem revisão estruturada.
- Conhecimento passado adiante pela memória tribal.
- Um recorte vinculado ao caminho do diretório em que o modelo está trabalhando.
- O custo em tokens acompanha o recorte relevante, não o conjunto inteiro de regras.
- Uma camada, muitos assistentes. Trocar de ferramenta não zera a equipe.
- Grafo de conhecimento revisável, com acesso ao espaço de trabalho controlado no servidor e um detector de regras desatualizadas.
- Conhecimento escrito uma vez e entregue automaticamente na sessão do próximo colega.
Assistentes de programação com IA compatíveis
Claude CodeCLAUDE.md, hooks com hook de prompt, MCP
CodexAGENTS.md, hooks com hook de prompt, MCP
Cursor.cursor/rules, hooks de sessão e de ferramenta, MCP
GitHub CopilotArquivos de instruções, hooks de sessão e de ferramenta, MCP
WindsurfArquivo de regras e MCP, sem hooks- Qualquer cliente MCPMemória via MCP
Perguntas frequentes.
O que é uma camada de contexto para programação com IA?
A camada de roteamento entre o conhecimento tipado de uma equipe (memórias, regras e skills) e os assistentes de programação com IA que a equipe usa. Ela indexa esse conhecimento por caminho e entrega ao modelo só o recorte relevante, no momento do hook, antes da primeira chamada de ferramenta.
Qual a diferença entre uma camada de contexto e o CLAUDE.md ou o AGENTS.md?
O CLAUDE.md e o AGENTS.md são arquivos planos que enviam todas as instruções em todo turno. Uma camada de contexto fica um nível acima: ela armazena o conhecimento em um grafo indexado por caminho e encaminha ao modelo só a subárvore correspondente, então cada instrução que o modelo vê é essencial para o caminho atual.
Uma camada de contexto é uma ferramenta de programação com IA?
Não. Uma camada de contexto não gera código, não roda inferência nem substitui sua IDE. Ela é a camada entre sua equipe e o assistente de programação com IA que você escolher, deixando cada sessão mais inteligente sem prender a equipe a uma única ferramenta.
O que uma camada de contexto carrega?
Três tipos de conhecimento tipado da equipe: memórias (o que vocês aprenderam), regras (o que fazer ou evitar) e skills (roteiros de vários passos). Ela não carrega seu código-fonte nem um índice do seu repositório.
Como o Pathrule implementa a camada de contexto para programação com IA?
O Pathrule armazena o conhecimento da equipe em um grafo indexado por caminho, expõe um servidor MCP e alcança cada agente do jeito que ele permite: hooks, incluindo um hook de prompt, para o Claude Code e o Codex, hooks de sessão e de ferramenta para o Cursor e o GitHub Copilot, e um arquivo de regras para o Windsurf. Só o recorte que corresponde ao diretório de trabalho atual é entregue ao modelo.
Uma camada de contexto vê o código-fonte?
Ela não precisa ver. O Pathrule não envia automaticamente o código-fonte do seu repositório. No modo Cloud, o Pathrule Cloud armazena as memórias, regras e skills que a equipe escreve, o início de cada prompt é enviado para ranquear o que se aplica, e o pathrule snapshot, quando você ou seu agente o executam, envia a árvore de arquivos, os manifestos, pequenas amostras de documentação e metadados recentes do git. No modo local não há conta. O detalhamento completo está na página de Segurança.
Qual ferramenta de contexto eu devo escolher?
Depende do problema que você realmente tem. Uma pessoa usando um agente em um repositório é bem atendida por um CLAUDE.md versionado. Memória dentro do seu próprio produto pede uma API de memória. Conhecimento que está escrito mas é difícil de localizar pede busca vetorial. Agentes em paralelo em checkouts isolados pedem um espaço de trabalho de agente. Uma camada de contexto vinculada a caminhos é para o momento em que um segundo agente ou uma segunda pessoa entra em cena, o que, para a maioria, é o segundo agente. As cinco abordagens, e onde cada uma falha, estão descritas acima.
Qual é a diferença entre uma camada de contexto e uma API de memória?
O momento da entrega. Uma API de memória responde quando é consultada, então uma restrição sobre a qual o agente nunca pensou em perguntar nunca chega. Uma camada de contexto lê o caminho em que o agente vai trabalhar e entrega o conhecimento correspondente antes da primeira chamada de ferramenta, quer o agente fosse pedir ou não.
RAG vetorial é uma camada de contexto?
Não. A recuperação vetorial encontra texto que já está escrito, ranqueado por similaridade com uma consulta. Uma camada de contexto carrega decisões que não estão em nenhum arquivo, vinculadas ao caminho que regem, e pode aplicá-las: uma regra tem escopo, prioridade e nível de aplicação, enquanto um armazenamento devolve texto. Similaridade é um palpite sobre relevância; um caminho é um fato sobre ela. Em detalhe: RAG vetorial vs contexto vinculado a caminhos.
Preciso de uma camada de contexto se trabalho sozinho?
Trabalhar sozinho não é bem a questão. A questão é quantos agentes você usa. Uma pessoa com um agente e uma página de convenções é exatamente o caso em que um arquivo de instruções se sai bem. Uma pessoa usando Claude Code, Codex e Cursor no mesmo repositório já tem o problema que uma camada de contexto resolve: o que você ensina a um deles fica dentro dele, e cada um lê um arquivo diferente. É por isso que o Pathrule é gratuito para uso individual.