Archify: مولّد Diagrams معمارية قابلة للتحقق لأي AI Agent (34 ألف نجمة)

لو انت جربت تخلي أي AI agent يعمل diagram معماري لمشروعك — عارف المشكلة: Mermaid بيطلع messy، والـ Draw.io مش أوتوماتيك، وأي حل تاني بيولّد كود بس مش diagram شغّال. Archify بيحل ده كله. أداة مفتوحة المصدر بتشتغل مع Claude Code و Cursor و Codex CLI و OpenCode — بتوصف نظامك بلغة عادية، وبتطلعلك diagram تفاعلي، قابل للتحقق، وجاهز للمشاركة.

الريبو وصل 34.1 ألف نجمة على GitHub و2.2 ألف fork، ومرخّص MIT.

ازاي بيشتغل؟

Archify مش بيولّد صورة عشوائية. بيشتغل بطريقة منظّمة:

• الـ AI agent بيقرا وصف نظامك (أو الكود نفسه)
• بيولّد JSON IR منظّم (نموذج بيانات وسيط)
• Archify نفسه (Node.js) بيتحقق من الـ JSON ويحوّله لـ HTML/SVG تفاعلي
• النتيجة ملف واحد مستقل بيشتغل في أي متصفح — تشاركه أو ترفعه على GitHub Pages

5 أنواع Diagrams مدعومة

• Architecture — رسم معماري كامل للنظام مع الخدمات والاتصالات
• Workflow — Business processes خطوة بخطوة
• Sequence — تفاعلات بين components مع الزمن
• Data-Flow — مسار البيانات عبر النظام
• Lifecycle — دورة حياة entity (طلب، مستخدم، إلخ)

المميزات اللي بتفرقه عن أي أداة تانية

• Before / Delta / After — قبل ما تعمل merge لأي تغيير معماري، Archify بيقارنلك النظام قبل وبعد ويقولك بالضبط: إيه اللي اتضاف، اتشال، اتغيّر، اتحرك
• Verifiable — كل diagram بيتحقق من الـ topology، مفيش hallucination في الروابط
• Interactive — تقدر تدور على أي node، تتبع مساراته upstream/downstream
• Guided Stories — تشغّل “قصة” جوّه الـ diagram تشرح flow معين
• Dark/Light Themes + 4 presets
• Export كامل: HTML، PNG، SVG، WebM (فيديو)، و 1200×630 لـ social sharing

التثبيت — سطر واحد لأي agent

# Claude Code
npx -y skills add tt-a1i/archify --agent claude-code --global --copy --yes

# Cursor
npx -y skills add tt-a1i/archify --agent cursor --global --copy --yes

# Codex CLI
npx -y skills add tt-a1i/archify --agent codex --global --copy --yes

# OpenCode
npx -y skills add tt-a1i/archify --agent opencode --global --copy --yes

# بعد التثبيت، اطلب من الـ agent:
"Use the archify skill to map this repository's runtime architecture"

حالات الاستخدام الحقيقية

• توثيق مشاريع — README فيه architecture diagram دايماً محدّث
• Code Review — قبل ما تعمل merge لـ PR كبير، اعمل Before/After diagram
• Onboarding — عضو فريق جديد يفهم النظام في دقايق مش أيام
• Presentations — Export لـ PNG/WebM جاهز للسلايدز
• Sales/Demos — تعرض على العميل النظام قبل ما تبنيه

ليه ده مهم؟

معظم الـ AI diagrams النهاردة بتطلع “شكلها حلو” بس مش دقيقة — روابط خطأ، nodes وهمية، أو layout مش منطقي. Archify بيحل ده بإلزام الـ agent يمر عبر JSON IR منظّم يتم التحقق منه قبل الرسم. النتيجة: diagrams تقدر تعتمد عليها فعلاً في documentation والـ code reviews.