מדריך קלוד קוד: מה ללמוד קודם, בסדר שעובד

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

המשימה הראשונה צריכה להיות כזו שאתה יודע לעשות לבד

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

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

CLAUDE.md זה ההבדל בין דמו לכלי עבודה

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

• הסטאק בשורה אחת, עם גרסאות: Next.js App Router, Supabase, Tailwind, TypeScript במצב strict.
• הפקודות שמוכיחות שהעבודה גמורה: הבדיקות, ה-type check, ה-lint, ה-build. בשמות המדויקים, לא בתיאור.
• מה כבר קיים בקוד: ה-helper של ההתחברות, הפורמט של התאריכים, ה-client של ה-API. זה לבד מוריד חצי מהכפילויות.
• החוקים שנמאס לך לחזור עליהם: בלי תלות חדשה בלי לשאול, בלי הערות שמסבירות מה שהשורה כבר אומרת, קוד שרת וקוד לקוח נשארים מופרדים.
• מה אסור לגעת בו: דאטה של פרודקשן, מיגרציות שמוחקות עמודות, וכל דבר שנוגע בחיובים לפני שבן אדם קרא אותו.

תן לו פרוסה שלמה, לא מטלה

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

האימות הוא העבודה האמיתית עכשיו

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

מוצר בעברית מחייב חוק אחד נוסף

רוב מה שאני בונה הוא עברית קודם, והסוכנים האלה אומנו על אינטרנט שהוא אנגלית קודם. אם לא תגיד כלום, תקבל ml-4 במקום ms-4, תאריך שנקרא הפוך, ושדה קלט שקופץ לצד הלא נכון ברגע שמישהו מקליד תו לטיני. לכן חוקי ה-RTL יושבים אצלי בתוך CLAUDE.md ולא בראש: רק logical properties, dir על אלמנט ה-html, וכל מחרוזת בעברית עוברת קריאה של בן אדם לפני שהיא עולה. כשבניתי את זרימת הערבויות של ערבויות ישיר, הסעיף הזה בקובץ חסך לי יותר זמן מכל פרומפט חכם, כי אותו סוג של טעות פשוט הפסיק לחזור.

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