Odobrena funkcionalnost može da prođe kroz tri sistema pre nego što bude završena: dokument sa zahtevima, hijerarhiju stavki u Jira i repozitorijum. Claude Code može da pomogne u pisanju i implementaciji, ali veze između tih sistema zahtevaju ljudsko odobrenje i neposredne provere. Ovaj vodič vodi programera ili vođu tima kroz jednu stvarnu funkcionalnost, uključujući svaku odobrenu priču, njene izvorne testove, ovlašćena ažuriranja u Jira i pregledanu odluku o projektnim smernicama.

Ovo je postupak zasnovan na dokumentaciji. BIG CHANGE nije pristupao Jira projektu, pokretao Claude Code, menjao repozitorijum niti merio vreme isporuke funkcionalnosti. Tačni tipovi stavki, polja, prelazi, komande i troškovi zavise od vašeg projekta i naloga.

Velika promena

  • Šta se promenilo: Funkcionalnost se može pratiti od odobrenog zahteva, preko stvarne nadređene Jira stavke i svake priče, do pregledanog koda, izvornih provera i ovlašćenih ažuriranja stavki.
  • Zašto je važno: Mapa stavki, zapisi o testovima i podaci ponovo pročitani neposredno iz Jira pokazuju koji je odobreni posao završen, a koja priča je još otvorena.
  • Na šta obratiti pažnju: Polja i prelazi specifični za projekat, upisi neizvesnog ishoda i neuspele provere zahtevaju ljudsko razrešenje; smernice za Claude Code same po sebi ne daju ovlašćenje za rad.

Pre početka

Izaberite funkcionalnost sa opisom koji je odobrio odgovorni vlasnik, repozitorijumom koji smete da menjate i izvornom proverom prihvatljivosti koju možete da pokrenete. Stvarni posao mora da opravda jednu nadređenu stavku na nivou epika, njene odobrene priče i bar jedan smislen podzadatak u okviru priče u izabranom Jira Cloud projektu. Ako nema stvarnog podzadatka, ovaj konkretni celoviti ishod ostaje nedovršen; dodavanje ukrasne stavke bi iskrivilo plan. Zabeležite podnosioca zahteva, ovlašćenje za odobravanje, reviziju izvora, dozvoljene podatke, početni Git commit, način izolacije ili vraćanja i osobu koja sme da pregleda kod i menja Jira status.

Proverite instaliranu verziju Claude Code, autentifikaciju i dozvole. Potvrdite da datoteka CLAUDE.md u repozitorijumu daje projektne smernice, ali ne daje dozvolu za izmene, pokretanje komandi ili slanje podataka. Odredite koje zahteve i kod Claude sme da dobije, koje komande sme da pokrene i ograničenje upotrebe za ovu funkcionalnost. Upotreba Claude Code može da troši pretplatničku kvotu ili napravi troškove kod dobavljača; Anthropic vodič o troškovima ne utvrđuje vaš račun unapred.

Za Jira pribavite dozvolu da pregledate i pravite odgovarajuće tipove stavki, a kasnije da kao ovlašćeni korisnik komentarišete ili menjate njihov status. Privatna skripta može da koristi postupak sa imejlom i API tokenom iz Atlassian dokumentacije; integraciji može biti potreban OAuth. Čuvajte akreditive u privatnom skladištu tajni. Ne unosite ih u upite, tekst stavki, CLAUDE.md, evidencije ili sistem kontrole verzija. Dogovorite vidljivost stavki pre slanja zahteva u Jira.

Tokom rada čuvajte sedam privatnih evidencija: docs/feature-prd.md, ticket-plan.json, dnevnik upisa stavki u koji se samo dodaju zapisi, ticket-map.json, po jednu potvrdu implementacije za svaku priču, dnevnik Jira ažuriranja i odluku nakon osvrta. To su zapisi o vašoj funkcionalnosti, a ne datoteke koje je BIG CHANGE obezbedio ili izvršio.

1. Odobrite jedan tačno određen PRD

Dajte Claude Code stvarni odobreni opis funkcionalnosti i zatražite da utvrdi nerešena pitanja pre pisanja docs/feature-prd.md. Dokument treba da sadrži podnosioca i vlasnika koji odobrava, reviziju ulaza, problem i namenjenog korisnika, obim i izuzetke, numerisane identifikatore zahteva, provere prihvatljivosti i izvore dokaza, nefunkcionalna ograničenja, Jira projekat i otvorena pitanja. Odgovorna osoba treba da uporedi nacrt sa izvornim opisom i odobri jednu tačnu reviziju sadržaja i njen heš. Rešite bitna pitanja pre pravljenja stavki ili menjanja koda.

Heš daje kasnijim zapisima precizan izvor. Ako se PRD promeni, ponovo pregledajte pogođeni plan stavki i provere; neuspeh implementacije nije razlog da prepišete kriterijume prihvatljivosti tako da rezultat bude prolazan.

