Archify: הסוכן שממפה את הארכיטקטורה של הפרויקט שלכם לדיאגרמות מאומתות

לא לכל פרויקט יש דיאגרמת ארכיטקטורה. אם הייתה כזאת, היא צוירה מזמן, ננטשה, והפרויקט התקדם הרחק ממנה. ואם הפרויקט נכתב ב-vibe coding, דיאגרמה לא הייתה מעולם: שירותים, אינטגרציות ו-webhooks הופיעו פרומפט אחר פרומפט, וכעבור חודשיים לחפור בעצמכם ולהבין מה נמצא איפה ומי מדבר עם מי זה קשה ומבלבל, כי פשוט יש יותר מדי.

בשביל זה Archify קיים. הוא לא עורך דיאגרמות אלא סקיל לסוכן: Claude Code, Cursor או Codex חוקרים בעצמם את הריפוזיטורי, מוצאים את הרכיבים והקשרים ביניהם, מציירים את הדיאגרמה ומריצים עליה תשע בדיקות לפני שמראים לכם אותה. אם חץ חותך צומת לא קשור או תווית נוחתת על קו שכן, הסוכן יראה את זה לפניכם ויתקן.

לפרויקט שנכתב ב-vibe coding זו ההזדמנות הראשונה לראות מה באמת בניתם ולבדוק מחדש את הארכיטקטורה לפני שהיא גדלה עוד. לפרויקט שחי איתכם שנים זו דרך לפקוח עיניים על איך הוא נראה בשלמותו, ולא מהזיכרון.

התקנו אותו בבוקר ועד הצהריים היו לנו דיאגרמות של הפרויקט שלנו שלא מתביישים להראות. למטה שתי דוגמאות, שתיהן צוירו על ידי Claude Code מתיאור של משפט או שניים.

מה זה באמת

בפנים יש שלושה דברים. קובץ הוראות לסוכן: איך לבחור סוג דיאגרמה, אילו שדות יש לצמתים ולקשרים, באיזה סדר לבדוק את התוצאה. חמש סכמות נתונים, אחת לכל סוג. ורנדרר ב-Node שלוקח את ה-JSON ומרכיב ממנו קובץ HTML אחד עם SVG בפנים, בלי שרת ובלי תלויות חיצוניות.

יש חמישה סוגים, והסוכן בוחר ביניהם לפי ניסוח הבקשה:

• ארכיטקטורה: רכיבים, אחסון, שירותים חיצוניים, גבולות כמו "זה חי בענן".
• תהליך עבודה: תהליכים בנתיבים ובצעדים, אישורים, CI/CD, ראנבוקים.
• רצף: מי שלח מה למי ומה חזר.
• זרימת נתונים: צינורות, מקורות, טרנספורמציות, צרכנים.
• מחזור חיים: מצבים ומעברים, המתנות, ניסיונות חוזרים, יציאות סופיות.

כל צומת מוגדר טיפוס: פרונטאנד, בקאנד, בסיס נתונים, ענן, אבטחה, אפיק הודעות או שירות חיצוני. הרנדרר לוקח מהטיפוס צבע ואייקון, והמקרא למטה מתרכב מעצמו.

פקודה אחת להתקנה, ואחר כך מבקשים במילים

npx skills add tt-a1i/archify -g
# לבדוק שהכול במקום
node ~/.claude/skills/archify/bin/archify.mjs doctor

ההתקנה שמה את תיקיית הסקיל ליד שאר הסקילים; ל-Cursor ול-Codex יש דגלים משלהם. בריפוזיטורי שלכם שום דבר לא משתנה, אין תלויות להתקין. מכאן השיחה היא במילים. עובד גם בלי ריפוזיטורי, לפי תיאור:

Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

וגם עם ריפוזיטורי, כשהדיאגרמה צריכה לשקף קוד אמיתי:

Analyze this repository, then use archify to create a high-level runtime architecture diagram. Show 8–12 core components, one primary path, external dependencies, and trust boundaries.

אחרי הגרסה הראשונה אפשר לדייק: "תוסיף תור", "תדגיש את מסלול הרולבק", "תוריד את האנליטיקה". הסוכן עורך את הדיאגרמה, בודק שוב ומחזיר קובץ חדש.

תשע בדיקות לפני שתראו את התוצאה

זה מה שמבדיל את Archify מ"תבקש ממודל לצייר". לפני המסירה כל דיאגרמה עוברת ולידטור: מבנה, פריסה, HTML ו-SVG, מסלולי חצים, מרווח בין תוויות לקווים. במצב showcase יש תשע בדיקות כאלה, וכל עוד אחת מהן אדומה ההוראות אוסרות על הסוכן לקרוא לתוצאה מוכנה.

