moai-workflow-loop

Ralph Engine - Automated feedback loop with LSP diagnostics and AST-grep integration for continuous code quality improvement. Use when implementing error-driven development, automated fixing, or continuous quality validation workflows.

1. Zainstaluj umiejętność Ralph Engine w swoim projekcie Claude Code — narzędzie automatycznie zintegruje się z dostępnymi narzędziami (Read, Write, Edit, Bash, Grep, Glob) oraz diagnostyką LSP.

2. Skonfiguruj plik ralph.yaml w katalogu projektu, definiując warunki zatrzymania pętli, reguły AST-grep do skanowania oraz priorytety naprawy błędów.

3. Uruchom polecenie /moai w Claude Code — to polecenie automatycznie wykonuje Plan-Run-Sync, czyli planowanie zmian, uruchamianie diagnostyki LSP i AST-grep, oraz synchronizację wyników.

4. Obserwuj pętlę sprzężenia zwrotnego — po każdej operacji Write lub Edit narzędzie uruchamia post_tool__lsp_diagnostic, który zbiera błędy z serwera języka i przygotowuje je do automatycznej naprawy.

5. W razie potrzeby użyj /moai loop do ręcznego uruchomienia pętli iteracyjnej lub /moai fix do jednorazowej naprawy bez pętli — loop controller automatycznie zatrzyma się, gdy wszystkie błędy zostaną rozwiązane lub osiągnięty zostanie limit iteracji.

6. Przejrzyj raport diagnostyki — narzędzie dokumentuje każdy krok (diagnostyka, skanowanie, naprawę), umożliwiając śledzenie zmian i walidację poprawek.