דילוג לתוכן
חן פלדמןLEAD BY NATURE
לכל הפוסטים
· Claude Code

איך מגייסים sub-agent ראשון לצוות, ולמה "המודל מספיק טוב" זו רק חצי תשובה

מלווה ארגונים וחברות במעבר ל-AI - מאסטרטגיה ועד יישום בשטח.

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

"המודלים החדשים כבר יודעים לשלוח sub-agents לבד. בשביל מה לייצר משלנו? המודל מספיק טוב."

את המשפט הזה אני שומע הרבה. ומי שאומר אותו חצי צודק.

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

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

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

"המודל כבר עושה את זה לבד, לא?"

כן. Anthropic כותבת את זה בעצמה: קלוד מאציל עבודה ל-sub-agents כשהוא רואה סיבה, ולרוב לא צריך לבקש. חיפוש רחב בקוד הולך ל-agent מובנה בשם Explore. משימות צד רצות ברקע בזמן שהשיחה שלכם ממשיכה.

אם אתם עובדים עם קלוד קוד, זה כבר רץ אצלכם.

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

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

ועוד שני דברים מהתיעוד, שהספקנים צודקים בהם:

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

אז אם זה לא חכם יותר, למה לבנות משלכם?

"אז מה המודל לא יכול לעשות לבד?"

המודל יודע מתי להאציל. הוא לא יודע מה שלא כתוב ב-repo, והוא לא יכול לאכוף גבולות על עצמו.

ה-agents המובנים הם כמו מהנדס מוכשר מצוות אחר שנכנס לכתוב קוד ב-repo שלכם. הוא יודע לעבוד. אין לו תפקיד מוגדר אצלכם, והוא לא צבר אצלכם ניסיון. Explore ו-Plan אפילו לא קוראים את ה-CLAUDE.md שלכם.

custom agent הוא אותו מהנדס, אחרי שהגדרתם לו תפקיד:

בצוותב-agentמה זה נותן
הגדרת תפקידdescriptionקלוד יודע מתי לפנות אליו
הרשאות גישהtoolsreviewer שלא יכול לערוך קוד. הכלי אוכף את זה, זו לא בקשה בפרומפט
מה המשימה דורשתmodelמיון של אלף שורות לוג דורש מהירות ונפח. החלטת design דורשת עומק ושיקול דעת
אונבורדינגskillsהנהלים שלכם נטענים אצלו מראש
ניסיון שנצברmemoryזוכר מה למד בריצות קודמות
ידע ששייך לצוות ולא לאדם אחדקובץ ב-.claude/agents/נכנס ל-git, וכל הצוות עובד עם אותו agent

שום דבר בטבלה לא תלוי בכמה המודל חכם. אלה החלטות שלכם.

"יש לי כבר skills. מה ההבדל?"

skill הוא נוהל עבודה. sub-agent הוא עובד.

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

הם גם עובדים יחד. agent יכול לקבל skills כחלק מהאונבורדינג שלו, ו-skill יכול לרוץ בתוך sub-agent, עם context: fork.

"מתי שווה לי לגייס?"

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

ארבעה סימנים שיש כאן תפקיד:

  1. פלט ארוך שלא תחזרו אליו. הרצת טסטים מלאה, חיפוש רחב, לוגים.
  2. צריך עין שלא הייתה בחדר. reviewer שלא ראה איך הקוד נכתב לא מושפע מההסבר שהוביל אליו.
  3. המשימה צריכה פחות הרשאות מכם. מי שרק בודק לא צריך יכולת לערוך.
  4. עבודה שאפשר לפצל. חלקים שלא תלויים זה בזה יכולים לרוץ במקביל, כל אחד אצל sub-agent משלו, בזמן שהשיחה שלכם ממשיכה. קלוד מריץ עד 20 כאלה בו זמנית כברירת מחדל. המחיר: כל אחד צורך טוקנים משלו, אז בקשו סיכומים קצרים.

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

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

"זה מסובך לבנות?"

לא. זו שיחה עם קלוד, כמו כמעט כל דבר אחר.

prompt
צור sub-agent בשם reviewer בתיקייה ⁦.claude/agents/⁩ של הפרויקט.
התפקיד: לבדוק קוד שהשתנה מול ה-spec שלפיו הוא נבנה, לפני פתיחת PR.
הרשאות: קריאה בלבד (Read, Grep, Glob). הוא שופט, לא מתקן.
פלט: רק פערים שמשפיעים על נכונות, עד 30 שורות. בלי הערות סגנון.
הראה לי את הקובץ לפני שאתה שומר.

מה שתקבלו הוא קובץ markdown אחד. שווה להכיר אותו, כי אותו תערכו אחר כך:

