fitcon × AI Workflow · להדפיס ולהדביק ליד המחשב

📄 הצ'יטשיט — כל ה-workflow בעמוד אחד

⚠️ ארבעת האסורים

❌ אף פעם לא עובדים ישירות על main · ❌ לא ממזגים PR בלי אישור השותף · ❌ לא מתקנים קונפליקטים בידיים · ❌ לא כותבים קוד — מדברים, והאייג'נט כותב.

🗺️ מפת הדרכים

💡 רעיון
←
🔥 Grill/grill-with-docs
←
📄 Spec/to-spec
←
🎫 Tickets/to-tickets
←
⚙️ Implement/implement על branch
←
🔍 PR + Reviewהשותף מאשר
←
✅ Mergeהטיקט נסגר לבד

🔁 חוזרים ל-frontier ובוחרים את הטיקט הבא

💡 עם opencode: אתה מדבר רק עם ה-Leader, הוא מזמן את השאר (explore → worker → reviewer) ומחזיר לך סיכום

🗺️ רעיון גדול מדי לspec? קודם /wayfinder — מפה של שאלות־החלטה, עד שהדרך נקייה. טיקט אחד לשיחה, claim לפני עבודה. 🟢 עם opencode: ה-Leader מתזמר explore/worker/reviewer — אתה רק אומר "בוא נעשה wayfinder".

📋 הפרומפטים — לפי מצב

🟢 פתיחת סשן עם opencode (Leader)

תעשה את ה-ritual: קרא AGENTS.md / CONTEXT.md / ADRs, טען ask-matt, תזמן explore, בדוק gh issue list ותן לי סיכום + frontier

🌅 פתיחת יום / משימה חדשה

תעשה pull לmain, תבדוק את הissues הפתוחים ותן לי את הfrontier — טיקטים ready-for-agent שכל החוסמים שלהם סגורים. תמיין לפי עדיפות.

💡 יש רעיון חדש

יש לי רעיון: [הרעיון]. נעבור על זה עם grill-with-docs — שאלות אחת־אחת. כשאני לא יודע משהו, תציע ותבקש אישור.

📄 אחרי ה-grill

עכשיו to-spec: תסכם לspec ותפרסם כissue. ואז to-tickets: תציג לי את הפיצול עם התלויות לפני פרסום, עם ready-for-agent.

⚙️ ביצוע טיקט

ניקח טיקט #NN: pull לmain, branch חדש tickets/NN-שם, ואז implement לפי קריטריוני הקבלה — TDD, טסטים ירוקים בסוף. משהו לא ברור? תשאל, אל תניח.

🔍 פתיחת PR

תריץ code-review ותתקן מה שתמצא. אחר כך תפתח PR לmain עם תיאור ו־Close #NN בסוף. תן לי את הקישור.

👀 השותף פתח PR — תסביר לי

השותף פתח PR חדש: #NN (או הדבק כאן קישור ל-PR). תקרא את כל ה-PR — תיאור, קבצים שהשתנו, והטיקט המקושר אם יש — ותסביר לי בעברית פשוטה בלי מילים טכניות: מה הוא ניסה לעשות ולמה, מה השתנה בכל קובץ במילים של בן אדם, והאם יש משהו שנראה מסוכן או שעלול לשבור דברים. בסוף תן לי המלצה ברורה במשפט אחד: לאשר או לבקש תיקונים — ולמה. אל תעשה כלום בלי אישור שלי, רק תשאל מה אני רוצה לעשות.

✅ אחרי אישור השותף

הPR אושר. תמזג לmain, תמחק את הbranch, תעשה pull, ותן לי סיכום של מה נכנס לגרסה הרשמית.

🗺️ רעיון ענק? פתיחת מפה (wayfinder)

רעיון גדול מדי לspec רגיל: [הרעיון]. נעשה wayfinder: תחקור אותי על היעד, תמפה את השאלות הפתוחות ברוחב, תבנה מפה כissue עם wayfinder:map וטיקטי החלטות עם תלויות. מה שאי אפשר לנסח חד — לערפל. תראה לי הכל לפני פרסום.

🧭 המשך עבודה על מפה קיימת

נמשיך על מפת הwayfinder (#NN): תבחר את הטיקט הבא בfrontier, תעשה claim, ונפתור יחד — טיקט אחד בלבד השיחה הזו. בסוף: החלטה כcomment, סגירה, עדכון מפה, והאם התבהר ערפל חדש.

🚧 קונפליקט (מקרה חירום)

יש קונפליקט בין הbranch שלי לmain. אל תדרוס ואל תחליט לבד. תסביר בעברית פשוטה מה מתנגש ומה האפשרויות, ותחכה לאישור שלי.

🚦 תוויות הלוח (labels)

תוויתמשמעותהפעולה שלי
needs-triageלא ברור עדייןgrill או דיון עם השותף
needs-infoחסר מידעלענות ולהחזיר לשולחן
ready-for-agentמוכן ל-AI 🟢implement!
ready-for-humanחייב בן אדםלקחת אישית
wontfixלא נעשהלשכוח מזה

🤝 חוקי השותפות

  1. pull + branch חדש לפני כל משימה
  2. אף דחיפה ישירה ל-main — רק דרך PR
  3. טיקט אחד פתוח לכל אחד
  4. merge מהר — PR ישן = קונפליקטים
  5. אותו אזור? מדברים קודם
  6. כל בעיה של Git = פרומפט, לא ידיים