====== Ralph Loop ======


[[https://github.com/snarktank/ralph|Ralph Loop]] je open-source nástroj navržený jako autonomní smyčka AI agenta, která automaticky provádí kroky vývoje softwaru podle seznamu úkolů (PRD – Product Requirements Document). V podstatě to je automatizovaná smyčka, kterou lze spustit, aby AI postupně implementovala, testovala a commitovala kód až do dokončení všech definovaných úkolů.


**Jak funguje Ralph (technicky a procesně)**

  * Nástroj spouští AI agent CLI (např. Amp nebo Claude Code) v opakované smyčce, kde každý běh je nová instance s čistým kontextem (to znamená, že AI neudržuje vlastní paměť mezi iteracemi).
  * Stav a pokrok není v hlavě modelu, ale je uchováván externě:
    * V git historii (commity s implementací),
    * V progress.txt (log provedených kroků a poznatků),
    * V prd.json (seznam úkolů a jejich status). 
  * AI si vybírá nejvyšší prioritu z nevyřešených úkolů (tj. “user stories”) a snaží se ho implementovat. Pokud kód projde testy a typecheckem, commitne se a úkol je označen jako hotový. Výsledkem je postupné dokončení všech úkolů, nebo dosažení maximálního počtu iterací.



**K čemu se Ralph používá:**

  * Automatizace vývoje funkcí podle plánovaných úkolů bez manuálního psaní kódu pro všechny kroky.
  * Umožňuje „nechat AI pracovat, zatímco vy spíte“ – AI iteruje, kontroluje výsledky a zapisuje progress.
  * Pomáhá strukturovat vývoj malými, jasně definovanými úkoly, které jsou dokončitelné v jedné iteraci AI.


----

**Hlavní výhody & principy:**

  * **Autonomie:** AI je řízena smyčkou a nepotřebuje manuální restartování každého kroku.
  * **Opakovatelnost:** Každý krok je samostatná AI instance, takže se nepřenáší kontext nebo „zmatení“ napříč úkoly.
  * **Uchovávání kontextu v kódu a logu:** Učení a vzory se zachovávají ve progress.txt a v dokumentaci v projektu.
  * **Integrace s git:** Každý validní krok je commitem, takže lze sledovat historii a rollbackovat změny.


----

**Předpoklady & omezení (co Ralph vyžaduje nebo s čím pracuje):**

  * Je potřeba mít nainstalovanou CLI aplikaci pro AI kódování (např. Amp nebo Claude Code).
  * Úkoly v PRD musí být **dostatečně malé**, aby je AI zvládla v jedné iteraci s omezeným kontextovým oknem.
  * Výsledky jsou tak dobré, jak dobře jsou definované úkoly a jak kvalitní jsou testy; AI generovaná řešení vyžadují ověření a review. To je odborný závěr – nikoli fakt ze zdrojů.


----

**Shrnutí:** Ralph je autonomní AI-řízená smyčka pro vývoj kódu, která postupně plní definované úkoly, zapisuje výsledky do git repozitáře a udržuje pokrok v externích souborech namísto v paměti modelu. Je to experimentální nástroj pro strukturovanou automatizaci vývoje funkcí pomocí AI.