CLAUDE.md — Instructiunile Core

Ce este CLAUDE.md?

CLAUDE.md este fisierul cel mai important din intregul sistem. Se afla in radacina proiectului si este incarcat automat la fiecare sesiune de Claude Code CLI. Gandeste-te la el ca la "constitutia" agentului tau.

Structura CLAUDE.md

Un CLAUDE.md complet are aceste sectiuni:

1. Identitate si Principii de operare

Defineste cine este agentul si cum lucreaza:

## Identitate & Principii de operare

Esti un agent AI autonom de development care opereaza in Claude Code CLI v2.1.x.
- Scrii teste INAINTE de cod. Intotdeauna. Fara exceptii.
- Faci atomic git commits — o schimbare logica per commit.
- Te opresti la 75% utilizare context.

2. Workflow PAUL

Cele trei faze obligatorii: Plan → Apply → Unify. Fiecare task non-trivial trece prin acest loop. Vom explora PAUL in detaliu in Modulul 06.

3. Strategie de Memorie (6 Layere)

Cum pastreaza agentul context intre sesiuni. Detalii in Modulul 07.

4. Managementul Contextului

Reguli pentru a mentine context window-ul lean:

• CLAUDE.md ramane sub 150 de linii de instructiuni
• Cunoasterea detaliata traieste in fisiere @docs/ incarcate on-demand
• Nu incarci niciodata tot codebase-ul in context

5. Strategia de Delegare

Implementarea se face in-session. Research si review se deleaga catre subagenti(architect, reviewer, researcher, qa).

6. Protocolul de Sesiune

Ce face agentul la start (citeste STATE.md) si la stop (update STATE + sync).

7. Anti-Pattern-uri

Lista explicita de lucruri pe care agentul nu le face niciodata:

• Nu scrie cod fara un plan
• Nu scrie cod inainte de teste
• Nu sare faza UNIFY
• Nu face commit-uri mari cu multiple concerns
• Nu continua peste 75% utilizare context fara sa compacteze

De ce conteaza?

Fara CLAUDE.md, fiecare sesiune incepe de la zero. Cu el, agentul stie:

• Cine este — un builder disciplinat, nu un chatbot
• Cum lucreaza — TDD, atomic commits, PAUL loop
• Ce NU face — lista clara de anti-pattern-uri
• Unde gaseste informatii — cele 6 layere de memorie

Exercitiu

Deschide fisierul CLAUDE.md din acest proiect si identifica cele 7 sectiuni. Observa cum fiecare principiu din "Identitate" apare ca regula concreta in alta sectiune.