מה זה AGENTS.md ואיך לכתוב אחד משלכם בתוך 30 דקות

חומרים מעשיים על וייב קודינג ועבודה עם סוכנים: התיעוד של Ailoot.

AGENTS.md בפסקה אחת#

להלן נבחן הפורמט על סמך agents.md, התיעוד של OpenAI Codex, JetBrains Junie, Cursor Rules Docs, יומן השינויים של GitHub Copilot Coding Agent והודעת העיתונות של Linux Foundation על הקמת Agentic AI Foundation. כל הנתונים והמאפיינים מעודכנים ל-30 במאי 2026, והתמיכה ב-AGENTS.md ב-Claude Code מתוארת לפי התיעוד של Anthropic, עם עדכון מ-24 בספטמבר 2026.

אם אין לכם מושג מהי המיני-מערכת הזאת של כלים בשוק ולמה הם צריכים קובץ משותף, קראו תחילה את המדריך „במה לתכנת ב-2026: 8 כלי AI מ-Claude Code ועד Antigravity”. המאמר הזה מתמקד בפורמט AGENTS.md ובאופן שבו כותבים אחד משלכם בתוך 30 דקות.

מה זה AGENTS.md ומאיפה הוא הגיע?#

בעבר, לכל כלי AI היה קובץ כללים משלו: ל-Anthropic היה CLAUDE.md, ל-Cursor היה .cursorrules, ל-GitHub היה .github/copilot-instructions.md, ל-Aider היה .aider.conf.yml, ול-JetBrains היה .junie/guidelines.md. אם לצוות שלכם היו שלושה סוכנים שונים, פירוש הדבר היה שלושה קבצים מקבילים עם אותו תוכן, שהיו מתפצלים תוך שבוע.

OpenAI הייתה הראשונה שנמאס לה מזה. באוגוסט 2025 היא פרסמה את Codex CLI ובמקביל השיקה את agents.md כפורמט פתוח. מתוך האתר:

„חשבו על AGENTS.md כעל README לסוכנים.”

(agents.md, תורגם מאנגלית)

הנקודה העיקרית היא ש-AGENTS.md משלים את README. README נכתב לאנשים: „מהו הפרויקט, איך להריץ אותו מקומית, איך לתרום.” AGENTS.md נכתב לסוכן: פקודות shell מדויקות, קריטריונים ניתנים לאימות להשלמת העבודה וגבולות כגון „אסור לגעת בזה לעולם.”

מתוך האתר:

„AGENTS.md משלים את README: הוא מכיל הקשר נוסף, לפעמים מפורט, שהסוכן צריך — שלבי בנייה, בדיקות ומוסכמות שיכבידו על README או פשוט אינן נחוצות לתורמים אנושיים.”

(agents.md, תורגם מאנגלית)

עד ספטמבר 2025, GitHub Copilot Coding Agent תמך בפורמט (יומן שינויים, 28.08.2025). עד דצמבר הצטרפו Cursor, Junie, Gemini CLI, Aider ועוד תריסר כלים. ב-9 בדצמבר 2025 הקימה Linux Foundation את Agentic AI Foundation (AAIF): שלושת הפרויקטים המייסדים שלה היו AGENTS.md של OpenAI, MCP של Anthropic ו-goose של Block. החברות המייסדות היו AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft ו-OpenAI. עד 24 בפברואר 2026 כבר כללה הקרן 146 ארגונים, ובהם Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, UiPath ו-Hitachi.

מאותו רגע, AGENTS.md חדל להיות „עוד משהו של OpenAI” והפך לסטנדרט דה-פקטו.

אילו סוכני AI קוראים את AGENTS.md ואילו לא?#

טבלת התמיכה נכון ל-30 במאי 2026; השורה של Claude Code עודכנה ב-24 בספטמבר 2026:

Anthropic הייתה האחרונה מבין השחקניות המרכזיות שהצטרפה. באוגוסט 2025 נפתחה במאגר הרשמי anthropics/claude-code בקשה מס' 6235 לתמיכה ב-AGENTS.md.

