בונים עיר סוכנים: כל צוות ה-AI שלכם במבט אחד

ועכשיו החלק שהפתיע אותי. ברגע שהעיר עלתה, ראיתי שארבעה סוכנים אצלי רדומים כבר חודשיים. שניים מהם עשו כמעט את אותה עבודה, ואחד עבד מול מערכת שכבר מזמן לא בשימוש. אף אחד לא שם לב, כולל אני (במיוחד אני..). מיזגתי אחד, ארכבתי אחד, והצוות ירד מ-11 בניינים ל-9.

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

מה רואים בעיר?

• בניין לכל סוכן, בצורה שמתאימה לתפקיד שלו. החוקר מקבל מצפה, הכותב מקבל בית דפוס.

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

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

• מצב ארכיטקטורה, שמראה קשתות בין סוכנים שמעבירים עבודה זה לזה.

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

שלב 1: צריך צוות סוכנים

העיר נבנית מתוך הצוות שלכם, אז בלי צוות אין עיר. זה יכול להיות צוות לשיווק, לתוכן, לשירות לקוחות או לניהול פרויקטים. כל צוות שבניתם ב-Claude Code, עם סוכנים בתיקייה .claude/agents.

עדיין אין לכם צוות? בקורס "מכונת הקמפיינים" כאן במועדון בונים מאפס מחלקת שיווק של 6 סוכני AI ב-Claude Code. צוות כזה בדיוק אפשר להפוך לעיר. להיכנס לקורס

שלב 2: מדביקים את הפרומפט

פותחים את Claude Code בתיקייה של הצוות, ומדביקים:

יש לי צוות סוכנים ב-Claude Code (בתיקיות .claude/agents ו-.claude/skills).
המטרה: להפוך אותו לעיר תלת-ממדית חיה, שבה כל סוכן הוא בניין. כלי שליטה אמיתי, לא רק אנימציה.

מה העיר צריכה לעשות:
- לסרוק את הריפו בכל טעינה. בלי להזין שום נתון ידנית.
- לכל סוכן: בניין עם צורה שמתאימה לתפקיד שלו (חוקר = מצפה, כותב = בית דפוס וכו').
- בצד: רשימת הסוכנים עם הטריגרים של כל אחד.
- ב-hover על בניין: כרטיס צף ליד הבניין, ולחיצה נועלת אותו. בכרטיס 4 לשוניות:
  1. סקירה: תיאור, טריגרים, זרימות, כלים.
  2. קבצים: הקבצים שהסוכן קורא וכותב, כולל תצוגה מקדימה.
  3. חיבורים: ממי הוא מקבל ולמי הוא מעביר.
  4. תוצרים: מה הוא הפיק לאחרונה, עם תצוגה מקדימה וכפתורי "פתח" ו"הצג בתיקייה".
- סטטוס פעילות לכל סוכן לפי git ותאריכי התוצרים: פעיל / שקט / רדום. בניין של סוכן רדום נראה כבוי.
- שני מצבי תצוגה: "עיר" (כל הדרכים יוצאות מהסוכן המנהל) ו"ארכיטקטורה" (קשתות בין סוכנים שמעבירים עבודה זה לזה).
- חבילות מידע קטנות שנעות ברחובות בין הבניינים.

טכני:
- שרת Node מקומי בלי npm install, ו-Three.js מ-CDN.
- השרת מאזין רק ל-localhost, ולא מגיש בשום מצב .env, מפתחות או תיקיות נסתרות.
- כל הקוד בתיקייה אחת (city/) עם README קצר.

לפני שבונים: להראות לי מוקאפ של המסך ולחכות לאישור שלי.

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

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

שלב 3: מאשרים מוקאפ

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

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

שלב 4: מריצים ומחפשים מה לנקות

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

• מי רדום? האם עדיין צריך אותו?

• יש שני סוכנים שעושים את אותו דבר? אפשר למזג.

• יש סוכן שאף אחד לא מעביר לו עבודה? אולי הוא מנותק מהצוות.

מצב ארכיטקטורה ממש עוזר פה. סוכן בלי אף קשת יוצאת או נכנסת הוא בדרך כלל הראשון לבדוק.

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

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

שדרוג: להיכנס לעיר ולתת לסוכנים פקודות

אחרי שהעיר עבדה, רציתי יותר מלהסתכל עליה מלמעלה. רציתי ללכת בה.

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

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

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

הכל רץ אצלכם במחשב, על המנוי של Claude Code, בלי API ובלי שרת חיצוני.

את השדרוג מוסיפים בפרומפט נפרד, אחרי שהעיר הבסיסית עובדת:

העיר עובדת. עכשיו שני שדרוגים:

1. הליכה בעיר
- כפתור "להיכנס לעיר": המצלמה יורדת לגובה הרחוב. הליכה עם גלגלת העכבר או W A S D (לפי e.code, כדי שיעבוד גם במקלדת בעברית), וגרירה כדי להסתכל.
- לכל בניין דלת מוארת ושלט עם שם הסוכן. לחיצה על בניין: הולכים עד הדלת ונכנסים.
- בפנים: חדר בצבע של הסוכן. התוצרים האחרונים שלו תלויים על הקירות (תמונות כתמונות, מסמכים כדף עם הכותרת והשורות הראשונות), והבניין שלו מסתובב כהולוגרמה באמצע. לחיצה על תוצר פותחת תצוגה מקדימה.
- כפתור "סיור מצולם": סרטון של כ-20 שניות שרץ לבד, ממבט העל ועד תוך החדר של אחד הסוכנים, במסך נקי בלי ממשק, לצילום.

2. להפעיל סוכנים מתוך העיר
- כפתור "פקודה ל<הסוכן המנהל>", וכפתור "הפעלה" בכרטיס של כל סוכן. נפתחת קונסולה: מקלידים, או מקליטים בעברית (Web Speech API).
- השרת מריץ את claude -p עם --output-format stream-json (ועם --agent <name> כשמפעילים סוכן בודד), ומזרים את ההתקדמות לדף.
- בזמן ריצה: הבניין של מי שעובד נדלק, כל העברת עבודה בין סוכנים עפה כקשת בין הבניינים, ומעל הבניין מופיעה בועה עם מה שהוא עושה עכשיו. בסוף: התשובה, והקבצים שנוצרו כקישורים.
- אבטחה: כל בקשת POST לשרת דורשת טוקן שנוצר מחדש בכל הפעלה ומוטמע בדף, ובדיקת Origin, כדי שאתר אחר לא יוכל להפעיל סוכנים. כברירת מחדל הסוכנים רצים בלי Bash.
- לפני שמריצים את claude, לנקות משתני סביבה שמתחילים ב-CLAUDE, למקרה שהשרת הופעל מתוך סשן של Claude.

לפני שבונים: להראות לי מוקאפ ולחכות לאישור.

מה כדאי לדעת

• כל פקודה היא ריצה אמיתית של Claude Code, ונספרת במכסת המנוי. לבדיקות הראשונות כדאי לבחור משימה קטנה, למשל שאלה, ולא "תכתוב לי מאמר".

• אם מופיעה שגיאת התחברות, מריצים claude auth login בטרמינל רגיל.

• השורה על משתני הסביבה נראית טכנית, אבל היא חוסכת שעה של חיפוש. אצלי, בלי השורה הזאת, הריצה נכשלה בהתחברות גם כשהייתי מחובר.

ומה הלאה?

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

שתפו צילום מסך של העיר שלכם בקהילה, אני ממש רוצה לראות 👇