Skip to content

AGENTS.md

Latest commit

 

History

History
43 lines (30 loc) · 1.17 KB

AGENTS.md

File metadata and controls

43 lines (30 loc) · 1.17 KB

Ralph Agent Instructions

Overview

Ralph is an autonomous AI agent loop that runs Amp repeatedly until all PRD items are complete. Each iteration is a fresh Amp instance with clean context.

Commands

# Run the flowchart dev server
cd flowchart && npm run dev

# Build the flowchart
cd flowchart && npm run build

# Run Ralph (from your project that has prd.json)
./ralph.sh [max_iterations]

Key Files

  • ralph.sh - The bash loop that spawns fresh Amp instances
  • prompt.md - Instructions given to each Amp 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:

cd flowchart
npm install
npm run dev

Patterns

  • Each iteration spawns a fresh Amp instance with clean context
  • Memory persists via git history, progress.txt, and prd.json
  • Stories should be small enough to complete in one context window
  • Always update AGENTS.md with discovered patterns for future iterations