Scrollcraft
Capitolul 3 din 15EN

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.

Capitolul 3 din 154 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Scrii un brief în cinci părți: rezultat, fapte, limite, format și dovezi.
  2. 02Transformi o cerere vagă într-una precisă.
  3. 03Păstrezi regulile care nu se schimbă într-un fișier de reguli al proiectului.
  4. 04Conduci o sesiune: un plan înainte de cod, o schimbare o dată și o cale de întoarcere.

01 · Anatomia

Cinci părți
Scop

Spune 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.

Context

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.

Limite

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.

Rezultat

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.

Verificare

Cere dovezi

Încheie cu „listează ce ai testat și ce n-ai putut testa”. Golurile devin vizibile în loc să rămână ascunse.

Șablon
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 cerere
Slab

Brief vag

Prompt
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.

Puternic

Brief precis

Prompt
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.

CLAUDE.md
# 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ă
Plan

Planul înaintea codului

Pentru orice depășește câteva rânduri, cere planul și aprobă-l mai întâi.

Prompt
Nu scrie încă cod. Listează fișierele pe care le vei schimba, ordinea și riscurile. Așteaptă aprobarea mea.
Mic

O schimbare pe rând

Cererile mari și combinate ascund ce schimbare a stricat pagina.

Prompt
Fă doar această schimbare: [schimbare]. Nu atinge nimic altceva. Spune-mi ce rânduri ai editat.
Arată

Cere dovezi

Întreabă ce s-a rulat, nu dacă merge.

Prompt
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ă.
Critică

Verifică precum un sceptic

O a doua trecere, cu alt rol, prinde ce i-a scăpat primei.

Prompt
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.
Explică

Pune-l să te învețe

Tu vei întreține acest cod, așa că cere motivele.

Prompt
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.
Înapoi

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.

bash
git init
git add -A && git commit -m "working hero"

Practică · Lucrul cu AI

Aceeași sarcină, în unealta ta

Două 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

Prompt
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

Prompt
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ă
1

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.

Prompt
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.
2

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.

3

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ă.

  1. Scrie brief.md cu cele cinci părți pentru [subiect], după șablonul de mai jos.
  2. Creează fișierul de reguli în rădăcina proiectului (CLAUDE.md, GEMINI.md sau AGENTS.md), cu limitele din brief.
  3. Rulează „Plan înainte de cod” și salvează planul primit ca plan.md.
  4. Rulează git init și fă un commit, ca fiecare pas de mai târziu să aibă o cale de întoarcere.
brief.md
# 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 rezultatul
  • brief.md are 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 log arată un prim commit.

Practică · Evaluare

Criterii de acceptare

0 din 4 criterii îndeplinite

Urmează Construcție

Zece pași cu promptul exact pentru fiecare, încă 24 de prompturi și un exemplu complet din trei fișiere, rulat și verificat.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor