End-User Stories¶

This page is the plain-English route map for real user goals. Use it when you know what you are trying to do but do not care which doc family contains the answer. Each section points at the shortest next page for that job, including first-run, overnight use, configuration, comparison, proof, and internals.

I am brand new and want the fastest honest first run¶

I want to know whether my task is even a good fit¶

I already use Claude Code, Codex, or OpenCode and want a baseline comparison¶

I want to run work overnight without babysitting the terminal¶

I want to edit `ralph-workflow.toml`¶

Configuration Reference

Short answer:

global defaults → ~/.config/ralph-workflow.toml
repo-specific override → .agent/ralph-workflow.toml
workflow structure changes → .agent/pipeline.toml

I want to change which agents Ralph uses¶

I want one repo to behave differently from my global defaults¶

Configuration Reference

Then create a project-local override with:

ralph --init-local-config

I want to understand what my current workflow policy actually does¶

Policy Explanation

And run:

ralph --check-policy
ralph --explain-policy

I want advanced docs for `pipeline.toml`¶

Advanced Pipeline Configuration

I want advanced docs for `artifacts.toml`¶

Advanced Artifact Configuration

I want advanced docs for `mcp.toml`¶

Advanced MCP Configuration

I want to review whether the result is trustworthy after a run¶

I want to see proof before I install anything¶

What Good Ralph Workflow Output Looks Like

I want the command and flag reference¶

CLI Reference

I am not an end user — I need internals or implementation detail¶

Developer Reference