چطور دستیار هوش مصنوعی رو با دیزاین سیستم پروژه آشنا کنیم
خلاصهٔ کاملتر
نویسنده تو این مقالهٔ LogRocket با یه پروژهٔ نمونه با React 19 و Tailwind CSS v4 نشون میده چرا کدی که دستیار هوش مصنوعی برای UI مینویسه از دیزاین سیستم (یعنی مجموعهٔ کامپوننتها و رنگها و فاصلههای استاندارد پروژه) فاصله میگیره. تو صفحهٔ «قبل»، دکمهٔ ذخیره رنگ indigo هاردکد شده داره، در حالی که رنگ برند teal هست و از توکن --color-brand میاد. toggle هم با یه div ساده دوباره ساخته شده که نه role مناسب داره، نه با کیبورد کار میکنه.
راهحل پیشنهادی سه فایل مرجعه: tokens.md که میگه هر کلاس مثل bg-brand یا hover:bg-brand-hover برای چه کاریه، components.md که propها و مقدارهای مجاز هر کامپوننت رو میگه (مثلاً Button فقط variantهای primary، secondary، ghost و danger داره و outline یا سایز lg نداره)، و patterns.md که نشون میده کامپوننتها چطور کنار هم چیده میشن. نویسنده تأکید میکنه که گفتن جایگزین درست، از صرفاً ممنوع کردن خیلی بهتر جواب میده.
بالای اینا یه فایل کوتاه AGENTS.md هست که به دستیار میگه قبل از تغییر UI چی رو بخونه، کامپوننتها رو از src/ds import کنه، مقدار دلخواه مثل p-[18px] ننویسه، و اگه کامپوننت یا توکنی کم بود، بهجای حدس زدن گزارشش کنه. هر ابزار این فایل رو یه جور لود میکنه. برای Claude Code، فایل CLAUDE.md با import صریح مطمئنترین راهه:
@AGENTS.md
@docs/design-system/tokens.md
@docs/design-system/components.md
@docs/design-system/patterns.mdنکتهٔ مهمی که مقاله روش دست میذاره اینه که لود شدن فایل دستور، یعنی لود شدن فایلهایی که اسمشون توش اومده نیست. مثلاً تو Cursor، گزینهٔ alwaysApply: true فقط متن خود rule رو وارد context میکنه و فایلهای ارجاعدادهشده رو باید جدا خوند. پشتیبانی Copilot هم بین IDE و Chat و code review فرق داره. پس بهتره با یه تسک کوچیک چک کنید دستیار واقعاً مستندات کامپوننتها رو باز کرده یا نه.
برای کنترل، پروژه یه اسکریپت ساده داره که دنبال hex، کلاسهای پالت پیشفرض و مقدارهای براکتی میگرده: صفحهٔ «قبل» ۲۵ مورد پیدا میکنه و صفحهٔ «بعد» صفر. یه اسکریپت check:docs هم چک میکنه هر توکن و کامپوننت تو مستندات اسم برده شده باشه، که میشه تو CI گذاشتش. نویسنده صادقانه میگه این چکها محدودن: دسترسپذیری یا درست بودن انتخابها رو نمیسنجن و Markdown هم مدل رو آموزش نمیده، فقط context بهش میده.
نکات کلیدی:
- سه فایل tokens.md، components.md و patterns.md بهاضافهٔ یه AGENTS.md کوتاه، هستهٔ این روشه.
- تو CLAUDE.md با @AGENTS.md قوانین مشترک import میشن؛ Claude Code از نسخهٔ v2.1.277 خودش هم AGENTS.md رو پشتیبانی میکنه.
- تو Cursor، alwaysApply: true فایلهای ارجاعدادهشده رو خودکار لود نمیکنه.
- اسکنر نمونه تو صفحهٔ «قبل» ۲۵ مشکل و تو صفحهٔ «بعد» صفر مشکل پیدا کرد.
- check:docs فقط وجود اسمها رو چک میکنه، نه propهای تغییرکرده یا توکنهای حذفشده رو.




