Primii pași în Claude: CLAUDE.md, un skill și /goal, explicați pe un exemplu de firmă

Primii pași în Claude: CLAUDE.md, un skill și /goal înseamnă trei lucruri, puse în ordinea asta. Întâi scrii un fișier CLAUDE.md cu regulile firmei. Apoi faci un skill pentru o sarcină pe care o repeți în fiecare săptămână. La final, dai sarcini mai lungi cu /goal, fiecare cu o stare finală verificabilă și o limită.

CLAUDE.md este un fișier Markdown cu instrucțiuni permanente pentru un proiect, pe care Claude Code îl citește la începutul fiecărei sesiuni. Un skill este o procedură salvată într-un fișier SKILL.md. Claude o folosește când e relevantă sau când o chemi direct cu /nume-skill. /goal este o comandă care fixează o condiție de final. Claude lucrează spre ea fără să-i dai fiecare pas.

Ghidul e scris pentru proprietari și manageri care nu scriu cod. Exemplul de lucru este o firmă mică de distribuție. Firma vinde echipamente de bucătărie profesionale către restaurante. Are notițe de la întâlnirile cu clienții, drafturi de e-mail și un rezumat săptămânal pentru conducere. Același tipar poate fi folosit în orice firmă care repetă aceleași sarcini de la o săptămână la alta.

Ordinea contează. CLAUDE.md îi spune lui Claude cine ești și ce nu are voie să facă. Skill-ul îi arată cum faci o anumită sarcină. /goal îi spune când a terminat.

Claude Code pornește fiecare sesiune cu o fereastră de context goală. Fereastra de context este tot ce vede Claude într-o conversație: mesajele tale, fișierele citite și răspunsurile lui. Ce i-ai explicat ieri nu mai există azi, dacă nu e scris undeva.

Documentația Anthropic numește două mecanisme care duc informația dintr-o sesiune în alta. Primul este CLAUDE.md, scris de tine. Al doilea este auto memory: notițe pe care Claude și le scrie singur, din corecturile și preferințele tale. Auto memory e pornită implicit în sesiunile locale.

Notițele din auto memory rămân însă pe calculatorul tău și nu se împart între calculatoare sau cu mediile din cloud. Regulile firmei, pe care trebuie să le respecte toată echipa, își au deci locul în CLAUDE.md.

Câteva lucruri pe care le întâlnești din prima zi:

• Sesiunile noi din terminal și din VS Code pornesc în auto mode. În acest mod, un clasificator verifică orice acțiune riscantă înainte să ruleze.
• O sesiune nouă rulează Claude Opus 5.5 la efort mediu, pe majoritatea planurilor.
• Conversația se compactează automat înainte să se umple fereastra de context.

Dacă nu ești sigur ce plan ai sau ce face fiecare produs, citește întâi ghidul despre ce este Claude și planurile lui.

Cel mai simplu început este comanda /init. O rulezi în folderul proiectului și ea generează un CLAUDE.md. Dacă folosești deja Cursor sau Copilot, /init citește și fișierele lor de instrucțiuni și preia ce e relevant. Poți scrie fișierul și de mână, ca pe orice document text.

Un CLAUDE.md bun spune cinci lucruri: cine este firma, în ce limbă și ton scrie Claude, unde stau datele, ce nu are voie să facă și cum sunt organizate folderele. În exemplul nostru, clienții și lead-urile stau în Zoho CRM, iar facturile se emit în SmartBill. Fișierul de mai jos poate fi salvat ca CLAUDE.md în folderul principal al proiectului:

Firma: vindem echipamente de bucătărie profesionale către restaurante și hoteluri.
Cine lucrează aici: vânzări, suport clienți, contabilitate.

Limba și tonul:
- Scrie în română, cu diacritice.
- Clienților te adresezi cu „dumneavoastră”. Colegilor, cu „tu”.

Unde sunt datele:
- Clienții și lead-urile sunt în Zoho CRM.
- Facturile se emit în SmartBill, doar de contabilitate.
- Lista de prețuri în vigoare este în preturi/lista-curenta.md.

Reguli de lucru:
- Orice e-mail către client rămâne draft în drafturi/. Nu trimite nimic.
- Nu inventa prețuri. Dacă un preț lipsește din listă, scrie „preț de confirmat”.
- Prețurile le scrii în lei, fără TVA.