הבקשה נשארה פתוחה כמעט שנה ונסגרה ב-17 באוגוסט 2026; גרסה 2.1.277 עם תמיכה ב-AGENTS.md יצאה ב-18 בספטמבר. ההיגיון של Anthropic הוא כזה: ל-CLAUDE.md יש עדיפות, ו-AGENTS.md נקרא כשאין CLAUDE.md בתיקיית העבודה או בתיקיית אב כלשהי. לפי התיעוד, כך זה עובד:

הקאץ': גם CLAUDE.local.md אישי נחשב, ובמקרה כזה Claude Code מפסיק לקרוא AGENTS.md. אפשר לשנות את ההתנהגות הזאת ב-/config, תחת Project instructions — למשל, להגדיר ל-Claude Code לקרוא את שני הקבצים יחד. בגרסאות מוקדמות מ-2.1.277, AGENTS.md לא ייטען אוטומטית; השורה @AGENTS.md בתוך CLAUDE.md עדיין משמשת פתרון עוקף.

במה AGENTS.md שונה מ-CLAUDE.md ומ-.cursorrules?#

השוואה בין ארבעת הפורמטים נכון ל-30 במאי 2026:

הרעיון המרכזי: AGENTS.md פותר את בעיית „קובץ אחד לכל הסוכנים”, אבל לא את בעיית „הגדרות אישיות שלא מכניסים ל-commit”. ל-Claude Code יש CLAUDE.local.md לשם כך, ול-Cursor יש קובצי .mdc מקומיים של משתמש. AGENTS.md לבדו אינו מספק זאת — צריך לשלב אותו עם קבצים אחרים או להסכים כצוות לכתוב כללים אישיים בחלקים שמתעלמים מהם ב-git.

פרט חשוב נוסף הוא monorepos. Codex ו-Cursor מיישמים את הכלל „AGENTS.md הקרוב ביותר מנצח”:

„ב-monorepo, הציבו AGENTS.md נפרד בכל חבילה. הסוכנים קוראים אוטומטית את הקובץ הקרוב ביותר בעץ התיקיות, והקרוב ביותר מנצח.”

(agents.md, תורגם מאנגלית)

ב-agents.md מצוין שב-monorepo הראשי של OpenAI יש 88 קובצי AGENTS.md עבור חבילות משנה שונות. אם אתם עובדים ב-monorepo, פזרו את הכללים בין הרמות: כללים כלליים בשורש, וכללים ספציפיים בתיקיות משנה.

מה צריך להופיע ב-AGENTS.md טוב?#

האתר agents.md מציע פורמט גמיש — „כל Markdown”. אבל 80% מהקבצים הטובים בעולם האמיתי כוללים את אותם שמונה סעיפים. הכלל המרכזי: כל פריט צריך להיות פקודה מדויקת או דוגמה קונקרטית. רעיון מופשט כמו „כתבו קוד נקי” ייזנח על ידי הסוכן.

1. סקירת הפרויקט — 2–3 שורות. מהו הפרויקט, למי הוא מיועד ומה מטרתו העיקרית. בלי שיווק. דוגמה: „בוט Telegram לקליטת משתמשים בסדנה בתשלום. מחסנית טכנולוגית: Next.js 14, Prisma, PostgreSQL. מופעל כשנוצרת רשומה חדשה ב-purchases.”
2. פקודות התקנה — פקודות shell מדויקות להרצה מקומית. npm install, npm run dev, npm run build. בלי „בדרך כלל כך עושים את זה”.
3. סגנון קוד / מוסכמות — כללים ספציפיים עם דוגמה, לא „כתבו בצורה נקייה”. למשל: „TypeScript strict, מירכאות יחידות, בלי default exports, שמות רכיבים ב-PascalCase, שמות hooks מתחילים ב-use.”
4. עצות לסביבת הפיתוח — היכן נמצאים דברים חשובים. אילו משתנים נדרשים ב-.env, היכן נשמרים סודות, אילו פורטים בשימוש ואיך לעבוד עם DB מקומי.
5. הוראות בדיקה — איך להריץ בדיקה מסוימת ומה נחשב „ירוק”. למשל: npm test -- --testPathPattern=user-auth; מצפים ל-100% הצלחה.
6. הנחיות PR / commit — פורמט הודעת commit, רשימת בדיקה לפני PR (בדיקות, linter, תיעוד) ומי מאשר.
7. שיקולי אבטחה — מה לעולם אסור שיקרה. „לעולם אל תכניסו .env ל-commit. סודות שייכים ל-Vault בלבד. אל תציגו נתונים אישיים של משתמשים ביומנים.”
8. גבולות / לעולם אל תעשו זאת — איסורים עם חלופה. „אל תשתמשו ב-git push --force על main. אם צריך לחזור לאחור, השתמשו ב-git revert או ב-git reset על ענף תכונה.”

