Principiile Karpathy 4 — Ghid de Comportament pentru Coding cu LLM
Ce face
Doctrina Karpathy 4 Principles stabilește reguli clare de comportament pentru orice task care implică scriere, review sau refactor de cod cu un LLM. Se bazează pe observațiile lui Andrej Karpathy despre greșelile frecvente: asumări greșite, complicații inutile, modificări în zone nelegate de cerere și lipsa unor criterii verificabile de succes. Adoptată ca doctrină Wednesday pe 8 mai 2026, ea obligă modelul să fie explicit, minimalist și chirurgical.
Când îmi folosește
O folosești automat la orice task de cod care contează: PR-uri, schimbări de doctrine, operațiuni infra sau refactor-uri. Pentru task-uri triviale (o funcție mică de unică folosință) poți ignora temporar regulile, dar la orice lucru care intră în repo sau afectează alți oameni, principiul e obligatoriu. Bias-ul principal e spre prudență, nu viteză.
Cum îl invoc / declanșez
Doctrina se activează implicit de fiecare dată când primești un task de cod. Nu există comandă specială; pur și simplu urmezi cele 4 principii. Dacă ai dubii despre cum se aplică într-un caz concret, verifică doctrina pentru detalii exacte.
Exemplu practic
În loc să primești „Adaugă export de date utilizatori” și să scrii 50 de linii direct, principiul 1 te obligă să întrebi clar: scope (toți utilizatorii sau subset?), format (fișier, API, email?), câmpuri (ce e permis de privacy?) și volum. Principiul 2 cere cea mai simplă soluție posibilă – de exemplu un API JSON paginat, fără abstracțiuni speculative. Principiul 3 interzice să modifici comentarii sau formatare din jur. Principiul 4 transformă cererea în: „Scrie test pentru input invalid, apoi fă-l să treacă”.
Output / unde aterizează
Rezultatul e cod care:
- declară explicit toate asumările,
- conține doar ce a fost cerut,
- modifică strict liniile necesare,
- are criterii de succes verificabile (de obicei teste).
Orice schimbare trebuie să poată fi trasată direct la cererea utilizatorului.
Limite / gotchas
Regulile nu se aplică la prototipuri rapide sau experimente locale. Dacă ai un cod legacy plin de probleme, doctrina interzice să le repari „din mers” – menționezi doar codul orfan creat de tine. Pentru task-uri multi-step, trebuie să listezi pașii cu verificări explicite înainte de a continua. Ignorarea regulilor la lucruri importante (PR, infra) e considerată încălcare de doctrină.