Foldere:
- note/ notițele de la întâlniri, scrise de echipă
- rezumate/ rezumatele făcute de Claude
- drafturi/ drafturile de e-mail

Schimbă primele două rânduri cu descrierea firmei tale. Schimbă apoi programele de la „Unde sunt datele” și numele folderelor. Documentația recomandă sub 200 de rânduri pe fișier, pentru că un fișier lung consumă context și e respectat mai slab. Verifică și să nu ai două reguli care se bat cap în cap. Dacă două instrucțiuni se contrazic, Claude poate alege una dintre ele la întâmplare.

Claude tratează CLAUDE.md ca pe un context, nu ca pe o configurare obligatorie. Conținutul fișierului ajunge la model ca mesaj al utilizatorului, după promptul de sistem. Documentația spune clar că respectarea strictă nu e garantată. În practică, Claude urmează regulile aproape mereu, dar „aproape” nu ajunge pentru o interdicție.

Pentru ce nu are voie să se întâmple niciodată există setări pe care le aplică programul, nu modelul:

• Regulile deny blochează o acțiune și rămân valabile în orice mod de permisiuni, inclusiv auto și bypassPermissions.
• Un hook PreToolUse rulează înaintea unei acțiuni și o poate opri, orice ar decide Claude.
• Setările gestionate vin din consola de administrare, din MDM sau dintr-un fișier managed-settings.json. Niciun fișier personal nu le poate suprascrie.

Firmele cu mai mulți oameni pot distribui și un CLAUDE.md central pentru toți utilizatorii unui calculator. Fișierul se trimite prin MDM, Group Policy, Ansible sau unelte similare. Un utilizator poate exclude alte fișiere CLAUDE.md cu setarea claudeMdExcludes, dar nu pe acesta.

La Svennis, când pornim un proiect nou, citim împreună cu clientul fiecare rând din CLAUDE.md și întrebăm dacă e o preferință sau o interdicție. Interdicțiile, de pildă „nu trimite nimic clienților”, le mutăm într-o regulă deny sau într-un hook, pentru că acolo nu mai depind de ce decide modelul.

Un skill este un folder cu un fișier SKILL.md. Fișierul începe cu un antet YAML care spune când se folosește skill-ul. Urmează instrucțiunile pe care Claude le execută când skill-ul rulează. Pentru un proiect, folderul stă la .claude/skills/nume-skill/SKILL.md.

Antetul are două câmpuri obligatorii: name și description. Descrierea e partea cea mai importantă. După ea decide Claude dacă folosește skill-ul. Centrul de ajutor Claude dă o limită de 200 de caractere pentru descriere.

Corpul skill-ului se încarcă doar când e folosit. Instrucțiunile lungi nu costă aproape nimic până în ziua în care ai nevoie de ele.

În exemplul nostru, sarcina săptămânală este rezumatul notițelor de la întâlniri, plus drafturile de follow-up. Fișierul de mai jos poate fi salvat la .claude/skills/rezumat-saptamanal/SKILL.md:

---
name: rezumat-saptamanal
description: Rezumatul săptămânii din note/ și drafturi de follow-up. Folosește-l la cerere.
---
Pașii:
1. Citește fișierele din note/ modificate în ultimele 7 zile.
2. Pentru fiecare client scrie trei rânduri: ce s-a discutat, ce am promis, următorul pas.
3. Salvează rezumatul în rezumate/, cu data zilei de luni în numele fișierului.
4. Pentru fiecare promisiune făcută unui client, scrie un draft de e-mail în drafturi/.
5. Folosește doar prețurile din preturi/lista-curenta.md.
6. La final, afișează lista fișierelor citite și a fișierelor create.

Schimbă descrierea dacă echipa ta cere sarcina cu alte cuvinte, de exemplu „raportul de vineri”. Schimbă apoi folderele și cele trei rânduri pe client. Pasul 6 e important pentru pasul următor: /goal poate verifica doar ce Claude afișează în conversație. Skill-ul îl chemi cu /rezumat-saptamanal sau îl lași pe Claude să-l aleagă singur. Fișierele vechi din .claude/commands/ merg în continuare, pentru că acele comenzi au fost unite cu skill-urile.

