AI-Optimized PRD: dokument zahteva za AI agente

U 2026. godini PRD čitaju ne samo ljudi već i AI agenti. Cursor, Claude Code, Bolt i drugi alati za AI kodiranje koriste PRD kao set instrukcija: šta graditi, kojim redosledom, sa kojim ograničenjima. Da bi ovo funkcionisalo, standardni PRD treba prilagoditi tako da i čovek i AI agent dobiju informacije koje su im potrebne.

Čime se razlikuje od standardnog PRD-a

Key insight

Ključna razlika je fazna struktura. Standardni PRD opisuje proizvod u celini, ostavljajući timu slobodu u redosledu realizacije. AI-Optimized PRD deli implementaciju na sekvencijalne faze, od kojih svaka ima ograničen scope, eksplicitne zavisnosti i testabilan rezultat.

Struktura AI-Optimized PRD-a

Zaglavlje dokumenta

Kao i u standardnom PRD-u: Problem Statement, Target Users, Proposed Solution, Success Metrics. Ovaj deo je napisan za ljude — u prozi, sa kontekstom i obrazloženjem.

Tehnička ograničenja

Sekcija koja ne postoji u standardnom PRD-u. AI agent mora da zna:

• Stek: jezici, framework-ovi, verzije (npr. „Next.js 15, TypeScript, Supabase”)
• Postojeća baza koda: koji fajlovi i obrasci već postoje
• API ugovori: spoljni servisi, formati podataka
• Zabrane: šta AI agent ne sme da radi (menja šemu baze, dira auth, instalira nove zavisnosti)

Faze realizacije

Svaka faza je samodovoljan blok posla:

## Phase 1: [Naziv]

**Dependencies:** None (ili Phase N)
**Scope:** Šta pokriva ova faza
**Out of scope:** Šta je eksplicitno isključeno

**Tasks:**
1. Kreirati model podataka za X
2. Realizovati API endpoint /api/x
3. Napisati test za endpoint

**Testable output:** Šta se može proveriti po završetku
- API endpoint vraća 200 sa korektnim podacima
- Test prolazi
- Migracija baze se primenjuje bez grešaka

Šta NE raditi (AI Instructions)

Eksplicitne zabrane za AI agenta:

• Ne menjati postojeće fajlove koji nisu navedeni u zadatku
• Ne instalirati zavisnosti bez eksplicitne instrukcije
• Ne kreirati fajlove izvan navedenih direktorijuma
• Ne menjati konfiguraciju deploy-a

Zašto je potreban poseban format

Standardni PRD opisuje „šta”, ostavljajući „kako” inženjerima. Kada je inženjer čovek, to funkcioniše: on razume kontekst, postavlja pitanja, donosi odluke na osnovu iskustva.

AI agent radi drugačije. On izvršava instrukcije doslovno i potrebno mu je:

• Jasne granice: šta raditi i šta ne raditi u svakoj fazi
• Redosled: koje faze zavise od kojih
• Testabilni rezultati: kako proveriti da je faza korektno završena
• Tehnički kontekst: stek, verzije, postojeći obrasci

Key insight

Bez ovih elemenata AI agent će ili generisati kod nekompatibilan sa bazom koda, ili izaći van scope-a, ili propustiti kritična ograničenja.

Primer fragmenta

# Task Manager MVP — AI-Optimized PRD

## Problem
Timu je potreban alat za praćenje zadataka.
Trenutno rešenje — Google Sheets — ne skalira se.

## Technical Constraints
- Stack: Next.js 15, TypeScript, Supabase
- Auth: već podešen preko Supabase Auth (ne dirati)
- Styling: Tailwind CSS, postojeći design system u /components/ui/
- DB: Supabase PostgreSQL, migracije preko supabase migration

## Phase 1: Data model + API

**Dependencies:** None
**Scope:** Kreirati tabelu tasks i CRUD API

**Tasks:**
1. Kreirati migraciju: tabela tasks (id, title, status, assignee, created_at)
2. Realizovati API rute: GET /api/tasks, POST /api/tasks, PATCH /api/tasks/[id]
3. Dodati RLS polise za tasks

**Testable output:**
- Migracija se primenjuje: `supabase db push` bez grešaka
- GET /api/tasks vraća prazan niz (200)
- POST /api/tasks kreira zadatak i vraća ga (201)

**Out of scope:** UI, filtriranje, pretraga

## Phase 2: Basic UI
**Dependencies:** Phase 1
...

Kada koristiti

AI-Optimized PRD je umestan kada:

• Radite sa AI agentom (Cursor, Claude Code, Bolt, Copilot Workspace)
• Projekat ima definisan stek i postojeću bazu koda
• Zadatak se može podeliti na tri do sedam sekvencijalnih faza
• Svaka faza ima proverljiv rezultat

Ako je projekat u fazi ideje i stek nije određen, počnite sa standardnim PRD-om ili MVP PRD-om, a AI-Optimized PRD napišite kada su arhitektonske odluke donete.

Dual-audience pristup

U praksi AI-Optimized PRD često sadrži dva sloja:

1. Za ljude — gornji deo dokumenta: Problem Statement, Target Users, Success Metrics. Napisan u prozi, objašnjava „zašto”.
2. Za AI agenta — donji deo: Technical Constraints, Phases, AI Instructions. Strukturiran, konkretan, bez retorike.

Key insight

Ovaj format omogućava da jedan dokument služi i za usklađivanje tima i kao direktan ulaz za AI kodiranje.

Resursi

• PRD — kompletni vodič — pregled svih varijacija
• AI-Optimized PRD šablon — gotov šablon za preuzimanje
• PRD generator prompt — napravite PRD koristeći ChatGPT ili Claude
• MVP PRD — minimalni format za brzo lansiranje