Cum scrii un prompt bun: ce ne-a funcționat când am construit un site cu AI

Construim Outcomo cu ajutorul lui Claude, inteligența artificială de la Anthropic. Lucrăm cu el în Claude Code, un instrument care scrie și modifică cod direct pe calculator. Din toate commiturile din depozitul site-ului (în total 229), 224 au fost făcute cu Claude, primul pe 28 septembrie 2026 (situația la 31 octombrie 2026). Toate calculatoarele și instrumentele (în total 21), articolele în 9 limbi și testele care le verifică: totul începe cu o instrucțiune, adică un prompt. Iată ce ne-a funcționat. La fiecare sfat spunem și ce spun despre el ghidurile oficiale de la Anthropic, OpenAI și Google.

1. Spune la ce folosește și pentru cine

AI știe despre sarcina ta doar ce îi scrii. Anthropic recomandă să-l tratezi pe Claude ca pe un coleg priceput, dar nou, care nu-ți cunoaște obiceiurile: cu cât descrii mai exact ce vrei, cu atât rezultatul e mai bun. Propune și un test simplu: dă-i promptul să-l citească cuiva care nu știe nimic despre sarcină. Dacă acea persoană s-ar pierde în el, s-ar pierde și AI.

De aceea, la noi AI primește pentru fiecare articol informația despre cui i se adresează: cititorilor din ce țară și cum să li se adreseze. În germană folosim Sie, de politețe, în română, spaniolă și poloneză ne adresăm cu tu, iar în maghiară folosim formalul Ön.

Ajută și să scrii de ce. Anthropic dă un exemplu: în loc de „nu folosi niciodată puncte de suspensie”, scrie că textul va fi citit de o voce AI care nu le poate pronunța. Cunoscând motivul, AI deduce și ce nu ai scris explicit. Când n-am vrut ca răspunsurile la întrebările frecvente să citeze legi, am adăugat și de ce: legile se schimbă și ar trebui să verificăm textul mereu. Regula e deci să scriem general și, pentru detalii, să trimitem la contract sau la bancă.

2. Scrie concret

Documentația Claude Code recomandă instrucțiuni atât de concrete încât să se poată verifica dacă AI le-a respectat: „indentează cu două spații” în loc de „formatează codul cum trebuie”. OpenAI recomandă același lucru: claritate, precizie, context suficient și fără ambiguități. Câteva instrucțiuni din munca noastră:

În general	Concret
Adaugă explicații.	Adaugă o explicație la fiecare câmp al calculatorului pe care un nespecialist s-ar putea să nu-l înțeleagă. La randament și volatilitate, cu exemple din datele noastre. În toate limbile site-ului.
Verifică cifrele.	Ia cifrele pentru articol doar din fișierele cu date, unde fiecare cifră are sursă și dată.
Nu scrie nimic nesigur.	Ce nu știi sigur, scrie ca întrebare deschisă, nu ca fapt.

Prima regulă a apărut când în unele calculatoare lipseau explicațiile. Scrisă așa, poate fi verificată câmp cu câmp la fiecare calculator nou.

3. Arată un model

Un exemplu spune adesea mai mult decât o descriere lungă. Anthropic consideră exemplele una dintre cele mai sigure căi de a stabili formatul, tonul și structura răspunsului și recomandă între 3 și 5 exemple. Ele trebuie să semene cu sarcina ta reală și, totodată, să difere suficient, ca AI să nu preia ceva ce au în comun doar din întâmplare. Google recomandă să adaugi mereu exemple.

De aceea, un articol nou nu pornește de la zero: AI citește mai întâi un articol terminat asemănător și îi urmează structura, tonul și felul în care citează sursele. Acesta a fost scris după ghidul despre vocea AI.

4. Spune ce să facă, nu ce să nu facă

O interdicție spune ce nu vrei, dar nu și ce vrei. Anthropic recomandă ca în loc de „nu folosi markdown” să scrii „răspunde în paragrafe continue”. Noi, în loc de „nu scrie prețuri din memorie”, avem „prețuri doar din lista oficială de prețuri, cu data la care am verificat-o”. Atunci AI știe unde să caute prețul și ce să scrie lângă el.

5. Lasă AI să spună „nu știu” și cere surse

