Architecture Intelligence para equipos AI-Native

Algo cambio en los últimos 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 código, 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 decidió hace tres meses enrutar toda la comunicación entre servicios a través 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 arquitectónico a velocidad de máquina.

Construimos Archyl para resolver esto. Y hoy, lanzamos la actualización más 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 rápido, pero codifican a ciegas

Cuando un desarrollador humano se une a un equipo, pasa días leyendo documentación, haciendo preguntas, construyendo un modelo mental del sistema. Aprende las reglas — escritas y no escritas. Entiende los límites.

Los agentes de IA se saltan todo eso. Reciben una tarea, escriben código, abren un PR. Si nadie detecta la violación arquitectónica en la revisión, se despliega. Multiplica eso por diez agentes trabajando en diez servicios en tres equipos, y tu arquitectura cuidadosamente diseñada se erosiona en semanas.

Hemos visto que esto sucede. Un equipo con un modelo C4 impecable en enero tenía un drift score del 40% en marzo. No porque dejaron de preocuparse — sino porque sus agentes no sabían que la arquitectura existía.

La solución: la arquitectura como infraestructura

La documentación de arquitectura no debería ser algo que mantienes. Debería ser algo que se mantiene solo — y que cada agente consulta antes de escribir una sola línea de código.

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 181 herramientas MCP. Pero era una caja de herramientas sin flujo de trabajo. Hoy, añadimos 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 línea de código.

> 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

Después de desplegar

archyl-postship — Ejecuta esto después de desplegar. Analiza lo que acabas de construir, actualiza el modelo C4, crea ADRs para decisiones arquitectónicas y registra Change Requests para revisión del arquitecto. Tu documentación se actualiza sola como efecto secundario de trabajar.

Durante la revisión

archyl-review — Un bot de revisión de arquitectura. Verifica el diff de tu PR contra la arquitectura documentada y proporciona feedback estructurado: violaciones de conformidad, cruces de límites, tecnologías no aprobadas, contratos API faltantes. Piensa en ESLint, pero para arquitectura.

Para visibilidad

archyl-changelog — Genera una línea de tiempo legible de todos los cambios arquitectónicos: nuevos servicios, relaciones modificadas, decisiones ADR, evolución del drift. Perfecto para reuniones de revisión de arquitectura.

archyl-dora — Correlaciona métricas DORA con cambios arquitectónicos. ¿Tu descomposición en microservicios mejoró el lead time? ¿El pico de drift precedió al aumento de change failure rate? Ahora tienes los datos.

archyl-roi — Cuantifica el impacto financiero de las decisiones arquitectónicas. "Nuestra inversión en reglas de conformidad ahorró un estimado de $23,000 el último trimestre al reducir el retrabajo." Ese es el tipo de datos que logra que aprueben presupuestos de arquitectura.

Para prevención

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

archyl-autofix — Cuando se detecta drift, propone correcciones específicas. Ya sea actualizar la documentación para que coincida con el código, o sugerir cambios de código para realinearse con la arquitectura. Crea Change Requests para revisión humana.

Para coordinación

archyl-orchestrate — Cuando múltiples agentes trabajan en diferentes servicios simultáneamente, 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 arquitectónica pertenece al CI. Lanzamos seis GitHub Actions que se ejecutan automáticamente en cada PR y merge:

La configuración 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 estás en GitHub? También ofrecemos plantillas para GitLab CI y Bitbucket Pipelines.

Packs de reglas de conformidad

Configurar la gobernanza arquitectónica desde cero es tedioso. Así que construimos cinco packs de reglas predefinidos que puedes instalar en segundos:

Instala a través 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) — Análisis estadístico real. Regresión lineal sobre drift scores, trayectorias de métricas DORA, tasas de decaimiento de conformidad y detección de hotspots de complejidad mediante análisis de acoplamiento fan-in/fan-out. No intuiciones — matemáticas.

Architecture Diff Analysis (POST /projects/:id/architecture-diff) — Envía un git diff, recibe un delta estructurado del modelo C4. Análisis impulsado por IA que detecta nuevos servicios, dependencias modificadas y decisiones arquitectónicas. Sugiere ADRs cuando se detectan decisiones significativas.

ROI Computation (GET /projects/:id/roi) — Cuantifica los retornos de la inversión en arquitectura. Divide tus métricas DORA antes/después, 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 están disponibles como herramientas MCP, así que cada agent skill puede llamarlas directamente.

El ciclo completo

Así 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 pídele a tu agente: "Genera el archivo de contexto de arquitectura para este proyecto."

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

Qué sigue

Esta es la base. Estamos trabajando en dashboards frontend para predicciones y ROI, integración más profunda con más agentes de codificación y un marketplace comunitario para packs de reglas de conformidad.

La documentación de arquitectura siempre fue aquello que los equipos querían hacer pero nunca encontraban el momento. Cuando los agentes escriben el código, la arquitectura se convierte en lo único que los humanos necesitan gestionar. Archyl se asegura de que no tengan que hacerlo solos.

Todo lo que lanzamos hoy es open source. Nos encantaría recibir tu feedback.