‏Agent behavior؛ استاندارد توصیف رفتار ایجنت‌های AI

تو این پروژه اومده که Agent behavior یه فرمت استاندارد برای نوشتن رفتاریه که از یه ایجنت AI انتظار می‌ره، اون هم نه توی یه تعامل، بلکه در طول کلی تعامل تکرارشونده. هر spec یه فایل Markdown ساده‌ست که کنار خود کد زندگی می‌کنه و همراهش نسخه‌بندی می‌شه، تا مرورکننده‌ها، rubricها و evalها یه چیز مشخص برای سنجیدن داشته باشن.

ساختارش عمداً کوچیکه: هر spec یه پوشه زیر .agents/behaviors/ داره با یه فایل BEHAVIOR.md توش. فایل باید فرانت‌متر YAML داشته باشه با دو فیلد اجباری name (حداکثر ۶۴ کاراکتر، فقط حروف کوچک و عدد و خط تیره، هم‌نام پوشهٔ والد) و description (حداکثر ۱۰۲۴ کاراکتر). بدنهٔ فایل آزاده و کلاینت‌ها هم موظفن فیلدهای ناشناختهٔ فرانت‌متر رو نادیده بگیرن.

نویسنده‌ها تشویق شدن هر رفتار رو حول چند بُعد توضیح بدن: Intent (چرا و کِی مهمه)، Evidence (ایجنت قبل از تصمیم چی رو باید بررسی کنه)، Decision، Execution و Recovery برای وقتی که مسیر اول شکست می‌خوره یا شواهد ناقصه. یه نمونهٔ رسمی برای رفتار «اقدام‌های هزینه‌بر» این شکلیه:

---
name: cost-sensitive-actions
description: Surface material costs, ask before expensive actions, and offer lower-cost alternatives.
---

**Intent:** Keep the agent from silently spending money or credits.
**Evidence:** Inspect or estimate cost, credits, and infrastructure impact.
**Execution:** Surface the cost and ask before crossing meaningful thresholds.

نکتهٔ مهم اینه که این فایل‌ها قرار نیست وارد پرامپت اجرا بشن. تو مقاله مرزش با AGENTS.md صریح کشیده شده: اون به ایجنت می‌گه چطور عمل کنه و مخاطبش خود مدل موقع اجراست، ولی BEHAVIOR.md تعریف می‌کنه چی رفتار خوب حساب می‌شه و مخاطبش مرورکننده و نویسندهٔ eval هست. یکی وقتی عوض می‌شه که پیاده‌سازی تغییر کنه، اون یکی وقتی که خودِ استاندارد رفتاری تغییر کنه.

به گفتهٔ نویسنده‌ها فقط رفتارهایی ارزش spec شدن دارن که پرتکرار، پرتأثیر، هویت‌ساز برای ایجنت، یا به‌طور پیش‌فرض مبهم باشن؛ یعنی جایی که دو ایجنت منطقی ممکنه متفاوت رفتار کنن. مشخصات کامل، نمونه‌ها و یه اسکیل برای نوشتن spec هم روی گیت‌هاب در دسترسه.

نکات کلیدی:

• فرمتی برای مستندسازی رفتار مورد انتظار ایجنت، جدا از پرامپت اجرا
• هر spec یه BEHAVIOR.md با فرانت‌متر YAML زیر .agents/behaviors/
• ابعاد پیشنهادی: Intent، Evidence، Decision، Execution، Recovery و failure modes
• AGENTS.md می‌گه چطور عمل کن، BEHAVIOR.md می‌گه چی خوبه
• مناسب مرور ترِیس، طراحی eval و دیباگ افت کیفیت رفتار