לכל סעיף, השתמשו בעיקרון „פקודה במקום רעיון”. הסוכן יתעלם מ„היזהרו מהגירות”. הוא יציית ל„לפני alembic upgrade head, הריצו alembic check. אם מתקבלת שגיאה, אל תחילו את ההגירה; שאלו אותי.”

תבנית AGENTS.md מוכנה לשימוש (להעתקה ולהתאמה)#

# AGENTS.md

## סקירת הפרויקט

<project-name> - <one phrase describing its purpose>.
Stack: <Next.js / Python / Go / ...>.
Main entities: <users, orders, posts ...>.
Details for people are in README.md.

## פקודות התקנה

```bash
# first install
npm install
cp .env.example .env  # then fill in manually; see list below

# run
npm run dev           # dev server on :3000
npm run build         # production build
npm run start         # run production build
```

## סביבת פיתוח

- Node 20+ (via nvm: `nvm use 20`)
- PostgreSQL 16 locally on :5432 (`docker-compose up postgres`)
- Redis is optional, needed only for queues (`docker-compose up redis`)
- `.env`: `DATABASE_URL`, `STRIPE_KEY`, `RESEND_API_KEY`, `JWT_SECRET`
- Never read the entire `.env` file. If you need one variable: `grep "^VAR=" .env`

## סגנון קוד

- TypeScript strict mode
- Single quotes, no semicolons (unless ESLint requires them)
- Imports: external first, then internal via `@/`, then relative
- Components in PascalCase; hooks start with `use`
- No `any` without an explicit comment explaining “why it can’t be typed”

דוגמה למודול טוב:

```ts
import { z } from 'zod'

const UserSchema = z.object({
  email: z.string().email(),
  name: z.string().min(2),
})

export function parseUser(raw: unknown) {
  return UserSchema.parse(raw)
}
```

## בדיקות

```bash
npm test                                # all tests
npm test -- --testPathPattern=auth      # auth only
npm test -- --watch                     # watch mode
```

כל הבדיקות חייבות לעבור (להיות ירוקות) לפני commit. אם בדיקה נכשלת, אל תעשו commit; שאלו אותי מה לעשות.

## הנחיות ל-Pull request

- פורמט commit: `<type>(<scope>): <description>` (`feat(auth): add magic-link`)
- לפני PR: `npm run build && npm test && npm run lint`
- תיאור PR = מה משתנה, למה ואיך לבדוק
- אל תאשרו את ה-PR שלכם — תמיד המתינו לביקורת אנושית

## אבטחה

- סודות רק ב-`.env` וב-Vault, לעולם לא בקוד
- אל תרשמו נתונים אישיים (email, phone, name) ביומנים
- בעבודה עם DB הייצור, השתמשו רק בשאילתות לקריאה בלבד אלא אם קיבלתם הרשאה מפורשת
- אל תקודדו מפתחות API של שירותים חיצוניים (Stripe, OpenAI) בתוך בדיקות

## לעולם אל תעשו זאת

- אל תריצו `git push --force` ל-main. אם צריך לחזור לאחור, השתמשו ב-`git revert` או פתחו PR חדש
- אל תריצו הגירות DB בלי `alembic check` (או המקבילה ב-ORM שלכם)
- אל תשתמשו ב-`npm install -g` או ב-`sudo` לתלויות הפרויקט
- אל תוסיפו תלויות בלי אישור (במיוחד כבדות: תוספי webpack, ORM)

בממוצע, אורך התבנית הוא 80–120 שורות. אם הקובץ עולה על 150 שורות, זה סימן שהגיע הזמן לארגן אותו מחדש: להעביר משהו ל-docs/, לקשר למשהו או לדחוס משהו לשורה אחת. בפועל, קבצים בני 100–150 שורות עובדים הכי טוב; מעבר לנקודה הזאת, היתרונות באיכות מתחילים להתהפך.

