CLAUDE.md: فایلی که هوش مصنوعی را همکار حرفه‌ای می‌کند | آکادمی برنامه‌نویسی

CLAUDE.md: فایلی که هوش مصنوعی را همکار حرفه‌ای می‌کند

هر بار که با Claude Code کار می‌کنید، باید قاعده‌های پروژه را دوباره توضیح بدهید؟ فایل CLAUDE.md همین مشکل را حل می‌کند.

CLAUDE.md یک فایل ساده است. Claude Code آن را در شروع هر جلسه می‌خواند. هر قاعده‌ای که نمی‌خواهید تکرار کنید، همین‌جا می‌نویسید.

فهرست مطالب

1. CLAUDE.md چیست؟

2. سه سطح فایل

3. یک نمونه برای پروژه ASP.NET Core

4. فناوری

5. ساختار

6. فرمان‌ها

7. قاعده‌ها

8. چه چیزی بنویسیم؟

9. چه چیزی ننویسیم؟

10. قاعده دو بار

11. کوتاه بهتر از بلند

12. یک تمرین

CLAUDE.md چیست؟

یک فایل Markdown است. مثل یادداشتی که کنار پروژه می‌گذارید. Claude هر جلسه اول آن را می‌خواند. پس مثل حافظه ثابت پروژه کار می‌کند.

سه سطح فایل

فایل‌های حافظه سه نوع‌اند:

• CLAUDE.md در ریشه پروژه: قاعده‌های مشترک تیم. وارد Git می‌شود.

. CLAUDE.local.md در ریشه پروژه: ترجیح‌های شخصی شما. در .gitignore می‌ماند.

• فایل سراسری کاربر: عادت‌های شخصی شما در همه پروژه‌ها.

یک نمونه برای پروژه ASP.NET Core

این نمونه برای یک سامانه نوبت‌دهی آرایشگاه است:

# پروژه: سامانه نوبتدهی آرایشگاه

## فناوری

- ASP.NET Core و Blazor Server

- SQL Server با EF Core و Code First

## ساختار

- Components/: فقط نمایش و تعامل کاربر

- Services/: منطق کسبوکار

- Tests/: تست واحد برای Services

## فرمانها

- ساخت: dotnet build

- تست: dotnet test

## قاعدهها

- هرگز رشته اتصال واقعی را در کد نگذار.

- برای هر سرویس جدید تست واحد بنویس.

- قبل از افزودن بسته NuGet جدید بپرس.

چه چیزی بنویسیم؟

• نسخه فناوری‌ها

• ساختار پوشه‌ها و کار هر پوشه

• فرمان‌های build و test

• قاعده‌های معماری و نام‌گذاری

• کارهای ممنوع

چه چیزی ننویسیم؟

• تاریخچه طولانی پروژه

• کپی مستندات فریم‌ورک

• جمله‌های کلی مثل «کد تمیز بنویس»

جمله کلی هیچ رفتاری را عوض نمی‌کند. قاعده باید مشخص باشد. مثلاً «هر سرویس جدید یک تست واحد داشته باشد».

قاعده دو بار

اگر Claude یک نکته را دو بار اشتباه انجام داد، همان نکته را با یک جمله به CLAUDE.md اضافه کنید.

CLAUDE.md خوب در طول زمان ساخته می‌شود. از همین اشتباه‌های تکراری.

کوتاه بهتر از بلند

فایلی با پانصد خط قاعده کلی و متناقض، اثر معکوس دارد. Claude به دستورهای زیاد و مبهم کمتر پایبند می‌ماند.

پس فایل را کوتاه و دقیق بنویسید.

CLAUDE.md یک دستورالعمل است. قفل نیست. برای چیزهای حیاتی، مثل فایل‌های محرمانه، از قاعده‌های deny و Hook استفاده کنید.

یک تمرین

CLAUDE.md پروژه خودتان را بنویسید. پنج بخش داشته باشد: نسخه، ساختار، فرمان‌ها، قاعده‌ها و یک قاعده امنیتی.

بعد قاعده امنیتی را آزمایش کنید. مثلاً از Claude بخواهید چیزی را انجام دهد که قاعده منع کرده است. ببینید چه می‌کند.

می‌خواهید CLAUDE.md پروژه‌تان را قدم‌به‌قدم بسازید؟ در دوره هوش مصنوعی در برنامه‌نویسی آکادمی بدیعی این کار را روی پروژه واقعی تمرین می‌کنید.

سوالات متداول

CLAUDE.md را کجا بگذارم؟

در پوشه اصلی پروژه. مثل README.

چقدر باید طولانی باشد؟

هرچه کوتاه‌تر و دقیق‌تر، بهتر. فایل خیلی بلند و مبهم، رعایت قاعده‌ها را کمتر می‌کند.

آیا مطمئن هستم Claude همه قاعده‌ها را رعایت می‌کند؟

نه. CLAUDE.md یک دستورالعمل است و تضمین ندارد. برای قاعده‌های حیاتی از deny یا Hook استفاده کنید.