Ralph Build

Execute the Ralph autonomous build loop to process subtasks from a queue.

Usage

/ralph-build [options]

Options

| Option | Description | |--------|-------------| | --subtasks <path> | Path to subtasks.json file (will prompt if not provided) | | -i, --interactive | Pause between iterations for user review | | -p, --print | Output the prompt without executing (dry run) | | --validate-first | Run pre-build validation before starting the loop | | --max-iterations <n> | Maximum retry attempts per subtask (default: 3) |

Workflow

1. Determine Subtasks Path

If --subtasks is not provided, prompt the user:

"Which subtasks.json file should I use? Provide the path or I'll look for docs/planning/milestones/*/subtasks.json"

2. Print Mode (-p)

If print mode is requested:

1. Output the full prompt content that would be sent to Claude
2. Do NOT execute any iterations
3. Exit after printing

3. Validate First (--validate-first)

If validate-first is requested:

1. Run pre-build validation prompt on the next subtask
2. If validation fails, report the issue and stop
3. If validation passes, proceed to build

4. Execute Build Loop

For each iteration, follow the ralph-iteration workflow:

@context/workflows/ralph/building/ralph-iteration.md

5. Interactive Mode (-i)

After each completed iteration:

1. Display summary of what was done
2. Prompt: "Continue to next subtask? [Y/n]"
3. Wait for user confirmation before proceeding
4. User can abort the loop at any time

6. Max Iterations (--max-iterations)

If a subtask fails repeatedly:

1. Track retry count per subtask
2. Stop after max-iterations failures on the same subtask
3. Report the failure and suggest next steps

CLI Equivalent

This skill provides the same functionality as:

aaa ralph build [options]

References

• Iteration prompt: @context/workflows/ralph/building/ralph-iteration.md
• Pre-build validation: @context/workflows/ralph/building/pre-build-validation.md