De juiste manier om CLAUDE.md te gebruiken

CLAUDE.md is een speciaal bestand in de root directory van een project, dat gebruikt wordt om AI-assistenten (zoals Claude) te informeren over de belangrijkste informatie van je project. Door dit bestand goed te schrijven, kan de AI je beter begrijpen en helpen.

Waarom CLAUDE.md nodig is?

Stel je voor dat je een nieuwe collega hebt. Hoe lang duurt het voordat hij/zij je project begrijpt? CLAUDE.md is die "projecthandleiding" waarmee de AI snel aan de slag kan.

De vijf belangrijkste onderdelen van CLAUDE.md

1. Projectoverzicht

Beschrijf kort wat het project doet, welk probleem het oplost en voor welke gebruikers het bedoeld is.

# Projectoverzicht Dit is een e-commerce backend beheersysteem voor het beheren van producten, bestellingen en gebruikers.

2. Technische stack

Geef een lijst van de belangrijkste technologieën en frameworks die in het project worden gebruikt.

`# Technische stack

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

3. Bestandsstructuur

Leg de functie van de belangrijkste mappen uit.

# Bestandsstructuur /src /components - UI componenten /pages - Pagina's /utils - Utility functies /api - API aanroepen

4. Gebruikelijke commando's

Geef een lijst van de commando's die vaak gebruikt worden tijdens de ontwikkeling.

# Gebruikelijke commando's npm run dev - Start de development server npm run build - Bouw de productie versie npm run test - Voer tests uit

5. Regels

Definieer de regels die de AI moet volgen bij het schrijven van code.

`# Codeerregels

Gebruik functionele componenten
Volg ESLint configuratie
Componentenamen gebruiken PascalCase
Variabelenamen gebruiken camelCase`

Een compleet voorbeeld

`# Projectnaam: Task Manager

Projectoverzicht

Een eenvoudige taakbeheer applicatie die het aanmaken, bewerken, verwijderen en categoriseren van taken ondersteunt.

Technische stack

React 18
TypeScript
Tailwind CSS
Vite

Bestandsstructuur

/src /components - UI componenten /hooks - Custom Hooks /types - TypeScript type definities /utils - Utility functies

Gebruikelijke commando's

npm run dev: Start de development server
npm run build: Bouw de productie versie
npm run lint: Code inspectie

Codeerstandaarden

Componenten gebruiken functionele code
Gebruik Tailwind CSS voor styling
Plaats elke component in een aparte map`

Tips

Houd het beknopt: schrijf niet te lang, de AI wordt ook "moe"
Regelmatig bijwerken: vergeet niet om CLAUDE.md bij te werken wanneer het project verandert
Geef de voorkeur aan voorbeelden: concrete code voorbeelden zijn effectiever dan abstracte beschrijvingen
Focus op pijnpunten: leg de nadruk op gebieden waar fouten gemakkelijk gemaakt worden

Schrijf een goede CLAUDE.md en laat de AI je rechterhand worden!