Los agentes de IA ahora escriben la mayor parte del codigo. Pero, quien se asegura de que respeten la arquitectura? Hoy lanzamos 10 agent skills, 6 GitHub Actions, packs de reglas de conformidad, SDKs y tres nuevas APIs impulsadas por IA — todo lo que tus agentes necesitan para comprender, validar y evolucionar tu arquitectura automaticamente.

Architecture Intelligence para equipos AI-Native

Algo cambio en los ultimos seis meses. Los agentes de IA pasaron de escribir funciones a escribir servicios completos. Claude Code, Cursor, Codex — ya no son asistentes. Son miembros del equipo. Abren PRs, revisan codigo, lanzan features.

Pero esto es lo que me quita el sueno: estos agentes no tienen idea de como luce la arquitectura.

Un agente puede escribir un servicio Go perfectamente limpio en diez minutos. Pero no sabe que el equipo decidio hace tres meses enrutar toda la comunicacion entre servicios a traves de Kafka. No sabe que el servicio de pagos tiene prohibido el acceso directo a la base de datos. No sabe que Python fue movido a "hold" en el technology radar el trimestre pasado.

El resultado? Drift arquitectonico a velocidad de maquina.

Construimos Archyl para resolver esto. Y hoy, lanzamos la actualizacion mas grande desde el lanzamiento: Architecture Intelligence — un ecosistema completo que convierte a Archyl en el sistema nervioso del desarrollo AI-native.

El problema: los agentes codifican rapido, pero codifican a ciegas

Cuando un desarrollador humano se une a un equipo, pasa dias leyendo documentacion, haciendo preguntas, construyendo un modelo mental del sistema. Aprende las reglas — escritas y no escritas. Entiende los limites.

Los agentes de IA se saltan todo eso. Reciben una tarea, escriben codigo, abren un PR. Si nadie detecta la violacion arquitectonica en la revision, se despliega. Multiplica eso por diez agentes trabajando en diez servicios en tres equipos, y tu arquitectura cuidadosamente disenada se erosiona en semanas.

Hemos visto que esto sucede. Un equipo con un modelo C4 impecable en enero tenia un drift score del 40% en marzo. No porque dejaron de preocuparse — sino porque sus agentes no sabian que la arquitectura existia.

La solucion: la arquitectura como infraestructura

La documentacion de arquitectura no deberia ser algo que mantienes. Deberia ser algo que se mantiene solo — y que cada agente consulta antes de escribir una sola linea de codigo.

Eso es lo que construimos. Esto es lo que lanzamos hoy.

10 Agent Skills

El skill original archyl-developer daba a los agentes acceso a mas de 200 herramientas MCP. Pero era una caja de herramientas sin flujo de trabajo. Hoy, anadimos nueve skills especializados que cubren el ciclo completo de desarrollo:

Antes de codificar

archyl-preflight — Ejecuta esto antes de implementar cualquier feature. Verifica tu enfoque planificado contra el modelo C4, las reglas de conformidad, el technology radar y los contratos API. Obtienes un veredicto claro PASS / WARN / FAIL antes de escribir una sola linea de codigo.

> Estoy a punto de agregar un cache Redis al servicio de usuarios. Esta bien?

Verificacion Preflight: ADVERTENCIA
- Redis esta aprobado en el technology radar ✓
- El servicio de usuarios existe en el modelo C4 ✓
- ⚠ No hay un contenedor de cache documentado — se sugiere crear uno
- ⚠ La regla "No Direct DB Access from Handlers" aplica — asegurate de que el cache se acceda a traves de la capa de servicio

Despues de desplegar

archyl-postship — Ejecuta esto despues de desplegar. Analiza lo que acabas de construir, actualiza el modelo C4, crea ADRs para decisiones arquitectonicas y registra Change Requests para revision del arquitecto. Tu documentacion se actualiza sola como efecto secundario de trabajar.

Durante la revision

archyl-review — Un bot de revision de arquitectura. Verifica el diff de tu PR contra la arquitectura documentada y proporciona feedback estructurado: violaciones de conformidad, cruces de limites, tecnologias no aprobadas, contratos API faltantes. Piensa en ESLint, pero para arquitectura.

Para visibilidad

archyl-changelog — Genera una linea de tiempo legible de todos los cambios arquitectonicos: nuevos servicios, relaciones modificadas, decisiones ADR, evolucion del drift. Perfecto para reuniones de revision de arquitectura.

archyl-dora — Correlaciona metricas DORA con cambios arquitectonicos. Tu descomposicion en microservicios mejoro el lead time? El pico de drift precedio al aumento de change failure rate? Ahora tienes los datos.

archyl-roi — Cuantifica el impacto financiero de las decisiones arquitectonicas. "Nuestra inversion en reglas de conformidad ahorro un estimado de $23,000 el ultimo trimestre al reducir el retrabajo." Ese es el tipo de datos que logra que aprueben presupuestos de arquitectura.

Para prevencion

archyl-predict — Pronostica riesgos arquitectonicos antes de que se materialicen. "Al ritmo actual, tu drift score cruzara el 50% para mayo. El PaymentService tiene 12 dependencias entrantes — considera la descomposicion."

archyl-autofix — Cuando se detecta drift, propone correcciones especificas. Ya sea actualizar la documentacion para que coincida con el codigo, o sugerir cambios de codigo para realinearse con la arquitectura. Crea Change Requests para revision humana.

Para coordinacion

archyl-orchestrate — Cuando multiples agentes trabajan en diferentes servicios simultaneamente, este skill negocia contratos API, resuelve conflictos de dependencias y asegura que los cambios entre equipos no rompan la arquitectura.

