ArchyntArchynt.api
Integración con GitHub

Frená el drift arquitectónico antes de que mergee

En cada pull request, Archynt analiza los commits base y head, compara los problemas de diseño entre ambos, y publica el resultado directo en GitHub — así una dependencia circular nueva o un god-service aparecen como un check que falla, no como una sorpresa tres sprints después.

#482 — Ship inventory reservation from checkout
archynt/architecture · feature/inline-reservation → main
FAIL

New circular dependency: OrderService ↔ ShippingService

HIGH
ShippingService.java:88 — orderService.markShipped(orderId)

OrderController now depends on InventoryRepository directly

MEDIUM
OrderController.java:54 — inventoryRepository.reserve(...)
Resolved by this PR — PaymentService god-object coupling
Bot de Archynt comentando el resultado del check de arquitectura en un pull request de GitHub

Cómo funcionan los checks de PR

01

Disparado por GitHub

Un webhook pull_request (opened, synchronize, reopened) inicia el check automáticamente — sin polling, sin disparo manual desde Archynt.

02

Compara el grafo, no el diff

Tanto el commit base como el head se analizan en grafos de arquitectura completos; el check compara los problemas de diseño que produce cada uno, no el diff de código en bruto.

03

Veredicto determinístico

PASS si no aparecen problemas nuevos, FAIL si el PR introduce un problema de severidad HIGH, WARN en los demás casos — los mismos detectores que se usan en el resto de Archynt, no una llamada a un LLM.

04

Check run nativo de GitHub

Los resultados se publican como un check run (con un resumen en markdown de los hallazgos introducidos y resueltos) una vez que la GitHub App está instalada en el repositorio.

05

También funciona sin la app

Sin la GitHub App, un token configurado igual publica el resultado como comentario de PR y commit status — solo sin la interfaz nativa de check run.

06

Soporta repos privados

El token de instalación de la GitHub App también se usa para clonar repositorios privados para el análisis, así que no hacen falta credenciales separadas.

¿Listo para verlo en tu sistema?

Corré un análisis o entrá directo al workspace de tu organización.