Architecture Intelligence para equipes AI-Native

Algo mudou nos últimos seis meses. Agentes de IA passaram de escrever funções para escrever serviços inteiros. Claude Code, Cursor, Codex — eles não são mais assistentes. São membros da equipe. Abrem PRs, revisam código, lançam features.

Mas eis o que me tira o sono: esses agentes não fazem ideia de como a arquitetura se parece.

Um agente consegue escrever um serviço Go perfeitamente limpo em dez minutos. Mas ele não sabe que a equipe decidiu três meses atrás rotear toda a comunicação entre serviços pelo Kafka. Não sabe que o serviço de pagamentos tem acesso direto ao banco de dados proibido. Não sabe que Python foi movido para "hold" no technology radar no trimestre passado.

O resultado? Drift arquitetural na velocidade da maquina.

Construímos o Archyl para resolver isso. E hoje, lançamos a maior atualização desde o lançamento: Architecture Intelligence — um ecossistema completo que transforma o Archyl no sistema nervoso do desenvolvimento AI-native.

O problema: agentes codificam rápido, mas codificam as cegas

Quando um desenvolvedor humano entra em uma equipe, ele passa dias lendo documentação, fazendo perguntas, construindo um modelo mental do sistema. Aprende as regras — escritas e não escritas. Entende os limites.

Agentes de IA pulam tudo isso. Recebem uma tarefa, escrevem código, abrem um PR. Se ninguém detecta a violação arquitetural na revisão, vai para produção. Multiplique isso por dez agentes trabalhando em dez serviços em três equipes, e sua arquitetura cuidadosamente projetada se corrói em semanas.

Já vimos isso acontecer. Uma equipe com um modelo C4 impecável em janeiro tinha um drift score de 40% em marco. Não porque pararam de se importar — mas porque seus agentes não sabiam que a arquitetura existia.

A solução: arquitetura como infraestrutura

Documentação de arquitetura não deveria ser algo que você mantém. Deveria ser algo que se mantém sozinho — e que cada agente consulta antes de escrever uma única linha de código.

Foi isso que construímos. Eis o que estamos lançando hoje.

10 Agent Skills

O skill original archyl-developer dava aos agentes acesso a 181 ferramentas MCP. Mas era uma caixa de ferramentas sem fluxo de trabalho. Hoje, adicionamos nove skills especializados que cobrem o ciclo completo de desenvolvimento:

Antes de codificar

archyl-preflight — Execute antes de implementar qualquer feature. Verifica sua abordagem planejada contra o modelo C4, as regras de conformidade, o technology radar e os contratos API. Você recebe um veredito claro PASS / WARN / FAIL antes de escrever uma única linha de código.

> Estou prestes a adicionar um cache Redis ao servico de usuarios. Tudo bem?

Verificacao Preflight: AVISO
- Redis esta aprovado no technology radar ✓
- O servico de usuarios existe no modelo C4 ✓
- ⚠ Nenhum container de cache documentado — sugerimos criar um
- ⚠ A regra "No Direct DB Access from Handlers" se aplica — garanta que o cache seja acessado pela camada de servico

Depois de implantar

archyl-postship — Execute depois de implantar. Analisa o que você acabou de construir, atualiza o modelo C4, cria ADRs para decisões arquiteturais e registra Change Requests para revisão do arquiteto. Sua documentação se atualiza sozinha como efeito colateral do trabalho.

Durante a revisão

archyl-review — Um bot de revisão de arquitetura. Verifica o diff do seu PR contra a arquitetura documentada e fornece feedback estruturado: violações de conformidade, cruzamento de limites, tecnologias não aprovadas, contratos API ausentes. Pense no ESLint, mas para arquitetura.

Para visibilidade

archyl-changelog — Gera uma linha do tempo legível de todas as mudanças arquiteturais: novos serviços, relacionamentos modificados, decisões ADR, evolução do drift. Perfeito para reuniões de revisão de arquitetura.

archyl-dora — Correlaciona métricas DORA com mudanças arquiteturais. Sua decomposição em microservicos melhorou o lead time? O pico de drift precedeu o aumento do change failure rate? Agora você tem os dados.

archyl-roi — Quantifica o impacto financeiro das decisões arquiteturais. "Nosso investimento em regras de conformidade economizou um estimado de $23.000 no ultimo trimestre ao reduzir retrabalho." Esse é o tipo de dado que faz orçamentos de arquitetura serem aprovados.

Para prevenção

archyl-predict — Prevê riscos arquiteturais antes que se materializem. "No ritmo atual, seu drift score cruzara 50% ate maio. O PaymentService tem 12 dependências de entrada — considere a decomposição."

