ניהול קבצי MD (Markdown) — הכלי לתיעוד

קבצי .md (Markdown) הם קבצי טקסט פשוטים עם עיצוב מינימלי. הם הבסיס לכל Skills, Rules, ותיעוד. Antigravity יוצר אותם, קורא אותם, ומבין אותם.

מה שחשוב לדעת:

• SKILL.md — קובץ ה-Skill המרכזי, כמוסבר למעלה
• README.md — קובץ שמסביר על הפרויקט. הסוכן קורא אותו כשהוא נכנס לפרויקט חדש
• AGENTS.md (או .agents/rules/*.md) — כללים קבועים
• כל קובץ MD שאתה יוצר בתיקייה .agents/ — הסוכן יכול לקרוא אותו

טיפ: צור קובץ .agents/context.md ובו כתוב בכמה פסקאות את הסיפור של הפרויקט — למי הוא מיועד, מה הערך שהוא נותן, מה ה-MVP. הסוכן שיקרא את זה יבין את ההקשר הרחב ויתן תשובות יותר מתאימות.

מה זה "פרודקשן" ולמה זה שונה ממה שעשית עד עכשיו#

כל מה שבנית עד עכשיו רץ "מקומית" — על המחשב שלך, נגיש רק לך. אתה פותח את Antigravity, הסוכן מריץ שרת מקומי (בדרך כלל בכתובת http://localhost:3000), ואתה רואה את האפליקציה שלך בדפדפן.

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

למה ההבדל משנה:

ב-"localhost" (המחשב שלך) — כל טעות היא שלך. אם הכל נפל — אתה לוחץ refresh ומתחיל מחדש. בפרודקשן — אם משהו נפל, משתמשים אמיתיים רואים דף שגיאה, יורדים ולא חוזרים.

שלוש סביבות שכל מוצר צריך — Dev, Staging, Production#

Development (Dev):

זו הסביבה שבה אתה עובד עם Antigravity. על המחשב שלך. פה מותר (ואפילו כדאי) שדברים יישברו, מותר לנסות דברים חדשים, ואין משתמשים שמושפעים.

Staging:

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

Production:

הגרסה האמיתית שהמשתמשים שלך יראו.

מדוע לא לדלג על Staging? כי פעמים רבות קוד שעבד ב-Dev שובר ב-Production בגלל הבדלי סביבה — משתני סביבה שונים, בסיס נתונים שונה, גרסת Node.js שונה. Staging מגלה את הבעיות האלה לפני שמשתמשים אמיתיים נפגעים.

כיצד לנהל את זה עם Antigravity:

יצור skill בשם environment-management עם הגדרה ברורה של שלוש הסביבות, ה-URLs שלהן, ואיזה משתני סביבה להשתמש בכל אחת.