6 GitHub Actions

La gobernanza arquitectonica pertenece al CI. Lanzamos seis GitHub Actions que se ejecutan automaticamente en cada PR y merge:

Action	Trigger	Que hace
conformance-check	PR	Ejecuta reglas de conformidad contra archivos modificados, anota violaciones inline
drift-score	PR	Calcula el drift score, lo publica como comentario en el PR, falla si esta por debajo del umbral
generate-context	Push a main	Genera `archyl.txt` — un briefing de arquitectura optimizado en tokens para agentes
auto-cr	Push a main	Crea automaticamente Change Requests de arquitectura a partir de diffs de merge
release	Deploy	Rastrea releases en Archyl con entorno y version
sync	Push a main	Sincroniza el DSL `archyl.yaml` para mantener la arquitectura como codigo

La configuracion recomendada es un solo archivo:

name: Architecture
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  pr-checks:
    if: github.event_name == 'pull_request'
    uses: archyl-com/actions/.github/workflows/archyl-pr.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
      drift-threshold: 70
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

  main-update:
    if: github.event_name == 'push'
    uses: archyl-com/actions/.github/workflows/archyl-main.yml@v1
    with:
      organization-id: ${{ vars.ARCHYL_ORG_ID }}
      project-id: ${{ vars.ARCHYL_PROJECT_ID }}
    secrets:
      api-key: ${{ secrets.ARCHYL_API_KEY }}

No estas en GitHub? Tambien ofrecemos plantillas para GitLab CI y Bitbucket Pipelines.

Packs de reglas de conformidad

Configurar la gobernanza arquitectonica desde cero es tedioso. Asi que construimos cinco packs de reglas predefinidos que puedes instalar en segundos:

Pack	Reglas	Que aplica
Microservices	10	Sin DBs compartidas, desplegabilidad independiente, comunicacion delimitada
Clean Architecture	9	Limites de capas, aislamiento de dominio, patrones port/adapter
Event-Driven	8	Cumplimiento de canales, requisitos de schema, dead letter queues
API-First	8	Requisitos de contratos, versionado, documentacion de autenticacion
Security Baseline	8	Aplicacion de gateway, gestion de secretos, controles de acceso

Instala a traves del agent skill: "Instala el pack de reglas de conformidad de microservicios." Listo.

SDKs

Para equipos que construyen integraciones personalizadas, publicamos SDKs oficiales:

npm install @archyl/sdk    # Node.js 18+, zero dependencies
pip install archyl-sdk     # Python 3.10+

const archyl = new ArchylClient({ apiKey: 'arch_...', organizationId: 'uuid' });
const drift = await archyl.governance.computeDrift(projectId);
const predictions = await archyl.projects.getPredictions(projectId);

Tres nuevas APIs impulsadas por IA

Bajo el capo, lanzamos tres nuevas capacidades en el backend:

Predictive Analytics (GET /projects/:id/predict) — Analisis estadistico real. Regresion lineal sobre drift scores, trayectorias de metricas DORA, tasas de decaimiento de conformidad y deteccion de hotspots de complejidad mediante analisis de acoplamiento fan-in/fan-out. No intuiciones — matematicas.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) — Envia un git diff, recibe un delta estructurado del modelo C4. Analisis impulsado por IA que detecta nuevos servicios, dependencias modificadas y decisiones arquitectonicas. Sugiere ADRs cuando se detectan decisiones significativas.

ROI Computation (GET /projects/:id/roi) — Cuantifica los retornos de la inversion en arquitectura. Divide tus metricas DORA antes/despues, calcula ganancias de productividad (horas ahorradas x costo por hora), ganancias de fiabilidad (incidentes evitados x costo por incidente) y clasifica tus ADRs por impacto financiero.

Las tres estan disponibles como herramientas MCP, asi que cada agent skill puede llamarlas directamente.

El ciclo completo

Asi es como todo encaja:

El agente recibe la tarea
       │
       ▼
  archyl-preflight ──── valida el enfoque contra la arquitectura
       │
       ▼
  El agente escribe codigo
       │
       ▼
  archyl-review ──────── revisa el PR contra el modelo C4
       │
       ▼
  CI: conformance-check ─ bloquea violaciones
  CI: drift-score ──────── aplica alineamiento
       │
       ▼
  Merge a main
       │
       ▼
  CI: auto-cr ──────────── registra Change Request
  CI: generate-context ─── actualiza archyl.txt
       │
       ▼
  archyl-postship ──────── actualiza modelo C4 + ADRs
       │
       ▼
  El siguiente agente lee archyl.txt ← el ciclo se repite

La arquitectura no se mantiene. Se mantiene sola.

Primeros pasos

1. Instala los skills:

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

2. Agrega las GitHub Actions: Copia el workflow anterior en .github/workflows/architecture.yml.

3. Genera tu primer archyl.txt: Ejecuta la action generate-context o pidele a tu agente: "Genera el archivo de contexto de arquitectura para este proyecto."

4. Comienza a codificar. Tu agente ahora conoce la arquitectura.

Que sigue

Esta es la base. Estamos trabajando en dashboards frontend para predicciones y ROI, integracion mas profunda con mas agentes de codificacion y un marketplace comunitario para packs de reglas de conformidad.

La documentacion de arquitectura siempre fue aquello que los equipos querian hacer pero nunca encontraban el momento. Cuando los agentes escriben el codigo, la arquitectura se convierte en lo unico que los humanos necesitan gestionar. Archyl se asegura de que no tengan que hacerlo solos.

Todo lo que lanzamos hoy es open source. Nos encantaria recibir tu feedback.

Architecture Intelligence para equipos AI-Native - Archyl Blog