CLAUDE.md i AGENTS.md: uputstvo za AI, bez programiranja

Ažurirano: 12.10.2026. | Verzija 1.0

Ako svaki put objašnjavate istu stvar, to nije prompt nego pravilo projekta, i treba da stoji u fajlu koji alat pročita sam. Taj fajl se kod Claude Code-a zove CLAUDE.md, a podržan je i naziv AGENTS.md koji koristi više alata.

Isto postoji i drugde pod drugim imenom: pravila u Cursor-u, znanje o projektu u Lovable-u, uputstva projekta u v0. Princip je svuda isti.

Čemu služi

Alat ga učita pre nego što počne da radi. Posledica je da prestajete da ponavljate stvari poput: koristimo srpske nazive za fajlove, baza je PostgreSQL, ne diraj folder sa migracijama, testovi se pokreću ovom komandom.

Bez tog fajla, svaki nov razgovor počinje od nule i agent donosi pretpostavke koje vi niste tražili.

Šta ide unutra

Šest grupa, po redu korisnosti.

1. Kako se pokreće projekat. Komanda za pokretanje, za testove, za gradnju. Ovo je stavka koja najviše štedi vremena jer agent inače pogađa.

2. Šta se ne dira. Fajlovi, folderi i delovi koda koje ne sme da menja bez pitanja. Ovde ide i produkcijska baza.

3. Dogovori oko imenovanja i jezika. Na kom jeziku su nazivi, kako se imenuju fajlovi, kako se pišu poruke uz izmene.

4. Tehnologije i verzije. Šta koristite, a šta namerno ne koristite. Rečenica „ne uvodi nove biblioteke bez pitanja" ovde vredi više nego bilo gde.

5. Pravila za osetljive delove. Gde su tajne, kako se radi sa plaćanjem, šta mora da ima proveru.

6. Kako izgleda završen posao. Šta mora da prođe da bi se izmena smatrala gotovom.

Primer koji možete da prekopirate

# Pravila projekta

## Pokretanje
- Razvoj: `pnpm dev`
- Testovi: `pnpm test`
- Provera pre slanja: `pnpm proveri`

## Ne diraj bez pitanja
- `migracije/` i sve u njemu
- `src/naplata/` (dira novac, traži pregled)
- Produkcijsku bazu. Radi isključivo na razvojnoj.

## Dogovori
- Nazivi fajlova i promenljivih na srpskom, latinicom, bez dijakritike u imenima fajlova.
- Poruke uz izmene: jedna rečenica, šta je promenjeno i zašto.
- Ne uvodi nove biblioteke bez pitanja. Koristi one iz spiska zavisnosti.

## Osetljivo
- Nijedan tajni ključ ne sme u kod koji ide u pregledač.
- Svaka tabela mora da ima uključenu zaštitu na nivou reda.
- Svaka ruta koja prima webhook mora da proveri potpis i da bude
  otporna na dupli dolazak istog događaja.

## Završen posao znači
- Testovi prolaze.
- Gradnja prolazi.
- Napisano je šta je menjano, u jednoj rečenici.

To je sve. Jedna strana je dovoljna za većinu projekata.

Dva pravila o pravilima

Dodajte stavku tek kad agent dvaput pogreši istu stvar. Fajl napisan unapred, na osnovu pretpostavki, pun je stavki koje nikom ne trebaju. Fajl koji raste iz stvarnih grešaka je tačno onoliko dugačak koliko treba.

Izbacujte ono što je prestalo da važi. Ovo je važnije nego što zvuči. Predugačak fajl se u praksi slabije poštuje, jer se pravila takmiče za pažnju. Ako imate tri strane pravila i agent ih povremeno ignoriše, problem je dužina.

Česte greške

Greška	Zašto smeta
Fajl od pet strana	Pravila se gube, agent počinje da bira koja će poštovati
Protivrečna pravila	„Budi koncizan" i „objasni detaljno" na istoj strani
Opisi umesto uputstava	„Vodimo računa o kvalitetu" ne znači ništa. „Svaka izmena mora da prođe pnpm test" znači
Prepisana dokumentacija	Fajl nije mesto za opis arhitekture, nego za pravila ponašanja
Tajne u fajlu	On ide u repozitorijum. Ključevi nikad ne idu unutra
Nikad se ne menja	Projekat se promeni, pravila ostanu, agent radi po starom

Da li vredi ako ne programirate

Vredi, i to više. Ako kod ne čitate, jedini način da nametnete dosledno ponašanje je da ga napišete jednom na mestu koje alat sam čita.

U alatima koji prave aplikacije iz opisa isto postoji, samo se drugačije zove. Potražite u podešavanjima nešto poput znanja o projektu ili uputstava, i upišite tri stvari: za koga je aplikacija, šta se nikad ne menja, i kako izgleda da je nešto gotovo.

Česta pitanja

Koja je razlika između CLAUDE.md i AGENTS.md? Ime. CLAUDE.md je prvobitno Claude Code, AGENTS.md se ustalio kao naziv koji podržava više alata. Claude Code podržava oba.

Gde se fajl stavlja? U koren projekta. Veći projekti dodaju i posebne fajlove po podfolderima, za pravila koja važe samo tamo.

Koliko dugačak sme da bude? Jedna do dve strane. Preko toga pravila počinju da se gube.

Da li agent uvek poštuje ta pravila? Ne uvek. Zato ozbiljne stvari, poput zabrane rada na produkciji, ne smeju da počivaju samo na tom fajlu, nego i na stvarnim dozvolama. Zvanična dokumentacija to kaže izričito: pravila dozvola sprovodi alat, a ne model.

Da li fajl ide u repozitorijum? Da, zato i radi za ceo tim. Zbog toga u njemu nikad ne sme biti tajni.

Sledeći korak

Napravite fajl danas sa tri stavke: kako se pokreće, šta se ne dira, kako izgleda gotovo. Dopunjavajte ga samo kad agent pogreši.

GoSimple · Ivan Dabetić

Izvori (provereno 12.10.2026)

• Claude Code, preporučeni tok rada i fajl sa pravilima: https://code.claude.com/docs/en/best-practices
• Claude Code, dozvole i granica između pravila i sprovođenja: https://code.claude.com/docs/en/permissions
• Cursor, preporuke za rad sa agentom: https://cursor.com/blog/agent-best-practices
• Lovable, znanje o projektu i pisanje zahteva: https://docs.lovable.dev/prompting/prompting-one
• v0, kako se piše zahtev: https://vercel.com/blog/how-to-prompt-v0