fitcon × AI Workflow · שיעור 2 מתוך 3
מרעיון לכרטיסי עבודה:
Grill ← Spec ← Tickets
למה לא פשוט "תבנה לי את זה"?
הדרך הכי גרועה לעבוד עם AI: לפתוח חלון ולכתוב "תוסיף סינון לפי מחיר ב-Marketplace". מה יקרה? האייג'נט ינחש. הוא ינחש איפה הכפתור, איך זה נראה, מה קורה בלי מחיר, ומה עושים עם מאמנים בלי תעריף. לפעמים הניחוש יהיה טוב — ובדרך כלל תגלו על זה רק אחרי שעות.
ובשביל שני שותפים זה גרוע עוד יותר: אין שום מקום אחיד שמתעד מה נאמר, מה הוחלט, ומה כבר נעשה.
✅ הפתרון: שלושה שלבים, שלוש פקודות
במקום לבנות ישר — מחדדים את הרעיון, מפרסמים אותו כ-spec, ומפצלים למשימות. הכל נשמר כ-issues ב-GitHub: מקום אחיד ששניכם וכל האייג'נטים רואים.
שלב 1: 🔥 ה-Grill — תן ל-AI לחקור אותך
ב-Claude Code יש "skills" — כישורים מוכנים שמריצים תהליך שלם. אחד מהם נקרא /grill-with-docs: במקום שתכתוב דוקומנטציה, האייג'נט רואה אותך. הוא שואל אותך שאלות נוקבות — אחד־על־אחד — עד שהרעיון חד כתער, ורושם את ההחלטות במסמכי הפרויקט (CONTEXT.md, ADRs) תוך כדי.
ככה זה נראה עם רעיון אמיתי מ-fitcon:
אתה: "אני רוצה שמתאמנים יוכלו לשתף את פרופיל המאמן שלהם בוואטסאפ."
האייג'נט: "שיתוף של פרופיל ציבורי או של מסך פרטי? האם מי שלא מחובר יוכל לפתוח את הקישור?"
אתה: "רק את הפרופיל הציבורי... וכן, גם בלי התחברות."
האייג'נט: "מה רואים בלי התחברות — גם כפתור 'קבע אימון'? ואם כן, מה קורה בלחיצה כשלא מחוברים?"
אתה: "...שמע, לא חשבתי על זה. תציע משהו ונחליט יחד."
💚 "לא יודע" היא תשובה מצוינת
ה-grill לא בא כדי לבחון אותך — אלא כדי לגלות את השאלות לפני שהקוד נכתב. כשאינך יודע, תגיד "לא יודע, תציע" — והאייג'נט יהפוך את זה להצעה שתאשר או תדחה. שלושים שאלות עכשיו = שבוע תיקונים שנחסך.
שלב 2: 📄 ה-Spec — המסמך המוסכם
כשה-grill מסתיים, מריצים /to-spec. האייג'נט מסכם את מה שכבר אמרת (בלי לשאול שאלות חדשות) למסמך אחד — ה-spec — ומפרסם אותו כ-issue ב-GitHub. המבנה המוסכם:
| חלק ב-spec | מה יש בו |
|---|---|
| בעיה (Problem) | מה מעצבן, מנקודת מבט המשתמש |
| פתרון (Solution) | מה יהיה שונה אחרי העבודה |
| סיפורי משתמש (User Stories) | "כמתאמן, אני רוצה..., כדי ש..." — רשימה ארוכה שמכסה הכל |
| החלטות מימוש | ההחלטות הטכניות שהוסכמו ב-grill |
| מחוץ לתחום (Out of Scope) | מה לא נבנה עכשיו — חשוב לא פחות! |
ה-spec הזה הוא "החוזה": גם אתה, גם השותף, וגם כל אייג'נט שיעבוד על זה — כולם קוראים מאותו מסמך.
שלב 3: 🎫 Tickets — משימות שאפשר לבצע
Spec הוא גדול מדי לביצוע בבת אחת. /to-tickets מפצל אותו לטיקטים — כל טיקט הוא חתיכה אחת שעוברת מקצה לקצה: מסך + לוגיקה + בדיקות, כזו שאחריה אפשר להראות משהו עובד. לכל טיקט יש קריטריוני קבלה ("מה צריך להיות נכון כדי לסגור אותו") ולפעמים — חוסמים.
- 🎫 טיקט 1: כפתור שיתוף + קישור ציבורי לפרופיל מאמן. Blocked by: כלום — מתחילים מיד.
- 🎫 טיקט 2: עמוד פרופיל ציבורי שעובד גם בלי התחברות. Blocked by: טיקט 1.
- 🎫 טיקט 3: הצגת תצוגה מקדימה של הקישור בוואטסאפ. Blocked by: טיקט 2.
🚦 ה-Frontier — משם מתחילים
טיקט שכל החוסמים שלו כבר נסגרו נמצא ב-frontier: קו החזית של העבודה. אל תבחרו טיקטים לפי מה שנחמד לכם — תעבדו על ה-frontier, ואז שניכם תמיד בונים על בסיס קיים ולא על אוויר.
שפת התוויות (labels) של הלוח
| תווית | משמעות |
|---|---|
needs-triage | רעיון שעוד לא ברור — ממתין לדיון/grill |
needs-info | חסר לנו מידע ממישהו — עד שיענו, לא זז |
ready-for-agent | הירוק — מוכן לאייג'נט. מותר ורצוי לתת ל-AI לבצע עכשיו |
ready-for-human | דורש בן אדם (החלטה, גישה חיצונית, בדיקה פיזית) |
wontfix | הוחלט לא לעשות — נסגר |
הפרומפטים של השיעור
1. פתיחת תהליך על רעיון חדש:
יש לי רעיון חדש ל-fitcon: [תכתוב את הרעיון כאן]. בוא נעבור על זה עם grill-with-docs — תשאל אותי את כל השאלות שצריך, שאלה אחת בכל פעם, עד שהעיצוב חד. אני לא זוכר את כל הפרטים הטכניים, אז כשאני לא יודע משהו — תציע הצעה ותבקש ממני לאשר.
2. אחרי שה-grill הסתיים:
מעולה, העיצוב מוסכם אצלי. עכשיו תריץ to-spec: תסכם את מה שהחלטנו לspec ותפרסם אותו כissue בGitHub של fitcon. תן לי את הקישור.
3. פיצול למשימות:
עכשיו תריץ to-tickets על הspec: תפצל לטיקטים עם תלויות ביניהם, תציג לי את הפיצול המוצע לפני פרסום — ואחרי שאני מאשר, תפרסם אותם עם התווית ready-for-agent.
4. "מה עושים היום?" — שאילת ה-frontier:
תבדוק את הissues הפתוחים בfitcon ותן לי את הfrontier: אילו טיקטים ready-for-agent שכל החוסמים שלהם סגורים? תמיין לפי סדר העדיפות שלך עם נימוק קצר לכל אחד.
💡 Claude Code מול Antigravity
ב-Claude Code הפקודות /grill-with-docs, /to-spec, /to-tickets מוכרות כ-slash skills. ב-Antigravity/Gemini פשוט מדביקים את אותם משפטים כטקסט — אותם מילים, אותו תוצאה. אם האייג'נט לא מכיר את השם, הוא יממש את המהות: "תחקור אותי", "תסכם לspec", "תפצל לטיקטים".
בוא נבדוק שהבנת 🔍
חידון — שיעור 2
🎯 תרגיל בית — תהליך מלא על רעיון קטן
- תבחר רעיון קטן ל-fitcon (דוגמה: "כפתור שיתוף פרופיל מאמן"). לא פיצ'ר ענק — משהו שאפשר להסביר במשפט.
- הרץ את פרומפט ה-grill מלמעלה. ענה על השאלות בכנות, כולל "לא יודע, תציע".
- הרץ את
/to-specואז את/to-tickets. תסתכל על הפיצול לפני האישור — ושאל את עצמך: "האם כל טיקט אפשר להסביר במשפט?" - שלח לשותף את הקישורים ל-issues. זה הרגע שבו הוא רואה את התוכנית — בלי שיחת טלפון אחת.
📖 המקור המומלץ להעמקה
mattpocock/skills: ה-repo של מאט פוקוק — שם חיים כל ה-skills שבהם השתמשנו (grill-with-docs, to-spec, to-tickets). שווה קריאה של ה-README כדי לראות את התמונה המלאה מהמקור.
❓ יש שאלה? העתק והדבק בצ'אט עם האייג'נט. למשל: "תסביר שוב מה ההבדל בין spec לטיקט, עם דוגמה מ-fitcon."