תגית:md הפרקטיקה הטובה ביותר: קוד קלוד לכל פרויקט
CLAUDE.md היא התצורה היחידה המשפיעה ביותר עבור קוד קלוד. אחד כתוב היטב הופך סיוע בינה מלאכותית גנרית למומחיות ספציפית לפרויקט.
CLAUDE.md הוא קובץ סימון בבסיס הפרויקט שלך. קלוד קוד קורא את זה בתחילת כל מפגש לפני שאתה מקליד כל דבר. טוב מאד. md הופך את הבינה המלאכותית הגנרית לכלי שמבין את המוסכמות של הפרויקט, ערימה טכנולוגית וקווים אדומים.
מה צריך לכלול ב- CLAUDE.md?
להתמקד במידע כי מפתח חכם להצטרף לצוות שלך יהיה צורך ביום אחד. שמור על זה מעשי: ערימה טכנולוגית, פקודות, מוסכמות, דברים להימנע.
תבנית Minimal 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מה הם הנפוצים ביותר. טעויות?
| טעות | למה זה כואב | לתקן |
|---|---|---|
| יותר מדי זמן (500+ שורות) | החלון של פסולת בכל פגישה | שמור מתחת ל-200 שורות, קישור לפרטים |
| מעורפל מדי ("קוד נקי") | לא נותנים הדרכה מעשית | להיות ספציפי: "רכיבי שרת באמצעות ברירת מחדל" |
| פקודות חסרות | קלוד מניח איך לרוץ / להעיד / | כל תסריט NPM רלוונטי |
| אין הגבלות | קלוד עשוי לשנות קבצים רגישים | הוספת סעיף "אל תעשה" |
| עקבו אחרי ReadMEME | ReadME מיועד לבני אדם, CLAUDE.md הוא עבור AI | להתמקד במוסכמות ובכללים, לא בתיאור הפרויקט |
איך בונים את CLAUDE עבור פרויקטים גדולים?
עבור בסיסי קוד גדולים, השתמש בסנמס @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כל תת-CLE.md מכיל כללים ספציפיים לחבילה זו. זה שומר את קובץ השורש קצר תוך מתן קודקוד עמוק בהקשר של כל אזור של בסיס הקוד.
איך מייצרים את CLAUDE.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 (כולם בקבוצה חולקים את זה)
- +קבצי CUDE.md (באמצעות @import)
- +/ ./CLE AUDAMD (העדפות גלובליות אישיות)
- +זיכרון אוטומטי (MEMORY.md, המנוהל על ידי פקודה /זיכרון)
הגדרות ברמת הפרויקט גוברות על האישיות. משמעות הדבר היא שמוסכמות קבוצתיות תמיד מנצחות על העדפות אישיות.