Kako raditi sa developerom na aplikaciji napravljenoj uz AI

Da biste dobro radili sa developerom na aplikaciji koju ste napravili uz AI, dajte mu kod u Git repozitorijumu, jednostranački pregled šta aplikacija radi i zašto, i jasno ograničen zadatak sa definicijom završenog. Dogovorite ko menja koje delove da vi i AI ne biste prepisali njegov rad, držite repozitorijum i hosting naloge na svoje ime i tajne delite kroz odgovarajuća podešavanja, a ne porukama.

Mnogi ljudi naprave prvu verziju aplikacije uz AI, pa uključe developera da doda plaćanja, popravi nešto što AI stalno greši, pregleda bezbednost ili preuzme aplikaciju kako raste. Ako još odlučujete da li uopšte da angažujete nekoga, pogledajte angažovati developera ili graditi uz AI. Ovaj vodič pretpostavlja da ste odlučili i želite da saradnja prođe glatko.

Kada se developer isplati

Uobičajeni razlozi za angažovanje:

• Problem koji AI ne može da reši posle nekoliko jasnih pokušaja i vraćanja unazad.
• Rizične oblasti: plaćanja, dozvole, osetljivi podaci, migracije baze.
• Pregled bezbednosti ili koda pre lansiranja ili pre preuzimanja većih klijenata.
• Performanse kad stigne pravi saobraćaj.
• Rast: aplikacija je postala posao i treba joj neko ko je vlasnik koda.

Kad znate o kom se od ovih slučajeva radi, to oblikuje sve ostalo.

Korak 1: Stavite kod na mesto gde može da se deli

Developeri rade iz Git repozitorijuma. Pre nego što se javite nekome:

1. Povežite projekat sa privatnim GitHub (ili sličnim) repozitorijumom, ili ga izvezite.
2. Proverite da tajne nisu u kodu ni u istoriji. Pogledajte kako čuvati API ključeve.
3. Proverite da projekat radi iz sveže kopije. Zamolite AI da napiše korake za podešavanje.

Napiši README za developera koji se pridružuje ovom projektu: šta aplikacija radi, koji je stek, kako se instalira i pokreće lokalno, koje promenljive okruženja su potrebne (samo nazivi), struktura foldera i šta je krhko ili neobično.

Ako vam je Git nov, kako koristiti Git sa aplikacijom napravljenom uz AI pokriva osnove.

Korak 2: Napišite kratak brif od jedne strane

Developer nije gledao vašu istoriju chata. Dajte mu kontekst na jednoj strani:

• Šta aplikacija radi, za koga i koliko ljudi je koristi.
• Šta je najvažnije: tokovi koji nikad ne smeju da pukne.
• Poznati problemi i šta ste već probali.
• Zadatak i kako ćete znati da je završen.
• Ograničenja: budžet, rok, stvari koje ne sme da menja.

Dobra "definicija završenog" može da se proveri: "Prijavljen korisnik može da plati mesečni plan preko Stripe Checkout-a, plan se pojavljuje na stranici njegovog naloga, a otkazivanje u portalu za klijente ga spušta na niži plan na kraju perioda." Ne "rešiti plaćanja".

Korak 3: Dajte pristup bezbedno

• Kod: dodajte ih kao saradnike na repozitorijum. Kad rad počne, ne šaljite ZIP fajlove napred-nazad.
• Alat za pravljenje: ako vaš AI alat podržava članove tima, pozovite ih u radni prostor koji sadrži samo ovaj projekat.
• Tajne: dodajte ih u podešavanja vašeg hostinga ili delite preko menadžera lozinki. Nikad ne lepite ključeve u mejl ili chat.
• Test nalozi: napravite ih sa test podacima, umesto da delite svoju prijavu.
• Produkcioni podaci: samo ako ih zaista trebaju, i samo ono što im treba.

Repozitorijum, domen i hosting nalozi neka ostanu na vaše ime. Dodajte ljude; ne predajte naloge.

Korak 4: Dogovorite ko šta menja

Najveći izvor trenja je to da dve strane, vi sa AI-jem i developer, menjaju isti kod u isto vreme. Izaberite pravilo:

