🏎️ Rrrralphy: Multi-Engine Support for Maximum Speed

.ralphy/config.yaml

@@ -0,0 +1,44 @@
+# Ralphy Configuration
+# https://github.com/michaelshimeles/ralphy
+
+# Project info (auto-detected, edit if needed)
+project:
+  name: "ralphy"
+  language: "bash"
+  framework: ""
+  description: "Orchestration framework for AI code agents"
+
+# Commands (auto-detected from package.json/pyproject.toml)
+commands:
+  test: ""
+  lint: ""
+  build: ""
+
+# Rules - instructions the AI MUST follow
+# These are injected into every prompt
+rules: []
+  # Examples:
+  # - "Always use TypeScript strict mode"
+  # - "Follow the error handling pattern in src/utils/errors.ts"
+
+# Boundaries - files/folders the AI should not modify
+boundaries:
+  never_touch: []
+    # Examples:
+    # - "src/legacy/**"
+    # - "migrations/**"
+
+# Parallel execution configuration
+parallel:
+  # List of engines to use for parallel execution
+  engines:
+    - name: "claude"
+      weight: 2
+    - name: "opencode"
+      weight: 1
+
+  # Distribution strategy: round-robin, weighted, random, fill-first
+  distribution: "weighted"
+
+  # Maximum number of concurrent tasks
+  max_concurrent: 3

.ralphy/progress.txt

@@ -0,0 +1,16 @@
+Created examples/multi-engine-weighted.yaml
+
+This file demonstrates weighted distribution configuration for multi-engine parallel execution.
+
+Key features:
+- Shows how to configure weighted task distribution across engines
+- Includes comprehensive documentation and usage examples
+- Demonstrates weight ratios (claude:3, cursor:2, opencode:2)
+- Explains how weighted distribution works with task cycling
+- Provides alternative weight configuration examples
+- Includes 14 sample tasks organized in 3 parallel groups
+
+The example shows a practical use case for weighted distribution where you want
+Claude to handle ~43% of tasks (weight 3) and Cursor/OpenCode to handle ~29% each (weight 2).
+
+File location: examples/multi-engine-weighted.yaml

README.md

@@ -78,6 +78,7 @@ Rules apply to all tasks (single or PRD).
 
 ## AI Engines
 
+**Single engine:**
 ```bash
 ralphy              # Claude Code (default)
 ralphy --opencode   # OpenCode
@@ -87,6 +88,48 @@ ralphy --qwen       # Qwen-Code
 ralphy --droid      # Factory Droid
 ```
 
+**Multi-engine** - distribute tasks across multiple engines:
+
+```bash
+# Use Claude and Cursor in round-robin
+./ralphy.sh --parallel --engines claude,cursor
+
+# Weighted distribution (Claude gets 70%, Cursor gets 30%)
+./ralphy.sh --parallel --engines claude:7,cursor:3
+
+# Different distribution strategies
+./ralphy.sh --parallel --engines claude,cursor --engine-distribution round-robin  # alternate
+./ralphy.sh --parallel --engines claude,cursor --engine-distribution fill-first   # fill Claude first
+./ralphy.sh --parallel --engines claude,cursor --engine-distribution random       # random assignment
+./ralphy.sh --parallel --engines claude:7,cursor:3 --engine-distribution weighted # use weights
+```
+
+**Config file:**
+```yaml
+# .ralphy/config.yaml
+parallel:
+  engines:
+    - name: claude
+      weight: 7
+    - name: cursor
+      weight: 3
+  distribution: weighted  # round-robin, weighted, fill-first, random
+  max_concurrent: 5
+```
+
+Then run: `./ralphy.sh --parallel`
+
+**Distribution strategies:**
+- `round-robin` - cycles through engines (Agent 1→claude, 2→cursor, 3→claude...)
+- `weighted` - respects weight ratios (7:3 = 70% claude, 30% cursor)
+- `fill-first` - fills first engine before using next
+- `random` - random selection from available engines
+
+**Weight syntax:**
+- `--engines claude,cursor` - equal distribution (weight 1 each)
+- `--engines claude:7,cursor:3` - weighted (70% claude, 30% cursor)
+- Weights can be any positive integers, interpreted as ratios
+
 ## Task Sources
 
 **Markdown** (default):
@@ -195,6 +238,8 @@ capabilities:
 | `--github-label TAG` | filter issues by label |
 | `--parallel` | run parallel |
 | `--max-parallel N` | max agents (default: 3) |
+| `--engines LIST` | comma-separated engines with optional weights (e.g., `claude:7,cursor:3`) |
+| `--engine-distribution TYPE` | distribution strategy: `round-robin`, `weighted`, `fill-first`, `random` |
 | `--branch-per-task` | branch per task |
 | `--base-branch NAME` | base branch |
 | `--create-pr` | create PRs |