Agentic Engineering - פתיחה

הזמנה לסדנה

הי כולם. ב-29/6 הסדנה שלנו על Agentic Engineering. המשפט שמסכם את התקופה הוא זה: אנחנו עוברים עברנו מעולם שבו “שואלים את הצ’אט” לעולם שבו מנהלים עבודה הנדסית עם סוכנים.

זו לא הולכת להיות הרצאה שבה אני “מעביר חומר”. אשתדל לקצר בחפירות. זו סדנה. בואו לשחק, לשבור, לשאול, לאתגר, להראות חלופות, ולעזור אחד לשני. מי שמכיר כלי אחר, דרך אחרת, ניסיון מוצלח או כישלון מפואר, שיביא אותו. כולנו נרוויח.

כל החומרים שאני בונה לסדנה זמינים כבר כאן בתפריט Agentic Engineering

יש שם יותר ממה שנספיק:

• פתיחה על ההבדל בין Chat רגיל לבין עבודה עם agent בתוך סביבת קוד,
• Git/GitHub, מפרטים ב-Markdown, AGENTS.md,
• Harness Engineering mindset & Agentic Workflows,
• עבודה עם clasp ו-Google Sheets / Apps Script,
• יצירת אתר תוכן Markdown/Jekyll בפרומפט אחד שיכול לשמש אותכם להוראה: גרסת GitHub Pages בלבד או גרסת Jekyll מקומית עם WSL/Bundler,
• אתר מלא עם Harness: live hosting, CI/CD, UnitTests ו-TDD, Playwright E2E, Firebase מהפרומפט הראשון,
• ואפילו התראות מ-Codex כשהוא מסיים לעבוד, לאלו שיצרו חשבון pushbullet

אשתדל לעבוד איתכם על שלושה תוצרים שימושיים לנו כמורים:

1. clasp ו-Google Apps Script. כל מי שמשתמש באקסל או בגוגל שיטס יכול להנות מהתועלת של app script. ואם כבר, אז agentic.
2. אתר Markdown/Jekyll שבו תוכלו ליצור תכניה הוראה הזמינים לתלמידים באתר (כמו אצלי למשל). יש שתי גרסאות - למתחילים ולמתקדמים שכבר עובדים עם WSL/Bundler.
3. התנסות ב- one shot prompt for a project+git with a full harness, עם המשך ל-Firebase ול-live deployment. המטרה שלי היא לא שתצאו עם “עוד כלי AI”, אלא עם התנסות טובה בעבודה שבה אתם המהנדסים וה- agentעובד (קורא קבצים, כותב, מעדכן, מתקין, מריץ בדיקות, מציג ראיות).

כפי שכבר ביקשתי לפני מספר חודשים - לא ניכנס לדיונים של “לאן פנינו” בחלון הזמנים של הסדנה. ונשאיר זאת לארוחת הערב.

תיאום ציפיות: harness enginneering סובב סביב עבודה נכונה שיכולה לקחת פרוייקט הרבה הרבה יותר רחוק. ואנחנו לצערינו כמעט בכל ההדגמות נבצע יותר one-shot prompt עם ראייה לטווח מעט יותר קצר.

מוזמנים להציץ מראש בחומרים. יש הרבה מעבר למה שנוכל להספיק.

מי זה ה-AGENT ומה עושים איתו?

בסדנה זו, Agent הוא coding agent, כגון codex or claude code or chat. אלו פלגינים ל-vscode וגם אפליקציות נפרדות. את ההבחנה בין Chat, CLI, Extension ו-App נרחיב בעמוד Online מול Agentic. אנחנו נעבוד עם codex ומי שמנוסים ב-claude or copilot יעבדו איתם.

הקושי בסדנה שלנו: בזמן קצר אפשר בעיקר לראות את הכח שיש כיום ל-Agent לעשות הכל, והדרך היא להראות דוגמאות ל- one shot prompt שמגיע רחוק. זה יוצר פרוייטק עם אורך חיים מוגבל. האתגר הוא לעבור ל- harness mindset, באופן שיאפשר לבנות מוצר שניתן להגדיל ולגדול איתו בלי שהכל מתפרק.

התמונה הגדולה

flowchart LR
    B["מפתח Prompt"] --> C["Agent"]
    C --> D["Codebase"]
    C --> E["Terminal"]
    C --> F["Browser / E2E"]
    D --> G["Git diff"]
    E --> H["Tests"]
    F --> I["Visual evidence"]
    G --> J["Review"]
    H --> J
    I --> J
    J --> |"agentic loop: Accept / Fix / Reject"| C

המונח: Harness Engineering כפי שהגדיר GPT5.5

Harness הוא הרתמה שמחזיקה את ה־agent בתוך מסלול עבודה מועיל:

• הוראות קבועות: AGENTS.md, CLAUDE.md, skills, docs.
• גבולות פעולה: הרשאות, תיקיות מותרות, מה לא למחוק, מתי לשאול.
• בדיקות: unit tests, TDD, build, lint, Playwright, בדיקה ידנית בדפדפן.
• תיעוד: Markdown, תרשימי Mermaid, דפי משימה, רשימת “done when”.
• ניהול שינוי: Git, Pull Requests, checkpoints, review.

אם ה־agent הוא “עובד”, ה־harness הוא מערכת העבודה. בפרומפט, אנחנו מנחים את העובד ליצור, אך גם ליצור את סביבת העבודה שסביבו.

דוגמת Prompt: תוצר מיידי וגם שיפור של ה־harness

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

Harness - הגדרה שלי

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

דמו - הסרטון שראינו

נסו בעצמכם לקחת פרוייקט עובד שלכם, ולבקש מ-Codex, Claude or אם תרצו נסיון חינמי-Copilot, לבצע שינוי מסויים.

דוגמא ממש שגויה - פרומפט שהציע AI

קרא את מבנה הפרויקט. הוסף עמוד Markdown קצר עם טבלה ותרשים Mermaid. עדכן את התפריט. הרץ build. בסוף תן לי רשימת קבצים ששונו והאם הבדיקה עברה.

אין טעם לבקש את הדברים האלו בסביבה אייג’נטית תקינה. קודקס יודיע אלו קבצים שונו, וגם הגיט יַעֲקֹב אחרי זה. עדכון התפריט בד”כ יקרה אם הוא רגיל לזה וזה שולי.

הדמו טוב אם רואים ארבעה דברים (שוב, לא מדוייק, הערות שלי ב-bold)

1. ה־agent קורא לפני שהוא משנה. מובן מאליו
2. הוא משנה מעט קבצים ולא “משכתב את העולם”. לא מדוייק - תלוי פרוייקט
3. הוא מריץ build או בדיקה. כיום, build מובן מאליו. בדיקה - רשות, תלויית הגדרות, ודרישה. עלולה לעלות ביוקר, ומצד שני הכרחית במקרים מסויימים של לולאות.
4. הוא נותן evidence: מה עבר, מה לא עבר, ומה נשאר לבדיקה.
5. תוספת שלי: שינויים שרלוונטיים ל-AGENTS, Schema, Spec, Harness בוצעו כחלק מהמימוש (של פיצ’ר או תיקון באג).

דוגמא נוספת - עבודה ב-repo הנוכחי

שאלת יציאה

איזה חלק בעבודה עם agent הוא הכי מסוכן בכיתה?

1. כתיבת קוד
2. מחיקת קבצים
3. קבלת תשובה בלי בדיקה
4. שימוש ב-Markdown

התשובה הרצויה היא ג. הבעיה אינה שה־agent כותב קוד. הבעיה היא שמקבלים תוצר בלי מסלול בדיקה, בלי Git, ובלי הגדרת אחריות. והכי מסוכן ללמידה - בלי שהתלמיד מבין מה הקוד עושה.

⟵ Harness בפרוייקט של תלמיד צריך לכלול:

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

על מה נדבר בסדנה

