Skills para Agentes de Código

O Archyl oferece 11 skills para agentes de código que levam toda a sua arquitetura para dentro do seu agente — Claude Code, Codex, Cursor ou qualquer ferramenta compatível. Em vez de alternar entre o editor e o painel do Archyl, seu agente pode validar alterações antes de você programar, documentar o que foi entregue, revisar pull requests contra o seu modelo C4 e prever o desvio arquitetural — tudo pelo terminal.

As skills são open source e estão disponíveis em github.com/archyl-com/agent-skills.

O Fluxo de Arquitetura Nativo de IA

As 11 skills trabalham juntas para formar um ciclo contínuo de arquitetura:

preflight → code → review → CI (GitHub Actions) → postship → generate context
    ↑                                                              |
    └──────────────────────────────────────────────────────────────┘

Pré-requisitos

• Uma conta Archyl com acesso à API
• Uma chave de API (obtenha uma em Perfil > Chaves de API no painel do Archyl)
• Claude Code, Codex, Cursor ou um agente de código compatível

Instalação

Passo 1: Adicionar o Marketplace

Execute o seguinte comando no Claude Code:

/plugin marketplace add archyl-com/agent-skills

Em seguida, configure as atualizações automáticas:

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

Passo 2: Instalar o plugin

/plugin install archyl-developer@archyl-marketplace

O plugin archyl-developer instala as 11 skills e o hook do Guard. Reinicie seu agente de código após a instalação.

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, obtida no painel do Archyl.

Outros Agentes de Código

Os arquivos de skill são compatíveis com qualquer agente que suporte o formato de plugin. Você também pode usá-los diretamente a partir do repositório agent-skills no Cursor, no Codex ou em outras ferramentas.

Configuração Rápida

A forma mais rápida de começar é o script de configuração. Ele gera todos os arquivos de configuração de que seu agente precisa.

O Script de Configuração

Execute na raiz do seu projeto:

npx archyl-setup

Isso cria três arquivos:

Template: CLAUDE.md

O CLAUDE.md gerado inclui instruções como estas:

# Architecture

This project is documented in Archyl (project ID: `proj_xxx`).

## Before coding
Run `/archyl-preflight` to validate your approach against the architecture.

## After shipping
Run `/archyl-postship` to update the C4 model and create ADRs.

## Architecture rules
Always run `/archyl-review` before requesting a code review.

Você pode personalizar esses templates para refletir o fluxo de trabalho da sua equipe.

Skills Principais

archyl-developer

A skill fundamental. Ela dá ao seu agente um conhecimento estruturado das mais de 200 ferramentas MCP do Archyl nos seguintes domínios:

Exemplos de prompts:

Create a new system called PaymentPlatform with containers for
the API server, a PostgreSQL database, and a React frontend.

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.

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

archyl-preflight

Execute antes de começar a programar para validar a abordagem planejada contra a arquitetura existente. O preflight confronta seu plano com o modelo C4, as regras de conformidade e os ADRs recentes para detectar violações logo no início.

Exemplos de prompts:

/archyl-preflight I'm planning to add a new Redis cache between the
API server and the database to reduce read latency.

/archyl-preflight We want to split the UserService into separate
authentication and profile services.

A skill aponta problemas como violações de dependência, conflitos de nomenclatura ou abordagens que contradizem ADRs existentes — antes que você escreva uma única linha de código.

archyl-postship

Execute depois da entrega para atualizar automaticamente a documentação da sua arquitetura. Ela analisa o que mudou na base de código e:

• Atualiza o modelo C4 (novos contêineres, componentes, relacionamentos)
• Cria ADRs para decisões significativas
• Abre solicitações de mudança para revisão da equipe quando necessário

Exemplos de prompts:

/archyl-postship We just shipped the Redis caching layer.
Update the architecture to reflect the new cache container
and its relationships.

/archyl-postship Document the authentication service split
we shipped this sprint.

archyl-harness

O protocolo de sessão de trabalho para programar sob governança — a skill por trás do Archyl Harness. Ela ensina ao seu agente o ciclo completo: plan_work antes de começar, start_work_session para obter um contexto focado e reservas consultivas, remember/recall para o grafo de conhecimento do projeto e finish_work_session com um resultado que pode abrir uma solicitação de mudança de arquitetura.

Work under the harness: plan, declare a session, respect the
guardrails, and finish with an honest summary.

Skills de Revisão e Governança

archyl-review

Um bot estruturado de revisão de arquitetura. Ele analisa diffs contra o seu modelo C4, as regras de conformidade e os ADRs para produzir comentários de code review que levam a arquitetura em conta.

Exemplos de prompts:

/archyl-review Review the current branch against the architecture.
Flag any conformance violations or undocumented dependencies.