Šta god izaberete: povucite najnoviji kod pre svake sesije pisanja promptova i radite velike izmene na granama koje druga osoba može da pregleda.

Korak 5: Komunicirajte pisanim putem

• Prijavljujte probleme sa koracima, očekivanim i stvarnim rezultatom. Pogledajte kako napisati dobar izveštaj o grešci.
• Odluke držite na jednom mestu: u sistemu za praćenje problema, u zajedničkom dokumentu ili u komentarima pull request-a.
• Zamolite ih da u svakom pull request-u objasne izmene običnim jezikom.
• Dogovorite koliko često ćete se javljati.

Korak 6: Pregledajte njihov rad

Ne morate da čitate kod da biste pregledali rad. Proverite:

• Radi ono što je brif tražio, na pregledu ili kopiji za testiranje.
• Ništa drugo nije pukne. Pokrenite svoje kritične tokove.
• Objasnili su šta su promenili i zašto.
• Nema tajni u kodu.

Za detaljniji pogled, kako pregledati kod generisan uz AI ima kontrolnu listu koja radi i za kod koji su napisali ljudi. Takođe možete da zamolite svoj AI alat da vam objasni developerov pull request običnim rečima.

Korak 7: Jasno zadržite vlasništvo

• Repozitorijum, hosting, domen i nalozi trećih strana ostaju vaši.
• Vlasništvo nad kodom koji napišu zapišite pre početka rada. Za ugovorna pitanja proverite lokalna pravila ili savetnika.
• Kad posao završi, ukinite im pristup i zamenite sve ključeve koje su videli.

Primeri promptova

Developer je promenio kod za plaćanje u poslednjem pull request-u. Objasni običnim jezikom šta je promenio i da li nešto drugo u aplikaciji zavisi od toga.

Izdvoji delove ove aplikacije koji su najsloženiji ili najrizičniji, da mogu developeru da kažem gde da usmeri pregled.

Plaćanja predajem developeru. Od sada ne diraj fajlove pod src/payments ili rute /api/billing. Ako neka izmena zahteva da ih dirate, samo mi to reci.

Česte greške

• Nema brifa. Developer plaćene sate troši na to da otkrije šta ste hteli.
• Neodređen obim kao "popravi greške" ili "učini da bude spremno za produkciju".
• Obe strane menjaju istovremeno bez povlačenja izmena, pa se rad gubi u konfliktima.
• Deljenje sopstvene prijave ili lepljenje ključeva u chat.
• Nalozi na ime developera, što otežava rastanak.
• Zaboravljanje da ukinete pristup i zamenite ključeve posle posla.

Kontrolna lista

• Kod je u privatnom repozitorijumu na moje ime, bez tajni.
• README objašnjava podešavanje; brif od jedne strane objašnjava aplikaciju i zadatak.
• Zadatak ima definiciju završenog koja može da se testira.
• Pristup ide preko pozivnica za saradnike, a tajne preko podešavanja ili menadžera lozinki.
• Dogovorili smo ko šta menja, a ja povlačim izmene pre prompta.
• Rad se pregleda u odnosu na brif i kritične tokove.
• Vlasništvo je zapisano; pristup se ukida i ključevi menjaju kad posao završi.

Rad sa developerom na Mythex-u

• Pozovite ih u radni prostor. Vlasnici mogu da pozovu neograničeno saradnika bez naknade po mestu; članovi rade na projektima radnog prostora. Koristite poseban radni prostor da vide samo ovaj projekat. Krediti za objavljene aplikacije se naplaćuju vlasniku radnog prostora. Pogledajte Invites.
• GitHub sinhronizacija i izvoz (Pro). Povežite repozitorijum i šaljite/povlačite izmene, ili izvezite projekat bez tajni. Pogledajte GitHub, export, and import.
• Podelite link za pregled da pokažete rad u toku nekome bez Mythex naloga; obrišite ga kad završite.
• Režim pitanja (Ask) odgovara na pitanja o kodu bez menjanja, korisno za razumevanje izmena developera.

Ako će developer da pokreće aplikaciju negde drugde, pogledajte kako izvesti i samostalno hostovati aplikaciju napravljenu uz AI.

Pitanja