O Windsurf age.
O Pathrule lembra.
Regras compartilhadas e contexto de equipe para o Windsurf, por um arquivo de regras que ele lê no início da sessão e por ferramentas MCP que ele pode chamar para obter mais. O Windsurf não tem hooks, então ali uma regra estrita chega como orientação.
Sem
Pronto. A página busca /api/orders em um useEffect.
Usa fetch onde a equipe usa o cliente da API.2 tentativas
Com o Pathrule
arquivo de regras, lido no início da sessão: 3 notas para features/orders
- Use o cliente da API, não fetch
- React Query para dados
- Botões compartilhados de ui/
Pronto. Os pedidos carregam pelo cliente da API com React Query.
Segue o que a equipe já decidiu.1 tentativa
Como o Pathrule chega ao Windsurf.
- arquivos que lê: simarquivos que lê
- .windsurf/rules
- antes de cada prompt: nãoantes de cada prompt
- Sem hook de prompt
- em torno das chamadas de ferramenta: nãoem torno das chamadas de ferramenta
- Sem hooks
- quando pede: simquando pede
- Local
Sem hooks: o Pathrule compila um arquivo de regras que o Windsurf lê, e o agente alcança o resto via MCP.
Regras do Windsurf vs Pathrule
- Memórias do Cascade, regras com escopo e AGENTS.md
- As alterações seguem as permissões do repositório e o histórico de Git ou de pull requests.
- O contexto depende dos arquivos e das orientações que o cliente carrega.
- Preso ao Windsurf; outras ferramentas precisam dos próprios arquivos.
- O onboarding segue a configuração de instruções do repositório.
- Conhecimento compartilhado do espaço de trabalho por um arquivo de regras e MCP
- Regras e skills revisáveis, com acesso ao espaço de trabalho controlado no servidor e uma autoauditoria.
- O custo em tokens acompanha o recorte relevante, não o conjunto inteiro de regras.
- O mesmo conteúdo chega a Claude Code, Codex, Cursor e GitHub Copilot.
- Onboarding = “entre no espaço de trabalho; as regras certas aparecem nos caminhos certos”.
Leitura longa: Por que assistentes de programação com IA precisam de regras com escopo.
O que o Pathrule acrescenta ao Windsurf
- Contexto geradoNo início da sessãoO Pathrule grava um arquivo de regras que o Windsurf lê quando uma sessão começa. O MCP fornece leituras mais profundas sob demanda.
- Grafo vinculado a caminhosRegras onde se aplicamO conhecimento é vinculado a caminhos, e as ferramentas MCP devolvem o que se aplica ao diretório sobre o qual o Windsurf pergunta. O arquivo de regras deixa de ser um depósito de tudo.
- Conhecimento de equipe revisávelMemórias, regras, skillsTrês tipos de conhecimento, revisáveis no Local Console e no VS Code, com autoria compartilhada no Cloud pela CLI e por MCP. Regras desatualizadas aparecem para limpeza, e edições simultâneas geram um conflito claro em vez de uma sobrescrever a outra.
- O mesmo conteúdo em todos os agentesUma fonte para todos os agentesClaude Code, Codex, Cursor e GitHub Copilot recebem o mesmo conhecimento vinculado a caminhos, então a escolha do editor não fragmenta o que a equipe sabe.
Perguntas frequentes.
O que o Pathrule acrescenta ao Windsurf?
Uma camada de conhecimento vinculada a caminhos para o Windsurf: um arquivo de regras que ele lê quando uma sessão começa e ferramentas MCP que ele pode chamar para obter as memórias, regras e skills que se aplicam ao diretório em que está trabalhando. O Windsurf não tem hooks do Pathrule, então o conhecimento não é injetado no meio da sessão, e as regras são orientação, e não bloqueio.
O Pathrule substitui minhas regras do Windsurf?
Não. O Pathrule é uma camada acima do arquivo de regras do Windsurf. Mantenha o arquivo de regras para as constantes do repositório inteiro; o Pathrule carrega o conhecimento que é específico de um caminho, que precisa sobreviver à pessoa que o aprendeu ou que trata de como você prefere que o trabalho seja feito, e o Windsurf lê a parte que se aplica ao lugar onde está trabalhando.
Minha equipe inteira pode compartilhar as regras do Windsurf pelo Pathrule?
Sim. Em um espaço de trabalho do Pathrule Cloud, regras e skills são compartilhadas em um grafo indexado por caminho, com acesso ao espaço de trabalho controlado no servidor, e o Windsurf de cada colega pode lê-las, assim como Claude Code, Codex, Cursor e GitHub Copilot.
Como o Pathrule é instalado no Windsurf?
Rode npm i -g @pathrule/cli, depois pathrule setup no seu projeto, e escolha o Windsurf (adicione --local para rodar sem conta). O setup grava .windsurf/rules/pathrule-protocol.md e uma entrada MCP local. Não há hook para o Windsurf. Remover o arquivo de regras e a entrada MCP remove o Pathrule.
O Pathrule vê meu código-fonte?
Não. O Pathrule não envia automaticamente o código-fonte do seu repositório. No modo local não há conta, e o conhecimento fica na sua máquina. No modo Cloud, o Pathrule Cloud armazena as memórias, regras e skills que sua 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. O detalhamento completo está na página de Segurança.