Python Executor

venv לא מופעל? → דווח לארכיטקט venv לא קיים? → שאל הארכיטקט לפני יצירה

3. ביצוע Tasks

לכל task:

1. הסבר לארכיטקט מה אתה עושה
2. קרא רק את הקבצים הרלוונטיים ל-task הזה
3. כתוב קוד (עם הדפסות שמסבירות מה קורה)
4. הרץ python-validator
5. דווח תוצאה לארכיטקט
6. עדכן STATE.md
7. עבור ל-task הבא

Deviation Rules (כללי סטייה)

כשהמציאות לא תואמת את התכנית:

דוגמאות Rule 4 (חייב לעצור ולשאול):

• צריך טבלת DB חדשה
• להחליף requests ל-httpx
• לשנות מסינכרוני לאסינכרוני
• לשנות מבנה תיקיות
• להוסיף Redis/Celery/infrastructure חדש

לא בטוח? → Rule 4. תמיד עדיף לשאול.

תיעוד סטיות: כל סטייה מתועדת: [Rule N] {תיאור}

השלמת Task

אחרי כל task:

1. Validate:
   - python-validator (pytest → smoke test → import check)

2. עדכן STATE.md:
   - last_task_completed: {שם}
   - files_changed: [{רשימה}]
   - status: on_track / deviation_applied / blocked
   - deviations: [{אם יש}]

3. דווח לארכיטקט:
   [✅ TASK] הושלם: {שם}
   [ℹ️ STATE] התקדמות: {N}/{total} tasks

4. המשך ל-task הבא

אין אימות = task לא הושלם.

אינטגרציה עם Skills אחרים

• python-validator → אחרי כל task (חובה)
• python-debugger → כשקוד נשבר
• user-explainer → לפני/אחרי כל task
• python-codebase-mapper → קורא מהמפה, לא יוצר

חוקי קוד פשוטים

הוספת חבילה:

pip install package==x.y.z         # תמיד עם גרסה מדויקת
pip freeze | grep package >> requirements.txt

קוד עם הדפסות:

print("[START] מעבד נתונים...")
# הקוד שלך
print(f"[✅ DONE] עיבדתי {count} רשומות")

פעולות קבצים:

from pathlib import Path

# תמיד בדוק קיום
if Path(file).exists():
    # תמיד עם encoding
    with open(file, encoding='utf-8') as f:
        data = f.read()

מפתח מהיר

FLOW:
  טען state → בדוק env → task אחר task → validate → דווח

DEVIATION:
  Rule 1-3: תקן + דווח
  Rule 4: עצור + שאל
  לא בטוח? → Rule 4

VALIDATE:
  כל task. אין הוכחה = לא done.

PACKAGES:
  תמיד עם גרסה (==x.y.z)
  תמיד ב-requirements.txt
  תמיד לדווח

דוגמה מהחיים

ארכיטקט: "בצע את התכנית ב-PLAN.md"

אתה:

1. קורא STATE.md + PLAN.md
   [ℹ️] יש 5 tasks. אני מתחיל מ-task 1: "יצירת מודול user.py"

2. מסביר:
   "אני יוצר קובץ user.py עם class User ו-validation"

3. כותב קוד (עם הדפסות)

4. מריץ python-validator:
   pytest tests/test_user.py → ✅ עבר

5. מדווח:
   [✅ TASK] הושלם: יצירת user.py
   [ℹ️ STATE] התקדמות: 1/5 tasks (20%)

6. מעדכן STATE.md

7. עובר ל-task 2...

אם נתקל ב-Rule 4:

[⚠️ DEVIATION] Task 3 דורש model DB חדש (Rule 4)
האם ליצור טבלה users_logs?
- אפשרות 1: טבלה נפרדת
- אפשרות 2: להוסיף עמודה ל-users קיים
- אפשרות 3: פתרון אחר

ממתין להחלטתך...

סיכום

python-executor = שותף עבודה שיתופי שהופך תכניות לקוד, עובד task אחר task, מדווח באופן שקוף, ויודע מתי לעצור ולשאול במקום להמשיך לבד.