CLAUDE.md بهترین تمرین ها: ساخت کد کلود برای هر پروژه

CLAUDE.md یک فایل علامت گذاری شده در ریشه پروژه شما است. کد کلود آن را در ابتدای هر جلسه قبل از تایپ هر چیزی می خواند. یک CLAUDE خوب md هوش مصنوعی عمومی را به ابزاری تبدیل می کند که کنوانسیون های پروژه، پشته تکنولوژی و خطوط قرمز را درک می کند.

تمرکز بر اطلاعاتی که یک توسعه دهنده هوشمند به تیم شما ملحق می شود، در روز اول به آن نیاز دارد. آن را عملی نگه دارید: پشته تکنولوژی، دستورات، قراردادها و چیزهایی که باید از آن اجتناب کنید.

# Project Context

Next.js 14 app with TypeScript, Tailwind CSS, and Prisma.
Database: PostgreSQL. Auth: NextAuth.js.

## Commands
- `npm run dev` — start dev server (port 3000)
- `npm run test` — run Jest tests
- `npm run lint` — run ESLint
- `npm run db:migrate` — run Prisma migrations

## Architecture
- Server components by default, client components in /components/client/
- API routes in /app/api/ with Zod validation
- Database queries in /lib/db/ (never in components)

## Conventions
- TypeScript strict mode, never use `any`
- Tailwind for styling, no CSS modules
- Conventional commits: feat:, fix:, chore:

## Do NOT
- Modify files in /legacy/ or /vendor/
- Change auth configuration without explicit approval
- Add new dependencies without asking first

برای پایه های کد بزرگ، از @import سینتکس برای تقسیم پیکربندی در سراسر دایرکتوری استفاده کنید. کد کلود به دنبال واردات و ساخت یک تصویر کامل است.

# Root CLAUDE.md

## Global conventions
- TypeScript strict, no `any`
- All API routes validate input with Zod

@import packages/api/CLAUDE.md
@import packages/web/CLAUDE.md
@import packages/shared/CLAUDE.md

هر sub-CLAE.md شامل قوانین خاص به آن بسته است. این فایل ریشه را کوتاه نگه می دارد در حالی که به کلود کد در مورد هر منطقه از پایگاه کد می دهد.

کد کلود می تواند یک CLAUDE شروع کند. با تجزیه و تحلیل پروژه خود:

# Auto-generate CLAUDE.md
claude /init

# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patterns

کد کلود فایل های CLAUDE.md را از چندین مکان به منظور اولویت بندی می کند:

تنظیمات سطح پروژه افراد شخصی را نادیده می گیرد. این به این معنی است که قراردادها همیشه بر ترجیحات فردی پیروز می شوند.