O que é o Archgate, o problema que ele resolve e o ciclo de governança em alto nível — prevenção, detecção e aprendizado para engenharia assistida por IA.
O Archgate é uma camada de governança para desenvolvimento assistido por IA. Ele fica entre os seus agentes de codificação por IA e o seu código, garantindo que tudo o que for gerado siga as suas regras.
O problema
Seção intitulada “O problema”Agentes de codificação por IA são poderosos, mas não governados. Quando equipes adotam ferramentas como Claude Code, Cursor ou Copilot, elas enfrentam uma tensão:
- Os desenvolvedores querem velocidade — agentes de IA os desbloqueiam de tarefas repetitivas e de boilerplate.
- As organizações precisam de consistência — o código precisa seguir padrões arquiteturais, políticas de segurança, convenções de nomenclatura e padrões de domínio.
- Os agentes de IA não têm barreiras — sem restrições explícitas, eles produzem código que funciona, mas não está em conformidade. Cada arquivo gerado vira um fardo de revisão.
O resultado: as equipes ou desaceleram a adoção de IA (perdendo produtividade) ou aceitam código inconsistente (acumulando dívida). O Archgate existe para eliminar esse dilema.
A percepção: ADRs como governança executável
Seção intitulada “A percepção: ADRs como governança executável”Architecture Decision Records (ADRs) são uma prática bem estabelecida — as equipes documentam decisões como “usamos esta arquitetura em camadas” ou “rotas de API precisam ter schemas OpenAPI”. Tradicionalmente, esses são documentos passivos que os desenvolvedores leem às vezes e seguem na esperança.
O Archgate torna os ADRs ativos. Cada ADR tem duas expressões:
- Um documento legível por humanos — para que desenvolvedores e agentes de IA entendam a intenção, o contexto e a justificativa.
- Regras verificáveis por máquina — regras de lint, asserções sobre a estrutura de arquivos, verificações de fronteiras de import, validadores de configuração — que verificam a conformidade automaticamente.
Quando um agente de IA escreve código em um projeto governado pelo Archgate, duas coisas acontecem: o agente lê os documentos do ADR como contexto, moldando o que ele gera (prevenção), e as verificações automatizadas validam o resultado, detectando o que o agente deixou passar (detecção).
Isso é desenvolvimento de IA governado: correção por construção sempre que possível, correção por detecção em todos os demais casos.
O ciclo de governança
Seção intitulada “O ciclo de governança”O sistema funciona como um ciclo contínuo com três estágios.
Prevention
ADRs encode architectural decisions as executable rules that guide humans and AI agents before code is written.
Detection
Rules run in the editor, on pre-commit, and in CI — surfacing violations the moment they appear.
Learning
Lessons from reviews and incidents are codified back into ADRs, closing the loop and hardening the system.
- Prevenção — os ADRs são carregados como contexto do agente, então a IA escreve código em conformidade desde o início.
- Detecção —
archgate checkroda no editor, no pre-commit e no CI: validação rápida, gratuita e determinística. A skill@revieweradiciona julgamento de IA para os casos que um linter não consegue avaliar. - Aprendizado — a skill
@lessons-learnedtransforma violações e descobertas de revisão em novas regras de ADR, que retornam à prevenção.
O ciclo é uma catraca: cada erro vira uma regra permanente. Com o tempo, mais governança migra da revisão de IA, que é cara, para verificações automatizadas e gratuitas — os custos com tokens diminuem enquanto a conformidade aumenta.
Duas camadas de imposição
Seção intitulada “Duas camadas de imposição”O Archgate impõe a governança em duas camadas complementares:
| Camada | Mecanismo | Custo | Velocidade | Caso de uso |
|---|---|---|---|---|
| Verificações automáticas | Regras de lint, asserções de arquivo, análise de import | Gratuito | Milissegundos | A maior parte das regras de ADR |
| Revisão por IA | Plugin revisa o código contra os ADRs | Tokens | Segundos | Qualidade subjetiva, encaixe arquitetural |
O objetivo estratégico é maximizar a primeira camada ao longo do tempo, usando a revisão por IA apenas para o que as máquinas genuinamente não conseguem avaliar.
O que impulsiona o ciclo
Seção intitulada “O que impulsiona o ciclo”O ciclo descreve o que acontece; os plugins descrevem quem o impulsiona. Existem dois modos de imposição:
- CI / pre-commit (determinístico, sem IA) —
archgate check --stagedem hooks earchgate checkno CI bloqueiam código fora de conformidade. Este é o portão rígido. - Plugin de editor (desenvolvimento assistido por IA) — os plugins entregam skills (
@reviewer,@lessons-learned,@adr-author,@onboard,@cli-reference) e um agente desenvolvedor que orquestram o fluxo de trabalho completo. Ferramentas MCP conectam a ferramenta de IA à CLI.
Os comandos da CLI e as ferramentas MCP são capacidades passivas. O fluxo de trabalho — a ordenação, os portões, os papéis — vive no plugin. Sem um plugin, as ferramentas existem, mas nada diz à IA quando e como usá-las.
O que o Archgate é — e o que não é
Seção intitulada “O que o Archgate é — e o que não é”O Archgate é uma camada de governança que funciona com qualquer ferramenta de IA, qualquer stack, qualquer sistema de CI e qualquer tamanho de equipe. O formato de ADR é agnóstico a stack; os ADR packs fornecem regras específicas para cada stack.
O Archgate não é um framework (não dita o seu stack), não é um linter (ele orquestra o lint como um mecanismo entre vários) e não é uma ferramenta de codificação por IA (ele governa as ferramentas de codificação por IA que você já usa).