Pular para o conteúdo
Pathrule

windsurf

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.

Windsurfexemplo
Adicione uma página de pedidos.

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

Só as regras do Windsurforientação nativa
  • 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.
Pathrule + Windsurfpara este caminho
  • 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.

Uma configuração.
Depois, ele lembra.