Il modo corretto di utilizzare CLAUDE.md

CLAUDE.md è un file speciale posizionato nella directory principale del progetto, utilizzato per comunicare all'assistente AI (come Claude) informazioni chiave sul tuo progetto. Scrivere bene questo file permette all'AI di comprendere meglio e aiutarti.

Perché è necessario CLAUDE.md?

Immagina di avere un nuovo collega, quanto tempo ti serve per fargli capire il tuo progetto? CLAUDE.md è quel "manuale del progetto" che permette all'AI di iniziare rapidamente.

I cinque contenuti principali di CLAUDE.md

1. Panoramica del progetto

Descrivi semplicemente cosa fa questo progetto, quali problemi risolve e a quali utenti è rivolto.

# Panoramica del progetto Questo è un sistema di gestione backend per l'e-commerce, utilizzato per gestire prodotti, ordini e utenti.

2. Stack tecnologico

Elenca le principali tecnologie e framework utilizzati dal progetto.

`# Stack tecnologico

• Frontend: React + TypeScript
• Backend: Node.js + Express
• Database: PostgreSQL
• Deployment: Docker + Kubernetes`

3. Struttura dei file

Spiega la funzione delle directory principali.

# Struttura dei file /src /components - Componenti UI /pages - Pagine /utils - Funzioni di utilità /api - Chiamate API

4. Comandi comuni

Elenca i comandi comunemente usati durante lo sviluppo.

# Comandi comuni npm run dev - Avvia il server di sviluppo npm run build - Costruisce la versione di produzione npm run test - Esegue i test

5. Regole

Definisci le regole che l'AI dovrebbe seguire quando ti aiuta a scrivere codice.

`# Regole di codifica

• Utilizzare componenti funzionali
• Seguire la configurazione ESLint
• Utilizzare PascalCase per la denominazione dei componenti
• Utilizzare camelCase per la denominazione delle variabili`

Un esempio completo

`# Nome del progetto: Task Manager

Panoramica del progetto

Una semplice applicazione di gestione delle attività che supporta la creazione, la modifica, l'eliminazione e la categorizzazione delle attività.

Stack tecnologico

• React 18
• TypeScript
• Tailwind CSS
• Vite

Struttura dei file

/src /components - Componenti UI /hooks - Custom Hooks /types - Definizioni dei tipi TypeScript /utils - Funzioni di utilità

Comandi comuni

• npm run dev: Avvia il server di sviluppo
• npm run build: Costruisce la versione di produzione
• npm run lint: Controllo del codice

Standard di codifica

• Utilizzare la scrittura funzionale per i componenti
• Utilizzare Tailwind CSS per lo stile
• Posizionare ogni componente in una cartella separata`

Suggerimenti

• Mantieni la semplicità: non scrivere troppo a lungo, anche l'AI si "stanca"
• Aggiorna regolarmente: ricordati di aggiornare CLAUDE.md quando il progetto cambia
• Dai priorità agli esempi: fornire esempi di codice specifici è più efficace di descrizioni astratte
• Concentrati sui punti critici: spiega in dettaglio le aree in cui è facile commettere errori

Scrivi bene CLAUDE.md e fai diventare l'AI il tuo braccio destro!