מתודת Digido (Digido Method): מתודת פיתוח סדורה לעבודה עם סוכני AI

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

1. למה המתודה קיימת? (ניהול הקשר והנדסת הקשר)

בשיעורים הקודמים דיברנו על יכולותיו ומגבלותיו של הסוכן: חלון ההקשר (Context Window), חלוקת השכבות, וניהול הזיכרון.

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

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

המתודה היא קונספט ניהולי

מתודה היא לא טכניקה חולפת ולא טריק בכלי מסוים. היא הסדר הניהולי שבו אתם מנהלים תהליך פיתוח מול גורם מבצע.

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

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

2. המבנה הקונספטואלי - הלופ של המתודה (7 השלבים)

לפני שצוללים למבנה הקבצים הפיזי, חשוב להבין את מבנה הלופ שמנהל את הפיתוח. כל תהליך פיתוח מול סוכן בנוי ממחזוריות רציפה של 7 שלבים:

שלוש הסיבות שלשמן נבנתה המתודה:

1. אפיון (Specification): תהליך מסודר ומקיף, כמו מול מהנדס בכיר. חוקרים, בודקים, ומביאים את כל המידע הנדרש. רק על בסיס אפיון סגור עוברים לתכנון.
2. תכנון (Planning): אפיון איכותי מוביל לתכנית מפורקת לאבני דרך (Phases) ותתי-שלבים מדודים.
3. ביצוע שכבתי (Layered Execution): לא מפתחים הכל בסשן אחד ("וייב קודינג"). בונים שכבה אחת, בודקים, מתעדים, מאשרים - ורק אז עוברים לשכבה הבאה.

3. מבנה התיקייה והרכיבים (.digido/)

כדי שהלופ הניהולי יתקיים בפועל בכל סשן חדש (כשהסוכן טוען הקשר מאפס), המתודה מארגנת את חבילת ההקשר (Context Package) בתוך תיקייה קבועה בשם .digido/:

4. תזרים העבודה המעשי (הלולאה מונחית הפקודות)

להלן סדר הפעולות המדויק בהפעלת הסוכן כאופרטור מנוהל:

שלב 1 - התחלה וטעינת אפיון: new-project

• מריצים את הפקודה new-project.
• הסוכן מנהל תשאול מובנה ושואל אתכם שאלות ממוקדות עד ליצירת קובץ SPEC.md מלא.

שלב 2 - מניעת ניחושים וטעינת תיעוד מקומי

• לסוכן אין גישה חיה ל-APIs או דוקומנטציות חיצוניות שמשתנות.
• הנחיה לארכיטקט: אם הפרויקט משלב כלי או API חיצוני, מביאים את הקישור הרשמי ומנחים את הסוכן להוריד את התיעוד לתוך .digido/references/.
• ברגע שטוענים את התיעוד לחבילת ההקשר המקומית, הסוכן עובד על בסיס עובדות ולא ניחושים.

שלב 3 - אישור האפיון (Human Gate)

• הסוכן מציג את ה-SPEC.md. אתם כארכיטקטים מאשרים מפורשות ("מאשר") לפני שממשיכים.

שלב 4 - פירוק לפאזות: plan

• מריצים את הפקודה plan.
• הסוכן מפרק את ה-SPEC.md המאושר לפאזות מדודות בתוך ROADMAP.md.
• בסיום התכנון, מריצים pause-session כדי לסכם את ה-STATE.md ולפנות את חלון ההקשר.

שלב 5 - ביצוע מבוקר: execute {N}

• פותחים סשן חדש (הסוכן טוען את הקשר ה-STATE.md הנקי) ומריצים execute 1.
• עובדים פאזה אחת בכל פעם.
• כלל הארכיטקט: אם הסוכן מבקש להריץ פקודה או לכתוב קוד שאינכם מבינים - עצרו ושאלו אותו "למה?".

שלב 6 - בדיקה אנושית (Human Verification)

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

שלב 7 - אבחון שגיאות והנדסת הקשר לבאגים: error-diagnose

• התגלתה שגיאה? מעבירים לסוכן ראיות מדויקות:
  • דפדפן: F12 -> Console -> העתקת שגיאה אדומה.
  • טרמינל: העתקת פלט הלוגים המדויק.
• מריצים error-diagnose ומדביקים את הלוג. הסוכן מאבחן ומתקן בצורה מבוקרת.

שלב 8 - עדכון הדרך: add-phase

• נדרש פיצ'ר חדש? מריצים add-phase להשחלת פאזה חדשה במיקום המדויק ב-ROADMAP.md.

5. Cheat Sheet - סיכום פקודות המתודה

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