AGENTS.md
Overview and commands for the Ralph repository: how to run ralph.sh with Amp or Claude Code, and which files matter.
- Kind
- Rules
- Works with
- Any agent
- Languages
- Shell
- Source
- Ralph @ 6c53cb0b831e
- Path
- AGENTS.md
- License
- MIT
- Jobs
- Documentation, Context management
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# Ralph Agent Instructions ## Overview Ralph is an autonomous AI agent loop that runs AI coding tools (Amp or Claude Code) repeatedly until all PRD items are complete. Each iteration is a fresh instance with clean context. ## Commands ```bash # Run the flowchart dev server cd flowchart && npm run dev # Build the flowchart cd flowchart && npm run build # Run Ralph with Amp (default) ./ralph.sh [max_iterations] # Run Ralph with Claude Code ./ralph.sh --tool claude [max_iterations] ``` ## Key Files - `ralph.sh` - The bash loop that spawns fresh AI instances (supports `--tool amp` or `--tool claude`) - `prompt.md` - Instructions given to each AMP instance - `CLAUDE.md` - Instructions given to each Claude Code instance - `prd.json.example` - Example PRD format - `flowchart/` - Interactive React Flow diagram explaining how Ralph works ## Flowchart The `flowchart/` directory contains an interactive visualization built with React Flow. It's designed for presentations - click through to reveal each step with animations. To run locally: ```bash cd flowchart npm install npm run dev ``` ## Patterns …