דרור משה אהרוני
EN

ארגז הכלים של היוצר העצמאי

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

סדרת Claude Code — מדריך 5 מתוך 5 (סיכום)

בחרו את ריפואי ה-AI שמתאימים לשלב שבו אתם נמצאים

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

איפה המדריך הזה נמצא בסדרה

מדריכים 1 עד 4 כיסו את הבסיס: למה כלי AI לפיתוח הם תשתית ממשית ולא רק השלמה אוטומטית; איך להכין מחשב חדש נקי; איך לבנות סביבת עבודה עם שבע תיקיות וקובץ CLAUDE.md; ואיך לחבר שרתי Composio MCP כדי שהסוכנים יוכלו לגשת לכלים חיצוניים.

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

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

  • 1. למה זה תשתית
  • 2. הכנת מחשב חדש
  • 3. מבנה סביבת עבודה
  • 4. Composio MCP
  • 5. יועץ ריפואים (אתם כאן)

מה זה ריפו ואיך "מתקינים" אותו?

ריפו (repository — מאגר קוד) הוא תיקיית קובצי קוד שמתארחת ב-GitHub. כש"מתקינים ריפו" הכוונה היא: מורידים אותו למחשב ומגדירים אותו כתוסף, שרת MCP, או תיקיית סקילים ש-Claude Code ייקרא מהם.

שיטה 1 — אוטומטית (מומלץ) השתמשו ב-Prompt המוכן שבתחתית הדף. הדביקו אותו ב-Claude Code ותארו מה אתם בונים. Claude Code יבדוק את הפרויקט, ימליץ על ריפואים ספציפיים, ויתקין אותם באישורכם. אתם שולטים בתהליך; לא צריך להכיר את הפקודות.
שיטה 2 — ידנית (כשרוצים להבין מה קורה)
  1. לחצו על שם הריפו (הקישור) לפתיחת GitHub
  2. לחצו על הכפתור הירוק Code והעתיקו את ה-URL
  3. בטרמינל: git clone [URL שהעתקתם]
  4. ספרו ל-Claude Code את הנתיב: "יש לי את הריפו [שם] בנתיב [נתיב]"

לפני שמתקינים — בודקים ארבעה דברים:

README האם מוסבר איזה בעיה הריפו פותר? אם לא מוצאים את ה-workflow שלכם בפסקה הראשונה — לדלג.
תאריך עדכון אחרון ריפואים שלא נגעו בהם 12 חודשים או יותר עלולים לא לעבוד עם גרסאות Claude Code נוכחיות.
מספר issues פתוחים הרבה דיווחים על כשלי התקנה או פיצ'רים חסרים — זה דגל צהוב. כדאי לקרוא כמה לפני ההחלטה.
רישיון לפרויקטים מסחריים — וודאו שהרישיון מתיר את השימוש שלכם. MIT בסדר; חלק מהרישיונות לא.
1 להתחיל קטן, לא מקיף

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

  • כן: כלי workflow אחד שמתאים למשימה הנוכחית
  • לא: התקנת קטלוג כולל לפני שסיפקתם פיצ'ר ראשון
2 גלובלי מול פרויקט — להיות מכוונים

התקנה גלובלית = הכלי זמין בכל פרויקט במחשב. התקנה לפרויקט = הכלי נמצא בתיקיית .claude/ של פרויקט אחד בלבד. כלל ההחלטה: גלובלי רק למה שתשתמשו בו כמעט בכל פרויקט. לפרויקט — כל מה שדומיין-ספציפי. קריאה בלבד — לכל השאר עד שיש סיבה קונקרטית להמשיך.

  • גלובלי: superpowers, hooks אוניברסליים לTDD/review
  • לפרויקט: react-doctor, סקילי אבטחה, MCP ספציפי
  • קריאה בלבד: קטלוגים, מערכות זיכרון (עד שיש צורך אמיתי)
3 לאמת כל workflow

כל משימה שסוכן מסיים צריכה להסתיים בשלב אימות קונקרטי. "נראה נכון לי" — זה לא אימות. לפני שמסמנים משימת סוכן כ"בוצעה", בוחרים אחד מאלה: מריצים בדיקות, מצלמים screenshot של הפיצ'ר הפועל, קוראים את סיכום ה-PR שClaude יצר, או כותבים רשימת סיכונים ידועים.

  • שינוי קוד: להריץ בדיקות, לאשר שאין כשלים חדשים
  • פיצ'ר UI: screenshot של מצב הדפדפן האמיתי
  • נתונים/API: לבדוק פלט אמיתי אחד, לא רק תשובת prompt
  • פעולה מסוכנת: לכתוב רשימת סיכונים קצרה, ואז להמשיך

להתאים ריפו לשלב, לא לרמת מיומנות

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

שלב מה קורה מה להתקין מה להתעלם
מחשב חדש עדיין אין פרויקטים. מגדירים את הסביבה הבסיסית. superpowers, anthropics/skills (כרפרנס) הכל השאר. ברצינות.
פרויקט חדש מתחילים עבודה מ-PRD או SPEC. ה-commit הראשון עומד לקרות. superpowers, 1–2 סקילים ספציפיים מ-agent-skills או subagents זיכרון, אוטומציה בדפדפן, פלטפורמות שלמות
אמצע פרויקט יש פיצ'רים. bugs, איכות וביצועים הם הדאגה הנוכחית. react-doctor (אם React), promptfoo (אם צריך יציבות בפלטי AI), סקילי אבטחה (לפני פרסום) מערכות זיכרון, פלטפורמות סוכנים
מתקדם / מוצר AI המוצר עצמו כולל סוכנים, או שבונים תשתית AI. promptfoo לevals, agentmemory או cognee אם סוכנים צריכים state, VoltAgent או OpenHands לאורקסטרציה אין הגבלות, אבל להתחיל ב-sandbox

