fitcon × AI Workflow · שיעור בונוס
🗺️ Wayfinder:
למצוא את הדרך כשהרעיון ענק ומעורפל
מתי ה-workflow הרגיל לא מספיק?
בשיעור 2 למדת את הזרימה: רעיון ← grill ← spec ← tickets. היא מעולה — כשאפשר לראות את כל הדרך. אבל מה עושים עם רעיון כמו:
🌫️ "בא לנו שיהיו תשלומים דרך הפלטפורמה"
רגע... איזה ספק סליקה? מי מפיק קבלות? איך עובדת עמלה? מה קורה כשחיוב נכשל? מתי הכסף מגיע למאמן? והאם זה חוקי בלי רואה חשבון? אי אפשר לכתוב על זה spec — עוד לא רואים את כל הדרך. זה "ערפל".
לזה יש skill בשם /wayfinder: במקום לרוץ ליעד — ממפים את הדרך אליו, כ-issue אחד גדול ("מפה") וטיקטים של שאלות, ופותרים אותם אחת־אחת עד שהערפל מתפזר.
כלל אצבע: מתי מה?
| המצב | הכלי |
|---|---|
| "בא לי כפתור שיתוף" — אפשר לחדד ביושב־אחד | 🔥 Grill ← 📄 Spec ← 🎫 Tickets (שיעורים 2–3) |
| "בא לנו תשלומים / אפליקציית web / מערכת התאמות AI" — ענק, עם שאלות על שאלות | 🗺️ Wayfinder — קודם ממפים, ורק כשהדרך ברורה עוברים ל-grill/spec |
💡 שימו לב: ה-map נגמר בדיוק היכן ששיעור 2 מתחיל. היעד של מפה הוא לרוב "spec נקי שאפשר לעבוד איתו".
ארבעה מושגים — וזה כל ה-skill
| מושג | מה זה |
|---|---|
| יעד (Destination) | שורה־שתיים: איך נראה הסוף? "spec מוסכם למערכת תשלומים", "החלטה נעולה על מבנה הDB". כל מפה נפתחת בזיהוי היעד — הוא קובע מה בכלל בתחום. |
| מפה (Map) | Issue אחד עם התווית wayfinder:map: היעד, ההערות, רשימת ההחלטות שכבר התקבלו (עם קישורים), והערפל. המפה היא אינדקס — לא מחסן. |
| טיקט החלטה | Sub-issue של המפה שכולו שאלה אחת: "באיזה ספק סליקה נשתמש?" התשובה שלו היא החלטה, לא קוד. כל טיקט בגודל של שיחת אייג'נט אחת. |
| ערפל (Fog of war) | החלק "עוד לא מוגדר" במפה: שאלות שמרגישות שבדרך אבל עוד אי אפשר לנסח אותן חד. כשפותרים טיקט ליד הערפל — הוא מתבהר ו"מתגייס" לטיקטים חדשים. |
🧭 העיקרון: לתכנן, לא לעשות
טיקט במפה לא בונה כלום — הוא מכריע. כשכל השאלות נסגרו והדרך ברורה, המפה "נגמרת": אז מתחילים לבנות, עם grill/spec/tickets רגילים. אם אתם מרגישים דחף "בוא נממש עכשיו" — זה הסימן שהגעתם לקצה המפה. זה טוב!
ארבעת סוגי הטיקטים
| סוג | מתי | איך נפתר |
|---|---|---|
research | חסר עובדה מבחוץ: מה גובים ב-Leumi Pay? מה ה-API של X? | האייג'נט לבד — רץ ברקע כמה במקביל 🤖 |
prototype | "איך זה אמור להיראות/להרגיש?" — צריך משהו מוחשי להגיב עליו | אתם+אייג'נט בונים דבר זול וגס (אבטיפוס) |
grilling | הברירת מחדל — שאלה שנפתרת בשיחה | האייג'נט מראיין אתכם (כמו שיעור 2!) |
task | צריך לעשות משהו כדי שאפשר יהיה להחליט: ליצור חשבון, להזמין גישה | אייג'נט או אתם — לפי מה שצריך |
איך מפעילים? שני מצבים
- טיקט אחד לכל שיחה. לא פותרים שניים בsession אחד — כל החלטה מקבלת ראש נקי.
- Claim לפני עבודה. לפני שמתחילים טיקט — עושים לו assign, ככה שיחה שנייה (של השותף!) לא תעבוד על אותה שאלה במקביל. מכירים את זה מה-frontier בשיעור 2 — אותו רעיון.
- מתייחסים בשמות. "טיקט בחירת ספק הסליקה" — לא "#47". שמות קריאים, מספרים מבלבלים.
הפרומפטים של השיעור
1. פתיחת מפה חדשה (מצב "צ'ארטר"):
יש לי רעיון גדול ל-fitcon שמרגיש לי גדול מדי ל-spec רגיל: [תיאור הרעיון]. בוא נעשה wayfinder. תתחיל לחקור אותי על היעד — מה בעצם המוצר הסופי שאנחנו רוצים להגיע אליו — ואחר כך תמפה את כל השאלות הפתוחות ברוחב. תבנה מפה כ-issue עם התווית wayfinder:map, תפתח טיקטי החלטות עם תלויות ביניהם, ותראה לי הכל לפני פרסום. מה שעוד לא אפשר לנסח חד — תשים בערפל (Not yet specified).
2. המשך עבודה על מפה קיימת (כל פעם מחדש):
נמשיך לעבוד על מפת ה-wayfinder (#NN). תקרא את המפה, תבחר את הטיקט הבא ב-frontier, תעשה עליו claim — ונפתור אותו יחד. בסוף: תרשום את ההחלטה כ-comment על הטיקט, תסגור אותו, תעדכן את המפה, ותגיד לי אם התשובה הבהירה ערפל שממנו צריך ליצור טיקטים חדשים.
3. מתי יודעים שסיימנו?
תבדוק את המפה: כמה טיקטים פתוחים נשארו וכמה ערפל נשאר בNot-yet-specified? אם אין כלום — תכין לי סיכום של כל ההחלטות, ונוכל להתחיל grill וspec רגיל על בסיסן.
בוא נבדוק שהבנת 🔍
חידון — שיעור בונוס
🎯 תרגיל בית — מפה אמיתית על fitcon
ב-README של fitcon יש רשימת "תכונות מתוכננות" — והגדולה שבהן היא מערכת התשלומים (v1.2): סליקה, מנויים חודשיים, קבלות, עמלת פלטפורמה, payout למאמנים. זו הדוגמה המושלמת לערפל.
- הריץ את פרומפט ה"צ'ארטר" למעלה עם: "מערכת תשלומים דרך הפלטפורמה".
- תסתכל על המפה שנוצרה: איפה היעד? אילו טיקטים חסומים ואילו ב-frontier? מה נשאר בערפל?
- פתרו יחד עם השותף טיקט אחד (הכי קטן ב-frontier) — וראו איך המפה מתעדכנת.
- שלחו לשותף את קישור המפה. מעכשיו יש לכם שפה משותפת גם לדברים הגדולים. 🗺️
📖 המקור המומלץ להעמקה
wayfinder ב-mattpocock/skills: קובץ ה-SKILL.md המקורי. אחרי השיעור הזה תפתיעו כמה מוכר זה נראה — עכשיו אתם קוראים אותו בשפת האם.
❓ שאלה על המפה שלכם? העתיקו לאייג'נט: "תסביר שוב מה ההבדל בין טיקט לערפל, עם דוגמה מהמפה שלנו."