/archyl-review Check if PR #42 introduces any new cross-system
dependencies that aren't in the C4 model.

archyl-changelog

Gera um changelog de arquitetura — uma linha do tempo das mudanças, incluindo ADRs, releases, verificações de conformidade, eventos de desvio e atualizações do modelo.

Exemplos de prompts:

/archyl-changelog Show the architecture timeline for the last month.

/archyl-changelog What changed in the PaymentPlatform system
since the v2.0 release?

archyl-autofix

Quando um desvio é detectado entre o seu código e a documentação da arquitetura, o autofix propõe correções concretas — no código ou no modelo — para colocá-los de volta em sincronia.

Exemplos de prompts:

/archyl-autofix We have drift on the PaymentService container.
Propose fixes to resolve it.

/archyl-autofix Show all current drift issues and suggest
the fastest path to zero drift.

Skills de Inteligência

archyl-dora

Correlaciona mudanças de arquitetura com as métricas de desempenho de entrega DORA. Veja como as decisões arquiteturais afetam a frequência de deploy, o lead time, a taxa de falha de mudanças e o tempo médio de recuperação.

Exemplos de prompts:

/archyl-dora Show DORA metrics for the last quarter.
Did the microservice split improve deployment frequency?

/archyl-dora Correlate recent architecture changes
with our change failure rate trend.

archyl-roi

Calcula o impacto financeiro das decisões de arquitetura. Estima o tempo economizado, os incidentes evitados e as mudanças de produtividade dos desenvolvedores resultantes de melhorias arquiteturais.

Exemplos de prompts:

/archyl-roi What's the estimated ROI of our migration
from monolith to microservices?

/archyl-roi Calculate the cost of our current architectural
drift vs the cost of fixing it.

archyl-predict

Prevê problemas arquiteturais antes que aconteçam. Usa tendências históricas para prever desvios, regressões nas métricas DORA e pontos críticos de complexidade.

Exemplos de prompts:

/archyl-predict Which components are most likely to drift
in the next 30 days?

/archyl-predict Based on current trends, will our deployment
frequency regress this quarter? Which services are at risk?

Orquestração

archyl-orchestrate

Coordena vários agentes trabalhando na mesma base de código. Cuida da negociação de contratos de API entre serviços e da resolução de conflitos de dependência, e garante que os agentes não façam mudanças de arquitetura conflitantes.

Exemplos de prompts:

/archyl-orchestrate Two agents are modifying services that share
an API contract. Coordinate the changes to avoid conflicts.

/archyl-orchestrate Agent A is adding a new field to the
UserService API. Check if Agent B's PaymentService integration
will break.

Esta skill é especialmente útil em configurações multiagente, em que agentes diferentes são donos de serviços diferentes e precisam negociar contratos compartilhados sem atrapalhar uns aos outros.

Pacotes de Regras de Conformidade

O Archyl oferece pacotes de regras de conformidade prontos para padrões de arquitetura comuns — microsserviços, orientada a eventos, em camadas e outros. Esses pacotes de regras funcionam com todas as skills acima para aplicar sua arquitetura automaticamente.

Consulte o guia de Regras de Conformidade para detalhes sobre os pacotes de regras disponíveis e sobre como criar regras personalizadas.

SDKs

Se você quiser integrar o Archyl a ferramentas personalizadas além dos agentes de código, há SDKs disponíveis para TypeScript, Python e Go.

Consulte a documentação do Servidor MCP para detalhes sobre os SDKs e a referência da API.

Como Funciona

Cada skill fornece ao seu agente de código um conhecimento estruturado sobre ferramentas MCP específicas do Archyl — incluindo parâmetros, valores esperados e boas práticas. Quando você pede ao agente que execute uma tarefa de arquitetura, ele:

1. Identifica quais ferramentas MCP chamar com base no conhecimento da skill
2. Constrói os parâmetros corretos (IDs de projeto, tipos de elemento, tipos de relacionamento)
3. Encadeia várias chamadas para fluxos de trabalho complexos
4. Retorna um resumo do que foi criado, modificado ou sinalizado

O agente sempre começa chamando list_projects para descobrir os projetos disponíveis e obter o projectId necessário para as operações seguintes.

Referência do Modelo C4

As skills compreendem os 4 níveis do modelo C4:

Tipos de Relacionamento

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

Contribuindo

As skills são open source. Você pode contribuir:

• Corrigindo nomes de ferramentas, parâmetros ou descrições
• Adicionando cobertura para novas funcionalidades do Archyl
• Melhorando os exemplos de fluxos de trabalho
• Criando novos arquivos de skill para outros casos de uso

Consulte o guia de contribuição para mais detalhes.