Ralph iteration 1: work in progress

.opencode/command/ralph.md

@@ -0,0 +1,44 @@
+---
+description: Run Open Ralph Wiggum loops in this repository
+---
+
+Run Open Ralph Wiggum in the current repository with OpenCode as the default agent.
+
+**Input**: The argument after `/ralph` is the Ralph task prompt. Optional Ralph flags may be included.
+
+**Steps**
+
+1. **Require task input**
+
+   If no argument is provided, ask:
+   > "What task should Ralph run? Include success criteria and completion promise if you have one."
+
+   Stop after asking.
+
+2. **Install Ralph locally in `.opencode`**
+
+   ```bash
+   npm install --prefix ".opencode" @th0rgal/ralph-wiggum
+   ```
+
+3. **Run Ralph loop**
+
+   If the user did not provide iteration bounds, use:
+   ```bash
+   npx --prefix ".opencode" ralph "<input>" --agent opencode --max-iterations 10
+   ```
+
+   If the user included explicit flags (for example `--max-iterations`, `--tasks`, `--model`), preserve them and append `--agent opencode` only when agent is not specified.
+
+4. **After run, show control commands**
+
+   ```bash
+   npx --prefix ".opencode" ralph --status
+   npx --prefix ".opencode" ralph --add-context "Focus on <area>"
+   ```
+
+**Guardrails**
+
+- Do not add `open-ralph-wiggum` to OpenCode plugin config.
+- Keep the run scoped to this repository.
+- Prefer bounded loops with `--max-iterations`.