markdown
---
name: reviewer
description: Reviews changed files against the spec they were built from. Use after implementing a feature, before opening a PR.
tools: Read, Grep, Glob
---
You are reviewing code you did not write.
Compare the changed files to the spec you are given.
Report only gaps that affect correctness, in 30 lines or less. Skip style.

רק name ו-description הם חובה. הטקסט שמתחת הוא ה-system prompt של ה-agent. אין כאן שורת model, אז הוא עובד עם המודל של הסשן.

שלושה תפקידים ראשונים ששווה לשקול:

  • reviewer - קריאה בלבד, בודק מול spec.
  • test-runner - מריץ את הטסטים ומחזיר רק את מה שנכשל. כאן model: haiku מספיק.
  • log-investigator - קריאה בלבד, דוח קצר, ובסופו רשימת "חוטים פתוחים". כל "עוד דבר אחד ששווה לבדוק" חוזר כמועמד לריצה נפרדת, במקום לגרור את הסשן הראשי.

בדקו שזה עבד: כתבו "use the reviewer agent on the last change", וודאו שחוזר אליכם סיכום קצר ולא כל מה שהוא קרא.

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

"בניתי, והוא לא עובד כמו שציפיתי"

שתי תקלות חוזרות.

קלוד לא פונה אליו. בדרך כלל הגדרת התפקיד מעורפלת. "Helps with code" לא אומר לקלוד כלום. כתבו ב-description מתי להשתמש ב-agent. וכשזה חשוב, אל תסמכו על ההאצלה האוטומטית: קראו לו בשמו, במשפט רגיל או עם @agent-reviewer.

הוא עובד, אבל התוצאה מגיעה מאוחר מדי. את זה למדתי על עצמי.

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

זה לא היה באג. sub-agents רצים כברירת מחדל ברקע, והתוצאה שלהם מגיעה בתור מאוחר יותר.

שלושה תיקונים סגרו את זה:

  1. הלולאה מחכה לבודק לפני שהיא ממשיכה.
  2. "סיום" הוא שורה מילולית שרק הבודק מדפיס: VERDICT: NO WEAK TESTS.
  3. ללולאה אסור להכריז על סיום בעצמה, ויש תקרה של 10 תורות.

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

"זה לא יעלה לי יותר?"

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

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

איך מוזילים:

  • model: haiku לתפקידים פשוטים, כמו איסוף קבצים או הרצת טסטים.
  • לבקש סיכום קצר בחזרה. עשרים דוחות ארוכים ימלאו את השיחה בכל מקרה.
  • /usage מראה כמה צורך כל סוג agent (בתוכניות Pro, Max, Team ו-Enterprise). שם רואים מי מצדיק את המחיר שלו.

"ואיך זה נראה ברמת צוות וארגון?"

למי שמנהל קבוצה, יש כאן שלושה מנופים:

  • סיכון. tools הוא גבול שהכלי אוכף. agent לקריאה בלבד לא יערוך קוד, גם אם הפרומפט השתבש. על ההבדל בין בקשה לאכיפה כתבתי בפוסט על guardrails.
  • עלות. מודל לכל תפקיד, ו-/usage כדי לראות לאן זה הולך.
  • סקייל. קובץ ב-.claude/agents/ נכנס ל-git ומשרת את כל הצוות. ברמת הארגון אפשר להפיץ agents דרך managed settings, או לארוז אותם כ-plugin לכמה repos. למה כדאי להתחיל ברמת הצוות, כתבתי בפוסט על harness צוותי.

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

מאיפה מתחילים: הסשן הכי כואב שכבר עשיתם

לא צריך לדמיין agent. ה-spec שלו כבר קיים, בסשן הארוך האחרון שלכם.

פתחו סשן ארוך שהסתיים, חקירת production למשל, ושאלו אותו:

prompt
אילו פיצלת את העבודה בסשן הזה ל-sub-agents, אילו שניים או שלושה היו תורמים הכי הרבה, ובאיזה חלק?

ואז:

  1. בחרו אחד. זה שצרך הכי הרבה והחזיר הכי מעט טקסט. כמעט תמיד אלה הלוגים.
  2. כתבו את התשובה הצפויה לפני ההרצה הראשונה. אחרת לא תדעו אם הוא טוב.
  3. תקנו דבר אחד בכל פעם.
  4. הפיצו לצוות רק אחרי שני מקרים אמיתיים.

הריצו /context לפני ואחרי. ההפרש הוא מה שנשאר מחוץ לסשן הראשי. ואם אתם רוצים לחלץ עוד מהסשנים הישנים, על זה כתבתי בפוסט על session mining.

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

מגייסים sub-agent ראשון: כרטיס הגדרת התפקיד וארבעת השלבים לגיוס הראשון

מקורות והרחבה

התיעוד והבלוג של Anthropic

כותבים נוספים

לעוד מוצרים וסדנאות מבית Lead By Nature

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

לעמוד הבית
וואטסאפלשיחת היכרות