{"guides":[{"id":"e03e8d19-f4a8-49f0-a34c-b4d2e7813f92","unique_id":"agent-design-architecture-guide-mar2026","title":"AI Agent Design Architecture","title_he":"ארכיטקטורת תכנון סוכני AI","summary":"The conceptual foundation: roles, guardrails, topology, memory, and security for building usable agent systems.","summary_he":"הבסיס הרעיוני: תפקידים, guardrails, טופולוגיה, זיכרון ואבטחה לבניית מערכות סוכנים שימושיות.","long_content":"## Core idea\n\nA useful AI agent is not a magic personality. It is a **work unit with a contract**.\n\nThat contract should define:\n- mission\n- boundaries\n- inputs\n- outputs\n- allowed tools\n- success criteria\n\n## The four-layer model\n\n### 1. Orchestrator\nThe coordinator that decides what should happen next.\n\n### 2. Specialists\nAgents with narrow expertise like research, building, reviewing, or writing.\n\n### 3. Guards\nVerification and safety layers: fact-checking, schema validation, QA, security review.\n\n### 4. Memory layer\nA context system that stores current state, durable memory, and open threads.\n\n## Design principles\n\n### Narrow role design\nOne agent, one job. If it needs more than one sentence to describe, it is probably too broad.\n\n### Least privilege\nGive each agent only the minimum tools it needs.\n\n### Clear outputs\nEvery agent should return a predictable structure.\n\n### Separated policy\nKeep role, guardrails, and procedure conceptually separate.\n\n## Security principles\n\n- Do not spread secrets across prompts or memory files\n- Put external write actions behind approval\n- Prefer deterministic checks over vibes\n- Limit memory exposure by agent role\n- Document repeated failures and convert them into process\n\n## Why this matters\n\nMost agent failures are not model failures. They are architecture failures: unclear ownership, too much permission, fuzzy outputs, and weak memory boundaries.\n\n## Related sections\n- Practical build workflow\n- Topology patterns and diagrams\n- Reusable templates for personal and family agents\n","slug":"agent-design-architecture","curation_note":"למה זה חשוב: בלי ארכיטקטורה ברורה, סוכנים נשארים דמו יפה. עם חוזה עבודה, טופולוגיה ברורה וגבולות אבטחה, הם הופכים לכלי עבודה אמיתי.","tool_name":"LLMs","feature_name":"Agent Design","difficulty_level":"בינוני","topics":["Agents","Architecture","Security","Memory"],"url":"https://code.claude.com/docs/en/sub-agents","sources":[{"url":"https://code.claude.com/docs/en/sub-agents","name":"Anthropic Claude Code — Create custom subagents"},{"url":"https://code.claude.com/docs/en/skills","name":"Anthropic Claude Code — Skills"},{"url":"https://agentskills.io/home","name":"Agent Skills Overview"}],"language":"עברית","created_at":"2026-03-25T21:47:19.794924+00:00","updated_at":"2026-03-25T21:47:19.794924+00:00","section":"features","section_order":2,"section_title":"Architecture","section_title_he":"ארכיטקטורה","long_content_he":"## הרעיון המרכזי\n\nסוכן AI שימושי הוא לא אישיות קסומה. הוא **יחידת עבודה עם חוזה**.\n\nהחוזה הזה צריך להגדיר:\n- mission\n- גבולות\n- קלטים\n- פלטים\n- גישת כלים\n- קריטריון הצלחה\n\n## מודל ארבע השכבות\n\n### 1. Orchestrator\nהמתאם שמחליט מה צריך לקרות עכשיו.\n\n### 2. Specialists\nסוכנים עם התמחות צרה כמו מחקר, בנייה, סקירה או כתיבה.\n\n### 3. Guards\nשכבות אימות והגנה: fact-checking, schema validation, QA, security review.\n\n### 4. Memory layer\nשכבת הקשר וזיכרון ששומרת מצב נוכחי, זיכרון מתמשך ו-open threads.\n\n## עקרונות תכנון\n\n### תפקיד צר\nסוכן אחד = עבודה אחת. אם צריך יותר ממשפט אחד כדי להסביר אותו, כנראה שהוא רחב מדי.\n\n### Least privilege\nכל סוכן מקבל רק את הכלים שהוא באמת צריך.\n\n### פלט ברור\nכל סוכן צריך להחזיר מבנה צפוי.\n\n### הפרדת policy\nשמור על הפרדה בין role, guardrails ו-procedure.\n\n## עקרונות אבטחה\n\n- לא מפזרים secrets בתוך prompts או memory files\n- פעולות חיצוניות עם כתיבה עוברות אישור\n- עדיף בדיקות דטרמיניסטיות על פני vibes\n- מגבילים חשיפת זיכרון לפי תפקיד הסוכן\n- מתעדים כשלונות חוזרים והופכים אותם לפרוצדורה\n\n## למה זה חשוב\n\nרוב הכשלונות במערכות סוכנים הם לא כשלונות מודל — אלא כשלונות ארכיטקטורה: אחריות לא ברורה, יותר מדי הרשאות, פלטים עמומים וגבולות זיכרון חלשים.\n\n## קישורים פנימיים\n- מדריך עבודה פרקטי\n- דפוסי טופולוגיה ותרשימים\n- תבניות עבודה לבניית סוכנים לעצמך ולמשפחה\n\n\n## מדריכי המשך\n- עבודה פרקטית: `agent-design-practical-workflow`\n- טופולוגיות ותרשימים: `agent-topologies-and-diagrams`\n"}],"total":1,"limit":null,"offset":0,"next_cursor":null}