קוד ספגטי מ-AI? כך כותבים קובץ כללים שמחזיק את הפרויקט מסודר (CLAUDE.md ו-Cursor)

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

בקצרה: ברשתות מסתובב פרומפט שאומר ל-AI "תתנהג כארכיטקט תוכנה בכיר", לפצל את הקוד לקבצים קטנים ולהציג מבנה תיקיות לפני שהוא כותב. הכיוון נכון, אבל כללים כלליים כאלה עובדים רק חלקית. מה שבאמת מחזיק פרויקט מסודר לאורך זמן הוא קובץ כללים קבוע בפרויקט (CLAUDE.md ב-Claude Code, או כללים ב-Cursor), עם הוראות קונקרטיות שמתאימות לפרויקט שלכם, יחד עם הרגל אחד: תכנון לפני קוד. במדריך תמצאו תבנית מוכנה בעברית, איפה שמים אותה בכל כלי, ואת הטעויות שהופכות את הקובץ לחסר תועלת. (נבדק מול התיעוד הרשמי של Claude Code ו-Cursor ב-8.11.2026.)

למה AI כותב קוד ספגטי

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

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

הפרומפט שמסתובב ברשת: מה טוב בו ומה חסר

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

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

מה חסר:

  • "תתנהג כארכיטקט בכיר" כמעט לא משנה כלום. המודל לא יודע יותר כשקוראים לו בכיר. מה שמשנה זה מידע: איזה פרויקט, איזו טכנולוגיה, איפה כל דבר יושב.
  • כללים כלליים מתפרשים בחופשיות. "פונקציות קטנות" זה כמה שורות? בתיעוד של Claude Code יש דוגמה טובה: "Use 2-space indentation" עדיף על "Format code properly". אותו דבר כאן: "קובץ לא עובר 300 שורות" עדיף על "אל תכתוב קבצים גדולים".
  • אין בדיקות. קוד מסודר שלא עובד הוא עדיין קוד שלא עובד. חסרה הוראה להריץ בדיקות לפני שמסיימים.
  • פיצול יתר הוא בעיה לא פחות גדולה. באפליקציה קטנה, עשרים קבצים של עשר שורות זה סדר מדומה. כדאי לבקש פיצול כשיש סיבה, לא תמיד.
  • פרומפט בצ'אט נשכח. הדבקה בתחילת שיחה עובדת רק לאותה שיחה. בשיחה הבאה מתחילים מאפס.

הפתרון: קובץ כללים קבוע בפרויקט

כל כלי פיתוח עם AI מאפשר היום לשמור הוראות שנטענות אוטומטית בכל שיחה:

כליאיפה שמים את הכלליםהערות
Claude Codeקובץ CLAUDE.md בתיקייה הראשית של הפרויקטנקרא בתחילת כל שיחה. הפקודה /init יוצרת קובץ התחלתי מתוך הקוד הקיים
Cursorתיקיית .cursor/rules, קבצים עם סיומת .mdcקובץ עם סיומת .md רגילה בתיקייה הזו לא נקרא. אפשר לבחור אם הכלל חל תמיד או רק על קבצים מסוימים
כמה כלים יחדקובץ AGENTS.md בתיקייה הראשיתCursor קורא אותו, ו-Claude Code יודע להשתמש בו כשאין CLAUDE.md
Claude באתר או באפליקציהProject, ובו הוראות לפרויקט (Project Instructions)מתאים כשעובדים בצ'אט ומעתיקים קוד ידנית

שני כללי אצבע מהתיעוד הרשמי: ב-Claude Code מומלץ שהקובץ יהיה קצר מ-200 שורות, כי קובץ ארוך מדי נקרא פחות טוב. ב-Cursor ההמלצה היא עד 500 שורות לכלל, ולפצל כללים גדולים לכמה קטנים.

תבנית מוכנה: CLAUDE.md נגד קוד ספגטי

מעתיקים לקובץ CLAUDE.md בתיקייה הראשית של הפרויקט (או לקובץ .mdc ב-Cursor), ומשנים את מה שבסוגריים מרובעים. אפשר לכתוב אותו בעברית, המודלים מבינים מצוין.

# [שם הפרויקט]

## מה זה
[משפט אחד: מה האפליקציה עושה ולמי.]
טכנולוגיה: [למשל React + TypeScript, שרת Node, מסד Postgres].

## מבנה התיקיות
- src/components: רכיבי ממשק בלבד. בלי קריאות לשרת ובלי לוגיקה עסקית.
- src/services: כל הקריאות לשרת ול-API החיצוניים. רק מכאן.
- src/lib: לוגיקה עסקית ופונקציות עזר, בלי תלות בממשק.
- tests: בדיקות, באותו מבנה של src.

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

