PathruleCompilação
Como o Pathrule compila o conhecimento de um espaço de trabalho nos arquivos de instrução que cada agente de programação já lê, nos caminhos que eles regem, quando isso acontece e por que os arquivos compilados trazem as palavras da sua própria equipe.
Nesta página
A compilação prepara o conhecimento do espaço de trabalho para os arquivos e hooks que cada agente de programação suporta. O resultado é uma visão do conhecimento, não um segundo lugar para escrevê-lo.
Hooks e arquivos de instrução
Com um hook do Pathrule instalado, o hook de início de sessão fornece o protocolo e o contexto da equipe. O arquivo de instrução principal mantém uma nota gerenciada curta, e o conhecimento de cada caminho chega pelos hooks de prompt e de ferramenta suportados. O Pathrule remove as cópias gerenciadas antigas do protocolo e os arquivos de conhecimento que essa forma de entrega substitui.
Sem um hook instalado, o Pathrule grava o protocolo completo e arquivos de conhecimento vinculados a caminhos no formato nativo do cliente. O Windsurf segue esse caminho porque não tem hook do Pathrule. As skills materializadas continuam disponíveis nos diretórios de skills que cada cliente lê.
| Cliente | Entrega preparada |
|---|---|
| Claude Code, Codex | Índice local para hooks, nota de instrução gerenciada curta e skills materializadas; arquivos de instrução mais completos quando não há hook instalado |
| Cursor, GitHub Copilot | Entrega por hooks de sessão e de ferramenta, nota gerenciada e skills materializadas; arquivos nativos vinculados a caminhos quando não há hook instalado |
| Windsurf | Arquivos de regras compilados e skills materializadas, com MCP para solicitações mais aprofundadas |
| Remote MCP | Nenhuma compilação ou arquivo local; o cliente solicita o conhecimento do Cloud por meio de ferramentas |
Os caminhos exatos estão listados nos guias de cada cliente.
Orientação de origem e orientação compilada
Uma entrada compilada aprovada só pode substituir um texto de origem mais longo enquanto o runtime conseguir confirmar que ela continua fundamentada na origem e no seu escopo. Se essa verificação falhar, o Pathrule entrega o texto de origem. As regras mantêm sua autoridade, as descobertas continuam sendo recomendações e leituras explícitas retornam o conteúdo escrito pelo autor.
Isso é diferente de pedir a um modelo que reescreva todo o espaço de trabalho em forma de resumo. O conhecimento continua inspecionável, e uma compilação incerta não se transforma em um novo requisito. Veja Knowledge IR e Segurança e fallback.
Quando ela é executada
pathrule setup prepara a integração quando um espaço de trabalho é conectado. pathrule sync atualiza os arquivos gerenciados e os índices locais a partir do conhecimento atual do espaço de trabalho e remove os arquivos gerenciados que deixaram de se aplicar.
Edite as entradas no Local Console, no VS Code ou via MCP; espaços de trabalho no Cloud também permitem escrever pelo CLI. O texto dentro de uma região gerenciada pelo Pathrule é regenerado, enquanto o texto fora dela continua sendo seu.
Entrega por tarefa
A compilação não tem como saber qual será o próximo prompt. Os hooks de prompt do Claude Code e do Codex selecionam o contexto da tarefa; os demais clientes usam os pontos de sessão e de ferramenta que suportam, os arquivos de instrução e o MCP. Uma chamada direta a pathrule_get_context solicita o caminho de conhecimento mais aprofundado.
Veja Agent IR para entender o que chega a uma tarefa e Como os hooks funcionam para a cobertura de cada cliente.