archyl-autofix — Quando drift é detectado, propõe correções especificas. Seja atualizar a documentação para corresponder ao código, ou sugerir mudanças no código para se realinhar com a arquitetura. Cria Change Requests para revisão humana.

Para coordenação

archyl-orchestrate — Quando múltiplos agentes trabalham em diferentes serviços simultaneamente, este skill negocia contratos API, resolve conflitos de dependências e garante que mudanças entre equipes não quebrem a arquitetura.

6 GitHub Actions

Governança arquitetural pertence ao CI. Lançamos seis GitHub Actions que executam automaticamente em cada PR e merge:

A configuração recomendada é um único arquivo:

name: Architecture
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  pr-checks:
    if: github.event_name == 'pull_request'
    uses: archyl-com/actions/.github/workflows/archyl-pr.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
      drift-threshold: 70
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

  main-update:
    if: github.event_name == 'push'
    uses: archyl-com/actions/.github/workflows/archyl-main.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

Não está no GitHub? Também oferecemos templates para GitLab CI e Bitbucket Pipelines.

Packs de regras de conformidade

Configurar governança arquitetural do zero é tedioso. Então construímos cinco packs de regras pre-construidos que você pode instalar em segundos:

Instale pelo agent skill: "Instale o pack de regras de conformidade de microservicos." Pronto.

SDKs

Para equipes que constroem integrações personalizadas, publicamos SDKs oficiais:

npm install @archyl/sdk    # Node.js 18+, zero dependencies
pip install archyl-sdk     # Python 3.10+

const archyl = new ArchylClient({ apiKey: 'arch_...', organizationId: 'uuid' });
const drift = await archyl.governance.computeDrift(projectId);
const predictions = await archyl.projects.getPredictions(projectId);

Três novas APIs alimentadas por IA

Sob o capo, lançamos três novas capacidades no backend:

Predictive Analytics (GET /projects/:id/predict) — Analise estatística real. Regressão linear sobre drift scores, trajetórias de métricas DORA, taxas de decaimento de conformidade e detecção de hotspots de complexidade por analise de acoplamento fan-in/fan-out. Não intuições — matemática.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) — Envie um git diff, receba um delta estruturado do modelo C4. Analise alimentada por IA que detecta novos serviços, dependências alteradas e decisões arquiteturais. Sugere ADRs quando decisões significativas são detectadas.

ROI Computation (GET /projects/:id/roi) — Quantifica os retornos do investimento em arquitetura. Divide suas métricas DORA antes/depois, calcula ganhos de produtividade (horas economizadas x custo por hora), ganhos de confiabilidade (incidentes evitados x custo por incidente) e classifica seus ADRs por impacto financeiro.

Todas as três estão disponíveis como ferramentas MCP, então cada agent skill pode chama-las diretamente.

O ciclo completo

Veja como tudo se encaixa:

Agente recebe a tarefa
       │
       ▼
  archyl-preflight ──── valida a abordagem contra a arquitetura
       │
       ▼
  Agente escreve codigo
       │
       ▼
  archyl-review ──────── revisa o PR contra o modelo C4
       │
       ▼
  CI: conformance-check ─ bloqueia violacoes
  CI: drift-score ──────── aplica alinhamento
       │
       ▼
  Merge para main
       │
       ▼
  CI: auto-cr ──────────── registra Change Request
  CI: generate-context ─── atualiza archyl.txt
       │
       ▼
  archyl-postship ──────── atualiza modelo C4 + ADRs
       │
       ▼
  Proximo agente le archyl.txt ← o ciclo se repete

A arquitetura não é mantida. Ela se mantém sozinha.

Primeiros passos

1. Instale os skills:

/plugin marketplace add archyl-com/agent-skills
/plugin install archyl-preflight@archyl-com-agent-skills

2. Adicione as GitHub Actions: Copie o workflow acima em .github/workflows/architecture.yml.

3. Gere seu primeiro archyl.txt: Execute a action generate-context ou peca ao seu agente: "Gere o arquivo de contexto de arquitetura para este projeto."

4. Comece a codificar. Seu agente agora conhece a arquitetura.

O que vem a seguir

Esta é a base. Estamos trabalhando em dashboards frontend para predições e ROI, integração mais profunda com mais agentes de codificação e um marketplace comunitário para packs de regras de conformidade.

Documentação de arquitetura sempre foi aquilo que as equipes queriam fazer mas nunca encontravam tempo. Quando os agentes escrevem o código, a arquitetura se torna a única coisa que os humanos precisam gerir. O Archyl garante que eles não precisem fazer isso sozinhos.

Tudo o que lançamos hoje e open source. Adoraríamos receber seu feedback.