Skip to main content
Ralph Workflow
Install
First run Local CLI

Hand off one task, then leave it alone.

Ralph Workflow is for the moment when you have a clear task and no desire to babysit the agent. Give it a tight brief, start the run, and come back when there is evidence to review.

Write the brief Install Ralph Workflow
1

Pick a real, bounded task.

Choose work you would hand to a careful engineer for an afternoon: one feature, one bug, one refactor, one migration.

Good: add a CLI flag with tests.
2

Write the contract.

State the goal, the files in scope, the behavior you expect, and exactly how Ralph Workflow should prove it worked.

A short spec beats a vague prompt.
3

Let the loop run.

Ralph Workflow plans, builds, checks, fixes, and leaves a receipt so your review starts from evidence instead of agent confidence.

Come back when the receipt exists.

PROMPT.md

A first brief should feel boring and checkable.

Browse templates 
Goal: Add a --dry-run flag to the CLI.
Scope: CLI entrypoint and workflow runner only.
Behavior: print planned phases without invoking agents.
Success: tests pass, command exits 0, existing behavior unchanged.

Morning review

Trust the process, then verify the result.

  • Existing tests still pass.
  • New behavior is covered.
  • The diff is readable.
  • The receipt matches the brief.