Ralph

lastmod 2026-01-31created 2026-01-311 edits

An autonomous AI agent that runs repeatedly until all PRD items are complete

About

• An Autonomous AI loop agent designed to automate development based on product requirements documents (PRDs)
• Uses Amp CLI and jq to run automated development cycles within a project
• Each iteration starts with a new Amp instance and runs in a clean context
  • Memory is stored via git history, progress.txt, and prd.json
• Works in a cycle of PRD → JSON conversion → implementation → verification → commit
  • Each PRD item is kept small enough to be completed within a single context window
  • Evaluates priority per PRD item and processes incomplete items (passes: false) first
  • After code generation, automatically runs type checking, tests, and quality verification
  • On success, commits and updates status; on failure, iterates again
  • When all stories are marked passes: true, outputs COMPLETE and exits
  • Records patterns, caveats, and codebase conventions discovered after iterations, and Amp learns from them in later runs, forming a continuous improvement loop
• Implemented based on Geoffrey Huntley's Ralph pattern

See also

• Github Actions
• Amp - Agentic coding tool

Favorite site

• Github - snarktank/ralph
• Ralph - An autonomous AI agent that runs repeatedly until all PRD items are complete | GeekNews