אילו 5 כללים הופכים את AGENTS.md לשימושי באמת?#

1. פקודות במקום רעיונות. סוכן אינו מבין „היזהרו מהגירות”. הוא יציית ל-alembic check לפני alembic upgrade head. סוכנים עובדים עם פקודות ותנאים, לא עם מצבי רוח. נסחו את כל הכללים המרכזיים בתבנית „עשו X, אחרת Y”.

2. איסורים עם חלופה. הסוכן יתעלם בשקט מ„אל תעשו force push” אחרי שתיים או שלוש הנחיות. הצמד „אל תעשו X; עשו Y במקום” עובד. דוגמה: „אל תשתמשו ב-git push --force על main; אם צריך לחזור לאחור, השתמשו ב-git revert או פתחו PR חדש.”

3. מקור אמת אחד בדיוק. AGENTS.md בשורש הוא מקור האמת של הפרויקט כולו. אם יש לכם monorepo, השתמשו בקובצי AGENTS.md מקוננים בתיקיות משנה, לפי הכלל „הקרוב ביותר מנצח”. בלי קבצים מקבילים עם הוראות סותרות.

4. קריטריונים ניתנים לאימות להשלמת העבודה. „הבדיקות חייבות לעבור” אינו מועיל. קריטריון מדויק הוא: npm test מחזירה קוד יציאה 0 ואינה מדפיסה FAIL ל-stdout. גם „הקוד צריך להיות נקי” אינו מועיל. קריטריון מדויק הוא: npm run lint עובר בלי אזהרות. הסוכן מבין מה פירוש „סיימנו” רק כשמתארים במפורש את התנאי.

5. קובץ קצר מ-150 שורות. מעבר ל-150 שורות, המדדים מתחילים להידרדר: הסוכן משקיע יותר הקשר בקריאה ומפספס כללים חשובים. אם הכול לא נכנס, העבירו את הפרטים ל-docs/architecture.md וקשרו אליו מתוך AGENTS.md, תוך השארת פקודות וגבולות בלבד בקובץ.

אילו 10 טעויות הופכות את AGENTS.md לזבל?#

1. כללים מעורפלים בלי פקודות. הסוכן יתעלם מ„היזהרו מהגירות” — המשפט הזה ריק מתוכן מבחינתו. רק פקודה ספציפית עם תנאי עובדת: „הריצו alembic check לפני alembic upgrade head. אם יש שגיאה, אל תחילו את ההגירה; שאלו אותי.”

2. „קוד נקי.” ביטוי חסר תועלת. החליפו אותו בדפוס ספציפי: „השתמשו ברכיבים פונקציונליים עם hooks. דוגמה: function LoginForm() { const [email, setEmail] = useState(''); ... }”

3. טקסט לא מובנה. אם AGENTS.md הוא 300 שורות של טקסט ללא כותרות, הסוכן יבזבז 80K אסימוני הקשר על קטעים לא רלוונטיים ויפספס את העיקר. השתמשו בכותרות H2/H3, בסעיפים קצרים וברשימות תבליטים.

4. קובץ ארוך מ-150 שורות. מדדי האיכות יורדים מעבר לסף הזה. פצלו לקובץ ראשי ולקישורים לפרטים בתיקיית docs/.

5. 30 איסורים או יותר בלי חלופות. אם הקובץ מכיל רשימה ארוכה של „אל תעשו X, אל תעשו Y” בלי להסביר „עשו Z במקום”, הסוכן יגמגם ויפעל בעיוורון.

6. שכפול README.md. אם כבר כתבתם ב-README איך להתקין ולהפעיל, אל תעתיקו זאת ל-AGENTS.md. במקום זאת, הפנו ל-README בשורה אחת ותארו ב-AGENTS.md מה הסוכן צריך ובני אדם תורמים לא.

7. הטמעת סודות בקובץ. AGENTS.md עשוי להיות ציבורי (הוא נמצא ב-git). אין לכלול מפתחות API, אסימונים או סיסמאות אמיתיים. יש לכלול רק הפניות למאגרי סודות: „ראו Vault: secret/staging/db.”

8. סדרי עדיפויות סותרים ללא דירוג. „עבדו מהר” + „שמרו על כיסוי בדיקות של 90%” משאירים את הסוכן בלי לדעת מה לבחור. דרגו אותם במפורש: „כיסוי בדיקות ≥80% קודם, ואז מהירות. במקרה של התנגשות, הבדיקות קודמות.”

