setup-ralph

Set up and configure Geoffrey Huntley's original Ralph Wiggum autonomous coding loop in any directory with proper structure, prompts, and backpressure.

1. Przygotuj strukturę projektu z plikami PROMPT.md (instrukcje dla Claude'a) i planem zadań. Setup-ralph wymaga dwóch promptów: jeden do analizy luk między specyfikacją a kodem, drugi do wyboru i implementacji zadań z listy TODO.

2. Skonfiguruj backpressure poprzez testy jednostkowe, type-checking i linting. Te mechanizmy odrzucają niedopuszczalne zmiany i zmuszają Claude'a do iteracji — są kluczowe dla jakości pętli.

3. Zainstaluj skill w swoim środowisku agenta i uruchom pętlę. Narzędzie automatycznie karmi PROMPT.md do Claude'a, czeka na wykonanie jednego zadania, aktualizuje plan i zatwierdza zmiany.

4. Obserwuj pierwsze iteracje, aby zidentyfikować wzorce błędów. Na podstawie obserwacji dostosuj prompty — to jest główna rola inżyniera. Nie ingeruj w pętlę, pozwól Ralph'owi pracować.

5. Monitoruj plik planu między iteracjami — służy jako deterministyczny stan współdzielony między odizolowanymi wykonaniami pętli. Każda iteracja ma dostęp do ~176K użytecznych tokenów, więc projektuj zadania tak, aby jedno zadanie zmieściło się w jednym cyklu.

6. Skaluj backpressure i prompty w miarę wzrostu złożoności projektu. Ralph automatycznie wybiera następne zadanie z planu i decyduje o implementacji — Twoja rola to inżynieria środowiska, które pozwala mu się powieść.