flow-next-ralph-init

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 repo-local Ralph harness. Opt-in only.

Rules

• Only create scripts/ralph/ in the current repo.
• If scripts/ralph/ already exists, stop and ask the user to remove it first.
• Copy templates from templates/ into scripts/ralph/.
• Copy flowctl and flowctl.py from $PLUGIN_ROOT/scripts/ into scripts/ralph/.
• Set executable bit on scripts/ralph/ralph.sh, scripts/ralph/ralph_once.sh, and scripts/ralph/flowctl.

Workflow

1. Resolve repo root and plugin root:

   ROOT="$(git rev-parse --show-toplevel)"
   PLUGIN_ROOT="$ROOT/plugins/flow-next"
   

2. Check scripts/ralph/ does not exist.
3. Detect available review backends:

HAVE_RP=0 if command -v rp-cli >/dev/null 2>&1; then HAVE_RP=1 elif [[ -x /opt/homebrew/bin/rp-cli || -x /usr/local/bin/rp-cli ]]; then HAVE_RP=1 fi

4. Determine review backend:
- If rp-cli available, ask user:
  ```
  Which review backend?
  a) OpenCode (GPT‑5.2 High)
  b) RepoPrompt (macOS, visual builder)

  (Reply: "a", "opencode", "b", "rp", or just tell me)
  ```
  Wait for response. Default if empty/ambiguous: `opencode`
- If only rp-cli available and user chooses rp: use `rp`
- Otherwise: use `opencode`
- If neither available and user requests none: use `none`
5. Write `scripts/ralph/config.env` with:
- `PLAN_REVIEW=<chosen>` and `WORK_REVIEW=<chosen>`
- replace `{{PLAN_REVIEW}}` and `{{WORK_REVIEW}}` placeholders in the template
6. Copy templates and flowctl files.
7. Print next steps (run from terminal, NOT inside OpenCode):
- 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/`