fitcon × AI Workflow · אסמכתא

📖 מילון מונחים

כל המונחים של ה-workflow, בעברית אחידה. השתמשו במונחים האלה גם בצ'אט עם האייג'נט — שפה אחידה = תקשורת ללא טעויות.

🌍 Git ו-GitHub

ריפו (Repository): התיקייה של הפרויקט ובנו כל ההיסטוריה, מסונכרנת בין המחשב שלך ל-GitHub. אל תגיד: "הפרויקט", "התיקייה"
main: הגרסה הרשמית והיציבה של הפרויקט. מה שמפורסם. לא עובדים עליה ישירות.
Branch / ענף: חדר עבודה פרטי — עותק של main למשימה אחת, שאף אחד לא רואה עד שמוכנים. אל תגיד: "עותק", "גרסה"
Commit: תמונת מצב שמורה של השינויים, עם תיאור קצר. האייג'נט עושה אוטומטית.
Push / Pull: העלאת commits ל-GitHub (push) / הורדת מה שחדש מ-GitHub (pull).
PR (Pull Request): בקשה לאשר את מיזוג הענף ל-main — דף שיחה שבו השותף סוקר, מגיב ומאשר.
Review / סקירה: בדיקת ה-PR על ידי השותף לפני המיזוג: Approve = אישור, Request changes = "תקנו".
Merge / מיזוג: הרגע שבו השינויים נכנסים רשמית ל-main. רק אחרי אישור השותף.
קונפליקט: מצב שבו שני ענפים שינו את אותן שורות ו-Git לא יודע לבד איזו גרסה נכונה. נפתר בהחלטה אנושית — דרך האייג'נט.

Issue / טיקט: כרטיס עבודה אחד ב-GitHub Issues: מה לבנות, קריטריוני קבלה, ומי חוסם אותו.
Spec: מסמך העיצוב המוסכם של תכונה: בעיה, פתרון, סיפורי משתמש, החלטות, ומה מחוץ לתחום. מפורסם כ-issue.
Grill: תהליך שבו האייג'נט מראיין אותך על הרעיון, שאלה־שאלה, עד שהעיצוב חד. "לא יודע" היא תשובה חוקית. אל תגיד: "ראיון", "בחינה"
Ticket / משימה: חתיכת עבודה אחת מקצה לקצה — כזו שאחריה יש משהו עובד להראות. מפוצלת מ-spec.
Blocked by / חוסם: טיקט אחר שחייב להיסגר לפני שאפשר להתחיל את הזה. בונים על בסיס קיים, לא על אוויר.
Frontier: קו החזית: הטיקטים שכל החוסמים שלהם כבר נסגרו — משם בוחרים את המשימה הבאה. אל תגיד: "הרשימה", "התור"

needs-triage: רעיון שממתין לדיון או grill — עוד לא ברור מספיק לביצוע.
needs-info: חסר מידע ממישהו; עד שיענו, הטיקט קפוא.
ready-for-agent: הירוק 🟢 — מוגדר מלא ומוכן לביצוע על ידי AI. זה מה שאנחנו רוצים לראות.
ready-for-human: דורש בן אדם: החלטה, גישה חיצונית, בדיקה פיזית.
wontfix: הוחלט לא לעשות. נסגר ונשכח.

אייג'נט / Agent: העוזר ה-AI שמבצע: קורא, כותב קוד, מריץ Git ופקודות. אתה מנהל — הוא מבצע.
Claude Code: הארנס (harness) של Anthropic לדיבור עם אייג'נט על הפרויקט; תומך slash skills מובנים (/grill-with-docs וכו').
Antigravity: הארנס של Google/Gemini לעבודה דומה. אותם משפטים עובדים גם שם כטקסט חופשי.
Skill / slash skill: "כישרון" מוכן — תהליך עבודה שלם שמריצים בפקודה כמו /to-spec. מ-Matt Pocock's skills.
TDD: Test-Driven Development: קודם טסט שמתאר את ההתנהגות (נכשל), אחר כך קוד שמעביר אותו. מוכיח שלא שברנו כלום.

מפה (Wayfinder Map): issue אחד עם התווית wayfinder:map: יעד, החלטות שהתקבלו, וערפל — לרעיונות גדולים מדי לspec. אינדקס, לא מחסן. אל תגיד: "התוכנית", "האפיק"
יעד (Destination): איך נראה הסוף של המפה — spec, החלטה נעולה או שינוי. מה שקובע מה בתחום.
טיקט החלטה: sub-issue שכולו שאלה שפתרונה החלטה, לא קוד. טיקט אחד לכל שיחת אייג'נט.
ערפל (Fog of war): שאלות שבדרך אבל עוד לא ניתן לנסח בחדות; חיות ב"Not yet specified" ומתגייסות לטיקטים כשהחזית מתקרבת. אל תגיד: "באגים נסתרים"
Claim / תביעה: assign על טיקט לפני עבודה — כך שיחות מקבילות (של השותף!) מדלגות עליו.
סוגי טיקטים במפה: research — עובדה מבחוץ; האייג'נט לבד ברקע · prototype — משהו מוחשי זול להגיב עליו · grilling — שיחה, ברירת המחדל · task — עשייה שחוסמת החלטה (חשבון, גישה, נתונים).
"לתכנן, לא לעשות": עיקרון המפה: טיקט מכריע, לא בונה. כשאפס שאלות פתוחות — המפה נגמרת ועוברים ל-grill/spec/tickets רגילים.

❓ מונח שחסר או מבלבל? תשאל את האייג'נט: "תסביר את המונח X עם דוגמה מ-fitcon."