שיעור 8

טיפים מעשיים — זה כל מה שצריך

הבעיה הגדולה ביותר: קובץ אחד עם 20 פונקציות. צריכים אחת, 19 מיותרות מגיעות איתה. זה מוריד ביצועי סוכן ב-30-85%.

לסוכן: “מצא את הקובץ הכי ארוך ופצל אותו לפי פונקציות. שם קובץ = שם פונקציה. טסטים קיימים חייבים לעבור.”

לסוכן: “הרץ filefunc validate והורד הפרות ל-0. טסטים קיימים חייבים לעבור.”

לסוכן: “חזור על tsma next והוסף טסטים לכל הפונקציות. ענפים לא מכוסים — כסה גם אותם. עד All functions complete.”


למה צריך לפקד ככה

קוד שמהנדס קורא ≠ קוד שסוכן יכול להפעיל

מהנדסים גוללים 2,000 שורות עם אינטואיציה. לסוכנים אין אינטואיציה — הם טוענים את כל הקובץ. מחקר: מידע מיותר מוריד ביצועי AI ב-30-85%.

filefunc — קובץ אחד, מושג אחד

# בלי filefunc
read utils.go → 20 פונקציות, 19 מיותרות. זיהום הקשר.

# עם filefunc
read check_one_file_one_func.go → פונקציה 1. בדיוק מה שצריך.

אומת על Hono Framework (23k+ כוכבים): 186 קבצים → 626. 4,419 טסטים, אף אחד לא נשבר.

tsma — קו הגנה מפני רגרסיה בקוד ישן

tsma next חוזר. סוכן מת? ההתקדמות נשמרת ב-session.json. 527 פונקציות — 0 TODO.

4 תנאים ל-Agent Operable Codebase

תנאיכליאפקט
1. קובץ אחד, מושג אחדfilefuncמניעת זיהום הקשר
2. כל הפונקציות נבדקותtsmaזיהוי רגרסיה
3. קישור רפרנסים סמלייםoperationId (yongol)מעקב בין שכבות
4. הסרת צימוד סמויwhyso couplingגילוי תלויות נסתרות

מסר מרכזי: אל תבנו רכבת מהירה יותר. הניחו מסילה.


קורס Reins Engineering המלא

שיעורכותרת
שיעור 1איך לפקד על AI
שיעור 2למה אי אפשר לסמוך על AI
שיעור 3אפליקציות שלא נשברות
שיעור 4החלטות מחוץ לקוד
שיעור 5AI עם רסן
שיעור 6עבר = נעול
שיעור 7איך להפוך חנופה
שיעור 8המפעל של הסוכן
שיעור 9אוטומציה מעבר לקוד
שיעור 10חוק הנתונים

מקורות

  • Stanford, “Lost in the Middle” (2024) — ירידה של 30%+ בביצועים כשהקשר רלוונטי קבור
  • Amazon (2025) — 13.9-85% ירידת ביצועים מטוקנים מיותרים
  • Hono Framework — 186→626 קבצים, 4,419 טסטים עברו
  • tsma — 527 פונקציות, PASS 246, DONE 281, TODO 0