Kako raditi s programerom na aplikaciji izrađenoj uz AI

Da biste dobro radili s programerom na aplikaciji izrađenoj uz AI, dajte mu kod u Git repozitoriju, jednostranični sažetak o tome što aplikacija radi i zašto te jasno definirani zadatak s kriterijem završetka. Dogovorite tko mijenja koje dijelove da se vi i AI ne biste prepisali preko njegova rada, držite repozitorij i hosting račune na svoje ime, a tajne podatke dijelite kroz odgovarajuće postavke, a ne u porukama.

Mnogi ljudi prvu verziju aplikacije naprave uz AI, a zatim angažiraju programera: da doda plaćanja, popravi nešto što AI stalno kvari, pregleda sigurnost ili preuzme održavanje kako aplikacija raste. Ako još odlučujete hoćete li uopće nekoga angažirati, pogledajte angažirati programera ili graditi uz AI. Ovaj vodič pretpostavlja da ste odlučili i želite da suradnja protekne glatko.

Kad se programer isplati

Česti razlozi za angažiranje:

• Problem koji AI ne može riješiti ni nakon nekoliko jasnih pokušaja i vraćanja promjena.
• Rizična područja: plaćanja, dopuštenja, osjetljivi podaci, migracije baze podataka.
• Pregled sigurnosti ili koda prije lansiranja ili prije preuzimanja većih klijenata.
• Performanse kad stigne pravi promet.
• Rast: aplikacija je postala posao i treba nekoga tko je vlasnik koda.

Jasnoća o tome o čemu je riječ oblikuje sve što slijedi.

Korak 1: Stavite kod na mjesto koje se može podijeliti

Programeri rade iz Git repozitorija. Prije nego što kontaktirate bilo koga:

1. Povežite projekt s privatnim repozitorijem na GitHubu (ili sličnom usluzi) ili ga izvezite.
2. Provjerite da tajne podatke nema u kodu ni u povijesti. Pogledajte kako čuvati API ključeve.
3. Provjerite da se projekt pokreće iz svježe kopije. Zamolite AI da napiše korake za postavljanje.

Napiši README za programera koji se pridružuje ovom projektu: što aplikacija radi, tehnološki stog, kako je instalirati i pokrenuti lokalno, koje varijable okoline su potrebne (samo nazivi), struktura mapa i sve što je krhko ili neobično.

Ako vam je Git nov, kako koristiti Git s aplikacijom izrađenom uz AI pokriva osnove.

Korak 2: Napišite kratak opis na jednoj stranici

Programer nije bio na vašem chatu i ne zna povijest razgovora. Dajte mu kontekst na jednoj stranici:

• Što aplikacija radi, za koga i koliko ljudi je koristi.
• Što je najvažnije: tokovi koji se nikad ne smiju pokvariti.
• Poznati problemi i što ste već isprobali.
• Zadatak i kako ćete znati da je gotov.
• Ograničenja: budžet, rok, stvari koje ne smije mijenjati.

Dobar „kriterij završetka” može se provjeriti: „Prijavljeni korisnik može platiti mjesečni plan putem Stripe Checkouta, plan se pojavi na stranici računa, a otkazivanje u portalu za kupce vraća ga na nižu razinu na kraju razdoblja.” Ne „riješi plaćanja”.

Korak 3: Dajte pristup na siguran način

• Kod: dodajte ih kao suradnike u repozitorij. Kad rad počne, nemojte slati ZIP datoteke naprijed-natrag.
• Alat za izradu: ako vaš AI alat za izradu podržava članove tima, pozovite ih u radni prostor koji sadrži samo ovaj projekt.
• Tajne podatke: dodajte ih u postavke hostinga ili ih podijelite preko upravitelja lozinki. Nikad ne lijepite ključeve u e-poštu ili chat.
• Testni računi: napravite ih s testnim podacima, umjesto da dijelite svoju prijavu.
• Produkcijski podaci: samo ako ih stvarno trebaju, i samo one koje trebaju.

Repozitorij, domenu i hosting račune držite na svoje ime. Dodajte ljude, nemojte im predavati račune.

Korak 4: Dogovorite tko što mijenja

Najveće trenje nastaje kad dvije strane, vi s AI-jem i programer, mijenjaju isti kod u isto vrijeme. Odaberite pravilo:

