Plugin para Agentes de Codificacion - Archyl Docs

Instala y usa el plugin de agente de codificacion de Archyl para gestionar tu arquitectura directamente desde Claude Code, Codex o cualquier agente de codificacion compatible

Plugin para Agentes de Codificacion

El Plugin para Desarrolladores de Archyl te permite gestionar todo tu modelo de arquitectura C4 directamente desde tu agente de codificacion: Claude Code, Codex o cualquier herramienta compatible. En lugar de alternar entre tu editor y el panel de Archyl, puedes crear sistemas, contenedores, componentes, ADRs, reglas de conformidad y mucho mas sin salir de tu terminal.

El plugin es de codigo abierto y esta disponible en github.com/archyl-com/agent-skills.

Que Puedes Hacer

El plugin proporciona a tu agente un conocimiento profundo de las mas de 200 herramientas MCP de Archyl en estos dominios:

Dominio Capacidades
Modelado C4 Crear y gestionar sistemas, contenedores, componentes, elementos de codigo y relaciones
Documentacion Registros de Decisiones de Arquitectura, documentacion de proyectos, flujos de usuario/sistema, perspectivas de IA
Gobernanza Reglas de conformidad, deteccion de desviaciones, metricas DORA, mapeo de propiedad
Operaciones Lanzamientos, entornos, contratos de API, canales de eventos, radar tecnologico
Colaboracion Comentarios, solicitudes de cambio, pizarras, gestion de equipos
Historial Instantaneas, viaje en el tiempo, comparacion de arquitectura, registros de auditoria
Integraciones Webhooks, widgets del marketplace, vistas de arquitectura global

Requisitos Previos

  • Una cuenta de Archyl con acceso a la API
  • Una clave de API (obtenla desde Configuracion → Claves de API en el panel de Archyl)
  • Claude Code, Codex o un agente de codificacion compatible

Instalacion

Paso 1: Agregar el Marketplace

Ejecuta el siguiente comando en Claude Code:

/plugin marketplace add archyl-com/agent-skills

Luego abre el gestor de plugins para configurar las actualizaciones automaticas:

  1. Ejecuta /plugin
  2. Selecciona Marketplaces
  3. Elige archyl-marketplace de la lista
  4. Selecciona Enable auto-update o Disable auto-update

Paso 2: Instalar el Plugin

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

Reinicia Claude Code despues de la instalacion.

Paso 3: Configurar el Servidor MCP

Agrega el servidor MCP de Archyl al archivo .mcp.json de tu proyecto:

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

Reemplaza arch_your_api_key_here con tu clave de API real del panel de Archyl.

Otros Agentes de Codificacion

El contenido del plugin es compatible con cualquier agente que soporte el formato de plugins. Tambien puedes usar los archivos de habilidades directamente desde el directorio del plugin archyl-developer en el repositorio.

Flujos de Trabajo Comunes

Una vez instalado, puedes pedirle a tu agente de codificacion que realice tareas de arquitectura en lenguaje natural. Estos son algunos flujos de trabajo comunes:

Documentar un Nuevo Proyecto

Pide a tu agente que estructure tu modelo de arquitectura:

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.

El agente llamara a las herramientas MCP apropiadas (create_project, create_system, create_container) y conectara todo automaticamente.

Analizar la Arquitectura 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 Reglas de Arquitectura

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

Registrar Decisiones de Arquitectura

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 el Rendimiento de Despliegue

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

Gestionar el Radar Tecnologico

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

Como Funciona

El plugin proporciona a tu agente de codificacion un conocimiento estructurado sobre cada herramienta MCP de Archyl, incluyendo parametros, valores esperados y buenas practicas. Cuando le pides a tu agente que realice una tarea de arquitectura, este:

  1. Identifica que herramientas MCP debe invocar
  2. Construye los parametros correctos (IDs de proyecto, tipos de elementos, tipos de relaciones)
  3. Encadena multiples llamadas para flujos de trabajo complejos
  4. Devuelve un resumen de lo que se creo o modifico

El agente siempre comienza llamando a list_projects para descubrir los proyectos disponibles y obtener el projectId necesario para las operaciones posteriores.

Referencia del Modelo C4

El plugin comprende los 4 niveles del modelo C4:

Nivel Elemento Ejemplo
1 System "Payment Platform", "Email Service"
2 Container "API Server", "PostgreSQL Database", "React Frontend"
3 Component "AuthService", "PaymentProcessor", "UserRepository"
4 Code "PaymentGateway interface", "processPayment()"

Convenciones de Nomenclatura

El agente sigue estas reglas de nomenclatura al crear elementos:

  • Systems: PascalCase, descriptivo (PaymentPlatform, NotificationService)
  • Containers: PascalCase con indicador de tipo (ApiServer, PostgresDatabase, RedisCache)
  • Components: PascalCase, orientado a modulos (AuthService, PaymentProcessor)
  • Code Elements: Nombres exactos de los simbolos del codigo fuente

Tipos de Relaciones

Al conectar elementos, el agente utiliza el tipo de relacion apropiado:

Tipo Caso de Uso
uses Dependencia general entre sistemas
calls Llamadas sincronas HTTP/gRPC
sends_to / consumes_from Mensajeria asincrona (colas, eventos)
reads_from / writes_to Acceso a base de datos
implements / extends Herencia a nivel de codigo

Contribuir

El plugin es de codigo abierto. Puedes contribuir de las siguientes formas:

  • Corrigiendo nombres de herramientas, parametros o descripciones
  • Agregando cobertura para nuevas funcionalidades de Archyl
  • Mejorando los ejemplos de flujos de trabajo
  • Agregando archivos de referencia para dominios faltantes

Consulta la guia de contribucion para mas detalles.