# Ralph Loop Ralph Loop

Ralph est un orchestrateur incrémental qui boucle entre des commandes Claude Code (build, test, fix, commit) jusqu'à atteindre un état stable. Idéal pour itérer sur de gros changements ou pour un développement autonome long. Ralph is an incremental orchestrator that loops between Claude Code commands (build, test, fix, commit) until reaching a stable state. Ideal for iterating on large changes or for long-running autonomous development.

## Commandes principales Main commands

    ss ralph start                # démarre la boucle en arrière-plan
    ss ralph status               # état + dernière itération
    ss ralph logs                 # tail des logs
    ss ralph stop                 # arrête proprement

## Cycle d'une itération Iteration cycle

Chaque itération suit quatre étapes : Each iteration follows four steps:

# | Étape Step | Effet Effect
--- | --- | ---
1 | Load context Load context | Charge l'état du repo + le dernier verdict Loads the repo state + last verdict
2 | Invoke skill Invoke skill | Exécute la skill cible (build, fix, scaffold, …)Runs the target skill (build, fix, scaffold, …)
3 | Run gates Run gates | Vérifie compile + tests Verifies compile + tests
4 | Décision Decision | GO → commit + itération suivante ; NO-GO → diagnostic + retry GO → commit + next iteration; NO-GO → diagnose + retry

## Configuration Configuration

La configuration vit dans `templates/ralph/` du repo CLI et est déployée à l'installation. Voyez `/.claude/ralph/` dans votre poste. Configuration lives in `templates/ralph/` in the CLI repo and is deployed at install time. See `/.claude/ralph/` on your machine.