עוזרי המפתחים שלכם, כגון Claude Code, Codex ו-Cursor, וסוכני Coroid קוראים את אותו AGENTS.md. רובו משרת את שניהם: הפקודות, הכללים והגבולות. החלק שאינו משרת את שניהם הוא זרימת העבודה של Git, מכיוון ש־Coroid יוצר את הענף, ההתחייבות ובקשת המשיכה בעצמו.
מה סוכני Coroid קוראים
לפני כל משימה, סוכני Coroid קוראים את קבצי הזיכרון בשורש המאגר: AGENTS.md, CLAUDE.md, GEMINI.md וכללי Cursor ב
.cursor/rules. הם מקיימים @ ייבואים, והוראות זהות נכללות פעם אחת בלבד. בחרו אילו מקורות הסוכנים מקבלים תחת
הגדרות → ידע → הקשר. ראו הקשר פרויקט.
משימה קוראת את הקבצים מהגרסה שלה, כך ששינוי ב AGENTS.md
חל על המשימות שמתחילות לאחר שהיא מגיעה לענף הבסיסי.
מה שמשרת את שניהם
כתבו זאת פעם אחת, עבור כל סוכן:
- פקודות: התקנה, בנייה, בדיקה, והבדיקה השימושית ביותר, כגון חבילה אחת או קובץ אחד. בדקו אותן מעותק נקי, וציינו את התיקייה שבה יופעלו ואת השירותים שהבדיקות זקוקות להם.
- כללים שהקוד אינו מציג: שמות, טיפול בשגיאות, כיצד מחרוזות מתורגמות, אילו תבניות אסורות.
- גבולות: מודולים קפואים, נתיבים שצוות מסוים אחראי עליהם, תלויות שאין להוסיף, קבצים שאסור לערוך באופן ידני.
השאירו זאת קצר. כל שורה נקראת בכל משימה, על ידי כל סוכן. קשרו למסמך ארוך במקום להדביק אותו, והשאירו בחוץ את מה שהקוד כבר מציג.
מה Coroid עושה בעצמו
סוכני Coroid משנים קבצים בסביבת ניסוי. Coroid מבצע את השאר:
| שלב | ב־Coroid |
|---|---|
| ענף | Coroid יוצר ענף אחד לכל משימה: feature/coroid-<id>-<title>, או bugfix/, refactor/, test/ או docs/ לפי סוג העבודה. נתיבי תוכנית משתמשים ב coroid/factory/… |
| התחייבות | Coroid כותב את הודעת ההתחייבות ומוסיף תגי מקור כגון Coroid-Task. כאשר החשבון המחובר שלכם הוא המחבר, הוא מוסיף Co-authored-by: Coroid <ai@coroid.ai> |
| דחיפה | Coroid דוחף את הענף. סביבת הניסוי דוחה git push, git pull, git fetch ו git clone, ואינה מאחסנת אישורים עבור הספק שלכם. |
| בקשת משיכה | Coroid פותח אותה, עם כותרת על שם המשימה, ותיאור שמקשר למשימה, לקריטריוני הקבלה שלה ולתוצאות הבדיקה והסקירה שלה. |
הוראות כגון "לעבוד על ws/ ענף", "לפתוח את pull request עם
gh pr create" או "לסיים כל התחייבות בשורת מחבר משותף" אינן חלות בתוך Coroid. רק הקבצים שהסוכן משנה יוצאים מסביבת הניסוי, כך שענף או התחייבות שהוא יוצר שם נזרקים. Coroid מודיע לסוכנים שלו על כך לפני קובצי ההוראות שלכם: הם דולגים על שלבים אלו וממשיכים לשאר.
שום דבר אינו מתחייב לענף הבסיסי שלכם: ראו הגדרות מאגר וענף.
ציינו אילו חלקים חלים היכן
סוכני Coroid כבר דולגים על זרימת העבודה של Git שלכם. ציון זה בקובץ מסייע לכל הקוראים, כולל אנשים, ושומר שלב ייחודי ל־Coroid, כגון בדיקה שיש להפעיל לפני סיום, במקום אחד. הכניסו קטע קצר בחלק העליון:
## Working in Coroid
When you run inside Coroid, Coroid creates the branch, commits, pushes and
opens the pull request. Change files only, and skip "Git workflow" below.
Before you finish, run `npm run validate`.לאחר מכן סמנו את זרימת העבודה המקומית כפי שהיא:
## Git workflow (local agents)
- Branch: `ws/<nn>-<name>` from `main`, in your own worktree.
- Commit messages end with your assistant's co-author line.
- Run `npm run check:local`, then open the pull request with `gh pr create`.עוזרי המפתחים שלכם שומרים על זרימת העבודה שלהם, ואיש אינו צריך לנחש אילו צעדים שייכים למי.
בדיקות שכל pull request חייב לעבור
בדיקה שנכתבה רק ב AGENTS.md רצה כאשר סוכן מחליט להפעיל אותה.
התחייבויות של Coroid גם דולגות על ה־Git hooks של המאגר שלכם, כגון Husky או Pre-commit. בדיקה שחייבת לחול על כל שינוי נמצאת ב
בקרת איכות כ פקודת מאגר בדיקה:
- Coroid מפעיל אותה על השינויים שהסוכנים שלו עושים.
- כאשר בדיקות pull request פועלות, הן גם רצות על בקשות המשיכה שהצוות שלכם פותח, כולל אלו שנכתבו עם Claude Code, Codex או Cursor.
שתי דרכי העבודה נפגשות אפוא לאותו רף. ראו מדיניות ואילוצי איכות.
לגבי כללי האנטי-סלופ, עוזר מפתחים יכול לבקש אותם מ־Coroid דרך MCP. anti_slop_rules מחזיר קטע טקסט שמציין את כללי הפרויקט עבור
AGENTS.md: ראו
כללי אנטי-סלופ מהעורך שלכם.
CI שרץ רק עבור ענפים מסוימים
אם ה־CI או הגנת הענפים שלכם רצים רק עבור שמות ענפים מסוימים, הוסיפו את של Coroid:
feature/coroid-*
bugfix/coroid-*
refactor/coroid-*
test/coroid-*
docs/coroid-*
coroid/factory/**אחרת, בקשות המשיכה של Coroid ייפתחו ללא הבדיקות שצוותכם סומך עליהן.
קובץ אחד עבור כל כלי
שמרו את ההוראות פעם אחת, ב AGENTS.md:
- Codex ו Cursor קרא
AGENTS.md. - Claude Code קורא
CLAUDE.md. הפוך זאת לקו אחד@AGENTS.mdקו, בתוספת כל מה ש-Claude Code צריך. - Cursor גם הוא קורא את הכללים שלו ב-
.cursor/rules. Coroid קורא אותם כפי ש-Cursor מיישם אותם: ראה הקשר הפרויקט.
Coroid קורא CLAUDE.md עם ייבוא והכללה של AGENTS.md פעם אחת.
בדוק מה Coroid קורא
תחת הגדרות → ידע → הקשר, מקורות מאגר מציג כל קובץ עם מספר משוער של טוקנים ומתג הפעלה. ערוך פותח שם קובץ. שמירה פותחת pull request על מאגר מחובר, כך שהשינוי עובר את אותו תהליך בדיקה כמו כל שינוי אחר.