18 באוגוסט 2026 · מדריכים

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

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

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

1. תפקיד הארכיטקט מול טכנולוגיות

סוכן AI הוא אופרטור. כלומר הוא יכול לבצע כתיבה מלאה של קוד והרבה יותר מזה. הארכיטקט מנהל את הנדסת ההקשר והארכיטקטורה. כאשר הסוכן מציע טכנולוגיה בשלב האפיון, תפקידכם הוא להבין למה הוא בחר בה, האם היא מוצדקת, והאם היא נשמרת פשוטה ("KISS - Keep It Simple, Stupid").

💡 הוראת עבודה מתודית: את האפיון ומסמכים נוספים, אנחנו מייצרים כחלק מתהליך העבודה המתודי שפיתחתי שנקרא Digido Method. מתודת פיתוח מסודרת המיועדת לארכיטקטים שעובדים עם סוכנים כמו קלוד קוד וחבריו. הסבר מלא על המתודה נמצא כאן.

2. מפת שפות הקוד והטכנולוגיות המרכזיות

🗺️ מפת טכנולוגיות בפרויקט

🖥️ Frontend (ממשק ויזואלי)
  • HTML: תבנית ומבנה העמוד
  • CSS: עיצוב, סגנון וטיפוגרפיה
  • JavaScript: לוגיקה ואינטראקטיביות בדפדפן

⚙️ Backend (אוטומציה ומנוע)
  • Python: סקריפטים, עיבוד וחיבור APIs
  • Virtual Env (venv): סביבת חבילות מבודדת לפרויקט

💾 Database (זיכרון קבוע)
  • SQL / PostgreSQL: שמירת נתונים מבניים
  • Supabase / SQLite: מסדי נתונים מנוהלים/מקומיים

💻 OS & CLI (ניהול מערכת)
  • Bash / PowerShell: פקודות טרמינל, הרצה והתקנות

📜 Agent Rules (שפת הארכיטקט)
  • Markdown (.md): הגדרת הנחיות, אפיון וכללים

A. HTML / CSS / JavaScript - הממשק הוויזואלי (Frontend)

  • מה זה באמת:
    • HTML: המבנה והשלד של העמוד (כפתורים, כותרות, טבלאות).
    • CSS: העיצוב הוויזואלי (צבעים, רווחים, טיפוגרפיה, גמישות למובייל).
    • JavaScript (JS): הלוגיקה והאינטראקטיביות (מה קורה כשלוחצים על כפתור, שליפת נתונים).
  • מתי משתמשים: בכל פעם שאדם צריך להביט במסך, להקליד בממשק, או לתקשר עם המערכת בדפדפן.
  • שאלת הארכיטקט שמכוונת לכאן: "האם משתמש אנושי צריך לראות או להפעיל משהו דרך מסך ויזואלי?"
  • כלל אצבע לארכיטקט: התחילו תמיד ב-Vanilla HTML/CSS/JS פשוט. אל תתנו לסוכן לקפוץ ל-Frameworks מורכבים (כמו React או Next.js) אלא אם כן המוצר דורש זאת מפורשות.

B. Python - מנוע האוטומציה ועיבוד הנתונים (Backend / Scripting)

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

    ⚠️ סכנת התנגשות חבילות: עבודה עם Python חייבת תמיד להתבצע בתוך Virtual Environment (venv) פנימי של הפרויקט! סוכני קוד לפעמים שוכחים זאת ומנסים להתקין חבילות באופן גלובלי (pip install). אם זיהיתם שהסוכן מריץ pip מחוץ ל-venv - עצרו אותו מיד והנחו אותו: "צור סביבת venv והתקן בתוכה בלבד."