2. Utvrdite Jira hijerarhiju i polja ovog projekta

Pomoću ovlašćenih zahteva samo za čitanje ka Jira REST API v3, prođite kroz sve stranice GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes. Za svaki predloženi tip stavke prođite kroz sve stranice GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId} da utvrdite obavezna polja za kreiranje i dozvoljene vrednosti. Atlassian označava široku operaciju GET /issue/createmeta kao zastarelu u svojoj referenci API-ja za stavke.

Potvrdite stvarnu nadređenu stavku ekvivalentnu epiku, podređene stavke na nivou priče i podržane podzadatke za ovaj projekat. Atlassian opisuje podrazumevanu hijerarhiju i njeno podešavanje; nazivi tipova i ID vrednosti nisu univerzalni. Proverite kako polje Parent u projektu radi za svaki podređeni nivo i koja prilagođena polja ili podešavanja vidljivosti zahteva kreiranje. Ako projekat ne može da predstavi odobrenu strukturu, zabeležite tip, polje ili dozvolu koja nedostaje i obustavite kreiranje. Obična veza između stavki ne stvara odnos roditelj–dete.

3. Pregledajte ceo plan stavki pre upisa

Povežite svaki PRD zahtev i proveru prihvatljivosti u ticket-plan.json. Zabeležite njegov planVersion, PRD heš, Jira sajt i ključ projekta, lokalni ID izvršavanja i osobu i vreme odobrenja plana. Za svaku predloženu stavku zabeležite jedinstven lokalni ID, planirani lokalni ID roditelja, utvrđeni ID tipa stavke, obavezna polja projekta, sažetak, opis, identifikatore zahteva i prihvatljivosti, vlasnika i dozvoljenu vidljivost. Odobreni posao određuje broj priča i podzadataka. Svaki podzadatak mora da obavlja stvarni posao u okviru svoje prave priče.

Jira REST v3 koristi Atlassian Document Format (ADF), strukturirani JSON dokument, za višeredne opise stavki i komentare. Pripremite te dokumente iz odobrenog sadržaja i proverite metapodatke polja koje sajt vraća pre formiranja svakog zahteva. API za stavke dokumentuje kreiranje; ne može da isporuči gotov objekat polja za nepoznati projekat. Osoba treba da odobri celu strukturu, pokrivenost svih zahteva, nadređene odnose i tačno odredište upisa pre bilo kog POST zahteva.

4. Prvo kreirajte roditelje i ponovo pročitajte svaku stavku

Kreirajte odobrenog roditelja putem POST /rest/api/3/issue, zatim njegove priče, pa svaki stvarni podzadatak. Pre svakog zahteva dodajte privatni zapis u dnevnik: ID izvršavanja, lokalni ID stavke, potvrđeni ključ roditelja kada je primenljivo, odredište, heš tačno odobrenog zahteva, UTC vreme pokušaja i stanje pending. Ne uključujte token. Posle HTTP 201 zabeležite ID i ključ stavke koje Jira vrati, pa direktno pozovite GET /rest/api/3/issue/{issueIdOrKey}. Uporedite projekat, tip, sažetak, opis ili PRD referencu i roditelja sa odobrenim planom. Označite zapis kao confirmed tek posle tog ponovnog čitanja. Potvrđen roditelj omogućava kreiranje njegove dece.

Ako zahtev istekne ili se odgovor izgubi, označite ga kao unknown. Proverite Jira prema projektu, vremenu, odobrenom sažetku i referenci plana, zatim neposredno otvorite mogući pogodak i zatražite da ovlašćeni vlasnik utvrdi njegov identitet. Atlassian upozorava da pretraga posle upisa može da kasni. Odsustvo rezultata pretrage nije dokaz da kreiranje nije uspelo. ID izvršavanja i dnevnik pomažu u usaglašavanju, ali ne primoravaju server da odbije duplo kreiranje. Nikada ne ponavljajte naslepo POST čiji je ishod neizvestan.

Neposredno pročitajte završenu strukturu u ticket-map.json: svaki lokalni ID, stvarni Jira ID i ključ, kanonski URL stavke, projekat, tip, ključ roditelja, PRD identifikatore i identifikatore prihvatljivosti, vreme ponovnog čitanja i referencu dnevnika. Uporedite sve odobrene stavke i kriterijume sa PRD-om. Zaustavite dalje upise ako stavka nedostaje ili ima pogrešnog roditelja; koristite pregledani postupak ispravke projekta.

5. Implementirajte i nezavisno pregledajte svaku odobrenu priču

