Ako pracovať s vývojárom na aplikácii vytvorenej AI

Ak chcete dobre pracovať s vývojárom na aplikácii vytvorenej AI, dajte mu kód v Git repozitári, jednostranový opis toho, čo aplikácia robí a prečo, a jasne vymedzenú úlohu s definíciou hotovosti. Dohodnite sa, kto mení ktoré časti, aby ste vy a AI neprepisovali jeho prácu, repozitár a účty hostingu nechajte na svoje meno a tajomstvá zdieľajte cez správne nastavenia, nie cez správy.

Mnohí ľudia postavia prvú verziu aplikácie s AI a potom prizvú vývojára — aby pridal platby, opravil niečo, čo AI stále pokazí, skontroloval bezpečnosť alebo prevzal aplikáciu, keď rastie. Ak ešte rozhodujete, či niekoho najať vôbec, pozri najať vývojára alebo stavať s AI. Tento sprievodca predpokladá, že ste sa rozhodli a chcete, aby spolupráca išla hladko.

Kedy sa vývojár oplatí

Bežné dôvody, prečo niekoho prizvať:

• Problém, ktorý AI nedokáže vyriešiť ani po niekoľkých jasných pokusoch a vráteniach späť.
• Rizikové oblasti: platby, oprávnenia, citlivé dáta, migrácie databázy.
• Kontrola bezpečnosti alebo kódu pred spustením alebo pred prijatím väčších zákazníkov.
• Výkon, keď prichádza skutočná návštevnosť.
• Rast: aplikácia sa stala biznisom a potrebuje niekoho, kto vlastní kód.

Jasnosť v tom, o ktorý z týchto dôvodov ide, formuje všetko ďalšie.

Krok 1: Dostaňte kód na miesto, kde sa dá zdieľať

Vývojári pracujú z Git repozitárov. Skôr než niekoho oslovíte:

1. Pripojte projekt k súkromnému repozitáru na GitHube (alebo podobnej službe), alebo ho exportujte.
2. Uistite sa, že v kóde ani v histórii nie sú tajomstvá. Pozri ako chrániť API kľúče.
3. Skontrolujte, že projekt sa spustí z čistej kópie — požiadajte AI, aby napísala kroky inštalácie.

Napíš README pre vývojára, ktorý sa pridáva k tomuto projektu: čo aplikácia robí, technológie, ako ju nainštalovať a spustiť lokálne, aké premenné prostredia potrebuje (iba názvy), štruktúru priečinkov a čo je krehké alebo nezvyčajné.

Ak je pre vás Git nový, ako používať Git s aplikáciou vytvorenou AI pokrýva základy.

Krok 2: Napíšte jednostranový brief

Vývojár nesedel pri vašej chatovacej histórii. Dajte mu kontext na jednej strane:

• Čo aplikácia robí, pre koho a koľko ľudí ju používa.
• Čo je najdôležitejšie — toky, ktoré nesmú nikdy prestať fungovať.
• Známe problémy a čo ste už vyskúšali.
• Úloha a ako zistíte, že je hotová.
• Obmedzenia: rozpočet, termín, veci, ktoré nemá meniť.

Dobrá „definícia hotovosti“ sa dá otestovať: „Prihlásený používateľ si môže zaplatiť mesačný plán cez Stripe Checkout, plán sa zobrazí na jeho účte a zrušenie v zákazníckom portáli ho na konci obdobia zaradí do nižšieho plánu.“ Nie „vyrieš platby“.

Krok 3: Bezpečne sprístupnite prístup

• Kód: pridajte ho ako spolupracovníka do repozitára. Keď práca začne, neposielajte ZIP súbory sem a tam.
• Builder: ak váš AI builder podporuje členov tímu, pozvite ho do workspace, ktorý obsahuje len tento projekt.
• Tajomstvá: pridajte ich do nastavení hostingu alebo zdieľajte cez správcu hesiel. Kľúče nikdy nevkladajte do e-mailu ani chatu.
• Testovacie účty: vytvorte ich s testovacími dátami namiesto zdieľania svojho prihlasovania.
• Produkčné dáta: len ak ich naozaj potrebuje, a len to, čo potrebuje.

Repozitár, doménu a účty hostingu majte na svoje meno. Pridávajte ľudí; účty neodovzdávajte.

Krok 4: Dohodnite sa, kto čo mení

Najväčšie trenie vzniká, keď dve strany — vy s AI a vývojár — menia ten istý kód v rovnakom čase. Zvoľte pravidlo:

