- Transforma repositoris de codi complets a mapes visuals interactius mitjançant agents d'IA.
- Permet fer comparacions detallades entre versions d'arquitectura per detectar canvis semàntics.
- Ofereix un sistema de validació rigorós que evita la generació de diagrames erronis o visualment trencats.
- Suporta múltiples tipus d'esquemes tècnics, des de fluxos de dades fins a diagrames de cicle de vida i ERD.
De vegades, intentar explicar com funciona un sistema complex és molt més pesat que programar-lo . Quan et toca prendre decisions tècniques o presentar un projecte a un client, necessites una manera clara d'explicar el procés sense que la gent es perdi entre tantes peces i dependències. Ja sigui un pipeline de dades o una arquitectura de programari, si deixes anar tota la informació de cop, l'interlocutor acaba desconnectat, però si vas peça a peça, necessites una metodologia que sigui comprensible tant per a un desenvolupador com per a un gerent.
En aquest escenari apareix Archify, una eina de codi obert que ha causat sensació a GitHub en permetre que la IA mapegi repositoris sencers en un obrir i tancar d'ulls. No es tracta només de fer un dibuix bonic, sinó d'integrar la capacitat de diagramació directament al flux de treball d'agents de programació com ara Claude Code o Cursor. És, bàsicament, passar de tenir milers de línies de codi a un mapa visual interactiu en HTML que qualsevol persona pot explorar sense necessitat d'instal·lar res de complex.
Què fa que Archify sigui diferent de la resta?
Segurament ja coneixes eines com Mermaid o D2, que són genials per convertir text en esquemes. Tot i això, Archify juga en una altra lliga perquè no es limita a renderitzar text, sinó que està embegut en el flux de l'agent . L'agent d'IA analitza el codi, entén la lògica i genera una representació intermèdia a JSON (IR) que després Archify valida i renderitza. Això soluciona el problema típic de les IA que dibuixen ràpid però s'equivoquen a les connexions; aquí, si l'esquema no passa els controls de qualitat i ruteig , el sistema torna un error detallat perquè l'agent el corregeixi abans que vegis el resultat final.
Una de les joies de la corona és la seva capacitat de comparar dues versions d'una arquitectura . Mentre que en un pull request normal només veieu canvis de línies de codi, amb Archify pots generar un «diff» visual. Podeu veure exactament quin component s'ha mogut, quin s'ha eliminat o com s'ha reencaminat una connexió. Aquesta funció d' Arquitectura Delta és fonamental per evitar que la documentació del wiki es quedi obsoleta mentre el codi continua evolucionant.
Tipus de diagrames i capacitats tècniques
L'eina no queda en un sol format, sinó que cobreix pràcticament totes les necessitats d'un equip tècnic. Pots generar diagrames d'arquitectura per veure serveis i límits, workflows per a CI/CD, diagrames de seqüència per a traces asíncrones o trucades a APIs, i fluxos de dades per entendre el llinatge de la informació. Recentment s'han afegit capacitats per crear ERD (entitat-relació) , diagrames de classes, arbres de jerarquia i fins i tot línies de temps per a revisions d'incidents.
El resultat final és un fitxer HTML autònom que permet cercar nodes específics , rastrejar rutes entre components i canviar entre temes clars i foscos. A més, permet exportar el treball en formats com ara PNG, SVG o WebM. Pels que vénen de Mermaid, Archify no re-renderitza el codi directament, sinó que reinterpreta la topologia per crear un esquema molt més robust i visualment atractiu.
Instal·lació i flux de treball
Per posar-lo en marxa, la majoria dels usuaris utilitzen ordres simples de npx per afegir la skill als seus agents. Per exemple, a Claude Code o OpenCode s'instal·la amb una sola línia, mentre que per a Cursor o Codex CLI hi ha ordres específiques. Un cop instal·lat, pots fer servir l'ordre archify doctor per verificar que tot estigui en ordre o generar exemples amb el mode demo.
El procés de creació segueix una cadena lògica: l'agent genera el JSON IR, s'executen les validacions d'esquema i layout i finalment es lliura l'HTML. Si busques la màxima qualitat, hi ha el perfil showcase , que exigeix que el diagrama passi nou comprovacions estrictes sense errors de composició. Si alguna cosa falla, el sistema no us dóna una imatge trencada, sinó un rebut de reparació amb codis de regla específics que l'agent pot processar automàticament.
La història darrere del projecte
Més enllà de la tècnica, Archify té una càrrega humana inspiradora. Va ser creat per un desenvolupador conegut com Teacher Sunny, que va enfrontar enormes barreres laborals a causa de la seva formació en una escola vocacional , malgrat haver estat el millor de la seva promoció en la transferència universitària. Després de patir el rebuig de departaments de RRHH que només miraven el títol i no la capacitat, va decidir que la millor manera de demostrar el seu talent era a través del codi obert.
Aquest projecte es va convertir en el millor currículum, demostrant que el valor real d'un enginyer resideix en allò que és capaç de construir i en el valor que aporta a la comunitat. Archify no és només una eina de productivitat, sinó un testimoni que el treball tangible i la contribució a l'ecosistema open source poden trencar els sostres de vidre de l'educació tradicional.
Comptar amb una eina que transformi el codi en mapes visuals interactius i permeti comparar versions darquitectura simplifica dràsticament la comunicació tècnica. En delegar la validació i el renderitzat en un sistema determinista basat en JSON, s'elimina la frustració dels diagrames manuals i es garanteix que la documentació evolucioni al mateix ritme que el programari, convertint la complexitat tècnica en una cosa digerible per a qualsevol membre de l'equip.
Redactor apassionat del món dels bytes i la tecnologia en general. M'encanta compartir els meus coneixements a través de l'escriptura, i això és el que faré en aquest bloc, mostrar tot el més interessant sobre gadgets, programari, maquinari, tendències tecnològiques, i més. El meu objectiu és ajudar-te a navegar pel món digital de forma senzilla i entretinguda.