Gerencie seu modelo C4 pelo Claude Code e pelo terminal

No mes passado, eu vi um desenvolvedor da nossa equipe fazer algo que parecia impossível de funcionar.

Ele estava no meio de uma sessão de refatoração no Claude Code, dividindo um serviço monolítico em três menores. No meio do processo, ele digitou: "Crie três novos containers no Archyl — OrderService, InventoryService e NotificationService — dentro do sistema ECommerce. Adicione relacionamentos 'calls' entre o OrderService e os outros dois."

Dez segundos depois, o modelo C4 no Archyl tinha três novos containers, corretamente conectados com relacionamentos, posicionados exatamente onde deveriam estar na arquitetura. Ele nunca trocou de aba. Nunca abriu o navegador. Apenas continuou codificando.

Foi quando percebi que o plugin estava pronto para ser lançado.

O Problema da Troca de Contexto

A documentação de arquitetura tem um problema fundamental de UX: ela vive em um lugar diferente do código.

Você está na sua IDE. Acabou de reestruturar um modulo, renomear três serviços e dividir um banco de dados em replicas de leitura e escrita. O código está pronto. Agora você precisa atualizar a arquitetura. Isso significa abrir o Archyl no navegador, encontrar o projeto certo, navegar ate o diagrama correto, atualizar os containers, adicionar relacionamentos, talvez escrever um ADR para explicar por que você fez a mudança.

Leva cinco minutos. Mas esses cinco minutos têm um custo oculto: troca de contexto. Seu cérebro precisa sair do código, entrar em um modo de diagramação visual, lembrar o que acabou de fazer, traduzir isso em conceitos de arquitetura e depois voltar a codificar. A maioria dos desenvolvedores simplesmente... não faz. Eles dizem a si mesmos que vão atualizar a documentação depois. Depois nunca chega.

E por isso que o drift de arquitetura existe. Não porque as equipes não se importam com documentação, mas porque a ferramenta está no lugar errado na hora errada.

Arquitetura na Sua Conversa

O Archyl Developer Plugin coloca toda a sua arquitetura dentro do contexto do seu agente de codificação. E um plugin para o Claude Code (e compatível com Codex e outros agentes) que ensina o agente a usar todas as 181 ferramentas MCP do Archyl.

O que isso significa na pratica? Significa que você pode fazer o seguinte:

Durante uma refatoração, diga ao seu agente para atualizar a arquitetura:

Acabei de dividir o PaymentService em PaymentProcessor e PaymentGateway.
Atualize a arquitetura — remova o container antigo, crie os dois novos,
e mova todos os relacionamentos existentes para o novo container apropriado.

Durante uma revisão de código, pergunte sobre o contexto arquitetural:

Obtenha o modelo C4 completo e me diga quais componentes dependem do UserRepository.
Existem regras de conformidade que eu deveria conhecer antes de alterar a camada de dados?

Durante o planejamento de trabalho, verifique se a documentação ainda está precisa:

Qual e o drift score atual? Mostre quais elementos desviaram
e o que a IA acha que esta desatualizado.

Apos uma reunião de design, registre a decisão sem sair do terminal:

Crie um ADR: decidimos migrar de REST para gRPC em toda a comunicacao
interna entre servicos. Contexto: requisitos de latencia da equipe mobile.
Vincule ao ApiGateway e a todos os containers de servicos backend.

O agente cuida das chamadas MCP, gerencia os IDs dos projetos e encadeia as operações. Você só descreve o que quer em linguagem natural.

O Que o Plugin Cobre

O plugin da ao seu agente conhecimento estruturado em sete domínios:

Modelagem C4 — Crie e gerencie sistemas, containers, componentes, elementos de código e relacionamentos. O agente entende a hierarquia C4 e aplica convenções de nomenclatura adequadas (PascalCase para sistemas e containers, nomes exatos de símbolos para elementos de código).

