Skip to content

docs: clarify setup instructions as distinct approaches #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Alex-Alaniz wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: clarify setup instructions as distinct approaches #42

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 15 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,11 @@ Based on [Geoffrey Huntley's Ralph pattern](https://ghuntley.com/ralph/).

## Setup

### Option 1: Copy to your project
Choose **one** of the following approaches:

Copy the ralph files into your project:
### Approach A: Project-local setup (recommended for teams)

Keep everything in your project repository so teammates get Ralph automatically:

```bash
# From your project root
Expand All @@ -33,24 +35,31 @@ cp /path/to/ralph/prompt.md scripts/ralph/prompt.md # For Amp
cp /path/to/ralph/CLAUDE.md scripts/ralph/CLAUDE.md # For Claude Code

chmod +x scripts/ralph/ralph.sh

# Also copy the skills to your project
cp -r /path/to/ralph/skills .claude/skills/ # For Claude Code
# OR
cp -r /path/to/ralph/skills .amp/skills/ # For Amp
Comment on lines +40 to +42
Copy link

@greptile-apps greptile-apps bot Jan 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

logic: incorrect path - creates nested skills/skills/ directory structure

copying the entire skills directory will create .claude/skills/skills/prd/ instead of .claude/skills/prd/

Suggested change
cp -r /path/to/ralph/skills .claude/skills/ # For Claude Code
# OR
cp -r /path/to/ralph/skills .amp/skills/ # For Amp
# Also copy the skills to your project
cp -r /path/to/ralph/skills/prd .claude/skills/ # For Claude Code
cp -r /path/to/ralph/skills/ralph .claude/skills/
# OR
cp -r /path/to/ralph/skills/prd .amp/skills/ # For Amp
cp -r /path/to/ralph/skills/ralph .amp/skills/
Prompt To Fix With AI 
This is a comment left during a code review.
Path: README.md
Line: 40:42

Comment:
**logic:** incorrect path - creates nested `skills/skills/` directory structure

copying the entire `skills` directory will create `.claude/skills/skills/prd/` instead of `.claude/skills/prd/`

```suggestion
# Also copy the skills to your project
cp -r /path/to/ralph/skills/prd .claude/skills/    # For Claude Code
cp -r /path/to/ralph/skills/ralph .claude/skills/
# OR
cp -r /path/to/ralph/skills/prd .amp/skills/       # For Amp
cp -r /path/to/ralph/skills/ralph .amp/skills/
```

How can I resolve this? If you propose a fix, please make it concise.

```

### Option 2: Install skills globally
### Approach B: Global setup (for personal use across projects)

Copy the skills to your Amp or Claude config for use across all projects:
Install skills globally so they're available in any project:

For AMP
**For Amp:**
```bash
cp -r skills/prd ~/.config/amp/skills/
cp -r skills/ralph ~/.config/amp/skills/
```

For Claude Code
**For Claude Code:**
```bash
cp -r skills/prd ~/.claude/skills/
cp -r skills/ralph ~/.claude/skills/
```

Then copy `ralph.sh` and the prompt template to each project as needed.

### Configure Amp auto-handoff (recommended)

Add to `~/.config/amp/settings.json`:
Expand Down