קוד מקור והתמצאות בפרויקט
בלי src, בלי node_modules
אליס ביקשה מ־AI כלי הזמנות קטן. בתיקייה לא היו src וגם לא node_modules, רק app.py, templates ו־.venv שאמרו לה לא לפתוח. היא חיפשה page.tsx, לא מצאה, וקפאה. בן הדוד אמר: תתחילי מהמילים שעל המסך. שמות התיקיות משתנים, התפקידים לא. אליס עדיין לא ידעה אילו שלוש תיקיות הן שלה.
- קוד מקור הוא טקסט רגיל בקבצים רגילים. אפשר לפתוח ולקרוא כל חלק ממנו.
- הסיומת מציינת את הסוג: .js/.ts, .py, .cs, .css, .html — וגם .json/.yaml/.md להגדרות ולהערות.
- התיקיות שלכם עשויות להיות app/, src/ או שורש הפרויקט — לא לכל אפליקציה יש src/ או node_modules/.
- מצאו תכונה בחיפוש המילים שמופיעות במסך, ואז עקבו אחריה מהמסך ועד לשמירת הנתונים.
מילים על המסך מובילות אל הקוד שמאחוריהן
עשה ואל תעשה
- חפשו בפרויקט את המילים המדויקות שמופיעות במסך.
- קראו את סיומת הקובץ וקובץ שורש אחד לפני שנכנסים לתיקיות.
- בקשו מה־AI לכתוב מפת תיקיות קצרה ב־AGENTS.md.
- אל תערכו חבילות שהורדו או שאריות בנייה, בכל שם תיקייה שהן נמצאות.
- אל תניחו שכל פרויקט משתמש ב־src/ וב־node_modules/.
בדיוק כמו שכתוב
אין שום קסם בקוד מקור, ואפשר לפתוח ולקרוא כל קובץ. המחשב מבצע את הטקסט בדיוק, בלי שיקול דעת. הוא עושה מה שכתוב. מה שהתכוונתם אליו ולא כתבתם הופך להתנהגות שאף אחד לא בחר.
אילו תיקיות הן שלכם
פרויקט נראה ענק כי רובו שייך לאחרים. כמה תיקיות מחזיקות את הקוד שחשוב, מסכים, כלי עזר משותפים ובדיקות, אבל השמות משתנים. חלק מהאפליקציות משתמשות ב־app/ או ב־src/, אחרות שמות את הקוד בשורש. חבילות שהורדו ושאריות של בנייה יושבות בתיקיות שבדרך כלל לא נוגעים בהן (למשל node_modules/, .venv/ של Python, או bin/ אחרי בנייה של C#).
איך מזהים שפה, סוג קובץ והגדרות
האותיות אחרי הנקודה האחרונה אומרות איזה סוג קובץ זה. .js הוא JavaScript, .ts ו־.tsx הם TypeScript, .py הוא Python, .java הוא Java, .cs הוא C#, .css קובע איך העמוד נראה ו־.html את המבנה שלו. חלק מהסיומות הן הגדרות או הערות ולא התוכנית עצמה: .json, .yaml / .yml ו־.toml מחזיקים הגדרות; .env מחזיק סודות (לעולם אל תעשו commit לערכים אמיתיים); .md הוא Markdown, טקסט קריא שמשתמשים בו לקבצי README ולהוראות לסוכן כמו AGENTS.md. גם קבצים בשורש כמו package.json, requirements.txt או .csproj מסגירים את הסטאק. שאלו את ה־AI באיזו שפה הפרויקט כתוב ואיזו פקודה מפעילה אותו.
עקבו אחרי מסלול אחד
לכל פרויקט יש נקודת כניסה, הקובץ הראשון שרץ. כדי למצוא את הקוד שמאחורי מסך, חפשו את המילים המדויקות שכתובות עליו, נגיד Save contact. בקשו מה־AI לכתוב מפה קצרה ב־AGENTS.md, ואז עברו בעצמכם על מסלול אחד.
מפו את הפרויקט שלי בלי להניח שיש בו src/ או node_modules/. מהתיקייה הראשית, רשמו את סיומות הקבצים שאתם רואים ומה כל אחת מרמזת עליה. ציינו אילו תיקיות מכילות את הקוד שלי, ואילו מכילות חבילות שהורדו או שאריות של בנייה. אם יש לי מסך שמירת איש קשר, עקבו אחרי הנתיב שלו.
דוגמה
פתחו את AGENTS.md שלי ובדקו את מפת הפרויקט מול התיקיות האמיתיות. אל תמציאו src/ או node_modules/ אם אין אותן. הוסיפו תיקייה שחסרה, הורידו כזו שכבר לא קיימת, ותוודאו מה נקודת הכניסה. תראו לי את ה־diff לפני השמירה.
הדביקו את ההנחיות לסוכן מתוך תיקיית פרויקט. כשההנחיה אומרת "הפרויקט הזה", הכוונה לאפליקציה שבונים בתרגול או לאפליקציה שכבר יש לכם. עדיין אין פרויקט? קראו עכשיו והדביקו אחר כך, בתרגול.
מפו לי את הפרויקט הזה בלי להניח שיש src/ או node_modules/. רשמו את תיקיות הרמה העליונה, שורה לכל תיקייה, תגידו מהי נקודת הכניסה, וסמנו אילו תיקיות נוצרות אוטומטית ואסור לערוך אותן ביד. שימו את התוצאה ב־AGENTS.md תחת הכותרת Project map.
תראו לי איזו דרך עובר הכפתור Save בדף אנשי הקשר: הקובץ עם הכפתור, הבקשה שהוא שולח, הקובץ שמקבל אותה, והפונקציה ששומרת את הנתונים. רק שמות הקבצים, בלי שום דבר אחר.
לפני שאתם עושים את השינוי הזה, רשמו כל קובץ שאתם מתכוונים לגעת בו ולאיזה חלק במפת הפרויקט הוא שייך. אם קובץ נמצא מחוץ למפה, עצרו והסבירו למה.