Locul în care salvezi skill-ul decide cine îl vede. În .claude/skills/ din folderul proiectului, skill-ul merge cu proiectul. În ~/.claude/skills/ pe calculatorul tău, e doar al tău. Dacă două skill-uri au același nume, câștigă cel enterprise, apoi cel personal, apoi cel de proiect.

Sesiunile Cowork și cele din cloud nu citesc folderul ~/.claude/skills/ de pe calculator. Ele încarcă skill-urile activate în contul tău claude.ai. Claude Code descarcă skill-urile sincronizate de acolo, dar nu urcă niciodată nimic. Pentru claude.ai, skill-ul se împachetează ca fișier ZIP, cu folderul skill-ului la rădăcină.

Skill-urile sunt disponibile pe planurile Free, Pro, Max, Ultra, Team și Enterprise și cer execuția de cod activată. Pe Pro, Max, Ultra și Team poți și înregistra un skill, în Cowork, în aplicația Claude pentru Mac. Îi arăți lui Claude ecranul, clicurile și vocea, iar el propune un skill pe care îl verifici. Înregistrarea nu există pe Windows. Detaliile despre lucrul în echipă sunt în ghidul despre Projects și Skills pentru o echipă mică și pe pagina despre Claude Cowork într-o firmă.

Skill-urile urmează standardul deschis Agent Skills. Peste 70 de platforme l-au integrat, între ele ChatGPT, Cursor, GitHub Copilot și VS Code. Anthropic donează standardul către Agentic AI Foundation. Un skill scris acum nu te leagă de un singur instrument.

Un lucru rămâne valabil: șabloanele de skill-uri din comunitate nu sunt sigure automat. Ele pot conține comenzi shell, hooks sau permisiuni, așa că le citești înainte să le instalezi.

/goal fixează o condiție de final pentru sesiune. După fiecare tur, un model separat verifică dacă ea e îndeplinită. Un tur este o rundă în care Claude lucrează până se oprește. Dacă nu e îndeplinită, Claude începe alt tur în loc să-ți dea controlul înapoi.

Evaluatorul nu citește fișiere și nu rulează comenzi. El judecă doar după ce a afișat Claude în conversație. Condiția trebuie deci scrisă ca ceva ce Claude poate arăta: o listă, un tabel, un rezultat de verificare. Condiția poate avea până la 4.000 de caractere. Evaluatorul răspunde cu unul din trei verdicte, fiecare cu un motiv scurt: neîndeplinită încă, îndeplinită sau imposibilă.

Fiecare sesiune poate avea un singur goal activ. Cele trei exemple de mai jos le rulezi pe rând, câte unul pe sesiune, după ce skill-ul a făcut rezumatul:

/goal Rezumatul săptămânii e în rezumate/ și ai afișat lista fișierelor citite. Maxim 10 tururi.
/goal Fiecare client din rezumat are un draft în drafturi/; afișează lista. Maxim 8 tururi.
/goal Niciun draft nu are preț lipsă din lista curentă; arată verificarea. Maxim 5 tururi.

Fiecare condiție are o stare finală pe care o poți număra: un fișier, câte un draft pe client, zero prețuri lipsă. Fiecare are și o limită de tururi. Claude Code ține socoteala tururilor, a timpului și a tokenilor cheltuiți pentru un goal, așa că limita are un reper. Schimbă folderele și numărul de tururi după sarcina ta. Detaliile complete sunt în documentația oficială pentru /goal.

Un goal nu îți schimbă modul de permisiuni. Dacă vrei ca tururile să ruleze fără să aprobi fiecare acțiune, pornești /goal în auto mode. Acolo, un clasificator verifică fiecare acțiune înainte să ruleze. Regulile deny din setări rămân valabile și în auto mode.

Claude Code oprește singur bucla în câteva situații:

• Claude răspunde evaluatorului câteva tururi la rând fără să folosească vreun instrument. Bucla se oprește cu un avertisment, iar goal-ul rămâne setat.
• O eroare de autentificare, când Claude Code își gestionează singur datele de acces, șterge goal-ul.
• Creditul epuizat, un context care nu mai poate fi redus și un model indisponibil șterg și ele goal-ul.