## תהליך עבודה
- שינוי שנוגע ביותר משני קבצים: קודם הצג תוכנית קצרה (אילו קבצים, מה משתנה) וחכה לאישור.
- אל תוסיף ספרייה חדשה בלי לשאול ולהסביר למה.
- בסוף כל שינוי הרץ [פקודת הבדיקות, למשל npm test] ותקן עד שהכול עובר.
- אל תיגע בקבצי .env ובסודות, ואל תכתוב מפתחות בקוד.

## פקודות
- התקנה: [npm install]
- הרצה: [npm run dev]
- בדיקות: [npm test]

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

ההרגל שעושה את רוב העבודה: תכנון לפני קוד

הקובץ נותן הקשר, אבל ההבדל הגדול מגיע מהרגל אחד: לא לתת ל-AI לכתוב קוד לפני שראיתם את התוכנית. ב-Claude Code יש לזה מצב מיוחד, Plan Mode: עוברים אליו בלחיצה על Shift+Tab, ובמצב הזה Claude חוקר את הקוד ומציע תוכנית בלי לשנות אף קובץ. בכלים אחרים פשוט כותבים בתחילת הבקשה:

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

אם התוכנית אומרת "אוסיף 200 שורות ל-App.js", זה הרגע לעצור ולבקש אחרת. זה זול בהרבה מלתקן אחר כך.

פרומפט משופר להדבקה בצ'אט

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

אנחנו בונים יחד [תיאור האפליקציה] ב-[טכנולוגיה]. לפני שאתה כותב קוד:
1. שאל אותי עד 5 שאלות שחסרות לך כדי להחליט על המבנה.
2. הצע מבנה תיקיות קצר: מה יושב בכל תיקייה ולמה. הפרד בין ממשק, לוגיקה עסקית וקריאות לשרת.
3. חכה לאישור.
אחרי זה, בכל שינוי: השתמש בקוד שכבר קיים לפני שאתה כותב חדש, שמור כל קובץ מתחת ל-300 שורות, ובסוף כתוב לי אילו קבצים שינית ואיך בודקים שזה עובד.

5 טעויות שהופכות את קובץ הכללים לחסר תועלת

  • קובץ ארוך מדי. כל כלל נוסף מחליש את האחרים. אם הקובץ עבר 200 שורות, מעבירים הוראות שחלות רק על חלק מהפרויקט לכללים נפרדים (ב-Claude Code בתיקייה .claude/rules, וב-Cursor כללים שחלים על קבצים מסוימים).
  • כללים שסותרים זה את זה. "תמיד קבצים קטנים" ו"אל תפצל סתם" בלי הגדרה מתי, יגרמו למודל לבחור באקראי. התיעוד של Claude Code ממליץ לעבור על הקבצים מדי פעם ולנקות סתירות.
  • משאלות במקום הוראות. "קוד נקי ויפה" לא אומר כלום. "קובץ עד 300 שורות" אומר.
  • לסמוך על הקובץ בדברים קריטיים. CLAUDE.md הוא הקשר, לא חסימה. לפי התיעוד, מה שאסור שיקרה בשום מקרה (למשל מחיקה של תיקייה מסוימת) חוסמים בהגדרות או ב-hook, לא רק בקובץ.
  • לכתוב פעם אחת ולשכוח. כש-AI חוזר על אותה טעות פעמיים, מוסיפים שורה לקובץ. ככה הוא משתפר עם הפרויקט.

שאלות נפוצות

אני לא מתכנת. זה רלוונטי אליי?

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

הפרויקט כבר מבולגן. מה עושים?

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

מה ההבדל בין CLAUDE.md לסקילים?

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

אפשר להשתמש באותו קובץ ב-Claude Code וב-Cursor?

כן, דרך AGENTS.md, ששני הכלים יודעים לקרוא. מי שעובד בעיקר עם Claude Code יכול גם להשאיר CLAUDE.md ולהפנות ממנו לקובץ המשותף.

גילוי נאות: המדריך נכתב בעזרת AI ונבדק על ידי הצוות מול התיעוד הרשמי של Claude Code ושל Cursor ב-8.11.2026. התבנית מבוססת על הכללים שאנחנו עצמנו עובדים לפיהם בבניית האתר. אין לנו קשר מסחרי ל-Anthropic או ל-Cursor.

כלים דומים לאלה שהוזכרו כאן: חלופות ל-Claude Code · חלופות ל-Cursor · חלופות ל-Claude

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

העמוד עזר לך?

מצאתם טעות או מידע שהתיישן? ספרו לנו

עוד מדריכים

לכל המדריכים

תגובות

הוסיפו תגובה

עדיין אין תגובות למאמר זה. היו הראשונים להגיב!