---
kind: slashhuman-agent-field-manual
version: 1
title: תנו לי עולם, לא תיקיית מסמכים
slug: give-me-a-world-not-a-folder-of-documents
source_slug: give-me-a-world-not-a-folder-of-documents
locale: he
summary: לפני עבודה שמשמעותה מפוזרת ברחבי המערכת, בנו אונטולוגיה, טקסונומיה וקאנון המקושרים למקורות שלהם.
human_keeps: הסמכות להגדיר מה קיים, לבחור את שפת המערכת, לקבוע מה מחייב ולהכריע בעמימות שיש לה השלכות.
agent_takes: חילוץ מבנה מוצע, קישור לראיות, חשיפת סתירות, מעקב אחר השלכות ותחזוקת העולם שהוגדר לאורך העבודה.
---

# מדריך שטח לסוכן: תנו לי עולם, לא תיקיית מסמכים

השתמש במדריך הזה כשמשימה חוצה מסמכים, מאגרי קוד, צוותים, מדיניות או גבולות
מערכת. המטרה אינה לסכם את אוסף החומרים. המטרה היא לרשת את המציאות שהמערכת
הצהירה עליה, בלי להמציא אותה בשקט.

## מטרה

בנה את המודל המצומצם ביותר שמספיק למשימה ושאושר בידי האדם האחראי:

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

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

## פרוטוקול

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

## דחה את ברירות המחדל האלה

- אל תתייחס לעץ תיקיות, לסכמת מסד נתונים, לגרף קוד או לגרף ידע שחולץ אוטומטית
  כאילו הם האונטולוגיה כברירת מחדל.
- אל תניח שדמיון סמנטי מוכיח זהות, תלות או סמכות.
- אל תאחד מונחים רק מפני שבשפה יומיומית נוח להשתמש בהם כמילים נרדפות.
- אל תהפוך את המסמך החדש, הארוך או הנשלף ביותר לקאנון בלי ראיה לסמכותו.
- אל תזרוק את המקורות אחרי חילוץ המבנה. מפה בלי מקור היא בסך הכול דעה עם ביטחון
  עצמי.
- אל תבנה יותר תשתית ממה שהבעיה דורשת. קובץ Markdown מתוחזק יכול להספיק; פלטפורמת
  גרפים שאיש אינו מתחזק לא.

## ראיות להשלמה

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

המאמר הקאנוני בעברית: https://slashhuman.blog/he/posts/give-me-a-world-not-a-folder-of-documents/

המקור באנגלית: https://slashhuman.blog/posts/give-me-a-world-not-a-folder-of-documents/