Modul corect de a folosi CLAUDE.md

CLAUDE.md este un fișier special plasat în directorul rădăcină al proiectului, folosit pentru a informa asistentul AI (cum ar fi Claude) despre informațiile cheie ale proiectului tău. Scrierea corectă a acestui fișier permite AI-ului să înțeleagă și să te ajute mai bine.

De ce este nevoie de CLAUDE.md?

Imaginează-ți că ai un coleg nou și cât timp îți ia să-l faci să înțeleagă proiectul tău. CLAUDE.md este acel "manual de instrucțiuni al proiectului", permițând AI-ului să înceapă rapid.

Cele cinci elemente de bază ale CLAUDE.md

1. Prezentarea generală a proiectului

Descrie pe scurt ce face acest proiect, ce probleme rezolvă și cui se adresează.

# Prezentarea generală a proiectului Acesta este un sistem de administrare backend pentru comerț electronic, folosit pentru a gestiona produse, comenzi și utilizatori.

2. Stiva tehnologică

Enumeră principalele tehnologii și framework-uri utilizate de proiect.

`# Stiva tehnologică

• Frontend: React + TypeScript
• Backend: Node.js + Express
• Bază de date: PostgreSQL
• Implementare: Docker + Kubernetes`

3. Structura fișierelor

Explică rolul directoarelor principale.

# Structura fișierelor /src /components - Componente UI /pages - Pagini /utils - Funcții utilitare /api - Apeluri API

4. Comenzi uzuale

Enumeră comenzile utilizate frecvent în timpul dezvoltării.

# Comenzi uzuale npm run dev - Pornește serverul de dezvoltare npm run build - Construiește versiunea de producție npm run test - Rulează testele

5. Reguli

Definește regulile pe care AI-ul ar trebui să le respecte atunci când te ajută să scrii cod.

`# Reguli de codare

• Utilizează componente funcționale
• Respectă configurația ESLint
• Utilizează PascalCase pentru denumirea componentelor
• Utilizează camelCase pentru denumirea variabilelor`

Un exemplu complet

`# Numele proiectului: Task Manager

Prezentarea generală a proiectului

O aplicație simplă de gestionare a sarcinilor, care acceptă crearea, editarea, ștergerea și clasificarea sarcinilor.

Stiva tehnologică

• React 18
• TypeScript
• Tailwind CSS
• Vite

Structura fișierelor

/src /components - Componente UI /hooks - Hooks personalizate /types - Definiții de tip TypeScript /utils - Funcții utilitare

Comenzi uzuale

• npm run dev: Pornește serverul de dezvoltare
• npm run build: Construiește versiunea de producție
• npm run lint: Verifică codul

Standarde de codare

• Utilizează scrierea funcțională pentru componente
• Utilizează Tailwind CSS pentru stiluri
• Plasează fiecare componentă într-un folder separat`

Sfaturi utile

• Păstrează-l concis: nu scrie prea mult, AI-ul va "obosi" și el
• Actualizează-l periodic: nu uita să actualizezi CLAUDE.md când proiectul se schimbă
• Prioritizează exemplele: oferirea de exemple concrete de cod este mai eficientă decât descrierile abstracte
• Concentrează-te pe punctele slabe: explică în detaliu zonele predispuse la erori

Scrie corect CLAUDE.md și lasă AI-ul să devină asistentul tău de încredere!