$ man how-to/claude-md-vs-agents-md-vs-cursorrules

CLAUDE.md הוא ל-Claude Code. AGENTS.md הוא תקן חוצה-כלים. .cursorrules הוא ל-Cursor IDE. שלושתם משרתים את אותה מטרה: לתת לכלי ה-AI הקשר והוראות ספציפיות לפרויקט כדי שיפיק פלט טוב יותר. ההבדל הוא בהיקף ובפורמט. אם אתה משתמש רק בכלי AI אחד, השתמש בקובץ התצורה של אותו כלי. אם אתה משתמש בכלים מרובים - ורוב המיישמים הרציניים כן - אתה צריך אסטרטגיה לשמור אותם מסונכרנים בלי לשלש את נטל התחזוקה.

PATTERN

CLAUDE.md הוא קובץ התצורה של Anthropic ל-Claude Code. הוא נטען אוטומטית בתחילת סשן ונשאר בהקשר לאורך כל השיחה. מיקום: שורש ה-repo לרמת פרויקט, ~/.claude/CLAUDE.md לגלובלי, ותיקיות פנימיות לרמת מודול. Claude Code ממזג את כל הרמות הרלוונטיות. פורמט: Markdown פשוט. כותרות, תבליטים, בלוקי קוד, טבלאות. לא נדרש תחביר מיוחד. Claude קורא אותו כמו כל מסמך אחר. תכונות ייחודיות: תומך בייבוא @path/to/file שמתרחבים inline. תומך ברמות מרובות (גלובלי, פרויקט, תיקייה). יש פקודת /init ייעודית שמייצרת אוטומטית קובץ התחלתי מה-codebase שלך. הכי טוב ל: מוסכמות קוד, פקודות build/test, כללי בטיחות, ארכיטקטורת פרויקט, שלבי deploy, והוראות התנהגותיות כמו "אף פעם אל תעשה commit לקבצי .env" או "הרץ בדיקות לפני סימון משימה כהושלמה." קובצי CLAUDE.md הטובים ביותר הם מתחת ל-200 שורות. הם משתמשים בהוראות ספציפיות וניתנות לאימות ("השתמש בהזחה של 2 רווחים" לא "פרמט קוד כראוי"). הם מצביעים לקבצים במקום להעתיק תוכן ("ראה docs/ARCHITECTURE.md לדיאגרמת המערכת המלאה" לא הדבקת הדיאגרמה inline).

PATTERN

AGENTS.md הוא תקן פתוח מתהווה שנועד לעבוד על פני כלי קידוד AI - לא רק Claude Code. הוא תוכנן על ידי הקהילה כקובץ תצורה אגנוסטי לכלים. מיקום: שורש ה-repo, דומה ל-CLAUDE.md. פורמט: Markdown עם חלקים מובנים. בדרך כלל כולל: תיאור פרויקט, סקירת ארכיטקטורה, תקני קוד, הוראות בדיקה, ותצורות ספציפיות לכלים. פילוסופיה: כתוב את ההוראות פעם אחת, כל כלי AI יקרא אותן. במקום לתחזק קבצים נפרדים ל-Claude Code, Cursor, Copilot ו-Windsurf, תחזק AGENTS.md אחד ותן לכל כלי לפרסר אותו. בדיקת מציאות: האימוץ עדיין מוקדם. Claude Code קורא CLAUDE.md באופן מקורי. Cursor קורא .cursorrules באופן מקורי. תמיכת AGENTS.md משתנה. חלק מהכלים מכבדים אותו, אחרים מתעלמים ממנו. התקן מבטיח אבל עדיין לא אוניברסלי. הכי טוב ל: צוותים שמשתמשים בכלי AI מרובים ורוצים מקור אמת יחיד להוראות פרויקט.

PATTERN

.cursorrules הוא קובץ ההוראות ברמת פרויקט של Cursor IDE. הוא נטען כשאתה פותח פרויקט ב-Cursor. מיקום: שורש ה-repo כ-.cursorrules (קובץ בודד) או תיקיית .cursor/rules/ למספר קבצי כללים עם תבניות glob. פורמט: טקסט פשוט או Markdown. גישת .cursor/rules/ משתמשת בקבצי .mdc עם frontmatter של YAML שמציין אילו תבניות קבצים מפעילות את הכלל. תכונות ייחודיות: הפעלת כללים מבוססת glob (כללים נטענים רק כשאתה עורך קבצים תואמים), כללים לפי דרישת הסוכן שנטענים לפי הצורך, ושילוב עם מצבי composer וצ'אט של Cursor. הכי טוב ל: תהליכי עבודה ספציפיים ל-Cursor, כללים מבוססי תבנית קובץ (טען מוסכמות TypeScript רק בעריכת קבצי .ts), וצוותים שמתקנים על Cursor כ-IDE שלהם. מגבלה: .cursorrules עובד רק ב-Cursor. אם מישהו בצוות שלך משתמש בכלי אחר, הוא לא מפיק תועלת מהקבצים האלה.

PRO TIP

תחזוקת שלושה קובצי תצורה נפרדים עם אותו מידע היא סיוט תחזוקה. הנה הגישה שעובדת: CLAUDE.md הוא התצורה העיקרית שלך. הוא המפורט ביותר כי Claude Code הוא בעל היכולת הגבוהה ביותר בביצוע הוראות מורכבות ורב-שלביות. כתוב את ההקשר המלא של הפרויקט, המוסכמות ותהליכי העבודה כאן. AGENTS.md הוא הפניה צולבת מפושטת. קשר ל-CLAUDE.md לפרטים. כלול רק את ההוראות האוניברסליות שכל כלי צריך לעקוב אחריהן: תקני קוד, דרישות בדיקה, סקירת ארכיטקטורה. .cursorrules מטפל בכללים ספציפיים ל-Cursor. הפעלת תבנית קובץ, העדפות עריכה inline, הוראות מצב composer. אל תשכפל מה שכבר ב-CLAUDE.md. המבנה: CLAUDE.md - תצורת פרויקט מלאה (200 שורות) AGENTS.md - תת-קבוצה אוניברסלית + קישורים ל-CLAUDE.md (50 שורות) .cursor/rules/*.mdc - כללי תבנית קובץ ספציפיים ל-Cursor (קבצים לפי כלל) ככה, כשמוסכמות משתנות, אתה מעדכן את CLAUDE.md. AGENTS.md מצביע אליו. .cursorrules מכיל רק התנהגות ספציפית ל-Cursor שלא רלוונטית במקומות אחרים. אם אתה משתמש רק ב-Claude Code: פשוט תחזק CLAUDE.md. דלג על האחרים עד שתצטרך אותם.