Johno Scott johnoscott

How to Set Up a Ralph Loop in a New Project

Ralph Loop is a milestone-driven development process for Claude Code that automates iterative implementation while capturing learnings at every step. It uses Claude Code's /ralph-loop slash command to create an autonomous loop that works through milestones sequentially -- implementing code, running tests, documenting progress, and committing -- all with human oversight.

This guide distills the patterns proven across 22+ milestones in the go-wasm-cli project into a reusable recipe for any new project.

Define a JDK Docker image

FROM openjdk:11-slim-bullseye  
  
# install:  
# - ca-certificates required by OpenJDK 11  
# - git for VaultSpeed to perform a git deployment  
RUN apt-get update -y && \  
    apt-get dist-upgrade -y && \

Open in Visual Studio Code

Open Automator
Create a new document
Select Quick Action
Set “Service receives selected” to files or folders in any application
Add a Run Shell Script action
- your default shell should already be selected, otherwise use /bin/zsh for macOS 10.15 (”Catalina”) or later
- older versions of macOS use /bin/bash
if you're using something else, you probably know what to do 😉

Getting Started With Plug'n'Play

If you use create-react-app, #5136 (released with the 2.0) implements a --use-pnp option that allows you to easily create a new project using PnP! In this case, just use create-react-app --use-pnp together with Yarn 1.12, and you're good to go! 👍

Plug'n'Play is a new initiative from Yarn that aims to remove the need for node_modules. It's already available, and has proved being effective even on large-scale infrastructures. This document describes in a few steps how to quickly get started with it. Spoiler alert: it's quite easy 🙂

First, download a package manager that supports it. Yarn 1.12 already does, so that's what we're going to use! To install it, just follow the instructions on our website: https://yarnpkg.com/en/docs/install

If everything is ok, running yarn --version should give you v1.12.1 or higher. If you don't get this result maybe a

Installing ngrok on OSX

For Homebrew v2.6.x and below:

brew cask install ngrok

For Homebrew v2.7.x and above:

How does it work?

From Gatsby docs

CodeSandbox uses the same URL compression schema used by the Babel REPL to embed the local code example in a URL.

This is than passed to the (awesome) define api to generate a sandbox on the fly.

https://github.com/babel/website/blob/c9dd1f516985f7267eb58c286789e0c66bc0a21d/js/repl/UriUtils.js#L22-L26

	.PHONY: download-scripts add-folder

	GIST_URL = https://gist.githubusercontent.com/johnoscott/f5d5110ddec85cb04729fe8ef982eeb8/raw

	download-scripts:
	curl -sL $(GIST_URL)/setup-macbook-client.sh -o setup-macbook-client.sh
	curl -sL $(GIST_URL)/add-sync-folder.sh -o add-sync-folder.sh
	chmod +x setup-macbook-client.sh add-sync-folder.sh
	@echo "Scripts downloaded"

	# --------------------------------------------------------------
	# Customer Support Ticket Classification System
	# --------------------------------------------------------------

	import instructor
	from pydantic import BaseModel, Field
	from openai import OpenAI
	from enum import Enum
	from typing import List

	# https://hub.docker.com/_/postgres

	# Usage:
	# $ docker compose up

	# NOTE: version not required as of compose spec v
	# version: '3.7'

	# docker run --name basic-postgres --rm \
	# -e POSTGRES_USER=postgres \