Jak spolupracovat s vývojářem na aplikaci vytvořené pomocí AI

Abyste na aplikaci vytvořené pomocí AI spolupracovali s vývojářem, dejte mu kód v Git repozitáři, jednostránkový souhrn toho, co aplikace dělá a proč, a jasně vymezený úkol s definicí hotovo. Domluvte se, kdo mění které části, aby vy ani AI nepřepsali jeho práci, držte repozitář a účty u hostingu na sebe a tajné údaje sdílejte přes správná nastavení, ne ve zprávách.

Mnoho lidí postaví první verzi aplikace pomocí AI a pak přizve vývojáře — aby přidal platby, opravil něco, co AI pořád dělá špatně, zkontroloval bezpečnost nebo převzal aplikaci, jak roste. Pokud ještě rozhodujete, zda vůbec někoho najímat, podívejte se na najmout vývojáře, nebo stavět s AI. Tento průvodce předpokládá, že jste se rozhodli a chcete, aby spolupráce šla hladce.

Kdy se vyplatí vývojář

Běžné důvody, proč někoho přizvat:

• Problém, který AI nezvládne, ani po několika jasných pokusech a vrácení změn.
• Rizikové oblasti: platby, oprávnění, citlivá data, migrace databáze.
• Bezpečnostní nebo kódová revize před spuštěním nebo před převzetím větších zákazníků.
• Výkon, jakmile dorazí skutečný provoz.
• Růst: aplikace se stala podnikem a potřebuje někoho, kdo za kód ručí.

Jasnost o tom, který z těchto důvodů platí, určí všechno dál.

Krok 1: Dostaňte kód na místo, kde jde sdílet

Vývojáři pracují z Git repozitářů. Než někoho kontaktujete:

1. Připojte projekt k soukromému repozitáři na GitHubu (nebo podobné službě), nebo ho exportujte.
2. Ujistěte se, že v kódu ani v historii nejsou tajné údaje. Viz jak chránit API klíče.
3. Ověřte, že projekt běží z čisté kopie — požádejte AI, aby napsala kroky k nastavení.

Napiš README pro vývojáře, který se připojuje k tomuto projektu: co aplikace dělá, technologický stack, jak ji nainstalovat a spustit lokálně, které proměnné prostředí potřebuje (jen názvy), strukturu složek a cokoli křehkého nebo neobvyklého.

Pokud je pro vás Git nový, jak používat Git s aplikací vytvořenou pomocí AI pokrývá základy.

Krok 2: Napište jednostránkový brief

Vývojář neseděl u vaší chatové historie. Dejte mu kontext na jedné stránce:

• Co aplikace dělá, pro koho a kolik lidí ji používá.
• Co je nejdůležitější — toky, které nesmí nikdy přestat fungovat.
• Známé problémy a co jste už zkusili.
• Úkol a jak poznáte, že je hotový.
• Omezení: rozpočet, termín, věci, které nesmí měnit.

Dobrá „definice hotovo“ je testovatelná: „Přihlášený uživatel může zaplatit měsíční tarif přes Stripe Checkout, tarif se zobrazí na jeho účtu a zrušení v zákaznickém portálu ho ke konci období přeřadí na nižší tarif.“ Ne „vyřešit platby“.

Krok 3: Bezpečně dejte přístup

• Kód: přidejte je jako spolupracovníka do repozitáře. Jakmile práce začne, neposílejte si ZIP soubory tam a zpět.
• Nástroj na tvorbu: pokud váš nástroj s AI podporuje členy týmu, pozvěte je do pracovního prostoru, který obsahuje jen tento projekt.
• Tajné údaje: přidejte je v nastavení hostingu, nebo je sdílejte přes správce hesel. Nikdy nevkládejte klíče do e-mailu nebo chatu.
• Testovací účty: vytvořte je s testovacími daty, místo abyste sdíleli své vlastní přihlášení.
• Produkční data: jen pokud je skutečně potřebují, a jen to, co potřebují.

Repozitář, doménu a účty u hostingu si nechte na sebe. Lidi přidávejte; účty jim nepředávejte.

Krok 4: Domluvte se, kdo co mění

Největší zdroj tření je, když dvě strany — vy s AI a vývojář — mění stejný kód ve stejnou dobu. Zvolte pravidlo:

