Visão geral da arquitetura

O Pathrule é a camada de inteligência entre você, o seu espaço de trabalho e os agentes de programação que você executa.

Cada parte dessa frase tem uma função específica, então vale analisá-la trecho por trecho. Entre você e os seus agentes, porque parte do que o Pathrule guarda é como você prefere trabalhar, e não fatos sobre o código. Entre o seu espaço de trabalho e os seus agentes, porque o restante é o que um repositório, e a equipe em torno dele, aprendeu sobre si mesmo. Uma camada, porque não fica dentro de nenhum agente: trocar o Claude Code pelo Codex muda quem executa, não o que se sabe.

O que o Pathrule não é: um modelo de programação, uma IDE ou um runtime de agentes. Ele não escreve o código da sua aplicação, e o seu agente de programação continua usando o próprio provedor de modelo.

A estrutura do sistema

        YOU                        YOUR TEAM
         |                             |
         v                             v
 USER INTELLIGENCE   WORKSPACE INTELLIGENCE   TEAM INTELLIGENCE
  (your machine)     (memories, rules,        (Pathrule Cloud,
                      skills, findings)        human-verified)
         \                   |                    /
          \                  v                   /
           +-------->  TASK-SCOPED DELIVERY  <--+
                             |
                             v
        Claude Code / Codex / Cursor / Copilot / Windsurf

Várias fontes de conhecimento convergem. Para um determinado trabalho, a parte relevante para aquele caminho e aquele prompt é selecionada, priorizada e entregue ao agente pelo mecanismo que o cliente dele suporta.

Base e clientes

O CLI, a extensão para VS Code e o servidor MCP local são as interfaces que você instala. Pathrule CLI, Pathrule para VS Code e Remote MCP descrevem cada uma delas.

O ciclo de vida

São seis etapas. Cada uma é algo que você consegue observar no produto, não apenas num diagrama.

Observar. O trabalho gera evidências: as memórias, regras e skills que pessoas e agentes escrevem, as descobertas que os agentes registram sobre o código, a atividade que os agentes registram e o que foi entregue a cada sessão.

Entender. O Intelligence Engine do Pathrule descobre o que essas evidências significam para o trabalho futuro. No Pathrule Cloud, o Team Intelligence analisa as evidências da equipe e as transforma em padrões sugeridos. Em um Mac com Apple Silicon, o modelo local opcional transforma o que você ensina sobre o seu jeito de trabalhar em uma preferência estruturada, fundamentada nas suas próprias palavras. Tudo o que é inferido continua sendo uma sugestão até que uma pessoa aprove.

Compilar. O conhecimento é renderizado nos arquivos que cada agente já lê, como CLAUDE.md ou AGENTS.md nos caminhos que eles regem, e em um índice local que os hooks leem. Veja compilação.

Entregar e aplicar. Para cada tarefa, o conhecimento que se aplica ao caminho e ao prompt é selecionado, priorizado e entregue dentro de um orçamento por prompt, e o que não couber é listado pelo título. Uma regra pode conter uma restrição executável; depois que uma pessoa a aprova, o hook pré-ferramenta pode bloquear uma edição correspondente nos clientes cujos hooks suportam isso. Um requisito apenas escrito não cria uma verificação bloqueante.

Verificar. O Pathrule registra o que entregou e quais entradas o agente leu em seguida, para que o efeito de um conhecimento possa ser medido em vez de presumido.

Aprender. O que os agentes de fato usaram orienta o que é trazido à tona na próxima vez. Conhecimento desatualizado pode ser sinalizado para atualização. No Cloud, os padrões da equipe passam de rascunho para sugerido e depois para verificado, ou então são rejeitados ou expiram, e apenas os verificados chegam aos agentes.

Palavras que não são sinônimos

O restante desta documentação depende de manter estes termos separados.

• Memória é o que foi registrado. Uma anotação sobre uma decisão, escrita em um determinado momento.
• Conhecimento é o que esse registro significa para o trabalho futuro, junto com as evidências que o sustentam.
• Inteligência é o sistema que decide qual conhecimento importa e quando.
• Contexto é a resposta para uma tarefa: o que importa, aqui, agora.
• Descoberta é uma conclusão que um agente registrou sobre o código. É um conselho, verificado contra o código a cada entrega, e nunca se torna uma regra por conta própria.
• Sugestão é algo que o Pathrule ou um agente inferiu e que uma pessoa ainda não aprovou. Não é considerada confiável.
• Conhecimento verificado é algo que uma pessoa aprovou.
• Regra é uma restrição que uma pessoa definiu para um escopo. Sua forma executável só é aplicada depois que uma pessoa a aprova.
• Entrega é o que de fato chega ao agente em uma tarefa. O Agent IR descreve isso.

Uma memória é uma entrada. O contexto é uma saída. Nenhum dos dois é o produto.

O que ler em seguida

• Workspace Intelligence: escopo, autoridade, fontes, ciclo de vida.
• User Intelligence: o que você ensina, o que você controla e por que os requisitos do projeto continuam prevalecendo.
• Aprendizado do projeto: descobertas que os agentes registram a partir do seu código, compartilhadas como conselho.
• O modelo local: o modelo opcional no dispositivo, sua plataforma e para que ele é usado.
• Knowledge IR: como o tipo e a autoridade de cada conhecimento são preservados na entrega.
• Compilação: o que o Pathrule escreve nos arquivos que os seus agentes leem.
• Proposed Knowledge: tudo o que aguarda uma pessoa antes de ser considerado confiável.
• Agent IR: o que um agente recebe em uma tarefa.
• Segurança e fallback: o que o Pathrule faz quando não tem certeza.

O limite do pacote aberto

O Pathrule CLI é de código aberto sob a licença Apache-2.0 e publicado no npm como @pathrule/cli. Os repositórios públicos em github.com/pathrule incluem o CLI, o core, os padrões e os benchmarks sob Apache-2.0, e o servidor MCP anterior sob MIT.

O Pathrule Cloud e o Intelligence Engine, que abrange extração, aprendizado, avaliação, seleção e priorização, além dos recursos assistidos por modelo, são proprietários. Esta documentação descreve o que eles fazem por você, não como são construídos.

Veja Núcleo de código aberto para mais detalhes.