9. תיעוד מיושן. תיאור ארכיטקטורה שאומר REST+polling, כשהמציאות כבר WebSockets. הסוכן פועל לפי התיאור המיושן ושובר את הארכיטקטורה. הכלל: עדכנו את AGENTS.md באותו PR עם שינויי הארכיטקטורה בקוד.

10. הגזמה ארכיטקטונית למשימה פשוטה. אם מישהו ביקש לשנות שתי שורות בקובץ תצורה, הסוכן לא צריך לקרוא את הטופולוגיה המלאה של 14 מיקרו-שירותים. העבירו ארכיטקטורה „עמוקה” ל-docs/architecture.md; השאירו ב-AGENTS.md רק „אם המשימה ארכיטקטונית, קראו את docs/architecture.md.”

המחקר של GitHub Blog על יותר מ-2,500 מאגרי AGENTS.md מציג את המסקנה העיקרית:

„רוב קובצי הסוכנים נכשלים כי הם כלליים מדי. 'אתה עוזר מועיל לתכנות' לא עובד.”

(GitHub Blog, תורגם מאנגלית)

איך לשמור את AGENTS.md ואת CLAUDE.md באותו מאגר?#

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

תרחיש 1: Claude Code בלבד. השאירו את CLAUDE.md והשתמשו בכל התכונות של Claude Code: ~/.claude/CLAUDE.md להוראות ברמת המשתמש, CLAUDE.md לפרויקט, CLAUDE.local.md לעקיפות אישיות, @import להכללת קבצים אחרים ו-.claude/skills/ למיומנויות ייעודיות. אין צורך ב-AGENTS.md.

תרחיש 2: כמה לקוחות קידוד. שמרו כללים משותפים ב-AGENTS.md, ואז חברו ובדקו כל לקוח בנפרד. Gemini CLI תומך בהגדרת שם קובץ הקשר; Aider יכול לטעון קובץ באמצעות הגדרת הקריאה. אלה מסלולי טעינה מפורשים, ולא גילוי אוטומטי זהה.

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

תרחיש 3: צוות מעורב (Claude Code ואחרים). זו ההגדרה הנפוצה ביותר ב-2026. הפתרון הוא להפוך את AGENTS.md לקובץ הראשי. אם אין לכם כללים ייחודיים ל-Claude Code, אל תיצרו CLAUDE.md כלל: מאז גרסה 2.1.277, Claude Code קורא AGENTS.md כשאין בפרויקט CLAUDE.md. אם יש לכם כללים כאלה, הפכו את CLAUDE.md ל-symlink או לעטיפה קצרה עם ייבוא @AGENTS.md.

לפני שינוי אחד הקבצים, בדקו וגבו את שניהם. אם שניהם קיימים, מזגו הוראות משותפות שאינן סותרות ל-AGENTS.md והשאירו הוראות ייחודיות ל-Claude ב-CLAUDE.md עם ייבוא @AGENTS.md. שמרו קישורים סמליים קיימים במקום להחליפם.

לקובץ CLAUDE.md רגיל רק כאשר AGENTS.md חסר, הבדיקה הבאה ב-shell של macOS/Linux מסרבת לדרוס יעד או קישור סמלי קיימים:

if [ -e AGENTS.md ] || [ -L AGENTS.md ]; then
  printf '%s\n' 'STOP: AGENTS.md exists; merge both files first.' >&2
elif [ -f CLAUDE.md ] && [ ! -L CLAUDE.md ]; then
  mv CLAUDE.md AGENTS.md && ln -s AGENTS.md CLAUDE.md
else
  printf '%s\n' 'STOP: inspect the existing CLAUDE.md path first.' >&2
fi

אחרי שינוי שם מוצלח, CLAUDE.md הוא קישור סמלי ל-AGENTS.md. כל הסוכנים שקוראים AGENTS.md רואים אותו תוכן. Claude Code, שקורא CLAUDE.md, רואה את אותו הדבר דרך ה-symlink.

ב-Windows, יצירת symlink דורשת Developer Mode (או הרשאת Admin), מה שעשוי להיות לא נוח לצוות כולו. חלופה היא CLAUDE.md קצר שמייבא את AGENTS.md:

