Skip to content

About

A generic protocol for safe, well-documented work with AI agents connected to a computer or server: numbered approval before every action, writes limited to a scoped folder, secret protection, three risk tiers, and run logs that carry context across sessions.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ProtoMotAI

English | עברית

פרוטוקול גנרי לעבודה עם Claude (claude.ai) כשהוא מחובר למחשב או לשרת שלכם. הוא מגדיר איך מבקשים אישור לפני פעולה, איך מטפלים בסודות, איך מתעדים ריצות והחלטות, ואיך חוזרים בצורה מסודרת אחרי הפסקה, כך שמי שפותח צ'אט חדש לא מתחיל מדף ריק.

מסמך: README | גרסה: 0.1 | סטטוס: טיוטה | עודכן: 2026-10-25 | מתאר פרוטוקול: PROTOMOTAI_V1 (טיוטה)

סטטוס: טיוטה. הפרוטוקול נבדק בבדיקות "התחלה קרה" (סוכן שקורא רק את נקודת הכניסה ועונה על שאלות) ובבדיקות עצמיות לכלים. הוא עדיין לא נוסה בפרויקט חי לאורך זמן. מה שנאכף בכלי ומה שהוא הוראה בלבד מפורט ב-security.

למי זה מתאים

  • מי שמחבר את Claude לשרת או למחשב ורוצה גבולות ברורים: מה מותר לקרוא, מה מותר לכתוב, מתי חייבים לשאול.
  • מי שעובד על פרויקט ארוך עם כמה צ'אטים לאורך זמן ורוצה שהמצב יישמר בקבצים ולא בזיכרון של שיחה.
  • מי שרוצה לעבוד בצורה מסודרת בלי להמציא נהלים: מפתחים, מנהלי רשת ומנהלי IT.

איך זה עובד, בקצרה

  1. לפני כל פעולה Claude מציג רשימה ממוספרת ומחכה: "אשר 1,3 / דחה 2 / שנה 4". מה שלא אושר לא נעשה.
  2. הוא כותב רק בתיקייה שהגדרתם. קבצי סודות לא נפתחים ולא מודפסים.
  3. כל ריצה מתועדת בקובץ התקדמות וביומן, ומשם אפשר להמשיך בצ'אט חדש.
  4. מודעות לטוקנים ולמכסה: הפרוטוקול עוקב אחרי שימוש בטוקנים לכל ריצה, מזכיר לכם לדווח על ניצול הסשן, ומתאים מקביליות ובחירת מודל כדי לא לחרוג מהמכסה ולא להשאיר אותה ללא ניצול.

התחלה בחמש דקות

ראו quickstart. בקצרה: מוסיפים להוראות הפרויקט שורה אחת, "לקרוא את <נתיב>/index.md ולעבוד לפיו".

מבנה המאגר ומי קורא מה

  • proto_draft/ (בעתיד proto_approved/): הפרוטוקול עצמו. הצ'אט קורא אותו, החל מ-index.md.
  • בתוך הפרוטוקול: profiles.md (פרופילים מקצועיים), core/remote_protocol.md (פרוטוקול ממקור מרוחק והגדרות פרויקט מקומיות), tools_build/ ו-tools_install/ (קטלוגי כלים), security/ (פרוטוקולי אבטחה).
  • docs/he/ ו-docs/en/: תיעוד לבני אדם בעברית ובאנגלית. הצ'אט לא צריך לקרוא אותו, ו-docs/reference/ נוצר מהפרוטוקול.
  • SECURITY.md: איך מדווחים על פגיעות. .gitignore: קבצים שאסור להכניס למאגר.
  • LICENSE.md, LICENSE-CODE.md, NOTICE.md, CITATION.cff: רישיון וייחוס בשורש.

תיעוד

מסמך תוכן
docs/he/overview.md סקירה קצרה: מה זה, איזו בעיה זה פותר, ואיפה הפרויקט עומד
docs/he/quickstart.md פרויקט חדש או מעבר מפרויקט קיים, צעד אחר צעד
docs/he/concepts.md המושגים: אישור, מודולים ומתגים, ריצות, החלטות, סודות
docs/he/faq.md שאלות נפוצות ותקלות
docs/he/security.md מה מוגן, מה לא נאכף, ואיך מדווחים על פגיעות
docs/reference/ מודולים, הגדרות, תבניות, כלים ומזהים (נוצר אוטומטית)
docs/he/contributing_profiles.md איך לתרום פרופיל מקצועי

נקודת הכניסה של הפרוטוקול עצמו, שהצ'אט קורא, היא proto_draft/index.md. אין צורך שהצ'אט יקרא את docs/.

רישיון וייחוס

תרומה ודיווח

הצעות לשיפור והערות: Issues בפרויקט. דיווח על פגיעות אבטחה: docs/he/security.md.

About

A generic protocol for safe, well-documented work with AI agents connected to a computer or server: numbered approval before every action, writes limited to a scoped folder, secret protection, three risk tiers, and run logs that carry context across sessions.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages