راهنمای عملی CLAUDE.md برای ReactAgent در نسخه 2026

چرا فایل قاعده‌ها برای_agent‌های AI مؤثر است؟

Agent‌های AI (مانند Claude Code، Cursor یا OpenAI Codex CLI) در هر سشن فایل تنظیمات روت پروژه را می‌خوانند. اگر قاعده‌ای تعریف نشده باشد، این ابزارها از قواعد کلی کدنویسی استفاده می‌کنند و ممکن است کدایی که با ویژگی‌های React + TypeScript (Vite) مانند ساختار src/features/ یا لایه‌ی اعتبارسنجی zod سازگار نیست، تولید کنند. افزودن فایل قاعده‌ها این امکان را می‌دهد که «قضاوت پیش‌فرض» پروژه مشخص شود. این کار نه‌تنها تکرار kommentarهای مرور کد را کاهش می‌دهد، بلکه باعث یکسانی سبک PRها می‌شود. تأثیری که «نوشتن زیاد» می‌تواند، نه‌چندان جادویی باشد.

تقسیم فایل‌های مختلف

در صورتی که در یک مخزن چند_agent استفاده می‌کنید، می‌توانید تعریف اصلی را در CLAUDE.md بنویسید و دیگر فایل‌ها را با اشاره به آن درک کنید.

مثال برای React + TypeScript (Vite)

در ادامه یک نمونهٔ واقعی از قاعده‌های ما برای یک SPA متوسط‌سized آورده شده است که بر طراحی کامپوننت و استراتژی تست تمرکز دارد.

# CLAUDE.md

## ساختار پروژه
- چارچوب: React 19 + TypeScript 5.8 + Vite 6
- مدیریت وضعیت: Zustand (برای وضعیت جهانی) + TanStack Query (برای وضعیت سرور)
- سبک‌بندی: Tailwind CSS v4؛ از CSS Modules استفاده نمی‌شود

## قوانین کامپوننت
- هر کامپوننت باید در یک پوشه components/ یا features/ قرار گیرد و شامل فایل‌های .tsx، .module.css (اگر مورد نیاز) و .test.tsx باشد.
- از zod برای اعتبارسنجی ورودی‌ها استفاده کنید؛ اسکریپت‌های تست باید فقط برای کامپوننت‌های عمومی بنویسید.

این قاعده‌ها به_agent‌ها کمک می‌کند تا ساختار موردنیاز را پیش‌بینی کنند و از انحراف از استانداردها جلوگیری کنند.

نتیجه‌گیری

استفادهٔ هوشمندانه از فایل‌های تنظیمی می‌تواند کیفیت کد تولید‌شده توسط AI را به‌طور قابل‌توجهی ارتقا دهد، به‌ویژه وقتی که پروژه‌های بزرگ با چند تکنولوژی ترکیبی استفاده می‌شوند. کلید موفقیت، تعریف واضح محدودیت‌ها و هماهنگی بین تیم توسعه و ابزارهای AI است.