Akokoľvek sa rozhodnete: pred každou reláciou tvorby stiahnite najnovší kód a väčšie zmeny robte na vetvách, ktoré druhá strana môže skontrolovať.

Krok 5: Komunikujte písomne

• Problémy hláste s krokmi, očakávaným a skutočným výsledkom. Pozri ako napísať dobré hlásenie chyby.
• Rozhodnutia držte na jednom mieste: v systéme na sledovanie úloh, v zdieľanom dokumente alebo v komentároch k pull requestu.
• Požiadajte ho, aby v každom pull requeste vysvetlil zmeny jednoduchým jazykom.
• Dohodnite sa, ako často sa budete zľaviť.

Krok 6: Skontrolujte jeho prácu

Na kontrolu práce nemusíte čítať kód. Overte:

• Robí to, čo hovoril brief, na náhľade alebo na staging kópii.
• Nič iné sa nepokazilo — prejdite si svoje kritické toky.
• Vysvetlil, čo zmenil a prečo.
• V kóde sa neobjavili žiadne tajomstvá.

Pre dôkladnejší pohľad ako skontrolovať kód vygenerovaný AI obsahuje kontrolný zoznam, ktorý funguje aj pre kód písaný ľuďmi. Môžete tiež požiadať svojho AI buildera, aby vám pull request vývojára vysvetlil jednoduchými slovami.

Krok 7: Udržte vlastníctvo jasné

• Repozitár, hosting, doména a účty tretích strán zostávajú vaše.
• Vlastníctvo kódu, ktorý napíše, mať písomne dohodnuté skôr, než práca začne. Otázky zmlúv konzultujte s miestnymi pravidlami alebo s poradcom.
• Keď práca skončí, odoberte mu prístup a zneplatnite kľúče, ktoré videl.

Príklady zadaní

Vývojár zmenil kód pokladne v poslednom pull requeste. Vysvetli jednoduchým jazykom, čo zmenil, a či niečo ďalšie v aplikácii na tom závisí.

Vypíš časti tejto aplikácie, ktoré sú najzložitejšie alebo najrizikovejšie, aby som vývojárovi vedel povedať, kde má zamerať kontrolu.

Odovzdávam platby vývojárovi. Od teraz nemeň žiadne súbory v src/payments ani trasy /api/billing. Ak zmena vyžaduje ich úpravu, povedz mi to namiesto toho.

Časté chyby

• Žiadny brief. Vývojár zaplatené hodiny strávi rekonštrukciou toho, čo ste chceli.
• Vágny rozsah ako „oprav chyby“ alebo „priprav na produkciu“.
• Úpravy oboch naraz bez stiahnutia zmien, potom strata práce v konfliktoch.
• Zdieľanie vášho vlastného prihlásenia alebo vkladanie kľúčov do chatu.
• Účty na meno vývojára, čo sťažuje rozchod.
• Zabudnutie odobrať prístup a zneplatniť kľúče po skončení práce.

Kontrolný zoznam

• Kód je v súkromnom repozitári na moje meno, bez tajomstiev.
• README vysvetľuje inštaláciu; jednostranový brief vysvetľuje aplikáciu a úlohu.
• Úloha má testovateľnú definíciu hotovosti.
• Prístup ide cez pozvánky spolupracovníkov, tajomstvá cez nastavenia alebo správcu hesiel.
• Dohodli sme sa, kto čo mení, a pred zadaním stiahnem zmeny.
• Práca je skontrolovaná voči briefu a kritickým tokom.
• Vlastníctvo je písomne dohodnuté; po skončení odoberiem prístup a zneplatním kľúče.

Práca s vývojárom v Mythex

• Pozvite ho do workspace. Vlastníci môžu pozvať neobmedzene spolupracovníkov bez poplatku za miesto; členovia pracujú na projektoch workspace. Použite samostatný workspace, aby videl len tento projekt. Kredity za publikované aplikácie účtujú vlastníkovi workspace. Pozri Pozvánky.
• Synchronizácia s GitHubom a export (Pro). Pripojte repozitár a posielajte a sťahujte zmeny, alebo exportujte projekt bez tajomstiev. Pozri GitHub, export a import.
• Zdieľajte odkaz na náhľad, keď chcete ukázať rozpracovanú prácu niekomu bez účtu Mythex; keď skončíte, odkaz zmažte.
• Režim Ask odpovedá na otázky o kóde bez jeho zmeny — užitočné na pochopenie zmien vývojára.

Ak bude vývojár aplikáciu spúšťať inde, pozri ako exportovať a self-hostovať aplikáciu vytvorenú AI.

Otázky