AI inventează uneori un răspuns care sună credibil. Anthropic recomandă să permiți explicit răspunsul „nu știu”, să ceri o sursă pentru fiecare afirmație și să tai afirmațiile fără sursă. Avertizează totodată că nici asta nu elimină complet greșelile, iar informațiile importante trebuie verificate.

Regulile noastre: surse doar de pe pagini oficiale și o estimare niciodată prezentată ca fapt. Două exemple din ultimele zile:

• Maghiara și vocea AI. Înainte să traducem în maghiară ghidul despre vocea AI, am verificat în documentația ElevenLabs ce limbi vorbește modelul. Maghiara nu e printre ele, așa că articolul în maghiară spune asta chiar de la început, în loc să susțină că pașii sunt aceiași.
• Butoane pe care nu le-am văzut. Ghidul despre Trezor nu numește butoane pe care nu le-am verificat. Scrie general „alege primirea”, nu o denumire care în aplicație poate apărea altfel.

6. Verifică rezultatul cu ceva ce se poate verifica

Anthropic recomandă să știi, încă înainte să ajustezi promptul, după ce recunoști un rezultat bun și să ai un mod de a-l testa. La noi fac asta testele: în prezent sunt 1.338, iar AI le rulează după fiecare modificare. Ele verifică atât calculele calculatoarelor, cât și articolele, de exemplu ca, în poloneză sau ucraineană, cuvintele de după numere să aibă forma corectă.

Testele le scrie tot AI și prind chiar și propriile ei greșeli. În versiunea în engleză a ghidului despre Trezor am scris la început că lista de cuvinte în engleză a generatorului de frază de acces conține doar litere. Un test care a parcurs toată lista a găsit și cuvinte cu cratimă, de exemplu drop-down. Am corectat textul înainte să fie publicat.

7. Împarte o sarcină mare în pași

Primul prompt iese rar din prima. OpenAI și Google descriu scrierea prompturilor ca pe o repetare: scrii, te uiți la rezultat, ajustezi formularea, adaugi context sau simplifici sarcina. Google recomandă și să împarți o sarcină complexă în pași mai mici, în care rezultatul unuia e intrarea următorului.

De aceea, schimbările mai mari de pe site nu încep cu cod. Mai întâi scriem cu AI un document de design: ce trebuie să apară, pentru cine și ce nu face parte din el. Din el, AI face un plan pas cu pas și abia apoi scrie codul, pas cu pas și cu teste. Numărul de documente de design din depozit: 23, iar de planuri: 11.

8. Ce se repetă, scrie o singură dată

Regulile care se aplică mereu nu trebuie scrise în fiecare prompt. ChatGPT are pentru asta instrucțiuni personalizate (Custom Instructions), valabile pentru toate conversațiile, iar Claude are instrucțiuni de proiect. Claude Code încarcă la începutul fiecărei sesiuni fișierul cu instrucțiunile proiectului (CLAUDE.md) și notițele pe care le ține singur. Documentația lui recomandă instrucțiuni scurte și concrete, sub 200 de rânduri pe fișier: un fișier mai lung ocupă mai mult loc, iar AI îl respectă mai greu.

La noi scrie acolo, de exemplu, că AI vorbește cu noi în cehă, de unde să ia cifrele și cum să se adreseze cititorilor în fiecare limbă. Regulile noi apar mai ales după greșeli, ca aceea cu explicațiile.

9. Skill-uri: instrucțiuni pe care AI le ia când are nevoie de ele

Instrucțiunile de proiect se încarcă de fiecare dată. Un skill, în schimb, e un folder cu instrucțiuni (fișierul SKILL.md), uneori și cu scripturi și materiale, pe care AI îl încarcă doar când e util. Până atunci îi cunoaște doar descrierea scurtă, așa că și instrucțiunile lungi nu costă aproape nimic cât timp nu sunt necesare. Un skill se poate porni și manual, cu o bară oblică și numele lui, de exemplu /brainstorming.

Claude are skill-uri integrate pentru documente Word, Excel, PowerPoint și PDF și, potrivit centrului de ajutor, skill-urile sunt disponibile în toate abonamentele, inclusiv în cel gratuit. Formatul e un standard deschis, Agent Skills, așa că același skill funcționează și în alte instrumente. Catalogul skills.sh menționează, de exemplu, Cursor, GitHub Copilot, Codex și Gemini CLI.

