Plugin para Agentes de Codigo: Gestiona Tu Arquitectura Sin Salir de Tu Terminal

El mes pasado, vi a un desarrollador de nuestro equipo hacer algo que parecia que no deberia funcionar. Estaba metido hasta el fondo en una sesion de refactoring en Claude Code, dividiendo un servicio monolitico en tres mas pequenos. A mitad de camino, escribio: "Crea tres nuevos containers en Archyl — OrderService, InventoryService y NotificationService — bajo el sistema ECommerce. Anade relaciones 'calls' entre OrderService y los otros dos." Diez segundos despues, el C4 model en Archyl tenia tres nuevos containers, correctamente conectados con relaciones, ubicados exactamente donde debian estar en la arquitectura. Nunca cambio de pestana. Nunca abrio un navegador. Simplemente siguio programando. Fue entonces cuando me di cuenta de que el plugin estaba listo para publicarse.

El Problema del Cambio de Contexto

La documentacion de arquitectura tiene un problema fundamental de experiencia de usuario: vive en un lugar diferente al del codigo. Estas en tu IDE. Acabas de reestructurar un modulo, renombrar tres servicios y dividir una base de datos en replicas de lectura y escritura. El codigo esta listo. Ahora necesitas actualizar la arquitectura. Eso significa abrir Archyl en un navegador, encontrar el proyecto correcto, navegar al diagrama adecuado, actualizar los containers, agregar relaciones, quiza escribir un ADR para explicar por que hiciste el cambio. Toma cinco minutos. Pero esos cinco minutos tienen un costo oculto: el cambio de contexto. Tu cerebro tiene que salir del codigo, entrar en un modo de diagramacion visual, recordar lo que acabas de hacer, traducirlo en conceptos de arquitectura, y luego volver a programar. La mayoria de los desarrolladores simplemente... no lo hacen. Se dicen a si mismos que actualizaran la documentacion despues. Despues nunca llega. Por eso existe el architecture drift. No porque a los equipos no les importe la documentacion, sino porque la herramienta esta en el lugar equivocado en el momento equivocado.

Arquitectura en Tu Conversacion

El Archyl Developer Plugin pone toda tu arquitectura dentro del contexto de tu agente de codigo. Es un plugin para Claude Code (y compatible con Codex y otros agentes) que le ensena al agente como usar las mas de 200 herramientas MCP de Archyl. Que significa eso en la practica? Significa que puedes hacer esto:

Mientras refactorizas, dile a tu agente que actualice la arquitectura:

I just split the PaymentService into PaymentProcessor and PaymentGateway.
Update the architecture — remove the old container, create the two new ones,
and move all existing relationships to the appropriate new container.

Mientras revisas codigo, pregunta sobre el contexto arquitectonico:

Get the full C4 model and tell me which components depend on the UserRepository.
Are there any conformance rules I should know about before changing the data layer?

Mientras planificas trabajo, verifica si la documentacion sigue siendo precisa:

What's the current drift score? Show me which elements have drifted
and what the AI thinks is out of date.

Despues de una reunion de diseno, registra la decision sin salir de tu terminal:

Create an ADR: we decided to migrate from REST to gRPC for all internal
service communication. Context: latency requirements from the mobile team.
Link it to the ApiGateway and all backend service containers.

El agente maneja las llamadas MCP, gestiona los IDs de proyecto y encadena operaciones. Tu solo describes lo que quieres en lenguaje natural.

Lo Que Cubre el Plugin

El plugin le da a tu agente conocimiento estructurado en siete dominios:

C4 Modeling — Crea y gestiona systems, containers, components, code elements y relationships. El agente entiende la jerarquia C4 y aplica las convenciones de nomenclatura correctas (PascalCase para systems y containers, nombres exactos de simbolos para code elements). Documentacion — Escribe ADRs, crea documentacion de proyecto, define flujos de usuario y revisa insights generados por IA. Los ADRs se vinculan a los elementos C4 que afectan, para que las decisiones arquitectonicas se mantengan conectadas a la arquitectura. Gobernanza — Crea reglas de conformance, ejecuta verificaciones de cumplimiento y monitorea el architecture drift. El agente puede establecer guardarrailes antes de que una sesion de codificacion con IA comience. Operaciones — Rastrea releases a traves de entornos, documenta contratos de API (OpenAPI, gRPC, GraphQL), mapea canales de eventos (Kafka, NATS, SQS) y gestiona el technology radar. Colaboracion — Agrega comentarios, crea change requests (como PRs para arquitectura) y gestiona whiteboards. Las discusiones de arquitectura suceden donde suceden las discusiones de codigo. Historial — Toma snapshots, viaja en el tiempo a traves de versiones de arquitectura y compara cambios. Cuando alguien pregunta "como se veia la arquitectura antes de la migracion?", el agente puede responder. Integraciones — Configura webhooks para notificaciones de cambios en la arquitectura, gestiona widgets del marketplace y visualiza la arquitectura global de todos los proyectos en la organizacion.

Tres Pasos para Configurarlo

La configuracion es sencilla:

1. Agrega el marketplace e instala el plugin:

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

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

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

3. Reinicia tu agente y empieza a hablar con tu arquitectura.

Eso es todo. El plugin se carga automaticamente y el agente sabe como usar cada herramienta. Sin archivos de configuracion, sin prompts personalizados, sin cableado manual.

Por Que Open Source

El plugin es completamente open source en github.com/archyl-com/agent-skills. Hay varias razones para esto. Primero, transparencia. Cuando un plugin le ensena a un agente de IA como interactuar con tu arquitectura, deberias poder leer cada instruccion que le da. Segundo, contribuciones. Archyl tiene mas de 200 herramientas MCP, y los mejores flujos de trabajo surgen del uso real. Tercero, portabilidad. El contenido del skill no esta bloqueado a Claude Code. Funciona con cualquier agente que soporte el formato de plugin.

Lo Que Cambia

El cambio es sutil pero significativo. Antes del plugin, la documentacion de arquitectura era una actividad separada. Escribias codigo, luego documentabas. Dos flujos de trabajo, dos herramientas, dos modos mentales. La documentacion siempre iba un paso atras porque siempre estaba a un paso de distancia. Con el plugin, la documentacion de arquitectura se convierte en parte de la conversacion de codigo. No "actualizas la documentacion" — mencionas lo que cambio y el agente se encarga. La arquitectura se mantiene sincronizada no porque alguien se acordo de actualizarla, sino porque actualizarla se volvio algo sin esfuerzo. Esto es especialmente poderoso en flujos de trabajo agenticos. Cuando un agente de IA esta haciendo cambios en tu codigo, puede simultaneamente actualizar la arquitectura.

Empieza Ahora

Instala el plugin, conecta tu servidor MCP e intenta pedirle a tu agente que describa tu arquitectura. Luego pidele que haga un cambio. La primera vez que actualices un C4 model desde una conversacion en la terminal, te preguntaras por que alguna vez funciono de otra manera. El plugin esta disponible ahora. La documentacion completa esta en nuestras guias, y el codigo fuente esta en GitHub. Tu arquitectura no deberia vivir en otra pestana. Ahora ya no tiene que hacerlo.