[קלוד·LEARN]/כתיבת CLAUDE.md
מבית אנתרופיק ישראל
01 / 14
פיתוח · מודול 53

איך כותבים
CLAUDE.md מצוין.

המבנה, מה לשים ומה להשמיט, ודוגמאות Do/Don't - הקובץ שגורם לקלוד לעבוד כמו מי שמכיר את הקוד.

14 שקופיות  ·  Claude Code  ·  ~9 דקות
העיקרון האחד

הקשר תפעולי,
לא תיעוד.

לפני כל שורה, שאלו: “זה ישנה את מה שקלוד יעשה?”. אם כן - פנימה. אם זה רק מידע נחמד לדעת - החוצה.

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

נקודת הפתיחה

אל תתחילו מדף ריק.

/init

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

מבנה מומלץ

חמש כותרות, לא יותר.

  • ## Project - משפט אחד: מה זה ומה ה-stack.
  • ## Commands - dev, build, test, lint. הפקודה המדויקת.
  • ## Conventions - סגנון, מבנה, דפוסים שחוזרים.
  • ## Architecture - היכן יושב מה, רק אם זה לא מובן מאליו.
  • ## Don't - מה אסור לגעת בו, מלכודות ידועות.
כלל 01 · ספציפי

מדיד, לא מעורפל.

עמום
כתוב קוד נקי ואיכותי. → לקלוד אין מה לעשות עם זה. “נקי” לא אומר כלום.
←
ספציפי
קומפוננטות ב-PascalCase. בלי default export. כל קריאת רשת עוברת דרך src/api/client.ts. → ניתן לבדיקה. קלוד יודע בדיוק מה לעשות.
כלל 02 · קצר

סרוק בשנייה, לא מגילה.

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

סעיף “אל תעשה”.

קלוד טוב בלמלא חוסר ידע בניחושים סבירים. הדרך לעצור ניחוש לא נכון היא לכתוב אותו מראש: “אל תשנה קבצים ב-/generated”, “אל תשתמש ב-any”, “אל תריץ migrations בלי לשאול”.

שורה אחת של “אל תעשה” שווה עשרה תיקונים אחרי.

פקודות

תנו את הפקודה, לא רמז.

## Commands pnpm dev # שרת פיתוח, פורט 3000 pnpm build # חייב לעבור לפני commit pnpm test # Vitest, watch mode pnpm lint # ESLint

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

היררכיה ו-@import

פצלו לפי טווח.

  • אישי בכל מקום - ל-~/.claude/CLAUDE.md (טון, שפה, העדפות שלכם).
  • ספציפי לפרויקט - ל-CLAUDE.md בשורש, נכנס ל-git, משותף לצוות.
  • קובץ ארוך? פצלו ויבאו עם @path/to/file.md - נשאר מודולרי.

על ההיררכיה המתקדמת לעומק - ראו מודול 51.

כלל 03 · אכיף

כלל, לא משאלה.

משאלה
נסה לשמור על ביצועים טובים ככל האפשר. → אין דרך לדעת אם קוים. סתם מילוי מקום.
←
אכיף
רשימות מעל 50 פריטים - תמיד עם וירטואליזציה. בלי fetch בתוך loop. → קונקרטי. אפשר לראות אם הקוד עומד בזה.
תחזוקה

קובץ חי, לא מצבה.

כשמשהו בפרויקט משתנה - עדכנו את הקובץ באותו רגע. CLAUDE.md מיושן גרוע מאין קובץ, כי הוא מטעה בביטחון.

לכלל קריטי שקלוד חייב לכבד, סמנו אותו בפירוש - למשל בשורה שמתחילה ב-# IMPORTANT.

צ'קליסט

לפני שסוגרים - חמש שאלות.

  1. כל שורה משנה מה שקלוד יעשה? (אם לא - למחוק)
  2. הפקודות מדויקות ועובדות כמו שכתוב?
  3. יש סעיף “אל תעשה” עם המלכודות האמיתיות?
  4. הכללים ספציפיים ואכיפים, לא משאלות?
  5. סורקים את כולו בפחות מדקה?
מה לא לעשות

שלוש טעויות נפוצות.

  • להעתיק את ה-README. תיאור שיווקי לא עוזר לקלוד לעבוד. כתבו הוראות.
  • לערום הכל “ליתר ביטחון”. ככל שארוך יותר, כך נקרא פחות. פחות זה יותר.
  • לכתוב פעם ולשכוח. קובץ שלא תואם לקוד שולח את קלוד לכיוון הלא נכון.
המשכים טבעיים

מכאן לרמת ה-power user.

51
Claude Code לעומק

CLAUDE.md היררכי, slash commands, hooks, סוכני משנה.

52
CLAUDE.md - הזיכרון של הפרויקט

המבוא: מה זה ולמה זה משנה את כל השיחה.

ClaudeLearn · סוף מודול 53 · חזרה לקטלוג

→ השתמשו במקשי החצים ←  ·  רווח להמשך