Când reiei o sesiune, Claude Code păstrează condiția, dar pornește de la zero numărătoarea tururilor, cronometrul și tokenii cheltuiți. Limita ta reîncepe deci de la zero după reluare. Ține cont de asta dacă ai pus „Maxim 10 tururi”.

Verificarea costă puțin. Tokenii evaluatorului se facturează pe modelul mic și rapid al furnizorului. Documentația îi descrie ca neglijabili, de obicei, față de tururile principale. /goal funcționează și în aplicația desktop, în modul neinteractiv și prin Remote Control. Pentru obiceiurile care fac sesiunile lungi mai sigure, vezi ghidul despre Claude folosit ca un utilizator avansat.

Cele trei piese răspund la trei întrebări diferite. CLAUDE.md răspunde la „cine suntem și ce reguli avem”. Skill-ul răspunde la „cum facem sarcina asta”. /goal răspunde la „când am terminat”. Tabelul de mai jos poate fi folosit ca listă de verificare înainte de prima săptămână de lucru.

Criteriu	CLAUDE.md	Skill	/goal
Ce conține	Regulile și contextul firmei	Pașii unei sarcini repetate	O condiție de final și o limită
Când se încarcă	La începutul fiecărei sesiuni	Doar când e folosit	Rămâne activ în sesiunea curentă
Unde stă	Fișierul CLAUDE.md din proiect	.claude/skills/nume/SKILL.md	Se scrie în sesiune
Limită practică	Sub 200 de rânduri	Descriere scurtă și precisă	Până la 4.000 de caractere, un goal pe sesiune
Greșeala frecventă	Interdicții lăsate doar aici	Descriere vagă, Claude nu-l alege	Condiție pe care Claude nu o poate afișa
Exemplul din ghid	Limbă, prețuri, drafturi	rezumat-saptamanal	Câte un draft pe client

Dacă o regulă trebuie respectată de fiecare dată, nu o lăsa în niciuna dintre cele trei coloane. Pune-o într-o regulă deny sau într-un hook.

Pentru o firmă din România, CLAUDE.md este locul în care scrii regulile de limbă. Claude trebuie să știe că scrie cu diacritice și că clienților le spune „dumneavoastră”. Mai trebuie să știe în ce monedă scrie prețurile și dacă le dă cu TVA sau fără. Fără aceste rânduri, primești texte corecte, dar care nu sună a firma ta.

Programele de facturare apar aproape în orice CLAUDE.md românesc. Factureaza.ro are propriul MCP server. Îl adaugi în Claude ca connector personalizat, cu autorizare OAuth, din abonamentul Standard. Pentru SmartBill, Svennis construiește un connector sau un MCP server.

Pentru fiecare legătură cu programele firmei, Svennis îți arată variantele cu costul lor, iar tu alegi. Până atunci, regula din exemplu rămâne valabilă: Claude nu scrie texte de factură, contabilitatea le emite în SmartBill.

Un ultim detaliu ține de calculatoarele din birou. Înregistrarea unui skill merge doar în aplicația pentru Mac. Dacă echipa ta lucrează pe Windows, scrii skill-ul de mână, ca în exemplul din acest ghid.

Prima săptămână poate fi împărțită în patru zile de lucru scurte:

1. Rulezi /init în folderul proiectului și scurtezi CLAUDE.md la regulile care contează, sub 200 de rânduri.
2. Marchezi fiecare interdicție și o muți într-o regulă deny sau într-un hook.
3. Alegi sarcina pe care o faci în fiecare vineri și scrii pentru ea un singur skill, cu o descriere precisă.
4. Rulezi un /goal cu o stare finală numărabilă și o limită de tururi, apoi verifici rezultatul de mână.

Nu adăuga al doilea skill până când primul nu merge trei săptămâni la rând fără corecturi. Notează ce a greșit Claude și pune regula în CLAUDE.md sau în skill, unde îi e locul.

Dacă vrei să faci asta împreună cu echipa, oferta Svennis are patru pași: Workshop-ul, apoi Pilot Claude A (un agent AI (Claude) pentru un proces) sau Pilot Claude B (Claude Team pentru toată echipa), apoi Activarea pe departament și operarea lunară. Primul pas este Workshop-ul de pregătire Claude, în care alegi procesul și scrii primele reguli. Costurile planurilor Claude sunt pe pagina cu prețurile Claude în euro.