Ať zvolíte cokoli: před každou relací s prompty stáhněte nejnovější kód a větší změny dělejte na větvích, které může druhá strana zkontrolovat.

Krok 5: Komunikujte písemně

• Hlaste problémy s kroky, očekávaným a skutečným výsledkem. Viz jak napsat dobré hlášení chyby.
• Rozhodnutí držte na jednom místě: v systému úkolů, sdíleném dokumentu nebo v komentářích k pull requestu.
• Požádejte je, aby v každém pull requestu změny vysvětlili srozumitelným jazykem.
• Domluvte se, jak často se budete scházet.

Krok 6: Zkontrolujte jejich práci

K revizi práce nemusíte číst kód. Zkontrolujte:

• Dělá, co říkal brief, na náhledu nebo na stagingové kopii.
• Nic dalšího se nerozbilo — spusťte své kritické toky.
• Vysvětlili, co změnili a proč.
• V kódu se neobjevily tajné údaje.

Pro podrobnější pohled má jak zkontrolovat kód vygenerovaný AI kontrolní seznam, který funguje i pro kód napsaný lidmi. Můžete také požádat svůj nástroj na tvorbu s AI, aby vám pull request vývojáře vysvětlil srozumitelně.

Krok 7: Držte vlastnictví jasné

• Repozitář, hosting, doména a účty u třetích stran zůstávají na vás.
• Vlastnictví kódu, který napíšou, mějte písemně ještě před začátkem práce. U smluvních otázek se obraťte na místní pravidla nebo poradce.
• Když práce skončí, odeberte jejich přístup a změňte všechny klíče, které viděli.

Příklady promptů

Vývojář minule změnil kód pokladny. Vysvětli srozumitelně, co změnil, a zda na tom něco v aplikaci dalšího závisí.

Vypiš části této aplikace, které jsou nejsložitější nebo nejrizikovější, abych vývojáři mohl říct, na co se má revize zaměřit.

Předávám platby vývojáři. Od teď nemění žádné soubory v src/payments ani trasy /api/billing. Pokud změna vyžaduje je, raději mi to řekni.

Časté chyby

• Žádný brief. Vývojář placené hodiny tráví odhadováním, co jste chtěli.
• Vágní rozsah jako „oprav chyby“ nebo „připrav na produkci“.
• Úpravy obou stran najednou bez stažení změn, pak ztracená práce kvůli konfliktům.
• Sdílení vlastního přihlášení nebo vkládání klíčů do chatu.
• Účty na jméno vývojáře, takže se z toho hůř vystupuje.
• Zapomenutí odebrat přístup a změnit klíče po skončení práce.

Kontrolní seznam

• Kód je v soukromém repozitáři na mé jméno, bez tajných údajů.
• README vysvětluje nastavení; jednostránkový brief vysvětluje aplikaci a úkol.
• Úkol má testovatelnou definici hotovo.
• Přístup je přes pozvánky spolupracovníků, tajné údaje přes nastavení nebo správce hesel.
• Domluvili jsme se, kdo co mění, a před promptem stahuji změny.
• Práce se kontroluje podle briefu a kritických toků.
• Vlastnictví je písemně; po skončení práce je přístup odebrán a klíče změněny.

Práce s vývojářem v Mythexu

• Pozvěte je do pracovního prostoru. Vlastníci mohou pozvat neomezený počet spolupracovníků bez poplatku za místo; členové pracují na projektech pracovního prostoru. Použijte samostatný pracovní prostor, aby viděli jen tento projekt. Kredity za publikované aplikace účtují vlastníkovi pracovního prostoru. Viz Pozvánky.
• Synchronizace s GitHubem a export (Pro). Připojte repozitář a odesílejte a stahujte změny, nebo exportujte projekt bez tajných údajů. Viz GitHub, export a import.
• Sdílejte odkaz na náhled, abyste ukázali rozpracovanou práci někomu bez účtu v Mythexu; až skončíte, odkaz smažte.
• Režim Ask odpovídá na otázky o kódu, aniž by ho měnil — užitečné pro pochopení změn vývojáře.

Pokud bude vývojář aplikaci provozovat jinde, viz jak exportovat a provozovat vlastní hosting aplikace vytvořené pomocí AI.

Otázky