Agent ne može da pronađe pravilo projekta koje postoji samo u nečijoj glavi. Prazninu popunjava čestim obrascem iz podataka za treniranje. Taj obrazac može da bude razuman i pogrešan za tvoj sistem.
Bolji kontekst smanjuje nagađanje. Više konteksta ne pomaže uvek. Ceo repo može da zakopa jedan interfejs ili odluku koja kontroliše zadatak.
Posmatraj kontekst kao dokaz
Koristan kontekst odgovara na pet pitanja:
- Koje ponašanje treba da se promeni?
- Gde to ponašanje živi?
- Koja pravila moraju da ostanu tačna?
- Koji postojeći primer pokazuje lokalni obrazac?
- Koja komanda dokazuje rezultat?
Kada možeš, svaki odgovor veži za dokaz. Putanja je bolja od opisa fajla. Padajući test je bolji od pasusa o bugu. Prihvaćen test primer je bolji od „prati naš uobičajeni format“.
Ako endpoint vraća pogrešan status, pošalji rutu, granicu servisa, relevantan test, komandu koja pada i očekivani odgovor. Ne lepi svaki kontroler iz aplikacije.
Napravi slojeve konteksta
Kontekst delim prema tome koliko dugo ostaje koristan.
Kontekst repoa se sporo menja: arhitektonske granice, komande, pravila imenovanja, bezbednosna ograničenja i vlasništvo. Čuvaj ga u verzionisanim fajlovima blizu koda.
Kontekst zadatka je privremen: trenutni cilj, primećen kvar, dozvoljen obim, uslovi prihvatanja i mesto za zaustavljanje. On pripada promptu ili issue-u.
Dokazi tokom rada stalno nastaju: logovi, screenshot-ovi, rezultati testova, stanje baze i završni diff. Osveži ih umesto da veruješ staroj poruci iz četa.
Ovi slojevi sprečavaju dva česta problema. Chat ostaje mali, a stabilna pravila prežive kada razgovor nestane.
Čuvaj trajno znanje u repou
Koristan repo obično ima:
- jednu ulaznu tačku sa komandama za build i test;
- lokalna uputstva za pakete sa drugačijim pravilima;
- arhitektonske odluke za ograničenja koja je lako pogrešno „pojednostaviti“;
- primere blizu koda čiji oblik treba ponoviti;
- testove koji beleže važno ponašanje.
Nemoj jedan instrukcioni fajl da pretvoriš u priručnik cele firme. I agenti i ljudi prestaju da nalaze pravila kada fajl postane gomila.
Svako pravilo drži blizu obima kojim upravlja. Zastarelo uputstvo obriši u istoj izmeni koja ga je učinila netačnim.
Pazi na otrovan kontekst
Pogrešan kontekst je često gori od praznog. Zastarela komanda, stari API primer ili nevažeća arhitektonska beleška daju agentu lažnu sigurnost.
Kada je rezultat neobjašnjivo pogrešan, proveri ulaze pre novog prompta. Pogledaj učitana uputstva, proveri da li je primer i dalje merodavan i da li je greška došla sa trenutne grane.
Počni kratkim pregledom konteksta
Pre zadatka u repou pišem ovo:
Cilj:
Primećeni dokaz:
Relevantni fajlovi:
Pravila i primeri:
Dozvoljen obim:
Provera:
Nepoznanice:
Ako ne mogu da popunim polje, pregledam repo ili označim nepoznanicu. To je bezbednije nego da model neprimetno izabere odgovor.
Kvalitet konteksta je osobina inženjerskog procesa. Čuvaj trajne činjenice, izaberi dokaze za trenutni zadatak i osvežavaj proveru.