Documentação — Escreva ADRs, crie documentos de projeto, defina fluxos de usuário e revise insights gerados por IA. Os ADRs são vinculados aos elementos C4 que afetam, para que as decisões arquiteturais permaneçam conectadas a arquitetura.

Governança — Crie regras de conformidade, execute verificações de compliance e monitore o drift de arquitetura. O agente pode configurar guardrails antes mesmo de uma sessão de codificação com IA começar.

Operações — Acompanhe releases entre ambientes, documente contratos de API (OpenAPI, gRPC, GraphQL), mapeie canais de eventos (Kafka, NATS, SQS) e gerencie o technology radar.

Colaboração — Adicione comentários, crie change requests (como PRs para arquitetura) e gerencie whiteboards. Discussões sobre arquitetura acontecem onde as discussões sobre código acontecem.

Histórico — Tire snapshots, viaje no tempo pelas versões da arquitetura e compare diferenças. Quando alguém perguntar "como era a arquitetura antes da migração?", o agente pode responder.

Integrações — Configure webhooks para notificações de mudanças na arquitetura, gerencie widgets do marketplace e visualize a arquitetura global de todos os projetos da organização.

Três Passos para Configurar

A configuração é simples:

1. Adicione o marketplace e instale o plugin:

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

2. Adicione o servidor MCP ao .mcp.json do seu projeto:

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

3. Reinicie seu agente e comece a conversar com sua arquitetura.

Pronto. O plugin carrega automaticamente e o agente sabe como usar todas as ferramentas. Sem arquivos de configuração, sem prompts customizados, sem integração manual.

Por Que Open Source

O plugin é totalmente open source em github.com/archyl-com/agent-skills. Existem algumas razoes para isso.

Primeiro, transparência. Quando um plugin ensina um agente de IA a interagir com sua arquitetura, você deveria poder ler cada instrução que ele da. A definição da skill, os arquivos de referencia, os exemplos de workflow — está tudo la, em markdown puro.

Segundo, contribuições. O Archyl tem 181 ferramentas MCP, e os melhores workflows surgem do uso real. Quando uma equipe descobre um padrão que funciona — digamos, um workflow para auditar a arquitetura antes de um grande release — ela pode contribuir de volta. O plugin melhora porque a comunidade o utiliza.

Terceiro, portabilidade. O conteúdo da skill não está preso ao Claude Code. Ele funciona com qualquer agente que suporte o formato de plugin. Os manifestos .claude-plugin e .codex-plugin estão ambos incluídos. Se um novo agente de codificação surgir no próximo mes com suporte a plugins, o conteúdo da skill se transfere diretamente.

O Que Muda

A mudança e sutil, mas significativa.

Antes do plugin, a documentação de arquitetura era uma atividade separada. Você escrevia código, depois documentava. Dois workflows, duas ferramentas, dois modos mentais. A documentação estava sempre um passo atrás porque estava sempre um passo distante.

Com o plugin, a documentação de arquitetura se torna parte da conversa de codificação. Você não "atualiza os docs" — você menciona o que mudou e o agente cuida do resto. A arquitetura se mantém sincronizada não porque alguém lembrou de atualiza-la, mas porque atualiza-la se tornou algo sem esforço.

Isso é especialmente poderoso em workflows agenticos. Quando um agente de IA está fazendo mudanças no seu codebase, ele pode simultaneamente atualizar a arquitetura. A mesma sessão que refatora o código também atualiza o modelo C4, registra o ADR e executa uma verificação de conformidade. A governança de arquitetura se torna uma parte natural do fluxo de desenvolvimento, não algo pensado depois.

Comece Agora

Instale o plugin, conecte seu servidor MCP e tente pedir ao seu agente para descrever sua arquitetura. Depois peca para ele fazer uma mudança. Na primeira vez que você atualizar um modelo C4 a partir de uma conversa no terminal, vai se perguntar por que alguma vez funcionou de outra forma.

O plugin está disponível agora. A documentação completa está nos nossos guias, e o codigo-fonte está no GitHub.

Sua arquitetura não deveria viver em uma aba diferente. Agora ela não precisa mais.