טיפים מעשיים — זה כל מה שצריך
עיקרון מרכזי: הוציאו החלטות מחוץ לקוד. בקוד מעורבות ההחלטות שלכם (“העמודה הזו היא integer”) עם פרטי יישום (שמות משתנים). ה-AI לא מבדיל ביניהם. הצהירו החלטות במפרטים נפרדים — ואז ה-AI לא יכול לדרוס אותן.
לסוכן: “npx skills add park-jun-woo/yongol”
לסוכן: “תצהיר תכונת Login כ-SSOT”
לסוכן: “תריץ yongol validate ותגיע ל-0 שגיאות”
yongol כרגע ל-Go בלבד. אבל העיקרון — להוציא החלטות מהקוד ולתפוס סתירות באימות צולב — הוא בלתי תלוי שפה.
למה צריך לפקד ככה
10 סוגי SSOT
yongol מפריד החלטות תוכנה ל-10 מפרטים הצהרתיים. כל אחד אחראי לתחום אחד בלבד.
הגדרת נתונים: features.yaml, manifest.yaml, SQL DDL, sqlc
הגדרת התנהגות: OpenAPI, SSaC, Mermaid stateDiagram
אימות: OPA Rego, Hurl
הגדרת מסך: STML
8 מתוך 10 הם תקנים תעשייתיים. אתם לא צריכים ללמוד אותם — ה-AI יודע.
operationId — מפתח אחד לכל השכבות
שם אחד (למשל ExecuteWorkflow) מחבר את כל 10 שכבות ה-SSOT.
yongol validate — 287 חוקים תופסים סתירות
✓ manifest ✓ openapi_ddl ✓ ssac_rego
...
0 errors, 0 warnings
Benchmark: ZenFlow — 32 endpointים ב-69 דקות
מדידה אמיתית. 32 endpointים, 14 טבלאות, 47 בקשות Hurl. אין האטה עם הוספת תכונות. אף טסט קיים לא נשבר.
למה מודל גדול יותר לא הפתרון
הבעיה היא לא אינטליגנציה של המודל — היא המדיום. קוד כמדיום לא מבדיל בין החלטה ליישום. yongol משנה את המדיום.
קורס Reins Engineering המלא
| שיעור | כותרת |
|---|---|
| שיעור 1 | איך לפקד על AI |
| שיעור 2 | למה אי אפשר לסמוך על AI |
| שיעור 3 | אפליקציות שלא נשברות |
| שיעור 4 | החלטות מחוץ לקוד |
| שיעור 5 | AI עם רסן |
| שיעור 6 | עבר = נעול |
| שיעור 7 | איך להפוך חנופה |
| שיעור 8 | המפעל של הסוכן |
| שיעור 9 | אוטומציה מעבר לקוד |
| שיעור 10 | חוק הנתונים |
מקורות
- ZenFlow Benchmark — 32 endpointים ב-69 דקות
- yongol agent — Gemma4 4.5B (מקומי, חינם) מגיע ל-0 שגיאות עם פידבק אחד
- yongol validate — 287 חוקים, אימות צולב בין 10 SSOTs