Como o nosso sistema de IA se encaixa

Indo mais fundo

Esta é a versão para quem está construindo algo parecido. O formato é o mesmo, com as peças em movimento nomeadas.

Uma pessoa, um hub

Uma pessoa define as metas e fica com as decisões que exigem julgamento, dinheiro ou gosto. O hub é uma sessão de IA de longa duração que lê a lista de trabalho em ordem de prioridade, decide o que importa em seguida e encaminha. Ele não faz o trabalho pesado. Seu papel é decidir, resumir o que volta e conversar com a pessoa em mensagens curtas.

Agentes de lane com seus próprios limites

Cada área de trabalho tem a sua própria definição de agente: uma para cada negócio, uma para as ferramentas que fazem tudo isso rodar, e algumas para tarefas específicas, como posicionar janelas ou controlar um navegador. Cada um lê primeiro o mesmo contrato curto, depois o seu próprio arquivo de lane, e mais nada. Um arquivo de lane diz o que ela cuida, o que ela nunca cuida e quais credenciais pode ler.

Somos diretos sobre o que isso é. Os limites são regras escritas mais hooks que pegam os cruzamentos mais comuns. Não é um sandbox, e todos os agentes ainda rodam como o mesmo usuário da máquina. Por isso os caminhos sensíveis também têm hooks que falham de forma fechada.

O lugar caro julga, os modelos mais baratos trabalham

Escolher o modelo é uma decisão de roteamento, não um padrão. O modelo de nível mais alto fica no lugar que conversa com a pessoa e toma as decisões de julgamento. Todo o resto é enviado a um modelo escolhido para aquela tarefa, e o envio diz qual modelo e por quê:

• Consultas, greps, verificações de status, formatação: o nível menor e mais barato.
• Rascunhos, código em área conhecida, leituras estruturadas: o nível intermediário.
• Uma subtarefa que exige raciocínio difícil (uma revisão de arquitetura, um diagnóstico complicado): o nível mais alto, como subagente.

O motivo é cota e custo, não preferência. Uma conversa longa reenvia todo o histórico a cada turno, então fazer leituras em massa no lugar caro queima o orçamento rápido. Um subagente devolve um resumo curto e o contexto dele desaparece. Parte disso é imposta por um hook que recusa os formatos errados mais comuns, como rodar uma consulta simples no nível mais alto. Parte é só uma regra que seguimos.

Gates e hooks

Regras que vivem só em um prompt são ignoradas sob pressão, então as importantes viram código. Exemplos: os testes precisam passar antes de um commit ser aceito, um hook bloqueia a leitura de segredos e de áreas onde um agente não tem o que fazer, tarefas em segundo plano nunca podem usar uma API paga com cobrança por uso, e qualquer mensagem endereçada a alguém de fora do sistema precisa antes da aprovação da pessoa para o texto exato. Um hook que dispara custa pouco. Uma regra que um agente esquece custa caro.

Memória e o vault

Duas camadas guardam o que aprendemos. A memória é uma pasta de notas pequenas que o agente carrega no início de uma sessão, com preferências e correções. O vault é um repositório git de markdown simples: decisões, referências, registros do que aconteceu. A divisão é simples. Se é um fato ou uma decisão, vai para o vault. Se faz alguma coisa, é código. Se é uma forma de olhar para o que o código já sabe, é uma visão. Um registro, um motor e quantas visões forem necessárias sobre eles. A Explicação 1 trata da memória em detalhe.

Tudo é uma tarefa

O trabalho começa em um ticket. Uma sessão abre dizendo em qual ticket está, as perguntas sobem para o hub uma de cada vez, e o resultado é registrado no ticket. Assim nada importante fica só em uma janela de chat que não existirá amanhã.

O que custa copiar isso

Você não precisa de tudo. A menor versão útil tem três partes: um hub que decide e delega, um arquivo de lane por área com linhas explícitas de "nunca cuida", e dois ou três hooks que bloqueiam os erros que você já cometeu uma vez.