Prompturi: cum îi dai un brief AI-ului ca prima variantă să fie utilizabilă.
Cele mai multe rezultate slabe vin dintr-un brief slab. Capitolul îți dă un șablon, un exemplu înainte și după, un fișier cu regulile proiectului și șase tipare pentru a ghida munca.
Ce vei învăța
La finalul capitolului- 01Scrii un brief în cinci părți: rezultat, fapte, limite, format și dovezi.
- 02Transformi o cerere vagă într-una precisă.
- 03Păstrezi regulile care nu se schimbă într-un fișier de reguli al proiectului.
- 04Conduci o sesiune: un plan înainte de cod, o schimbare o dată și o cale de întoarcere.
01 · Anatomia
Cinci părțiSpune ce există la final
O propoziție care numește lucrul și pentru cine e. „Un site de o pagină pentru un studio fictiv” e un scop. „Ceva tare” nu e.
Dă-i faptele pe care nu le poate ghici
Numele fișierelor, tema, bibliotecile pe care le-ai ales deja și ce nu intră în proiect. Altfel asistentul alege în locul tău.
Stabilește limitele
Versiunile exacte ale bibliotecilor, ce proprietăți pot fi animate, regula pentru reduced motion, browserele care contează. Limitele sunt cel mai ieftin mod de a evita refacerea muncii.
Numește formatul
„Cele trei fișiere, nimic altceva” oprește o explicație lungă de care nu ai nevoie. Când sarcina e mare, cere întâi un plan scurt.
Cere dovezi
Încheie cu „listează ce ai testat și ce n-ai putut testa”. Golurile devin vizibile în loc să rămână ascunse.
Scop: [ce există la final, pentru cine]
Context: [fișiere, temă, biblioteci, ce intră în proiect]
Construiește, în ordine: [listă numerotată]
Limite: [versiuni, proprietăți permise, reduced motion, browsere]
Rezultat: [format]. Apoi listează ce ai testat și ce n-ai putut testa.02 · Înainte și după
Aceeași cerereBrief vag
Fă-mi un site tare cu scroll și animații.Vei primi o pagină generică, probabil cu o bibliotecă grea, un gradient și efecte pe care nu le-a cerut nimeni. Apoi pierzi mai multe runde desfăcând alegeri.
Brief precis
Scop: un site de o pagină pentru un studio fictiv numit Northlight, construit cu HTML, CSS și JavaScript simple.
Context: e un exemplu didactic. Cele trei fișiere sunt index.html, style.css și app.js. Temă întunecată, o singură culoare de accent.
Construiește, în această ordine:
1. Un hero cu două straturi de parallax (vitezele 0.2 și 0.4).
2. O propoziție care se aprinde cuvânt cu cuvânt pe măsură ce derulez printr-o secțiune fixată.
3. Trei carduri care apar de jos când intră în ecran, o singură dată.
4. O galerie orizontală fixată, cu cinci panouri.
Limite: Lenis 1.1.18 de pe jsDelivr pentru scroll lin. Doar transform și opacity. Reduced motion oprește tot.
Rezultat: cele trei fișiere, nimic altceva. Apoi listează ce ai testat și ce n-ai putut testa.Fiecare decizie ambiguă e lămurită. Rezultatul poate fi verificat față de listă, punct cu punct.
03 · Fișierul de reguli
Scrie-l o datăPune regulile care nu se schimbă niciodată într-un fișier pe care unealta îl citește la începutul fiecărei sesiuni, ca să nu le mai repeți. Claude Code citește CLAUDE.md, Gemini CLI citește GEMINI.md, iar Codex citește AGENTS.md. Numele fișierelor și regulile de încărcare se pot schimba, așa că verifică pagina actuală a uneltei tale înainte să te bazezi pe ele.
# Northlight
Site static: index.html, style.css, app.js. Fără pas de build.
## Reguli
- JavaScript simplu. Bibliotecile vin de pe jsDelivr, fixate pe o versiune exactă.
- Animă doar transform și opacity.
- Fiecare mișcare are o variantă pentru prefers-reduced-motion.
- Testează cu `python3 -m http.server 8000`. Nu deschide niciodată fișierul direct.
- Nu inventa texte, statistici, citate sau logouri de clienți.
## Gata înseamnă
- Nicio eroare în consolă la lățimi de 375, 768 și 1440 px.
- Listezi verificările pe care le-ai rulat și pe cele pe care n-ai putut să le rulezi.Ține-l scurt. Regulile lungi sau contradictorii sunt ignorate mai des decât cele scurte și concrete.
04 · Șase tipare
Copiază și adapteazăPlanul înaintea codului
Pentru orice depășește câteva rânduri, cere planul și aprobă-l mai întâi.
Nu scrie încă cod. Listează fișierele pe care le vei schimba, ordinea și riscurile. Așteaptă aprobarea mea.O schimbare pe rând
Cererile mari și combinate ascund ce schimbare a stricat pagina.
Fă doar această schimbare: [schimbare]. Nu atinge nimic altceva. Spune-mi ce rânduri ai editat.Cere dovezi
Întreabă ce s-a rulat, nu dacă merge.
Deschide pagina la 375 px și la 1440 px. Raportează erorile din consolă cuvânt cu cuvânt și numește fiecare element care iese din pagină.Verifică precum un sceptic
O a doua trecere, cu alt rol, prinde ce i-a scăpat primei.
Verifică pagina ca un recenzent ostil. Listează cele cinci puncte cele mai slabe: performanță, accesibilitate, mișcări care pot provoca disconfort și orice pare inventat.Pune-l să te învețe
Tu vei întreține acest cod, așa că cere motivele.
Explică pe înțelesul tuturor cum funcționează calculul de parallax, cu un exemplu numeric. Apoi spune ce s-ar strica dacă viteza ar fi 0.9.Păstrează o cale de întoarcere
Fă un commit sau copiază folderul înaintea fiecărui pas mare. Dacă o schimbare iese prost, revino și rescrie promptul în loc să cârpești peste.
git init
git add -A && git commit -m "working hero"Practică · Lucrul cu AI
Aceeași sarcină, în unealta taDouă prompturi pe care le vei folosi tot restul cursului: unul care pune AI-ul să planifice înainte să scrie cod și unul care îl pune să-și caute singur greșelile.
Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.
Plan înainte de cod
Citește CLAUDE.md și brief.md. Nu scrie încă cod. Dă-mi un plan numerotat pentru secțiunea hero a site-ului pentru [subiect]: fișierele pe care le schimbi, ce face fiecare schimbare și cum o pot verifica în browser. Așteaptă aprobarea mea.Verifică sceptic
Verifică ultima ta schimbare ca un programator front-end senior și sceptic. Listează ce s-ar putea strica pe telefon, cu mișcare redusă și doar cu tastatura. Nu repara încă nimic.Deschide un terminal în folderul proiectului și rulează gemini; prima dată te întreabă dacă ai încredere în folder, așa că răspunde da pentru proiectul tău. Lipește promptul. Gemini CLI cere voie înainte să editeze un fișier sau să ruleze o comandă: citește fiecare cerere înainte s-o accepți. Regulile proiectului stau în GEMINI.md.
Plan înainte de cod
Citește GEMINI.md și brief.md. Nu scrie încă cod. Dă-mi un plan numerotat pentru secțiunea hero a site-ului pentru [subiect]: fișierele pe care le schimbi, ce face fiecare schimbare și cum o pot verifica în browser. Așteaptă aprobarea mea.Verifică sceptic
Verifică ultima ta schimbare ca un programator front-end senior și sceptic. Listează ce s-ar putea strica pe telefon, cu mișcare redusă și doar cu tastatura. Nu repara încă nimic.Deschide un terminal în folderul proiectului, rulează codex, lipește promptul și aprobă fiecare schimbare. În aplicația ChatGPT fără Codex, atașezi fișierele, lipești promptul și copiezi singur schimbările înapoi. Regulile proiectului stau în AGENTS.md.
Plan înainte de cod
Citește AGENTS.md și brief.md. Nu scrie încă cod. Dă-mi un plan numerotat pentru secțiunea hero a site-ului pentru [subiect]: fișierele pe care le schimbi, ce face fiecare schimbare și cum o pot verifica în browser. Așteaptă aprobarea mea.Verifică sceptic
Verifică ultima ta schimbare ca un programator front-end senior și sceptic. Listează ce s-ar putea strica pe telefon, cu mișcare redusă și doar cu tastatura. Nu repara încă nimic.Practică · Exerciții
Încearcă, apoi comparăRescrie un brief vag
Rescrie „Fă-mi un site mișto cu animații.” ca un brief în cinci părți pentru [subiect].
Indiciu: treci prin rezultat, fapte, limite, format și dovezi, în această ordine.
Arată soluția
Compară-l pe al tău cu acesta. Fiecare parte răspunde la o întrebare la care altfel AI-ul ar ghici.
Rezultat: un site cinematic de o pagină pentru [subiect], pentru [public], care se încheie cu o singură acțiune: [o acțiune].
Fapte: cinci secțiuni în această ordine: hero, poveste, trei funcții, un moment de produs fixat, îndemnul final. Folosește doar textul pe care ți-l dau.
Limite: HTML, CSS și JavaScript simplu, în trei fișiere. Animezi doar transform și opacity. Fiecare efect are o variantă statică sub prefers-reduced-motion. Fără cifre, citate sau logouri inventate.
Format: cele trei fișiere complete, apoi o listă cu ce s-a schimbat.
Dovezi: listează fiecare verificare pe care ai rulat-o, cu lățimea sau unealta, și fiecare verificare pe care n-ai putut-o rula.Găsește partea lipsă
Acest brief nu are limite: „Construiește un site de o pagină pentru [subiect], cu o secțiune de produs fixată și un link de contact. Răspunde cu cele trei fișiere.” Adaugă-le.
Indiciu: limitele sunt ce nu are voie AI-ul să facă sau să folosească.
Arată soluția
De exemplu: HTML, CSS și JavaScript simplu; nicio bibliotecă în afară de Lenis; animezi doar transform și opacity; respecți mișcarea redusă; nimic ascuns fără o clasă .js; fără cifre, citate sau logouri inventate.
Cere dovezi
Scrie propoziția care pune AI-ul să-și dovedească munca, în loc să spună „testat”.
Indiciu: cere și ce a rulat, și ce n-a rulat.
Arată soluția
„Listează fiecare verificare pe care ai rulat-o de fapt, cu lățimea sau unealta folosită, și fiecare verificare pe care n-ai putut-o rula și de ce.” Apoi deschide pagina și uită-te la verificările pe care nu le-a putut rula.
Practică · Proiectul cursului
Un site, construit pe tot parcursulÎnainte de orice cod, scrie ce este site-ul și regulile care nu se schimbă.
- Scrie
brief.mdcu cele cinci părți pentru [subiect], după șablonul de mai jos. - Creează fișierul de reguli în rădăcina proiectului (CLAUDE.md, GEMINI.md sau AGENTS.md), cu limitele din brief.
- Rulează „Plan înainte de cod” și salvează planul primit ca
plan.md. - Rulează
git initși fă un commit, ca fiecare pas de mai târziu să aibă o cale de întoarcere.
# Brief: [subiect]
Rezultat: un site cinematic de o pagină pentru [subiect], pentru [public].
Pagina se încheie cu o singură acțiune: [o acțiune].
Fapte: nume, cifre reale, citate reale și secțiunile în ordine.
Limite: HTML, CSS și JavaScript simplu, în trei fișiere. Animezi doar
transform și opacity. Fiecare efect are o variantă statică sub
prefers-reduced-motion. Fără cifre, citate sau logouri inventate.
Format: cele trei fișiere complete, apoi o listă cu ce s-a schimbat.
Dovezi: fiecare verificare rulată, cu lățimea sau unealta, și fiecare
verificare care n-a putut fi rulată.Practică · Testează
Verifici rezultatulbrief.mdare toate cele cinci părți și niciuna nu spune „de completat”.- Întrebat „Ce reguli se aplică în acest proiect?”, AI-ul citează fișierul tău de reguli.
- Planul numește fișierele și o verificare pentru fiecare pas, iar niciun fișier nu s-a schimbat înainte să-l aprobi.
git logarată un prim commit.
Practică · Evaluare
Criterii de acceptare0 din 4 criterii îndeplinite