pam ▸ docs/ralph/README.md
updated 2026-03-28

Ralph in Pam

Pam includes a Ralph-ready prompt and PRD set so Ralph can run bounded research iterations against the current strategy system.

Files

  1. docs/ralph/PROMPT_PAM_RESEARCH.md
  2. docs/prds/PRD_001_eventful_market_observation.md
  3. docs/prds/PRD_002_dislocation_research_sleeves.md
  4. docs/prds/PRD_003_deployment_gate_and_candidate_review.md
  5. docs/prds/PRD_004_ralph_research_operator.md
  6. scripts/run_ralph_pam_research.sh

Run

./scripts/run_ralph_pam_research.sh

Notes

  1. Ralph is installed locally at /Users/joshua/.ralph.
  2. This local install is a script bundle, not a git checkout, so updates are manual.
  3. The current Claude Code version on this machine is compatible with Ralph’s modern CLI checks.
  4. The local Ralph bundle was refreshed on 2026-03-16 from upstream frankbria/ralph-claude-code.
  5. The most relevant upstream improvements for Pam are: - dual-condition exit gate using explicit EXIT_SIGNAL: true - improved premature-exit protection - uninstall script
  6. Pam should use the local wrapper here: - ./scripts/run_ralph_pam_research.sh
  7. Newer Ralph versions write runtime state under the project-local .ralph/ directory. That directory is ignored in Git.
  8. Pam also includes a provider router: - scripts/ralph_provider_router.py This lets Ralph run against claude or codex by changing RALPH_PROVIDER.
  9. The wrapper exports CLAUDE_CODE_CMD directly because the current upstream Ralph release snapshots the default command too early for .ralphrc to reliably override it.