# CLAUDE.md

@AGENTS.md

## Claude Code ספציפי

- השתמשו ב-.claude/skills/ להנחיות ייעודיות
- בעבודה עם Skills, עיינו ב-.claude/skills/INDEX.md
- השתמשו ב-Plan Mode לפני שינויים גדולים (Shift+Tab)

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

הפריסה המקובלת לצוות רב-כלי ב-2026:

repo-root/
├── AGENTS.md                              # מקור האמת, ≤150 שורות
├── CLAUDE.md                              # רק אם יש כללים ייחודיים ל-Claude: symlink → AGENTS.md או @AGENTS.md + הרחבות
├── .cursor/rules/                         # עקיפות ממוקדות ל-Cursor בלבד
├── .github/copilot-instructions.md        # „עיינו ב-AGENTS.md”, אם משתמשים בו
└── docs/architecture.md                   # ארכיטקטורה מפורטת שאליה AGENTS.md מפנה

מידע נוסף על CLAUDE.md נמצא במדריך „איך להגדיר את CLAUDE.md כראוי”. להקשר נוסף על הסיבה שסוכן זקוק לקובץ הוראות גדול, קראו את „מהי הנדסת הקשר”.

מה השתנה ב-2026: למה AAIF הכניסה את AGENTS.md תחת Linux Foundation?#

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

בהודעת עיתונות מ-9 בדצמבר 2025, הודיעה Linux Foundation על הקמת Agentic AI Foundation כמסגרת לשלושה פורמטים:

• AGENTS.md של OpenAI — פורמט לקובץ הוראות לסוכנים
• Model Context Protocol (MCP) של Anthropic — פרוטוקול לחיבור כלים חיצוניים לסוכנים
• goose של Block — מסגרת קוד פתוח לסוכנים

מתוך הודעת העיתונות של Linux Foundation:

„איחוד הפרויקטים האלה תחת מטריית AAIF מבטיח שיוכלו להתפתח בשקיפות וביציבות שרק ממשל פתוח יכול לספק.”

(הודעת העיתונות של Linux Foundation, 9 בדצמבר 2025, תורגם מאנגלית)

עד 24 בפברואר 2026 השתייכו ל-AAIF 146 ארגונים (97 חברים חדשים בתוך חודשיים). החברות החדשות ברמת Gold כללו את Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, Hitachi, UiPath, American Express ו-Autodesk. Anthropic נמצאת ברמת Platinum ומקדמת את MCP. OpenAI נמצאת ברמת Platinum ומקדמת את AGENTS.md. Block נמצאת ברמת Platinum עם goose.

הדבר משנה את מעמדו של AGENTS.md: מ„פורמט של OpenAI” לסטנדרט בתעשייה. באביב 2026 Claude Code עדיין עמד מן הצד, אך בספטמבר למד לקרוא את AGENTS.md בעצמו, עם גרסה 2.1.277. CLAUDE.md לא נעלם, וכברירת מחדל עדיין יש לו עדיפות אם הוא נמצא בפרויקט.

נקודת פתיחה מעשית היא כללי פרויקט משותפים ב-AGENTS.md, עם הייבוא, קובץ העטיפה או הגדרת הקריאה המפורשת שדורש כל לקוח שבשימוש. ב-Claude Code בדקו את הגרסה המותקנת ואת קדימות קובצי ההוראות לפני החלטה על ייבוא ב-CLAUDE.md או symlink. אמתו טעינה בכל לקוח; המדריך אינו מבסס אחוז כיסוי כללי.

מה הלאה?#

AGENTS.md הוא אבן הבניין הראשונה ב„איך להגיע להסכמה עם סוכן כך שיעבוד באופן צפוי”. אחריו באה אבן הבניין השנייה — תיקיית הידע של הפרויקט, שמכילה הקשר עסקי, קהל, מוצרים ומחירים. אבן הבניין השלישית היא הנדסת הקשר, שמחברת הכול: אילו קבצים הסוכן רואה בכל שלב, איך שומרים על המצב בין הפעלות ומה הדרך לעבור בין מודלים שונים.

חומרים מעשיים: התיעוד של Ailoot.

חומרים וכלים נוספים: Ailoot.