Gestiona tu modelo C4 desde Claude Code y la terminal

El mes pasado, vi a un desarrollador de nuestro equipo hacer algo que parecía que no debería funcionar. Estaba metido hasta el fondo en una sesión de refactoring en Claude Code, dividiendo un servicio monolítico en tres más pequeños. A mitad de camino, escribió: "Crea tres nuevos containers en Archyl — OrderService, InventoryService y NotificationService — bajo el sistema ECommerce. Añade relaciones 'calls' entre OrderService y los otros dos." Diez segundos después, el C4 model en Archyl tenía tres nuevos containers, correctamente conectados con relaciones, ubicados exactamente donde debían estar en la arquitectura. Nunca cambió de pestaña. Nunca abrió un navegador. Simplemente siguió programando. Fue entonces cuando me di cuenta de que el plugin estaba listo para publicarse.

El Problema del Cambio de Contexto

La documentación de arquitectura tiene un problema fundamental de experiencia de usuario: vive en un lugar diferente al del código. Estás en tu IDE. Acabas de reestructurar un módulo, renombrar tres servicios y dividir una base de datos en replicas de lectura y escritura. El código está 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, quizá escribir un ADR para explicar por qué hiciste el cambio. Toma cinco minutos. Pero esos cinco minutos tienen un costo oculto: el cambio de contexto. Tu cerebro tiene que salir del código, entrar en un modo de diagramación visual, recordar lo que acabas de hacer, traducirlo en conceptos de arquitectura, y luego volver a programar. La mayoría de los desarrolladores simplemente... no lo hacen. Se dicen a si mismos que actualizaran la documentación después. Después nunca llega. Por eso existe el architecture drift. No porque a los equipos no les importe la documentación, sino porque la herramienta está en el lugar equivocado en el momento equivocado.

Arquitectura en Tu Conversación

El Archyl Developer Plugin pone toda tu arquitectura dentro del contexto de tu agente de código. Es un plugin para Claude Code (y compatible con Codex y otros agentes) que le enseña al agente como usar las 181 herramientas MCP de Archyl. ¿Qué significa eso en la práctica? 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 código, pregunta sobre el contexto arquitectónico:

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 documentación sigue siendo precisa:

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

Después de una reunión de diseño, registra la decisión 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 jerarquía C4 y aplica las convenciones de nomenclatura correctas (PascalCase para systems y containers, nombres exactos de símbolos para code elements). Documentación — Escribe ADRs, crea documentación 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 arquitectónicas se mantengan conectadas a la arquitectura. Gobernanza — Crea reglas de conformance, ejecuta verificaciones de cumplimiento y monitorea el architecture drift. El agente puede establecer guardarraíles antes de que una sesión de codificación con IA comience. Operaciones — Rastrea releases a través de entornos, documenta contratos de API (OpenAPI, gRPC, GraphQL), mapea canales de eventos (Kafka, NATS, SQS) y gestiona el technology radar. Colaboración — Agrega comentarios, crea change requests (como PRs para arquitectura) y gestiona whiteboards. Las discusiones de arquitectura suceden donde suceden las discusiones de código. Historial — Toma snapshots, viaja en el tiempo a través de versiones de arquitectura y compara cambios. Cuando alguien pregunta "¿cómo se veía la arquitectura antes de la migración?", 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 organización.

Tres Pasos para Configurarlo

La configuración 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 automáticamente y el agente sabe cómo usar cada herramienta. Sin archivos de configuración, sin prompts personalizados, sin cableado manual.

Por Qué 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 enseña a un agente de IA como interactuar con tu arquitectura, deberías poder leer cada instrucción que le da. Segundo, contribuciones. Archyl tiene 181 herramientas MCP, y los mejores flujos de trabajo surgen del uso real. Tercero, portabilidad. El contenido del skill no está 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 documentación de arquitectura era una actividad separada. Escribías código, luego documentabas. Dos flujos de trabajo, dos herramientas, dos modos mentales. La documentación siempre iba un paso atrás porque siempre estaba a un paso de distancia. Con el plugin, la documentación de arquitectura se convierte en parte de la conversación de código. No "actualizas la documentación" — mencionas lo que cambió y el agente se encarga. La arquitectura se mantiene sincronizada no porque alguien se acordó de actualizarla, sino porque actualizarla se volvió algo sin esfuerzo. Esto es especialmente poderoso en flujos de trabajo agenticos. Cuando un agente de IA está haciendo cambios en tu código, puede simultáneamente actualizar la arquitectura.

Empieza Ahora

Instala el plugin, conecta tu servidor MCP e intenta pedirle a tu agente que describa tu arquitectura. Luego pídele que haga un cambio. La primera vez que actualices un C4 model desde una conversación en la terminal, te preguntaras por qué alguna vez funcionó de otra manera. El plugin está disponible ahora. La documentación completa está en nuestras guías, y el código fuente está en GitHub. Tu arquitectura no debería vivir en otra pestaña. Ahora ya no tiene que hacerlo.