Gratuit · reçu par email

Le Ralph Kit

Tu valides la spec et les tickets. La loop code, vérifie, corrige et t'ouvre une PR draft.

Les scripts et le prompt d'installation que j'utilise pour faire tourner une Ralph loop sur mes repos, avec Codex, Claude Code ou les deux.

Gratuit. Tu confirmes ton adresse et le ZIP se télécharge. Tu reçois aussi ma newsletter, désinscription en un clic.

ton-repo
$ python3 loops/check-ralph.py
✅ Configuration ralph.toml
✅ Python 3.11+, git, gh, claude
✅ Branche dédiée, arbre propre
✅ Skill implement trouvé
ℹ️ CI désactivée, contrôles locaux seuls
$ python3 loops/start-ralph.py 42 4
01Dans le kit

Ce que tu télécharges

Un ZIP de quelques fichiers Python et Markdown. Les scripts n'utilisent que la bibliothèque standard.

loops/start-ralph.py

La loop

Elle prend un ticket dont les dépendances sont prêtes, lance l'agent, vérifie le résultat et organise les corrections. Puis elle passe au suivant.

loops/check-ralph.py

Le précontrôle

Avant le lancement, il vérifie ta config, tes CLIs, l'accès GitHub, ta branche et tes skills, ligne par ligne.

PROMPT-INSTALLATION.md

Le prompt d'installation

Tu le colles dans ton agent. Il inspecte ton repo, te pose ses questions et remplit la config : modèles, labels, commandes de test.

loops/ralph.toml

La config

Un moteur et un modèle par rôle, Codex ou Claude Code. Tu actives tes tests locaux, ta CI, les deux ou aucun.

02Le workflow

De l'idée à la PR en quatre étapes

  1. 1

    Installer les skills

    grill-with-docs, to-spec, to-tickets et implement, les skills de Matt Pocock, dans ton repo.

  2. 2

    Adapter la loop

    Ton agent suit PROMPT-INSTALLATION.md et prépare la config pour ton projet.

  3. 3

    Préparer la feature

    Tu précises le comportement, puis tu valides la spec et son découpage en tickets GitHub.

  4. 4

    Lancer et relire

    La loop enchaîne les tickets. Tu relis la PR draft et tu décides du merge.

03Avant de télécharger

Ce qu'il te faut

  • Python 3.11 ou plus récent
  • Git et GitHub CLI (gh) authentifié
  • Codex CLI ou Claude Code CLI, selon tes rôles
  • Les outils de ton projet : runtime, tests, lint

Les agents tournent sans approbation

La loop contourne les approbations et la sandbox de Codex, ou les permissions de Claude Code. Les agents ont les droits du compte qui la lance.

Fais-la tourner sur un VPS dédié, avec un compte sans droits admin et des accès limités au repo. Relis le code avant de l'envoyer en production.

04La théorie

Le pourquoi est dans la vidéo

Pourquoi une spec, des tickets et une session fraîche par ticket : je l'explique dans « J'ai construit une usine à code. »

05Le kit

Lance ta première loop

Commence par une petite feature sur un repo que tu connais, avec un budget de quatre sessions.

Gratuit. Tu confirmes ton adresse et le ZIP se télécharge. Tu reçois aussi ma newsletter, désinscription en un clic.