בחרו את השלב הנוכחי שלכם — התמקדו בשורה שלו. חזרו לשורות האחרות כשהמצב משתנה.

קטלוג ריפואים

השתמשו בכפתורי השלב למעלה או בלוח היועץ לסינון. ריפואי זיכרון מופיעים רק בשלב המתקדם — הם לא רלוונטיים עד שלסוכנים יש צורך אמיתי ב-state מתמיד בין sessions.

Prompt מוכן להעתקה

הדביקו את ה-Prompt הזה ב-Claude Code כדי לקבל תוכנית התקנה מותאמת לפרויקט ולמצב שלכם. מלאו את החלקים בסוגריים לפני השליחה.

I already have Claude Code installed and my workspace set up.
Help me choose the smallest useful agent repo setup for my current situation.

My situation: [תארו מה אתם בונים או איזו בעיה אתם פותרים]
My technical comfort: [beginner / comfortable with terminal / advanced]
Current stage: [new machine / new project / mid-project / building an AI product]

Please inspect my project context, then tell me:
1. Which workflow stage I am in (and whether my self-assessment matches)
2. Which repos or skills are worth installing right now
3. Which ones I should skip for now and why
4. For each recommendation: should it be global or project-level, and why
5. How we will verify each part of the setup after installation

Do not install anything before explaining the reason and asking for my approval.
Flag any repo that may conflict with existing tools in my setup.

מילון מונחים

מונחים שמופיעים במדריך הזה ובREADMEs של ריפואים. הגדרות inline מופיעות לאורך הטקסט; הסעיף הזה אוסף אותן לסריקה מהירה.

TDD (פיתוח מונחה-בדיקות) — כותבים בדיקות אוטומטיות לפני שכותבים את הקוד שיגרום להן לעבור. ריפואים כמו superpowers בונים את הדפוס הזה לתוך ה-workflow של הסוכן כך שיקרה אוטומטית.
Hooks — קוד שרץ אוטומטית לפני או אחרי אירוע ספציפי. ב-Claude Code, hooks יכולים להיות מופעלים לפני שמירת קובץ, לפני commit, או אחרי קריאה לכלי. הם אוכפים כללים בלי שצריך לזכור ליישם אותם.
Evals (הערכות) — בדיקות אוטומטיות לאיכות פלטי AI. כמו שunit tests בודקות אם הקוד רץ נכון, evals בודקות אם תשובת LLM עומדת ברף איכות מסוים. promptfoo הוא כלי ה-evals העיקרי בקטלוג הזה.
Sandbox — סביבה מבודלת שבה Claude Code עובד בלי לפגוע בקבצים האמיתיים או במערכות הקיימות. השתמשו ב-sandbox כשמעריכים ריפואים לא מוכרים או מריצים פעולות הרסניות בפעם הראשונה.
Subagent (סוכן-משנה) — סוכן Claude Code מיוחד שמוגדר לתפקיד אחד ספציפי (למשל: "בודק אבטחה", "כותב תיעוד"). subagents מקבלים משימה ומחזירים תוצאה, במקום לנהל את כל הפרויקט.
MCP (Model Context Protocol) — התקן שמאפשר ל-Claude Code להתחבר לכלים חיצוניים: בסיסי נתונים, APIs, דפדפנים, מערכות קבצים, יומנים ועוד. שרתי MCP נכוסו במדריך 4.
Skill / Plugin (סקיל / תוסף) — ערכת הוראות ארוזה ש-Claude Code טוען כדי לרכוש יכולת. סקילים מוגדרים בהיקף (גלובלי או לפרויקט) וניתן להתקינם, להסירם, או להשתמש בהם כרפרנס בלבד.
Workflow (זרימת עבודה) — רצף חוזר של פעולות סוכן: תכנון, כתיבת קוד, בדיקות, review, אימות, שחרור. ריפואי workflow טובים נותנים לסוכן את אותו מבנה שמהנדס בכיר ינהג לפיו אוטומטית.

הצעד הבא: להתקין בבטחה עם אשף ה-onboarding

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

W

סקיל agent-onboarding-wizard

הצעד הטבעי הבא. הסקיל הזה מדריך אתכם בהתקנה בטוחה: הוא בודק אם כל ריפו שייך גלובלי או לפרויקט, שואל את השאלות הנכונות לפני אישור שינויים, ומריץ שלב אימות אחרי כל התקנה. התחילו אותו על ידי הקלדת /agent-onboarding-wizard ב-Claude Code.

N

סקיל new-project-from-prd (אופציונלי)

אם הערכת הריפואים גרמה לכם להבין שאתם רוצים להתחיל פרויקט חדש לגמרי — הסקיל /new-project-from-prd בונה פרויקט שלם מ-PRD, תוך שימוש במבנה סביבת העבודה ממדריך 3 כבסיס.