---
title: "AGENTS.md: المسارات والتنسيق · DotsAgent"
description: "مكان AGENTS.md، وتنسيقه وبيانات Frontmatter فيه، وكيفية دمج النسخ العامة والمتداخلة، والأدوات التي تقرؤه. تم التحقق في 2026-10-01."
url: https://dotsagent.io/ar/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: مكانه وكيفية قراءته من الأدوات

ملف AGENTS.md هو ملف Markdown نصي يضم تعليمات المشروع، وتقرأه معظم وكلاء البرمجة دون إعداد إضافي. ساهمت OpenAI به في Agentic AI Foundation التابعة لـ Linux Foundation، وتستخدمه أكثر من 60k من مشاريع المصدر المفتوح.

## مكان الملف

- ملف AGENTS.md في جذر المستودع، للمشروع بأكمله.
- ملفات AGENTS.md متداخلة داخل المجلدات الفرعية أو الحزم؛ يستخدم الوكلاء الملف الأقرب في شجرة المجلدات.
- OpenAI Codex: ملف عام ~/.codex/AGENTS.override.md، أو ~/.codex/AGENTS.md إذا كان الأول فارغًا أو غير موجود.
- Cline: ملف عام ~/.agents/AGENTS.md.
- يقبل Claude Code أيضًا الملف .claude/AGENTS.md.

## التنسيق

Markdown نصي بلا ترويسة front matter أو حقول إلزامية؛ يمكنك استخدام أي عناوين. لا يفرض التنسيق حدًا للحجم، لكن OpenAI Codex يتوقف عن القراءة عند project_doc_max_bytes، الذي يبلغ 32 KiB افتراضيًا.

`AGENTS.md`

```
# Acme web app

Customer-facing web app with an admin area and a REST API.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`

## Code style

- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.

## Never

- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
```

## الأولوية والدمج

تسري تعليمات ملف AGENTS.md الأقرب إلى الملف قيد التحرير، وتتجاوزها أي تعليمات صريحة في المحادثة. يضم OpenAI Codex محتوى ملف واحد من كل مجلد، بدءًا من جذر المشروع وصولًا إلى مجلد العمل؛ لذا تأتي الملفات الأقرب أخيرًا وتكون لها الأولوية. يتجاهل Claude Code ملف AGENTS.md افتراضيًا عند وجود CLAUDE.md.

## الأدوات التي تقرأه

| الأداة | الدعم |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | مدعوم أصليًا. يقرأ ملفًا عامًا، ثم ملفًا واحدًا كحد أقصى من كل مجلد، من الجذر إلى مجلد العمل، بحد افتراضي قدره 32 KiB. |
| [Claude Code](https://code.claude.com/docs/en/memory) | مدعوم أصليًا منذ v2.1.277، لكن فقط عند عدم وجود CLAUDE.md أو CLAUDE.local.md، ما لم تُضبط القيمة على claude-md-and-agents-md. |
| [Cursor](https://cursor.com/docs/context/rules) | مدعوم أصليًا في الجذر والمجلدات المتداخلة؛ تُدمج الملفات المتداخلة مع ملفات المجلدات الأم، وتكون الأولوية للملف الأكثر تحديدًا. |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | مدعوم أصليًا في أي مكان داخل المستودع؛ تكون الأولوية للملف الأقرب. |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | مدعوم أصليًا. يُفعّل ملف الجذر دائمًا؛ ويسري ملف المجلد الفرعي على ذلك المجلد. |
| [Cline](https://docs.cline.bot/features/cline-rules) | مدعوم أصليًا، إضافةً إلى ملف عام ~/.agents/AGENTS.md؛ فعّله أو أوقفه من لوحة Rules. |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | اختياري: أضف AGENTS.md إلى context.fileName في .gemini/settings.json. |
| [Aider](https://agents.md/) | اختياري: أضف read: AGENTS.md إلى .aider.conf.yml. |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | مدعوم أصليًا، بوصفه ملف تعليمات التشغيل المطلوب في مساحة عمل الوكيل. |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | واحد من 23 أداة مدرجة في agents.md، ومنها Amp وJules وZed وWarp وgoose وopencode وJetBrains Junie؛ لم نتحقق من هذه الأدوات واحدةً تلو الأخرى. |

## نصائح

- هل تريد إعادة تسمية AGENT.md قديم؟ يقترح agents.md تنفيذ mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md للإبقاء على عمل الاسمين.
- اذكر أوامر الاختبار وفحص التنسيق؛ يحاول الوكلاء تشغيل الفحوصات المذكورة وإصلاح الإخفاقات قبل الانتهاء.
- في المستودع أحادي البنية، أضف ملف AGENTS.md قصيرًا لكل حزمة بدلًا من إطالة ملف الجذر.
- في OpenAI Codex، تكون الأولوية لملف AGENTS.override.md على ملف AGENTS.md في المجلد نفسه.

أنشئ ملف AGENTS.md وملفات قواعد متوافقة لخمسة أدوات من نموذج واحد. [افتح مولّد AGENTS.md →](https://dotsagent.io/ar/instructions)

## ملفات التعليمات الأخرى

[CLAUDE.md](https://dotsagent.io/ar/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/ar/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/ar/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/ar/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/ar/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/ar/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/ar/instructions/files/openclaw-workspace)

## المصادر

1. [agents.md](https://agents.md/)/
2. [github.com](https://github.com/agentsmd/agents.md)/agentsmd/agents.md
3. [linuxfoundation.org](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation)/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foun
4. [openai.com](https://openai.com/index/agentic-ai-foundation/)/index/agentic-ai-foundation/
5. [developers.openai.com](https://developers.openai.com/codex/guides/agents-md)/codex/guides/agents-md

مرجع مستقل لمطوّري وكلاء الذكاء الاصطناعي. لا تربطنا أي علاقة بأي من المورّدين المذكورين هنا.

© 2026 DotsAgent · تم التحقق من المعلومات في 1 أكتوبر 2026