Výběr sekce

Sekvence práce

Fáze 1: Zadání od člověka

Proces začíná konkrétním zadáním od člověka. Zadání může být:

  • nová funkcionalita,
  • oprava chyby,
  • refaktor,
  • stabilizace testů,
  • úprava dokumentace,
  • procesní změna.

Bez lidského zadání se nezačíná žádná implementace.

Fáze 2: Zadání ChatGPT pro Claude

ChatGPT připraví na základě od člověka přesný prompt podle Zadání pro Claude. Ten musí obsahovat:

  • jasné zadání, co se má zanalyzovat,
  • co se nesmí měnit,
  • požadavek na zachování existující logiky mimo scope,
  • které soubory má Claude prověřit,
  • požadovaný výstupní dokument podle šablony,
  • název a cestu k šabloně výstupní analýzy,
  • požadavek na ověření projektové struktury a názvů relevantních testů,
  • požadavek na vytvoření dokumentu analýzy,
  • název dokumentu výstupní analýzy,
  • požadavek na commit a push do větve main, pokud není požadováno jinak.

Požadovaný výstup musí být formulován tak, aby Claude provedl analýzu, ne implementaci.

Fáze 3: Analýza od Claude

Claude vytvoří analytický dokument podle šablony výše a uloží jej do repozitáře. Tento dokument musí být verzovaný v Gitu a odeslaný do větve main i na GitHub.

Claude analysis template obsahuje:

  • Popis problému
  • Poznámky k reprodukci
  • Aktuální chování v kódu
  • Existující pokrytí testy
  • Doporučení
  • Posouzení rizik

Claude nesmí vytvářet produkční implementaci v této fázi.

Fáze 4: Kontrola Claude analýzy ChatGPT

ChatGPT zkontroluje analytický dokument od Claude. Kontrola musí být věcná a přísná. Nestačí, že text vypadá dobře. Musí sedět se skutečným stavem projektu a být dostatečný pro přípravu zadání pro Codex.

Kontrola se zaměřuje hlavně na:

  • soulad se zadáním,
  • technickou přesnost,
  • správné názvy souborů,
  • správné názvy testů,
  • nepřítomnost halucinací,
  • nepřítomnost svévolného rozšíření scope,
  • jasné vymezení scope změny,
  • dostatečný podklad pro implementaci a ověření změny.

Pokud analýza neobstojí, nejde se dál do implementace.

Fáze 5: Zadání pro Codex

Na základě schválené analýzy člověkem připraví ChatGPT Zadání pro Codex. Tyto instrukce musí být konkrétní, strukturované a orientované na implementaci.

Instrukce pro Codex musí obsahovat:

  • jasné zadání, co se má implementovat na základě schválené analýzy,
  • název a cestu k dokumentu analýzy,
  • explicitní vymezení scope změny,
  • požadavek na úpravu pouze nezbytných souborů,
  • požadavek na zachování existující logiky mimo scope,
  • požadavek na úpravu nebo doplnění testů,
  • požadavek na ověření změny pomocí testů,
  • požadavek na vytvoření implementačního dokumentu podle šablony,
  • název a cestu k šabloně implementačního dokumentu,
  • požadavek na commit a push do větve main,
  • požadavek, aby komentář ke commitu byl v češtině.

Codex má dostat jen takový rozsah, který odpovídá schválené analýze.

Fáze 6: Implementace od Codexu

Codex provede implementaci, upraví kód, testy a vytvoří implementační dokument podle šablony Codex implementation template. Vše uloží do repozitáře, commitne a pushne do lokálního repa i na GitHub do větve main.

Výstup Codexu musí zahrnovat:

  • změněný kód,
  • upravené nebo nové testy,
  • implementační dokument,
  • validaci provedené změny,
  • použité ověřovací příkazy,
  • výsledky testů,
  • jasně dohledatelnou historii v Gitu.

Fáze 7: Uživatelská kontrola člověkem

Člověk provede kontrolu výsledku. Tato kontrola je finální rozhodovací bod. Člověk může:

  • změnu přijmout,
  • vrátit ji k doplnění,
  • odmítnout přístup a zadat nové směrování.

Fáze 8: Denní Reality Report od Claude

Po ukončení vývojové session Claude vytvoří Reality Report, který popisuje aktuální stav projektu.

Reality Report vychází z aktuálního stavu repozitáře (kód, testy, soubory, commity) a nesmí obsahovat domněnky ani návrhy.

Dokument je uložen v projektové dokumentaci, verzovaný v Gitu a Claude jej commitne a pushne do main, pokud není výslovně určeno jinak.

Slouží jako zdroj pravdy pro člověka, ChatGPT, Claude i Codex a jako vstup pro další zadání v následující session.

Fáze 9: Aktualizace struktury projektu

Po ukončení vývojové session musí být vygenerována aktuální struktura projektu a uložena do souboru docs/PROJECT_STRUCTURE.md.

Tato fáze musí zahrnovat:

  • vytvoření aktuálního přehledu struktury projektu pomocí skriptu,
  • uložení tohoto přehledu do souboru docs/PROJECT_STRUCTURE.md,
  • commit a push do větve main, pokud není určeno jinak,
  • nahrání souboru docs/PROJECT_STRUCTURE.md do projektu ChatGPT.

Aktuální struktura projektu musí odpovídat skutečnému stavu repozitáře po dokončení změn.