Add Ralph Orchestrator dependency documentation and improved installation

Added comprehensive Ralph Orchestrator integration documentation:

1. requirements.txt
   - ralph-orchestrator (core dependency for /ralph command)
   - pyyaml (for config parsing)
   - Comments explaining each dependency

2. Updated supercharge.sh
   - Enhanced Ralph installation with dual detection:
     * Checks for 'ralph' command in PATH
     * Checks for ralph_orchestrator Python package
   - Installs from requirements.txt if available
   - Falls back to direct pip install
   - Provides helpful error messages with installation instructions
   - Confirms successful installation with detailed status

3. Updated README.md with new section "Ralph Orchestrator"
   - What is Ralph Orchestrator and how it works
   - Installation methods (automatic, manual, system-wide)
   - Detailed breakdown of our Ralph integration:
     * bin/ralphloop wrapper script (6,290 bytes, 223 lines)
     * skills/ralph/ Claude Code skill
     * skills/brainstorming/ multi-AI integration
     * hooks/ralph-auto-trigger.sh automatic triggering
     * hooks/qwen-consult.sh Qwen AI consultation
   - File structure created by Ralph
   - Environment variables reference
   - Troubleshooting guide
   - Ralph Orchestrator source links

The /ralph command will now work properly on:
- This machine (ralph already installed)
- Fresh clones (supercharge.sh auto-installs ralph-orchestrator)
- Any machine with pip3 available

Co-Authored-By: Claude <noreply@anthropic.com>

supercharge.sh

@@ -189,16 +189,67 @@ install_dependencies() {
         log_success "Git found: $(git --version)"
     fi
 
-    # Install Ralph Orchestrator if not present
-    if ! command -v ralph &> /dev/null; then
+    # Install Ralph Orchestrator (Python package for /ralph autonomous agent)
+    RALPH_INSTALLED=false
+
+    # Check if ralph command exists
+    if command -v ralph &> /dev/null; then
+        log_success "Ralph Orchestrator found: $(ralph --version 2>/dev/null || echo 'installed')"
+        RALPH_INSTALLED=true
+    fi
+
+    # Check if Python package is installed
+    if python3 -c "import ralph_orchestrator" 2>/dev/null; then
+        if [ "$RALPH_INSTALLED" = false ]; then
+            log_success "Ralph Orchestrator Python package found"
+            RALPH_INSTALLED=true
+        fi
+    fi
+
+    # Install if not found
+    if [ "$RALPH_INSTALLED" = false ]; then
         log_info "Installing Ralph Orchestrator..."
         if command -v pip3 &> /dev/null; then
-            pip3 install ralph-orchestrator 2>/dev/null || log_warn "Failed to install Ralph Orchestrator"
+            # Try installing from requirements.txt if it exists in script dir
+            if [ -f "$SCRIPT_DIR/requirements.txt" ]; then
+                log_info "Installing from requirements.txt..."
+                pip3 install -r "$SCRIPT_DIR/requirements.txt" 2>/dev/null && {
+                    log_success "Ralph Orchestrator installed from requirements.txt"
+                } || {
+                    # Fallback to direct install
+                    log_warn "requirements.txt install failed, trying direct install..."
+                    pip3 install ralph-orchestrator pyyaml 2>/dev/null || {
+                        log_error "Failed to install Ralph Orchestrator"
+                        echo ""
+                        echo -e "${YELLOW}Ralph Orchestrator is required for /ralph command${NC}"
+                        echo "Install manually:"
+                        echo "  pip3 install ralph-orchestrator"
+                        echo ""
+                        echo "The /ralph command will not work without it."
+                    }
+                }
+            else
+                # Direct install
+                pip3 install ralph-orchestrator pyyaml 2>/dev/null && {
+                    log_success "Ralph Orchestrator installed"
+                } || {
+                    log_warn "Failed to install Ralph Orchestrator"
+                }
+            fi
         else
             log_warn "pip3 not found. Skipping Ralph Orchestrator installation."
+            echo ""
+            echo -e "${YELLOW}Install pip3 first:${NC}"
+            echo "  sudo apt-get install python3-pip"
+            echo "  Then: pip3 install ralph-orchestrator"
         fi
+    fi
+
+    # Verify installation
+    if command -v ralph &> /dev/null || python3 -c "import ralph_orchestrator" 2>/dev/null; then
+        log_success "Ralph Orchestrator ready for /ralph command"
     else
-        log_success "Ralph Orchestrator found"
+        log_warn "Ralph Orchestrator not available - /ralph command will use fallback mode"
     fi
 }