Cel mai mult folosim pachetul Superpowers. Skill-ul lui brainstorming pune întrebări despre sarcină înainte de lucru, una câte una, și din răspunsuri scrie un document de design. Skill-ul writing-plans face din documentul de design un plan. De aici vin documentele de design și planurile de la punctul 7.

Că skill-urile ajută cu adevărat a arătat studiul SkillsBench: cu skill-uri pregătite cu grijă, modelele au rezolvat în medie 50,5 % din sarcini în loc de 33,9 %. Skill-urile concentrate, din cel mult 3 părți, au funcționat mai bine decât pachetele mari de instrucțiuni. Iar un model mai mic cu skill-uri a egalat unul mai mare fără ele.

Ce skill-uri folosesc oamenii cu adevărat

Nimeni nu publică câți oameni folosesc fiecare skill. Am comparat deci ce se poate număra (situația la 31 octombrie 2026):

• Proiecte pe GitHub. În grep.app, un motor de căutare peste un eșantion mare de depozite publice de pe GitHub, am numărat proiectele care țin skill-ul într-un folder din care îl încarcă AI (.claude/skills sau .agents/skills). E cel mai aproape de folosirea reală.
• Instalări în catalogul skills.sh de la Vercel, care numără instalările făcute cu instrumentul său npx skills.
• Mențiuni în discuții. Comentarii pe Hacker News de la 1 octombrie 2025 care numesc skill-ul.

În proiectele publice, cele mai frecvente sunt frontend-design, skill-creator și vercel-react-best-practices. În schimb, pentru unele skill-uri cu foarte multe instalări n-am găsit niciun proiect (în paranteză, instalările): reddit-automation (1,2 mil.), design-mobile-apps (1,1 mil.) și ai-video-generation (916 K). Numărul de instalări spune deci, singur, puțin despre folosire. Pe Hacker News, cele mai menționate sunt Superpowers, frontend-design, grill-me și caveman.

Skill	Proiecte	Instalări
Planificare și metodă
skill-creator (anthropics)	162	420 K
grill-me (mattpocock)	114	1,5 mil.
Design și interfață
frontend-design (anthropics)	214	1,1 mil.
web-design-guidelines (vercel-labs)	111	808 K
Site-uri în React
vercel-react-best-practices (vercel-labs)	138	858 K
shadcn (shadcn)	85	131 K
Testare și depanare
playwright-cli (microsoft)	54	203 K
diagnosing-bugs (mattpocock)	41	872 K
Baze de date
convex-quickstart (get-convex)	25	133 K
supabase-postgres-best-practices (supabase)	24	468 K
Aplicații mobile
vercel-react-native-skills (vercel-labs)	9	262 K
building-native-ui (expo)	6	58 K
Marketing și SEO
seo-audit (coreyhaines31)	29	243 K
copywriting (coreyhaines31)	15	242 K
Documente
pdf (anthropics)	24	220 K
docx (anthropics)	14	211 K
Video
remotion-best-practices (remotion-dev)	25	720 K
hyperframes (heygen-com)	9	1,3 mil.

Skill-urile integrate ale lui Claude pentru documente se folosesc fără instalare, deci nici nu trebuie să apară în proiecte. Un skill poate conține și scripturi care rulează pe calculatorul tău. De aceea, instalează doar skill-uri de la autori în care ai încredere. Catalogul skills.sh arată la ele și rezultatele verificărilor de securitate.

Pe scurt

1. Scrie la ce folosește rezultatul, pentru cine și de ce îl vrei exact așa.
2. Scrie instrucțiunile atât de concret încât să se poată verifica dacă AI le-a respectat.
3. Adaugă un exemplu sau un model gata făcut.
4. Scrie ce să facă, nu ce să nu facă.
5. Permite răspunsul „nu știu” și cere surse.
6. Verifică rezultatul cu ceva ce se poate verifica, de exemplu un test.
7. Împarte o sarcină mare: document de design, plan, pași.
8. Ce se repetă, scrie o singură dată, iar instrucțiunile mai lungi pune-le în skill-uri scurte și concentrate.

Cât de precise trebuie să fie instrucțiunile poți încerca și fără AI. În instrumentul nostru Programare pentru începători, robotul face exact ce îi construiești, niciun pas în plus.