Skip to content

Conversation

@eevisceral
Copy link

Summary

Transform the ralph skill from a PRD converter into a full autonomous execution workflow that enables Claude Desktop to run the Ralph pattern without requiring Amp's auto-handoff feature or external bash scripts.

Changes

  • Enhanced ralph skill - Added complete 11-step execution workflow including:

    • Session bootstrap and handoff detection
    • Story selection and implementation
    • Quality checks and browser verification
    • State persistence (prd.json, progress.txt, git commits)
    • Context detection and handoff preparation
  • Added context management - Created HANDOFF.md template and CONTEXT.md guide for managing context limits in Claude Desktop

  • Updated prd skill - Added story sizing guidance emphasizing context window constraints

  • Added comprehensive README - Created skills/README.md documenting workflow, concepts, and usage

Why

The original Ralph design relies on Amp's auto-handoff feature and external bash scripts (ralph.sh) to spawn fresh instances. Claude Desktop has no equivalent mechanisms, so this PR builds the execution workflow directly into the Skills, making Ralph tool-agnostic.

Testing

  • Skills follow progressive disclosure patterns (HANDOFF.md and CONTEXT.md load only when needed)
  • Execution workflow matches original prompt.md structure
  • State persistence patterns align with existing Ralph conventions

Transform ralph skill from PRD converter to full autonomous execution workflow.
Add context detection, handoff management, and session bootstrap procedures.

- Enhance ralph skill with complete execution workflow (11-step process)
- Add context management and handoff procedures for Claude Desktop
- Create HANDOFF.md template for session continuation
- Create CONTEXT.md guide for context detection patterns
- Update prd skill with story sizing guidance for context limits
- Add comprehensive README.md for skills directory

This enables Ralph to work with Claude Desktop without requiring Amp's
auto-handoff feature or external bash scripts.
@PBLIZZ
Copy link

PBLIZZ commented Jan 15, 2026

just add this to ralph.sh and

Run claude code with the ralph prompt

OUTPUT=$(
cat "$SCRIPT_DIR/prompt.md" |
claude -p --dangerously-skip-permissions 2>&1 |
tee /dev/stderr
) || true

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants