claudegoodies
CLAUDE.md

ralph-claude-code CLAUDE.md

From frankbria

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Runs Claude Code repeatedly in an autonomous loop with exit detection, rate limiting, and GitHub issue/PRD import.

Use it when

  • Automating multi-loop AI development cycles against a repo
  • Importing GitHub issues or PRDs as tasks via the gh CLI
  • Batch-processing a queue of GitHub issues sequentially
  • Tracking issue lifecycle: progress comments, PR creation, auto-close

Skip it if

  • Requires gh CLI and GitHub-based workflow, not usable without it
  • Single branch, no concurrency — not for parallel task processing
  • Shell-script based system with many moving state files (.ralph/ dir) to manage

Facts

Repository
frankbria/ralph-claude-code
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Repository Overview

Ralph for Claude Code — an autonomous AI development loop system enabling continuous development cycles with intelligent exit detection and rate limiting. See [README.md](README.md) for version info, changelog, and user documentation.

## Core Architecture

### Main Scripts

- **ralph_loop.sh** — main autonomous loop that executes Claude Code repeatedly
- **ralph_monitor.sh** — live monitoring dashboard for tracking loop status
- **setup.sh** — project initialization for new Ralph projects
- **create_files.sh** — bootstrap script that creates the entire Ralph system
- **ralph_import.sh** — converts PRD/spec documents to Ralph format; uses `--output-format json` with automatic text fallback for older CLI versions
  - GitHub issue import (Issue #69): `--github-issue <N>` for an exact issue, plus `--repo <owner/repo>`, `--include-comments`
  - Fetches via `gh` into a markdown PRD, then the normal conversion pipeline. Comments off by default (prompt-injection surface); source content is treated as data, not instructions
  - Metadata filtering + selection (Issue #71), implemented in `resolve_github_issue_candidates()` / `select_issue_from_candidates()` / `preview_issue_matches()` (replaced `resolve_github_issue_number()`; "first match" is now o
View full source on GitHub →

Other claude.md files