## Introduction

Ralph Loop implemente la technique Ralph Wiggum - une methodologie de developpement iteratif basee sur des boucles IA continues, inventee par Geoffrey Huntley.

Ralph Loop implements the Ralph Wiggum technique - an iterative development methodology based on continuous AI loops, pioneered by Geoffrey Huntley.

🔄

##### Principe fondamental

##### Core Principle

Le meme prompt est envoye a Claude de maniere repetee. L'aspect "auto-referentiel" vient du fait que Claude voit son propre travail precedent dans les fichiers et l'historique git.

The same prompt is fed to Claude repeatedly. The "self-referential" aspect comes from Claude seeing its own previous work in the files and git history.

⚠

##### Determinisme

##### Determinism

La technique est decrite comme "deterministically bad in an undeterministic world" - les echecs sont previsibles, permettant une amelioration systematique par ajustement des prompts.

The technique is described as "deterministically bad in an undeterministic world" - failures are predictable, enabling systematic improvement through prompt tuning.

## Concept Concept

    # Core concept
    while :; do
      cat PROMPT.md | claude-code --continue
    done

#### Chaque iteration

#### Each iteration

1. Claude recoit le MEME prompt
2. Claude receives the SAME prompt
3. Travaille sur la tache, modifie les fichiers
4. Works on the task, modifying files
5. Essaie de quitter
6. Tries to exit
7. Le Stop hook intercepte et renvoie le meme prompt
8. Stop hook intercepts and feeds the same prompt again
9. Claude voit son travail precedent dans les fichiers
10. Claude sees its previous work in the files
11. Ameliore iterativement jusqu'a completion
12. Iteratively improves until completion

## Commandes Commands

`/ralph-loop` Principal Main

Demarre une boucle Ralph dans votre session actuelle.

Start a Ralph loop in your current session.

    /ralph-loop "Refactor the cache layer" --max-iterations 20
    /ralph-loop "Add tests" --completion-promise "TESTS COMPLETE"

#### Options

Option | Description | Description
--- | --- | ---
`--max-iterations <n>` | Nombre max d'iterations avant arret auto | Max iterations before auto-stop
`--completion-promise <text>` | Phrase promise pour signaler la completion | Promise phrase to signal completion

`/cancel-ralph` Annulation Cancel

Annule une boucle Ralph active (supprime le fichier d'etat).

Cancel an active Ralph loop (removes the loop state file).

    /cancel-ralph

Fonctionnement: Verifie le fichier d'etat actif et supprime `.claude/ralph-loop.local.md`.

How it works: Checks for active loop state file and removes `.claude/ralph-loop.local.md`.

`/ralph-loop:help` Help

Affiche l'aide complete du plugin Ralph Loop.

Display complete help for the Ralph Loop plugin.

## Completion Promise

Pour signaler la completion, Claude doit outputter un tag `<promise>`:

To signal completion, Claude must output a `<promise>` tag:

    <promise>TASK COMPLETE</promise>

⚠

##### Important

Le stop hook recherche ce tag specifique. Sans lui (ou sans `--max-iterations`), Ralph tourne indefiniment.

The stop hook looks for this specific tag. Without it (or `--max-iterations`), Ralph runs infinitely.

#### Mecanisme d'auto-reference

#### Self-reference mechanism

La "boucle" ne signifie pas que Claude se parle a lui-meme. Cela signifie:

The "loop" doesn't mean Claude talks to itself. It means:

- Meme prompt repete
- Same prompt repeated
- Le travail de Claude persiste dans les fichiers
- Claude's work persists in files
- Chaque iteration voit les tentatives precedentes
- Each iteration sees previous attempts
- Construit incrementalement vers l'objectif
- Builds incrementally toward goal

## Exemples Examples

#### Correction de bug iterative

#### Iterative bug fix

    /ralph-loop "Fix the token refresh logic in auth.ts. Output <promise>FIXED</promise> when all tests pass." --completion-promise "FIXED" --max-iterations 10

Ralph va:

Ralph will:

- Tenter des corrections
- Attempt fixes
- Executer les tests
- Run tests
- Voir les echecs
- See failures
- Iterer sur la solution
- Iterate on solution
- Dans votre session actuelle
- In your current session

#### Refactoring avec limite

#### Refactoring with limit

    /ralph-loop "Refactor all database queries to use the new repository pattern. Output <promise>REFACTORING COMPLETE</promise> when done." --completion-promise "REFACTORING COMPLETE" --max-iterations 20

#### Integration avec Business Analyse

#### Integration with Business Analyse

    # Le mode automatique de Business Analyse genere automatiquement
    # des prompts Ralph Loop optimises apres le handoff
    /business-analyse "Ajouter une fonctionnalite d'export PDF"

    # Le prompt genere ressemble a:
    /ralph-loop "Implement PDF export feature according to .claude/ba/pdf-export/06-implementation-brief.md. Output <promise>IMPLEMENTATION COMPLETE</promise> when all acceptance criteria pass." --completion-promise "IMPLEMENTATION COMPLETE" --max-iterations 15

## Quand utiliser When to use

Bon pour | Good for | Pas recommande pour | Not recommended for
--- | --- | --- | ---
Taches bien definies avec criteres de succes clairs | Well-defined tasks with clear success criteria | Taches necessitant jugement humain ou decisions de design | Tasks requiring human judgment or design decisions
Taches necessitant iteration et raffinement | Tasks requiring iteration and refinement | Operations one-shot | One-shot operations
Developpement iteratif avec auto-correction | Iterative development with self-correction | Taches sans criteres de succes clairs | Tasks with unclear success criteria
Projets greenfield | Greenfield projects | Debugging de problemes production (utiliser debugging cible) | Debugging production issues (use targeted debugging)

💡

##### En savoir plus

##### Learn more

Technique originale par Geoffrey Huntley
Ralph Orchestrator sur GitHub