Što god odaberete: povucite najnoviji kod prije svake sesije upita i napravite velike promjene na granama koje druga osoba može pregledati.

Korak 5: Komunicirajte pisano

• Prijavljujte probleme s koracima, očekivanim i stvarnim rezultatom. Pogledajte kako napisati dobru prijavu greške.
• Odluke držite na jednom mjestu: u sustavu za praćenje zadataka, zajedničkom dokumentu ili komentarima uz pull request.
• Zamolite ga da u svakom pull requestu objasni promjene običnim jezikom.
• Dogovorite koliko često ćete se čuti.

Korak 6: Pregledajte njegov rad

Ne morate čitati kod da biste pregledali rad. Provjerite:

• Radi ono što je pisalo u opisu, na pregledu ili kopiji za testiranje.
• Ništa drugo se nije pokvarilo. Pokrenite svoje ključne tokove.
• Objasnio je što je promijenio i zašto.
• Nema tajni u kodu.

Za detaljniji pogled, kako pregledati kod generiran AI-jem ima popis koji vrijedi i za kod koji su napisali ljudi. Možete i zamoliti AI alat za izradu da vam objasni programerov pull request običnim riječima.

Korak 7: Jasno držite vlasništvo

• Repozitorij, hosting, domena i računi trećih strana ostaju vaši.
• Vlasništvo nad kodom koji napišu dogovorite pisano prije početka rada. Za ugovorna pitanja provjerite lokalna pravila ili savjetnika.
• Kad posao završi, ukinite im pristup i zamijenite ključeve koje su vidjeli.

Primjeri upita

Programer je u zadnjem pull requestu promijenio kod za blagajnu. Objasni običnim jezikom što je promijenio i ovisi li išta drugo u aplikaciji o tome.

Popiši dijelove ove aplikacije koji su najsloženiji ili najrizičniji, da programeru mogu reći gdje da usmjeri pregled.

Predajem plaćanja programeru. Od sada ne diraj datoteke pod src/payments ni rute /api/billing. Ako neka promjena to zahtijeva, reci mi umjesto da je napraviš.

Česte greške

• Nema sažetka. Programer troši plaćene sate na to da otkrije što ste htjeli.
• Nejasan opseg poput „popravi greške” ili „učini da bude spremno za produkciju”.
• Oboje mijenjaju u isto vrijeme bez povlačenja, pa se rad izgubi u sukobima.
• Dijeljenje vaše prijave ili lijepljenje ključeva u chat.
• Računi na ime programera, pa je teško prekinuti suradnju.
• Zaboravljen pristup i nezamijenjeni ključevi nakon posla.

Popis za provjeru

• Kod je u privatnom repozitoriju na moje ime, bez tajni.
• README objašnjava postavljanje; sažetak na jednoj stranici objašnjava aplikaciju i zadatak.
• Zadatak ima provjerljiv kriterij završetka.
• Pristup je preko pozivnica za suradnike, a tajne preko postavki ili upravitelja lozinki.
• Dogovorili smo tko što mijenja i ja povlačim promjene prije upita.
• Rad se pregledava prema sažetku i ključnim tokovima.
• Vlasništvo je zapisano; pristup se ukida, a ključevi zamjenjuju kad posao završi.

Rad s programerom na Mythexu

• Pozovite ga u radni prostor. Vlasnici mogu pozvati neograničen broj suradnika bez naknade po mjestu; članovi rade na projektima radnog prostora. Koristite zaseban radni prostor kako bi vidjeli samo ovaj projekt. Krediti za objavljene aplikacije terete vlasnika radnog prostora. Pogledajte Pozivnice.
• GitHub sinkronizacija i izvoz (Pro). Povežite repozitorij i šaljite i povlačite promjene ili izvezite projekt bez tajni. Pogledajte GitHub, izvoz i uvoz.
• Podijelite poveznicu za pregled da pokažete rad u tijeku nekome bez Mythex računa. Kad završite, izbrišite je.
• Način pitanja odgovara na pitanja o kodu bez njegove promjene. Korisno za razumijevanje programerovih promjena.

Ako će programer aplikaciju pokretati drugdje, pogledajte kako izvesti i samostalno pokrenuti aplikaciju izrađenu uz AI.

Pitanja