flow-next-ralph-init
Scaffold repo-local Ralph autonomous harness under scripts/ralph/. Use when user runs /flow-next:ralph-init.
When & Why to Use This Skill
This Claude skill automates the scaffolding and initialization of the Ralph autonomous harness within a local repository. It streamlines the setup of automation scripts, templates, and control utilities, allowing developers to quickly deploy an autonomous agent environment for task execution and code review while ensuring configuration persistence during updates.
Use Cases
- Initializing a new repository with the Ralph autonomous framework to automate repetitive development workflows.
- Updating an existing Ralph setup to the latest version while preserving critical environment variables and configuration files.
- Configuring and switching between different review backends like RepoPrompt or Codex for automated code analysis.
- Setting up executable shell scripts for both single-iteration observations and full-loop autonomous task processing ('AFK' mode).
| name | flow-next-ralph-init |
|---|---|
| description | Scaffold repo-local Ralph autonomous harness under scripts/ralph/. Use when user runs /flow-next:ralph-init. |
Ralph init
Scaffold or update repo-local Ralph harness. Opt-in only.
Rules
- Only create/update
scripts/ralph/in the current repo. - If
scripts/ralph/already exists, offer to update (preserves config.env). - Copy templates from
templates/intoscripts/ralph/. - Copy
flowctlandflowctl.pyfrom${CLAUDE_PLUGIN_ROOT}/scripts/intoscripts/ralph/. - Set executable bit on
scripts/ralph/ralph.sh,scripts/ralph/ralph_once.sh, andscripts/ralph/flowctl.
Workflow
Resolve repo root:
git rev-parse --show-toplevelCheck if
scripts/ralph/exists:- If exists: ask "Update existing Ralph setup? (preserves config.env and runs/) [y/n]"
- If no: stop
- If yes: set UPDATE_MODE=1
- If not exists: set UPDATE_MODE=0
- If exists: ask "Update existing Ralph setup? (preserves config.env and runs/) [y/n]"
Detect available review backends (skip if UPDATE_MODE=1):
HAVE_RP=$(which rp-cli >/dev/null 2>&1 && echo 1 || echo 0) HAVE_CODEX=$(which codex >/dev/null 2>&1 && echo 1 || echo 0)Determine review backend (skip if UPDATE_MODE=1):
- If BOTH available, ask user (do NOT use AskUserQuestion tool):
Wait for response. Default if empty/ambiguous:Both RepoPrompt and Codex available. Which review backend? a) RepoPrompt (macOS, visual builder) b) Codex CLI (cross-platform, GPT 5.2 High) (Reply: "a", "rp", "b", "codex", or just tell me)rp - If only rp-cli available: use
rp - If only codex available: use
codex - If neither available: use
none
- If BOTH available, ask user (do NOT use AskUserQuestion tool):
Copy files using bash (MUST use cp, NOT Write tool):
If UPDATE_MODE=1 (updating):
# Backup config.env cp scripts/ralph/config.env /tmp/ralph-config-backup.env # Update templates (preserves runs/) cp "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/ralph.sh" scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/ralph_once.sh" scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/prompt_plan.md" scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/prompt_work.md" scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/watch-filter.py" scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/scripts/flowctl" "${CLAUDE_PLUGIN_ROOT}/scripts/flowctl.py" scripts/ralph/ chmod +x scripts/ralph/ralph.sh scripts/ralph/ralph_once.sh scripts/ralph/flowctl # Restore config.env cp /tmp/ralph-config-backup.env scripts/ralph/config.envIf UPDATE_MODE=0 (fresh install):
mkdir -p scripts/ralph/runs cp -R "${CLAUDE_PLUGIN_ROOT}/skills/flow-next-ralph-init/templates/." scripts/ralph/ cp "${CLAUDE_PLUGIN_ROOT}/scripts/flowctl" "${CLAUDE_PLUGIN_ROOT}/scripts/flowctl.py" scripts/ralph/ chmod +x scripts/ralph/ralph.sh scripts/ralph/ralph_once.sh scripts/ralph/flowctlNote:
cp -R templates/.copies all files including dotfiles (.gitignore).Edit
scripts/ralph/config.envto set the chosen review backend (skip if UPDATE_MODE=1):- Replace
PLAN_REVIEW=codexwithPLAN_REVIEW=<chosen> - Replace
WORK_REVIEW=codexwithWORK_REVIEW=<chosen>
- Replace
Print next steps (run from terminal, NOT inside Claude Code):
If UPDATE_MODE=1:
Ralph updated! Your config.env was preserved. Changes in this version: - Removed local hooks requirement (plugin hooks work when installed normally) Run from terminal: - ./scripts/ralph/ralph_once.sh (one iteration, observe) - ./scripts/ralph/ralph.sh (full loop, AFK)If UPDATE_MODE=0:
Ralph initialized! Next steps (run from terminal, NOT inside Claude Code): - Edit scripts/ralph/config.env to customize settings - ./scripts/ralph/ralph_once.sh (one iteration, observe) - ./scripts/ralph/ralph.sh (full loop, AFK) - Uninstall: rm -rf scripts/ralph/