השגיאות מגיעות לא כ"משהו לא בסדר" אלא כקוד כלל ורשימת תיקונים: "התווית נוחתת על צומת, הזז אותה או קבע עוגן", "הקו רץ לאורך גבול הבלוק, חצה אותו בניצב", "שני חצים חולקים מסדרון אחד, הפרד ביניהם". אף אחת מהשגיאות האלה לא מונעת מהתמונה להיראות סבירה, ובדיוק אותן העין מפספסת.

הטיוטה הראשונה של הארכיטקטורה שלנו חזרה עם שש הערות, והתיקון לקח שלושה סבבים: להזיז צומת אחד, לקצר תווית אחת, למסור מסלול אחד לניתוב האוטומטי. זה נורמלי, וההוראות אומרות לסוכן במפורש לתקן רק את מה שהאבחון הצביע עליו, ולעצור אם שני סבבים רצופים לא משפרים את הספירה. הדיאגרמה לא הופכת אחרי עריכות לסבך של עקיפות ידניות, כי קואורדינטות קיימות רק על צמתים ואת המסלולים מחשב המהדר.

מה מקבלים בסוף

לא תמונה אלא דף HTML, ויש בו דברים שאין ל-PNG סטטי. למעלה פאנל של "פרקים": הסוכן מתאר שלושה עד חמישה סיפורים כמו "בקשת לקוח", "מטמון וחיפוש", "הזמנות ודואר", וכפתור Play story עובר עליהם בזה אחר זה ומדגיש את הצמתים הרלוונטיים. יש חיפוש צמתים, מעקב אחר מסלול בין שתי נקודות, מצב מצגת ומעבר בכפתור אחד בין ערכת נושא כהה לבהירה.

הייצוא חי באותו דף: PNG ללוח בכפתור אחד, SVG לתיעוד, WebM אם הופעלה אנימציית מעקב, וכרטיס שיתוף 1200×630 לרשתות. הכרטיס לא מופשט: הוא נלכד אחרי שעקבתם אחרי מסלול מסוים ומראה אותו על רקע הדיאגרמה כולה.

מהקוד, לא מהזיכרון

שתי יכולות שבגללן שווה להחזיק את Archify ליד הריפוזיטורי. הראשונה: צומת ארכיטקטורה יכול לשאת תג SRC שפותח קובץ וטווח שורות בקומיט מסוים. הדיאגרמה מפסיקה להיות טענה "אנחנו חושבים שזה עובד ככה" והופכת לקישור "הנה הקוד". השנייה: הפקודה compare לוקחת שתי גרסאות של דיאגרמה ובונה דף דלתא: מה נוסף, מה נעלם, מה עבר. לסקירה של "הוצאנו את התור לשירות נפרד" זה בדיוק הארטיפקט שרוצים לצרף ל-pull request.

כמה זה עולה

כלום. הרישיון MIT, הפרויקט צמח מתוך מחולל דיאגרמות הארכיטקטורה של Cocoon-AI, גם הוא MIT, וזה כתוב בכנות בכותרת ההוראות. אין תוכניות בתשלום, אירוח או חשבון: כל מה שאתם מקבלים יושב בתיקייה שלכם ונפתח בלחיצה כפולה.

נכון ל-4 בספטמבר 2026 לריפוזיטורי 47,000 כוכבים, 24,000 מהם מהשבוע האחרון: הפרויקט הצומח ביותר השבוע ב-GitHub. גרסה 2.17, קומיטים נוחתים מדי יום.

למי אני ממליץ, ולמי לא

ממליץ אם יש לכם פרויקט שאת המבנה שלו הסברתם במילים לפחות פעם אחת: למפתח חדש, ללקוח, לעצמכם בעוד חצי שנה. ערב אחד, ויש לכם דיאגרמות שהורכבו מהקוד, נבדקו על ידי ולידטור ומתרעננות באותה פקודה כשהקוד משתנה. ממליץ במיוחד למי שכותב תיעוד ומאמרים: ייצוא ל-PNG וערכת הנושא הכהה סוגרים את שאלת האיורים.

לא ממליץ בשני מקרים. אם אתם צריכים לוח שבו מזיזים דיאגרמה ביד בזמן שיחה, זה Figma, Excalidraw או tldraw; ל-Archify אין מצב כזה בכוונה. ואם אתם עובדים בלי סוכן בכלל: אפשר לכתוב את ה-JSON ביד, אבל אז תקבלו ולידטור בלי החלק שבשבילו כל זה הומצא.