A11Y.md؛ قرارداد دسترسپذیری برای ایجنتهای کدنویس
هوش مصنوعی
فرانتاندخلاصهٔ کاملتر
به گفتهٔ سازندهٔ پروژه، A11Y.md یه راهنمای دیگه دربارهٔ دسترسپذیری نیست؛ یه پروتکل اعتبارسنجی و یه معماری context دائمیه که قراره به سیستمهای ایجنت کدنویس مثل Cursor، Claude و Copilot وصل بشه. استدلال پشتش سادهست: ما .gitignore و eslint و فایل دستورالعمل ایجنت رو تو مخزنهامون بهعنوان حقیقت قطعی میپذیریم، پس چرا دسترسپذیری همون جایگاه رو نداشته باشه؟
ساختارش یه هستهٔ هنجاری مستقل از پلتفرم داره — بر پایهٔ اصول POUR، پروفایلهای انطباق، سطحبندی شدت و حاکمیت — بهعلاوهٔ یه لایهٔ ترجمه برای iOS، اندروید، React Native و Flutter. مهمترین بخشش چیزیه که خودش بهش میگه قرارداد رفتاری ۱۱ قانونه: مجموعهای از محدودیتهای قطعی که ایجنت رو وادار میکنه کامپوننتهای موجود پروژه رو دوباره استفاده کنه بهجای اینکه از نو بسازه، و از تولید ضدالگوهای خطرناک مثل div کلیکشونده دست برداره.
پروفایلهای انطباق سه سطح دارن: Shield برای سطح AAA، Standard برای AA و Launchpad برای سطح A. نکتهٔ طراحی جالبش اینه که تو هر پروفایل، چیزی که واقعاً از طرف WCAG الزامیه از قواعد سختگیرانهتر خود پروژه جدا شده و به معیار موفقیت مربوطه ارجاع داده شده. پروفایل Launchpad هم برای استارتاپهاییه که میخوان سریع MVP بسازن؛ محدودیتهای بصری رو شل میکنه ولی ساختار معنایی حیاتی رو دستنخورده نگه میداره.
بخش سوم، بارگذاری تنبل context ـه: ۲۱ راهنمای مرجع بر پایهٔ WAI-ARIA APG که ایجنت فقط اونهایی رو که لازم داره در لحظه میخونه تا توکن هدر نره. راهاندازیش هم به گفتهٔ مستندات کمتر از دو دقیقه طول میکشه: کافیه تو فایل پیکربندی ایجنتت یه قانون اضافه کنی که به فایل اصلی A11Y.md ارجاع بده؛ نیازی به کپی کردن فایلها نیست، هرچند نسخهٔ آفلاین و پینشده هم پشتیبانی میشه.
نویسنده تفاوت عملی رو با مثال نشون میده: بدون این context، ایجنت div کلیکشونده تولید میکنه، مودالی میسازه که با کلید ESC بسته نمیشه و پیام خطایی مینویسه که صفحهخوان اصلاً اعلامش نمیکنه. با context فعال، دکمهٔ بومی بهعنوان قانون سختگیرانه استفاده میشه، فوکوس بعد از جابهجایی مسیر تو اپهای تکصفحهای مدیریت میشه و aria-live سر جای درست تزریق میشه. پروژه متنبازه و به گفتهٔ مخزن، تو تیر ۱۴۰۵ برای برنامهٔ Claude for Open Source انتخاب شده.
نکات کلیدی:
- پروتکل دسترسپذیری که بهجای مستند خواندنی، context دائمی ایجنتهای کدنویسه
- قرارداد رفتاری ۱۱ قانونه برای جلوگیری از ضدالگوها و اجبار به استفادهٔ مجدد از کامپوننتها
- سه پروفایل انطباق Shield، Standard و Launchpad با تفکیک الزام WCAG از قواعد داخلی
- ۲۱ راهنمای مرجع WAI-ARIA APG با بارگذاری تنبل برای صرفهجویی در توکن
- هر قاعده به معیارهای WCAG 2.2 نگاشت شده تا برای ممیزی رسمی قابلردیابی باشه