C. SQL / מסדי נתונים - הזיכרון הקבוע (Database & Storage)

  • מה זה באמת: השפה והמערכת לשמירת נתונים בצורה מובנית, אמינה ומהירה לאורך זמן (למשל Supabase, PostgreSQL, SQLite).
  • מתי משתמשים: כשמידע חייב להישמר בין גלישות או סשנים שונים (משתמשים, רשימת משימות, היסטוריית פעולות, הגדרות).
  • שאלת הארכיטקט שמכוונת לכאן: "האם המערכת צריכה לזכור נתונים גם אחרי שנסגור את הדפדפן או את הסשן?"
  • כלל אצבע לארכיטקט: לפרויקטים קטנים/מקומיים מספיק קובץ JSON או SQLite local. לפרויקטים עם משתמשים אמיתיים - משתמשים במסד נתונים ענני מנוהל כמו Supabase.

D. Bash / PowerShell - פקודות מערכת ההפעלה (Terminal & CLI)

  • מה זה באמת: שפות הפקודה הישירות של מערכת ההפעלה (Linux/Mac משתמשות ב-Bash/Zsh, Windows משתמשת ב-PowerShell).
  • מתי משתמשים: התקנת רכיבים, ניהול תיקיות, הרצת ה-Dev Server, והפעלת סקריפטים מקומיים.
  • שאלת הארכיטקט שמכוונת לכאן: "האם אני מנהל כעת את המחשב/השרת עצמו ולא את מוצר הקצה?"

E. Markdown (.md) - שפת הניהול והנדסת ההקשר

  • מה זה באמת: שפת הסימון שבה נכתבים כל קובצי האפיון, הכללים והמיומנויות (SPEC.md, ROADMAP.md, CLAUDE.md, SKILL.md).
  • מתי משתמשים: תמיד. זוהי שפת האם שלכם ושל הסוכן לניהול חבילת ההקשר.

3. שלוש הדרכים לדייק את האופרטור (MCP, API, DOCS)

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

  1. שרתי MCP (Model Context Protocol): הידיים הישירות של הסוכן לכלים חיצוניים. חיבור מהיר וחי מתוך הממשק.
  2. קריאות API: כשיש צורך בגמישות ש-MCP לא מספק, הסוכן כותב סקריפט Python/JS שמבצע קריאות API ישירות.
  3. דוקומנטציה מקומית (DOCS): איסוף תיעוד מבוקר מקדים ושמירתו בתיקייה (.digido/references/), כדי למנוע ניחושים בטעינת ההקשר.

4. מטריצת החלטה מהירה לארכיטקט (Decision Matrix)

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

הצורך של המוצר השפה / הכלי המתאים דוגמה מעשית
מסך, כפתורים, דשבורד ויזואלי HTML / CSS / JavaScript ממשק מעקב משימות בדפדפן
אוטומציה, עיבוד קבצים, חיבור APIs Python (+ סביבת venv) סקריפט שמושך לידים ומעבד אותם
שמירת נתונים אמינה לאורך זמן SQL / Supabase / SQLite טבלת משתמשים והרשאות
התקנות, הרצת השרת המקומי Bash / PowerShell npm run dev או python main.py
הגדרת חוקים, אפיון ותכנון Markdown (.md) קובצי SPEC.md ו-CLAUDE.md

5. ארבע השאלות שארכיטקט שואל בשלב האפיון

במהלך שלב האפיון מול הסוכן (SPEC.md), הסוכן יציע לכם מחסנית טכנולוגית (Tech Stack). לפני שאתם מאשרים, שאלו אותו את 4 השאלות הבאות:

  1. "למה בחרת דווקא בטכנולוגיה הזו, והאם יש דרך פשוטה יותר לבצע זאת?"
  2. "האם הפתרון דורש התקנות גלובליות במחשב שלי, או שהכל כלול בתוך תיקיית הפרויקט (כולל venv/node_modules)?"
  3. "איזה רכיב בפרויקט אחראי על הממשק הוויזואלי, ואיזה אחראי על הלוגיקה ברקע?"
  4. "איזה תיעוד רשמי אנחנו צריכים להוריד מקומית כדי שלא תצטרך לנחש לגבי ה-APIs המעורבים?"

זכרו: אתם לא צריכים לכתוב את הקוד - אתם צריכים לוודא שהסוכן בונה אותו במבנה הנכון, הפשוט והיציב ביותר.

← חזרה למשאבים