Radite odobrene priče po redosledu zavisnosti. Za svaku zabeležite Jira ključ, početni Git commit i granu ili radno stablo, izvornu komandu za prihvatljivost, dozvoljene putanje i komande. Zatražite od Claude Code da upotrebi Plan mode da poveže kriterijume te priče sa repozitorijumom. Programer proverava plan i odobrava ograničenu izmenu. Granica priče čini izmenu preglednom; ne uklanja preostale odobrene priče iz funkcionalnosti.

Posle izmene sačuvajte tačan diff, izvornu komandu provere sa celim izlazom i izlaznim statusom, relevantne ciljane testove i ocenu za svaki identifikator zahteva. Pregledajte stvarni kod i evidencije. Pisani plan, generisane datoteke ili Claude tvrdnja da su testovi prošli nisu dokaz da izmena radi. Obustavite priču pri neuspešnoj proveri, neočekivanoj tajni, promeni zavisnosti, spoljnom upisu ili širokom refaktorisanju; popravite u odobrenom obimu i ponovite izvornu proveru. Drugi pregledač koda odlučuje da li prihvata nastali commit ili zadržava diff na čekanju. Zabeležite tu odluku za svaku priču. Naš raniji vodič za jednu pregledanu izmenu pomoću Claude Code pokriva užu fazu pregleda koda; PRD i cela Jira struktura ovde daju širu granicu funkcionalnosti.

6. Potvrdite ovlašćena Jira ažuriranja

Za svaku pregledanu priču pročitajte trenutni Jira status i zatražite GET /rest/api/3/issue/{key}/transitions?expand=transitions.fields. Proverite prelaz koji je stvarno dostupan tom korisniku, njegovo odredište, obavezna polja i dozvoljene vrednosti. Ovlašćeni vlasnik zatim može da pošalje izabrani prelaz putem POST /rest/api/3/issue/{key}/transitions sa vrednostima polja utvrđenim za projekat. Ponovo neposredno pročitajte stavku i potvrdite novi status. Prolazna provera koda sama po sebi ne ovlašćuje Done, spajanje ili postavljanje u rad.

Zabeležite status pre upisa, planirani prelaz, korisnika, zahtev i odgovor u dnevnik Jira ažuriranja. Postavite činjenični ADF komentar sa dokazima putem POST /rest/api/3/issue/{key}/comment: prihvaćeni commit ili zadržani diff, izvorna provera i ciljani testovi, preostali neuspesi i odluka pregledača. Ponovo pročitajte ID i tekst napravljenog komentara iz Jira API-ja za komentare. Ako je odgovor bilo kog upisa neizvestan, neposredno proverite status ili komentare pre razmatranja novog zahteva. Prazna lista prelaza ili nedostupno obavezno polje jesu nedostatak u toku rada ili dozvolama koji treba rešiti sa vlasnikom projekta, a ne poziv da izmislite ID.

7. Odlučite da li CLAUDE.md treba menjati

Uporedite stvarne PRD, stavke, diff, testove, preglede i Jira dnevnike. Zatražite od Claude kratak osvrt koji ukazuje na uočena nerazumevanja ili nedostajuće provere. Osoba bira preciznu izmenu smernica ili beleži odluku da nema izmene, uz pregledača i vreme. Ako je odobreno, pregledajte i napravite commit samo za diff datoteke CLAUDE.md i njegov heš. Anthropic vodič o memoriji opisuje projektne smernice; ovaj pregled ne odobrava automatski budući rad. Ne dodajte tajne i ne pretvarajte nagađanje u pravilo projekta.

Završetak i oporavak

Funkcionalnost je završena samo kada odobrena PRD revizija odgovara direktno potvrđenoj strukturi epika, priča i podzadataka; svaka odobrena priča ima početno stanje, prihvaćeni diff, dokaze izvorne provere i ciljanih testova i nezavisan pregled; svaki ovlašćeni Jira prelaz i komentar sa dokazima neposredno su ponovo pročitani; i osoba je donela odluku o osvrtu. Zabeležite tačnu preostalu fazu ako nešto nedostaje. Izbor prvog AI zadatka završava se ranije, izborom zadatka i predloženom proverom; ne dokazuje ovaj rezultat implementacije.

Neizvesno kreiranje u Jira ostaje unknown dok osoba ne usaglasi njegov identitet. Pogrešan roditelj zaustavlja kreiranje dece. Neuspeli testovi zadržavaju izvorne kriterijume. Nedostajući prelaz ili iscrpljena kvota ostavljaju datiran delimičan zapis za vlasnika. Svedite zahteve i podatke klijenata na odobreni minimum za Claude i Jira, proverite trenutne troškove i dozvole naloga i planirajte ljudski pregled koda. Vodič dokumentuje uslovni put kroz alate; ne izveštava o funkcionalnosti koju je BIG CHANGE završio, Jira upisu, pokretanju modela, izmerenoj uštedi, spajanju ili postavljanju u rad.

Izvori i dalje čitanje