Plugin para Agentes de Programacao

O Archyl Developer Plugin permite que voce gerencie todo o seu modelo de arquitetura C4 diretamente do seu agente de programacao — Claude Code, Codex ou qualquer ferramenta compativel. Em vez de alternar entre seu editor e o painel do Archyl, voce pode criar sistemas, containers, componentes, ADRs, regras de conformidade e muito mais sem sair do terminal.

O plugin e open source e esta disponivel em github.com/archyl-com/agent-skills.

O Que Voce Pode Fazer

O plugin da ao seu agente conhecimento profundo sobre as mais de 200 ferramentas MCP do Archyl nos seguintes dominios:

Pre-requisitos

• Uma conta Archyl com acesso a API
• Uma chave de API (obtenha uma em Configuracoes → Chaves de API no painel do Archyl)
• Claude Code, Codex ou um agente de programacao compativel

Instalacao

Passo 1: Adicionar o Marketplace

Execute o seguinte comando no Claude Code:

/plugin marketplace add archyl-com/agent-skills

Em seguida, abra o gerenciador de plugins para configurar atualizacoes automaticas:

1. Execute /plugin
2. Selecione Marketplaces
3. Escolha archyl-marketplace na lista
4. Selecione Enable auto-update ou Disable auto-update

Passo 2: Instalar o Plugin

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

Reinicie o Claude Code apos a instalacao.

Passo 3: Configurar o Servidor MCP

Adicione o servidor MCP do Archyl 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"
            }
        }
    }
}

Substitua arch_your_api_key_here pela sua chave de API real do painel do Archyl.

Outros Agentes de Programacao

O conteudo do plugin e compativel com qualquer agente que suporte o formato de plugin. Voce tambem pode usar os arquivos de skill diretamente do diretorio do plugin archyl-developer no repositorio.

Fluxos de Trabalho Comuns

Uma vez instalado, voce pode pedir ao seu agente de programacao para realizar tarefas de arquitetura em linguagem natural. Aqui estao alguns fluxos de trabalho comuns:

Documentar um Novo Projeto

Peca ao seu agente para estruturar seu modelo de arquitetura:

Create a new Archyl project for our e-commerce platform.
Add the main systems: WebApp, PaymentService, and PostgreSQL Database.
Then create containers for the API server and React frontend inside WebApp.

O agente chamara as ferramentas MCP apropriadas (create_project, create_system, create_container) e conectara tudo automaticamente.

Analisar a Arquitetura Existente

Get the full C4 model for my project and summarize the architecture.
Check the drift score — is the documentation still accurate?
Show me any open architecture insights.

Aplicar Regras de Arquitetura

Create a conformance rule that prevents any container from having
more than 10 direct dependencies. Then run a conformance check.

Registrar Decisoes de Arquitetura

Create an ADR titled "Migrate from REST to gRPC for internal services".
Set it as proposed, explain the context around latency requirements,
and link it to the ApiGateway and PaymentService containers.

Verificar Desempenho de Deploys

Show me the DORA metrics for the last month.
What's our deployment frequency and lead time trend?

Gerenciar o Technology Radar

Show me the current technology radar.
Add "Temporal" as an adopted workflow orchestration technology
and tag it on the OrderProcessing container.

Como Funciona

O plugin fornece ao seu agente de programacao conhecimento estruturado sobre cada ferramenta MCP do Archyl — incluindo parametros, valores esperados e boas praticas. Quando voce pede ao seu agente para realizar uma tarefa de arquitetura, ele:

1. Identifica quais ferramentas MCP chamar
2. Constroi os parametros corretos (IDs de projeto, tipos de elementos, tipos de relacionamento)
3. Encadeia multiplas chamadas para fluxos de trabalho complexos
4. Retorna um resumo do que foi criado ou modificado

O agente sempre comeca chamando list_projects para descobrir os projetos disponiveis e obter o projectId necessario para as operacoes subsequentes.

Referencia do Modelo C4

O plugin compreende todos os 4 niveis do modelo C4:

Convencoes de Nomenclatura

O agente segue estas regras de nomenclatura ao criar elementos:

• Systems: PascalCase, descritivo (PaymentPlatform, NotificationService)
• Containers: PascalCase com indicacao de tipo (ApiServer, PostgresDatabase, RedisCache)
• Components: PascalCase, orientado a modulos (AuthService, PaymentProcessor)
• Code Elements: Nomes exatos dos simbolos do codigo-fonte

Tipos de Relacionamento

Ao conectar elementos, o agente utiliza o tipo de relacionamento apropriado:

Contribuindo

O plugin e open source. Voce pode contribuir:

• Corrigindo nomes de ferramentas, parametros ou descricoes
• Adicionando cobertura para novas funcionalidades do Archyl
• Melhorando exemplos de fluxos de trabalho
• Adicionando arquivos de referencia para dominios faltantes

Consulte o guia de contribuicao para mais detalhes.