ב-2 בפברואר 2025 אנדריי קרפתי (Andrej Karpathy) פרסם ציוץ קצר שהפך תוך חודשים לטרנד הגדול ביותר בעולם הפיתוח: Vibe Coding. הרעיון פשוט - מתארים לבינה מלאכותית מה רוצים בשפה טבעית, והיא כותבת את הקוד. אבל בין הצהרת הכוונה לבין תוכנה שבאמת עובדת, יש פער. את הפער הזה סוגר קובץ אחד קטן וצנוע בעל סיומת md, וברגע שמבינים מה הוא עושה - כל המשחק משתנה.
רוצים לקבל עדכונים בלייב? רוצים מקום בו אתם יכולים להתייעץ עם מומחי AI, לשאול שאלות ולקבל תשובות? רוצים לשמוע על מבצעים והטבות לכלי ה-AI שמשנים את העולם? הצטרפו לקהילות ה-AI שלנו.
אפשר גם להרשם לניוזלטר שלנו
מה זה בכלל קובץ md?
הקיצור md מייצג Markdown - פורמט טקסט פשוט שהומצא ב-2004 על ידי ג'ון גרובר (John Gruber), בלוגר ומפתח, כדי לאפשר כתיבה מעוצבת בלי כל המורכבות של HTML. במקום לכתוב תגיות פתיחה וסגירה, סולמית רגילה לפני שורה הופכת אותה לכותרת, כוכביות הופכות מילים לבולד, ומקפים יוצרים רשימה. הקובץ עצמו הוא טקסט רגיל לחלוטין - אפשר לפתוח אותו בכל עורך, לקרוא אותו ללא תרגום, ולערוך אותו במגע אנושי.
בעולם המפתחים Markdown הפך לשפת התיעוד הסטנדרטית. קובצי README שמסבירים פרויקטים בגיטהאב (GitHub), מדריכי שימוש, הערות פנימיות, וגם חלק מהמסמכים שבינה מלאכותית מקבלת לפני שהיא מתחילה לעבוד - כולם כתובים ב-md. הסיבה פשוטה: המודלים הגדולים מבינים את הפורמט הזה טוב יותר מכל אחר. הוא נקי, מובנה, וקל לפענוח גם לאדם וגם למכונה.
הבעיה שצמחה יחד עם ה-Vibe Coding
כשקרפתי הגדיר את ה-Vibe Coding, הוא דיבר על חוויה משחררת: לראות דברים, להגיד דברים, להריץ דברים, להעתיק ולהדביק - וזה פשוט עובד. בפרויקטים קטנים ובניסויים מהירים, התיאור הזה מדויק. הבעיה מתחילה ברגע שהפרויקט גדל מעבר לקובץ בודד או שני מסכים של קוד.
המודלים הגדולים, גם המתקדמים ביותר, לא זוכרים בין שיחה לשיחה. כל סשן חדש מתחיל מאפס. אתם פותחים את הכלי בבוקר, מבקשים להוסיף פיצ'ר, והכלי לא יודע באיזו שפת תכנות הפרויקט שלכם נכתב, איך קוראים לבדיקות, מה הקונבנציות שאתם מקפידים עליהן, או למה החלטתם שלא להשתמש בספרייה מסוימת. כל הדיון הארוך שניהלתם אתמול נמחק.
התוצאה היא תסכול. מפתחים מצאו את עצמם מתקנים את אותן טעויות שוב ושוב, מסבירים שוב ושוב שהפרויקט משתמש ב-pnpm ולא ב-npm, ושפקודת הבדיקות היא לא הסטנדרטית. כל תיקון נעלם בסיום הסשן. הקוד שנכתב נראה מצוין על פני השטח אבל לא מתאים למבנה הקיים.
איך קובץ md פותר את הכאוס
הפתרון שצמח מהקהילה הוא קובץ md שיושב בתיקיית השורש של הפרויקט. שמו משתנה לפי הכלי - CLAUDE.md אצל קלוד (Claude), AGENTS.md בפורמט שמנסה להפוך לסטנדרט, copilot-instructions.md אצל GitHub Copilot, וקובצי rules אצל קורסור (Cursor) ו-Windsurf. הרעיון זהה בכולם: הכלי קורא את הקובץ הזה אוטומטית בתחילת כל סשן ומטמיע אותו כהקשר קבוע.
מה כותבים בקובץ כזה? את הדברים שהייתם נאלצים להסביר מחדש כל פעם. סטנדרטים של כתיבת קוד, החלטות אדריכליות, ספריות מועדפות, פקודות בדיקה, מבנה הפרויקט, ולפעמים גם רשימה של דברים שאסור לעשות. מפתח שתיאר את החוויה כתב שאחרי 3 חודשים של תיקונים חוזרים על אותם דברים, הוא יצר קובץ של 40 שורות בלבד - והתיקונים פשוט נפסקו.
זה לא נגמר שם. הופיעו וריאנטים נוספים. DESIGN.md הפך לפתרון לבעיית העיצוב - קובץ שמגדיר את שפת העיצוב של הפרויקט, צבעים, טיפוגרפיה, ועקרונות חזותיים, כך שהממשק שהבינה המלאכותית מייצרת לא יראה כמו לוטו ויזואלי. קובצי תוכנית בפורמט md הפכו לדרך לתכנן משימות מורכבות לפני שמתחילים לקודד, כדי שהבינה המלאכותית תעבוד לפי מפה ולא לפי דחפים.
למה זה עובד כל כך טוב?
הסוד הוא שהפורמט עצמו מתאים בדיוק לאופן שבו מודלי שפה חושבים. רשימות, כותרות היררכיות, ובלוקים של דוגמאות - כל אלו מבנים שהמודל אומן עליהם מיליארדי פעמים. כשנותנים לו מסמך md מובנה, הוא לא רק קורא מילים אלא מבין יחסים: מה כותרת ראשית, מה סעיף משנה, מה דוגמה ומה אזהרה.
בנוסף, הפורמט אגנוסטי לכלי. אותו AGENTS.md יכול לשרת את קלוד היום, את Cursor מחר, וכלים חדשים בעתיד. אין צורך ללמוד פורמט חדש לכל מוצר, ואין נעילה לספק מסוים. זה גם אומר שאפשר לשתף קבצי הקשר בין צוותים ובין פרויקטים.
"For persistent instructions — telling Claude Code about your project's coding conventions, which test framework you use, which files should never be modified automatically — create a CLAUDE.md file at the root of your project."
— Claude Code Best Practices, Anthropic Engineering Team
הטעויות שכדאי להימנע מהן
הקובץ הזה הוא לא מקום לדחוס לתוכו את כל התיעוד של הפרויקט. מחקרים שבחנו את האפקטיביות של קבצי הקשר גילו שקובץ ארוך מ-500 שורות מאבד את רוב הערך שלו - המודל פשוט מתעלם מהחלק התחתון. שיפור ממוצע של 4% בהצלחת משימות הושג בקבצים מצומצמים וממוקדים, ואילו קבצים ארוכים ועמומים פעמים רבות הזיקו במקום לעזור.
הכלל הוא לכתוב חוקים ולא תיעוד. במקום להסביר מה הפרויקט עושה, להסביר איך המודל צריך להתנהג. במקום להעתיק את כל ה-API לקובץ, להפנות אליו. במקום שכפול של אותם כללים בקבצי הקשר שונים, להחזיק מקור אמת אחד שכל השאר מצביעים אליו.
מה זה משנה למי שלא מפתח מקצועי?
היופי בקבצי md הוא, שהם לא דורשים רקע של ידע טכני, משמע: מדובר בטקסט שאפשר לפתוח אותם בפנקס הרשימות, לכתוב בעברית או באנגלית, לתאר את עצמכם ואת מה שאתם מצפים לקבל. גם בכלים שאינם כלי קוד טהורים - למשל בקלוד עצמו או במוצרי AI אישיים - קבצי הקשר הם אותו רעיון: מסמך אחד שמסביר מי אתם, מה התפקיד שלכם, ואיך אתם רוצים שהבינה המלאכותית תעבוד אתכם.
ראיון עם קרפתי שנערך לאחרונה בו הוא דיבר על ההתפתחות אחרי Vibe Coding והמעבר ל"Agentic Engineering"
זו אולי הנקודה החשובה ביותר בכל הסיפור הזה. ה-Vibe Coding לא הופך אנשים למפתחים אוטומטית, אך קובץ md פשוט הופך כל מי שיודע לכתוב טקסט לאדם שיודע לנהל בינה מלאכותית. הוא הופך את השיחה החד-פעמית למערכת יחסים. הוא הופך את המקרים המוצלחים האקראיים לתהליך שניתן לחזור עליו.
בסופו של דבר, החזון של "לזרום עם הוויב ולשכוח מהקוד" עובד רק כשמישהו מתעקש לזכור משהו אחר במקום הקוד - את הכוונה, את הסטנדרטים, את האופי של הפרויקט. קובץ ה-md הוא הזיכרון הזה. הוא הקול הקטן והעיקש שמלחש לבינה המלאכותית, בכל שיחה מחדש, מי אתם ומה אתם רוצים באמת.








