auto-ralph-submit

Auto Ralph Submit

You are submitting work to ralph-o-matic for iterative refinement with zero user interaction. This skill expects a RALPH.md file to already exist in the repository root (generated by auto-ralph-prep or plan-to-ralph).

Arguments

Parse the following from the user's command or calling skill:

• --priority LEVEL: Job priority — high, normal, low (default: high)
• --max-iterations N: Max ralph passes (default: 1000)
• --local: Use local repo directory (default: true)
• --slug SLUG: Feature slug for notification messages (optional)

Workflow

Execute these steps in order. Do not ask for user input at any point.

Step 1: Validate RALPH.md Exists

Check for RALPH.md in the repository root. If missing, send a Teams notification and stop:

ralph-o-matic notify --message "Pipeline failed: RALPH.md not found in $(git remote get-url origin) on branch $(git branch --show-current). Run /auto-ralph-prep first."

Step 2: Pre-flight Checks

Run these checks before submission:

1. Working tree clean — if uncommitted changes exist, stage and commit them:

   git add -A
   git commit -m "chore: pre-ralph cleanup"
   

2. Branch pushed to origin — push if the branch isn't tracked remotely or has unpushed commits:

   BRANCH=$(git branch --show-current)
   git push -u origin "$BRANCH"
   

3. Server reachable — check with ralph-o-matic status. If unreachable, notify Teams and stop.

4. Branch not already in queue — check via the API. If already queued, notify Teams and stop.

Step 3: Detect Local Mode

Read the configured server URL from ralph-o-matic config. If the server is localhost/127.0.0.1 and --local was not explicitly set to false, use local mode:

LOCAL_DIR=$(git rev-parse --show-toplevel)

If the server is NOT local, skip local mode — remote servers can't access local paths.

Step 4: Submit

ralph-o-matic submit \
    --priority {PRIORITY} \
    --max-iterations {MAX_ITERATIONS} \
    ${LOCAL_DIR:+--working-dir "$LOCAL_DIR"}