Sa wakas, Narito Na! Ralph TUI, Biswalisasyon ng Ralph Loop

# Sa wakas, Narito Na! Ralph TUI, Biswalisasyon ng Ralph Loop\n\Sumulat ako dati ng isang tutorial tungkol sa **ralph-loop**, at maraming kaibigan ang nagbigay ng parehong feedback pagkatapos patakbuhin ito: **Ang saya, sa wakas ay tumatakbo na nang matagal ang Claude Code.** Ngunit kung minsan, kapag nakikita mong parang hindi ito gumagalaw, hindi mo maiwasang mag-alala: \- Awtomatikong tuklasin kung aling mga agent ang naka-install sa iyong makina (tulad ng Claude Code, OpenCode, atbp.) - Bumuo ng configuration file sa proyekto: .ralph-tui/config.toml - Agad na i-install ang mga skills na may kaugnayan sa pagbuo ng PRD/pag-convert ng gawain (hindi mo na kailangang manu-manong gawin ito sa hinaharap) Personal kong payo: Sa unang pagkakataon, huwag maging tamad, **tiyaking patakbuhin ang setup nang isang beses**. ### Bumuo ng Proyekto PRD Pagkatapos patakbuhin ang setup, ang susunod na hakbang ay ang pinakapuso ng opisyal na tutorial, at ang pinakaangkop na isulat bilang isang demo sa pampublikong account: **create-prd**. Ang utos na `ralph-tui create-prd --chat` ay papasok sa isang conversational process, na magtatanong sa iyo tungkol sa mga layunin ng pangangailangan, mga hangganan, at pamantayan ng pagtanggap tulad ng isang product manager. Pagkatapos magtanong, direktang maglalabas ito ng dalawang bagay sa proyekto (ito ang punto): - Isang PRD markdown file: ./tasks/prd-feature.md - Isang direktang maipapatupad na task file: ./prd.json Sa puntong ito, tunay kang nakapasok sa "standard closed loop" ng ralph-tui: **Pangangailangan (PRD) → Gawain (prd.json) → Pagpapatupad (run)** ### Patakbuhin Sa pagkakaroon ng prd.json, natural na ang pagpapatakbo: `ralph-tui run --prd ./prd.json` Makikita mo ang TUI na tumatakbo, simulan ang loop: pumili ng gawain → ipatupad → hatulan ang pagkumpleto → isulat ang status → tapusin o susunod na round. Sa unang pagkakataon na patakbuhin ko ito, mariin kong inirerekomenda na magdagdag ng limitasyon sa pag-ulit, ikulong muna ito: `ralph-tui run --prd ./prd.json --iterations 5` Pagkatapos tumakbo, tingnan ang mga pagbabago, patakbuhin ang mga pagsubok, at tingnan kung ang PRD at mga gawain ay nakakatugon sa mga inaasahan. Kumpirmahin na ang link na ito ay gumagana, pagkatapos ay palayain ang mga iterations, pagkatapos ay pumunta sa headless/remote, ito ang maaasahang ritmo. Sa puntong ito, karaniwang makukumpirma mo: **Ang loop na ito ay talagang tumatakbo.** ## Paano Pumili ng Modelo/Agent? Kailangang Magsabi ng Totoo Tungkol sa Pagtitipid ng Pera Alam ko na ang pinaka-aalala ng maraming tao ay: "Hindi ko ba kailangang gumamit ng Claude Code? Maaari ba akong gumamit ng mas murang modelo?" Ang sagot ay: **Oo.** Sinusuportahan mismo ng ralph-tui na tukuyin mo ang agent at modelo (may mga halimbawa sa opisyal na run documentation). Halimbawa, gamitin ang Claude Opus: `ralph-tui run --prd ./prd.json --agent claude --model opus` Ngunit sa totoo lang, hindi ko gagamitin ang Opus para sa mga gawaing tulad ng "pagpupuno ng mga pagsubok, pag-aayos ng lint", masyadong mahal. Ang aking ugali ay stratification: - **Murang modelo**: Patakbuhin ang maraming paulit-ulit na gawain (pagpupuno ng mga pagsubok, pagpupuno ng mga komento, pag-aayos ng mga format, pagdaragdag ng mga hangganan) - **Mahal na modelo**: Lumabas lamang sa mga kritikal na node (pagsasaayos ng arkitektura, mahihirap na bug, pangunahing lohika) Kung ikaw ay isang ordinaryong developer, ang mindset na ito ay mas mahalaga. Dahil hindi ka malaking badyet ng kumpanya, kailangan mong panatilihing kontrolado ang mga gastos upang tumagal ka. ## Gusto Mo Bang Maging Mas Masaya? Ipagkatiwala rin ang "Pagsulat ng PRD" sa Agent Ang ralph-tui ay may disenyo na gusto ko: sinusuportahan nito ang mga skills (sa madaling salita, ito ay isang hanay ng mga panlabas na utos ng agent). Ang opisyal na paraan ng pag-install ay ang paggamit ng add-skill: `bunx add-skill subsy/ralph-tui --all` O i-install ito sa isang tinukoy na agent, tulad ng claude-code: `bunx add-skill subsy/ralph-tui -a claude-code -g -y` Pagkatapos ng pag-install, maaari kang gumamit ng slash command sa agent session: `/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads` Ito ay katulad ng pag-install ng isang plugin sa IDE, maliban na ang plugin na ito ay para sa agent. Ang kahulugan nito ay upang bawasan ang oras ng "manu-manong paglilipat ng mga pangangailangan", upang ang pangangailangan → gawain → pagpapatupad ay mas katulad ng isang linya ng produksyon. ## Kailan Ito Dapat Gamitin? Kailan Hindi Dapat Gamitin?Hindi ko masyadong gusto ang naratibo na "lahat ay kayang gawin ng AI," dahil madali itong makapanlinlang. Ang mga tool ay mga tool lamang, at mahalaga lamang ang mga ito kung angkop sa sitwasyon. ### Mga Sitwasyon Kung Kailan Angkop ang ralph-tui Mayroon kang mga ganitong uri ng gawain: - Pagpupuno ng mga pagsubok (lalo na sa mga lumang proyekto) - Pag-aayos ng lint / format - Maliit na hakbang na pag-refactor (pagtitipon ng paulit-ulit na code) - Pagdaragdag ng mga uri, pagpupuno ng mga hangganan sa batch - Dahan-dahang pagtulak ayon sa pila ng gawain pagkatapos hatiin ang mga kinakailangan Ang mga gawaing ito ay may isang bagay na karaniwan: **maraming gawain, mataas na antas ng pag-uulit, maaaring tanggapin, at maaaring umunlad nang paulit-ulit.** ### Mga Sitwasyon Kung Kailan Hindi Angkop na Gamitin ang ralph-tui Ang ginagawa mo ay ganito: - Isang beses na malaking pag-refactor, hindi malinaw ang mga pamantayan sa pagtanggap - Malabo ang mga kinakailangan mismo, batay sa iyong implicit na kaalaman - Kailangan ng maraming komunikasyon/kumpirmasyon sa iba't ibang team - Kailangan mong gumawa ng mga pagpapasya sa produkto Sa ganitong uri ng gawain, palalakihin lamang ng agent loop ang kaguluhan. ## Ano ang pagkakaiba nito sa ralph-loop (ralph-claude-code)? Ang **ralph-claude-code** ay mas katulad ng isang "awtomatikong pagmamaneho na plugin para sa Claude Code": ilulunsad ito ng script, magpapatakbo ng loop, at ang pagtuklas ng paglabas, paglilimita ng rate, at circuit breaker ay magiging iyong backstop. Kung gusto mo ng "mabilis," ito ay magiging mabilis. Ang **ralph-tui** ay mas katulad ng isang "engineering console para sa agent loop": hindi nito isinasama ang isang partikular na modelo, o isang partikular na sistema ng gawain. Sinusubukan nitong lutasin ang mga problemang pang-engineering tulad ng "pangmatagalang pagtakbo, naoobserbahan, nakokontrol, nababawi, at remote." Kaya kung tatanungin mo ako kung paano pumili? - Ikaw ay isang gumagamit ng Claude Code at gusto mong patakbuhin ito nang mabilis → ralph-claude-code - Gusto mong kumonekta ng iba't ibang modelo, gusto mong makatipid ng pera, gusto mong pamahalaan ang loop bilang isang serbisyo → ralph-tui ## Sa wakas: Huwag hayaang gamitin nito ang iyong repository bilang isang laboratoryo Mayroon akong ilang mahigpit na panuntunan para sa pagpapatakbo ng agent loop, isinulat ko ang mga ito dito para sundin mo, at ang posibilidad ng pagkabigo ay mas maliit: - **Patakbuhin sa isang branch, huwag magpakamatay sa main.** - **Sa unang pagtakbo, tiyaking magdagdag ng --iterations, kumpirmahin muna sa maliit na hakbang na hindi ito mababaliw.** - **Dapat tanggapin ang gawain**: alinman sa maaaring magpatakbo ng mga pagsubok, o maaaring magpatakbo ng lint, o maaaring ihambing ang mga output file. - **Dapat kang matutong huminto**: mas matalino ang paghinto kaysa sa patuloy na pagsunog ng pera kapag nakita mong nagsisimula itong umikot. - **Gumamit ng murang mga modelo para sa magaspang na gawain, at mamahaling mga modelo para sa mahahalagang gawain**: ang gastos ay pinamamahalaan, hindi ipinagdarasal.Address ng Proyekto: https://github.com/subsy/ralph-tui