GuardianContext · Coordenação de agentes de IA

Várias IAs no mesmo repositório,
sem perder regras, contexto nem trabalho

A base de conhecimento fica no seu git. O GuardianContext indexa, audita e concilia, e cada agente lê só o que precisa.

MCP local e atualização segura

Versão publicada · 0.1.9 · 2026-10-02

Sessões de diferentes clientes podem descobrir pares e trocar mensagens no mesmo repositório. O desktop reúne configuração MCP, sessões, envio humano e estado da atualização.

O problema

Nasceu de incidentes reais

Trabalho de uma sessão some na outra

Claude Code, Codex, Cursor e Kimi comitando na mesma árvore. Um git add -A leva o arquivo alheio, um checkout -- apaga a edição de quem ainda não comitou. Foi assim que nasceu o produto: commits perdidos e horas de diagnóstico errado num repositório real.

Contexto que custa mais que o código

O quadro de trabalho do repositório de origem chegou a 245 KB, cerca de 66 mil tokens lidos em toda sessão (43% de uma janela de 200 mil) antes de abrir um arquivo de código.

Cada ferramenta lê só o próprio arquivo

Claude Code lê CLAUDE.md; Codex, Cursor e outros leem AGENTS.md. No repositório medido, regras de segurança e de contratos existiam para uma família de ferramentas e eram invisíveis para a outra.

Números medidos

Tokens que seus agentes deixam de gastar

Medido num monorepo real operado por quatro ferramentas de IA ao mesmo tempo, com cerca de 690 documentos markdown. Tarefas escritas como um agente perguntaria; gabarito tirado do próprio repositório.

19×
menos contexto lido em toda sessão
quadro de ~66 mil para ~3,5 mil tokens
12×
menos tokens por tarefa que sem base de conhecimento
57.976 → 4.699 tokens
7×
menos que só um grafo de código, em perguntas de processo e regra
33.248 → 4.699 tokens
Como o agente procuraTokens por tarefaAchou o arquivo certo
Sem base de conhecimento (grep e leitura)57.9762/12
Só um grafo de código33.2485/12
Wiki com router bem mantido4.88312/12
GuardianContext4.6997/12

Tokens estimados por caracteres ÷ 3,7, a mesma régua em todos os cenários; leitura limitada a 2.000 linhas por arquivo. Os cenários sem base e só com grafo simulam uma passada de busca, não o comportamento de um modelo. As tarefas são de processo e regra: um grafo de código é feito para perguntas de código, e as duas ferramentas se somam. Contra uma wiki já bem mantida, o ganho é pequeno; o valor aparece onde ela não existe ou envelhece. Reproduza no seu repositório comguardian benchmark.

Como funciona

Seis peças, um repositório

Protocolo no seu git

Router, wiki por tópico, decisões e quadro de trabalho em markdown, versionados com o código. Funciona offline, entra no diff do PR e não cria uma segunda fonte de verdade fora do repositório.

Busca local por trechos

Índice SQLite com busca textual e semântica multilíngue na sua máquina. O agente recebe só os trechos que respondem à pergunta.

Auditoria e hook de pre-commit

Mede a disciplina do repositório (quadro inchado, decisões sem status, claims vencidos) e recusa o git add -A numa árvore compartilhada, sem atrapalhar merge.

Conciliação entre ferramentas

Mostra, pasta por pasta, que regra cada ferramenta deixa de ver e concilia CLAUDE.md e AGENTS.md com um ponteiro entre marcadores, sem copiar conteúdo e sem mudar nenhuma ferramenta.

Biblioteca de padrões de incidentes

45 regras curadas a partir de incidentes reais de repositórios operados por várias IAs (git compartilhado, deploy, testes, regras de acesso ao banco de dados). Cada uma traz o caso e o comando para conferir.

Benchmark no seu repositório

guardian benchmark mede quantos tokens seus agentes gastam para achar cada resposta, com e sem o GuardianContext. Os números desta página saíram dele.

Integração

Revisão cruzada com a Claudex Loop

A Claudex Loop é uma skill aberta em que o Claude Code e o Codex se revezam: um modelo planeja e constrói, o de outra empresa revisa numa sessão nova, e quem escreveu nunca aprova o próprio código. É o cenário para o qual o GuardianContext foi feito.

As mesmas regras para quem constrói e quem revisa

O Claude Code lê CLAUDE.md e o Codex lê AGENTS.md. Sem conciliação, o revisor julga por um padrão diferente do que o construtor seguiu. O guardian instrucoes sync liga os dois arquivos.

Contexto pronto para a sessão sem memória

Cada revisão começa do zero. O guardian brief entrega, em algumas centenas de tokens, as regras da ferramenta, os trechos que respondem à tarefa e as decisões relacionadas, para colar no plano.

O log de revisão sob controle

PLAN.md e PLAN-REVIEW-LOG.md entram no índice local, e o auditor avisa quando o log de rodadas cresce além do orçamento, antes de virar custo fixo de toda sessão.

Antes de cada rodada
guardian instrucoes sync guardian brief "descrição da tarefa" --tool agents --saida .guardian/brief.md

Use --tool agents quando o Codex revisa e --tool claude quando o Claude Code revisa; cole o brief na seção de contexto do PLAN.md. A Claudex Loop é um projeto independente, de código aberto, sem relação comercial com a IronStack.

Planos

Comece grátis, cresça por repositório

Os planos variam pelo número de repositórios e de usuários que a conta cobre. O plano gratuito não tem prazo.

Free
Grátis
sem prazo
  • 1 repositório
  • 1 usuário
Starter
R$ 19,90/mês
≈ US$ 3,84
  • 3 repositórios
  • 1 usuário
Developer
R$ 49,90/mês
≈ US$ 9,63
  • 10 repositórios
  • 2 usuários
Professional
R$ 199,00/mês
≈ US$ 38,41
  • 25 repositórios
  • 5 usuários
Enterprise
R$ 999,00/mês
≈ US$ 192,82
  • 100 repositórios
  • 20 usuários

Cobrança em reais (BRL), inclusive com cartão internacional. Valores em dólar são referência pela PTAX de venda do Banco Central de 30/09/2026 (R$ 5,1809); a fatura do cartão pode variar com o câmbio e o IOF do emissor.

Instalar

Uma linha, sem falar com ninguém

Instala o CLI e abre o Desktop Manager, onde você cria a conta e conecta o repositório. Plano gratuito para um repositório, sem prazo. O conteúdo do repositório continua no seu git.

Windows · PowerShell
irm https://api.ironstack.dev.br/install.ps1 | iex
macOS · Linux
curl -fsSL https://api.ironstack.dev.br/install.sh | sh

Só terminal: uv tool install "guardiancontext[semantic]" e guardian signup. Termos de uso em api.ironstack.dev.br/termos.