• Online מול Agentic - מה ההבדל בין שיחה עם מודל לבין עבודה עם agent בתוך פרויקט אמיתי.
• Git ו-GitHub - איך שומרים נקודות חזרה, בודקים שינויים, ומלמדים עבודה אחראית עם קוד.
• AGENTS ו-Markdown - איך כותבים הוראות עבודה, מסמכי משימה ותיעוד שה-agent מסוגל לבצע לפיהם.
• Google Sheets ו-clasp - איך מחברים עבודה agentic לכלי בית ספר מוכרים כמו Sheets ו-Apps Script.
• Hosting - איך מעלים תוצר לרשת ומבינים את ההבדל בין קוד מקומי לשירות חי.
• TDD ובדיקות - איך נותנים ל-agent לרוץ יותר זמן בלי לאבד שליטה: בדיקות, build וקריטריוני סיום.
• Playwright ודפדפן Codex - איך בודקים ממשק בדפדפן ומקבלים ראיות ויזואליות שהתוצר עובד.
• Firebase מפרומפט ראשון - איך ניגשים לשירותי backend בלי להפוך את הפרומפט לקסם לא מבוקר.
• התראות PushBullet - איך מקבלים סימן כשה-agent סיים, במיוחד במשימות ארוכות.

במה נשתמש (pre-requisites)

לוז

לארגן מראש:

• חשבון Open AI plus (החשבון ב-20$ לחודש) רצוי חשבון באתרים הבאים. אלו דברים שיותר נוח לארגן מראש כשאתם פנויים לטפל בסיסמאות וכיוב’
• github,
• vercel or netlify or railway (or more than 1),
• pushbullet, רשות. לצורך notifications. חשבון - חינמי. תתקינו את האפליקציה בטלפון אם זה רלוונטי לכם

להביא:

• מחשב נייד
• טלפון

להתקין מראש:

1. Codex Desktop App (from windows store) https://apps.microsoft.com/detail/9PLM9XGG6VKS?hl=neutral&gl=IL&ocid=pdpshare or the same on Mac…
2. VSCode,
3. VSCode extension: Codex (by Open AI),
4. VSCode extension: markdownlint,
5. VSCode - Git for windows (vscode התקנה נפרדת שניתן להתחיל מתוך ),
6. Codex app on your android or iphone.
7. PushBullet למי שרוצים הודעות מהאייג’נט

Codex settings

my global AGENTS.md (under username.codex)

קובץ agents הגלובאלי שלי, וקובץ notify.ps1

### AGENTS.md ```text # Global Agent Permissions ## Workspaces You may freely read, write, delete, and execute in: - `C:\Users\myUser\source\repos` - `C:\Users\myUser\StudioProjects` - `C:\Users\myUser\AndroidStudioProjects` - `C:\Users\myUser\source\Work` - `\\wsl.localhost\Ubuntu\home\stra\repos\` - `\\wsl.localhost\Ubuntu\home\stra\sites\` - `C:\Users\myUser\Downloads` - `C:\Temp` - WSL `~/repos$` - WSL `~/sites$` Do not write outside these unless explicitly asked. ## Python You may use Python here: - `C:\Users\myUser\AppData\Local\Programs\Python\Python313\` Feel free to run `python`, `pip`, `pipx`, install packages, and use tools. ## Git (read-only) Allowed: - `git status`, `git diff`, `git log`, `git show`, `git blame`, `git rev-parse`, `git branch --show-current`, `git ls-files` Do NOT: - `git commit`, `git branch`, `git switch`, `git checkout`, `git reset`, `git clean`, push ## Runtime You may build, test, run servers, and open browsers (Edge, Chrome, Brave). When running Playwright E2E test suites, you may use `4-6` workers instead of `2` when that is appropriate for the run. ## Notifications At the end of each user prompt, run `.\\notify.ps1` from the `.codex` folder to notify me whether the task completed successfully or failed. Use this pattern: `.\notify.ps1 -Title "Codex - - " -Message " Finished"` If the task fails, still run the notification script and make the message reflect the failure state. This relies on the `push_bullet_acc_token` environment variable being set. ## Mode Prefer acting without asking, keep changes scoped, flag anything risky. ``` ### notify.ps1 **לצורך שימוש** - הטוקן שלי שיצרתי באתר pushbullet מוגדר כ-env variable בשם `push_bullet_acc_token` ```text param( [string]$Title = "Codex", [string]$Message = "Task finished" ) $token = $env:push_bullet_acc_token if (-not $token) { throw "Missing environment variable: push_bullet_acc_token" } $body = @{ type = "note" title = $Title body = $Message } | ConvertTo-Json Invoke-RestMethod ` -Uri "https://api.pushbullet.com/v2/pushes" ` -Method Post ` -Headers @{ "Access-Token" = $token } ` -Body $body ` -ContentType "application/json" ``` </details>