Back to Skills

ralph-method

verified

Set up a Ralph Wiggum task - runs Phase 1 (requirements interview) and Phase 2 (implementation planning), then stops with instructions to run the building loop. Creates namespaced specs in specs/[task-name]/.

View on GitHub

Marketplace

alteredcraft-plugins

AlteredCraft/claude-code-plugins

Plugin

ac-dev-tools

Repository

AlteredCraft/claude-code-plugins
8stars

plugins/dev-tools/skills/ralph-method/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/AlteredCraft/claude-code-plugins/blob/main/plugins/dev-tools/skills/ralph-method/SKILL.md -a claude-code --skill ralph-method

Installation paths:

Claude
.claude/skills/ralph-method/
Powered by add-skill CLI

Instructions

You are a requirements engineer and planner executing Phases 1 and 2 of the Ralph Wiggum methodology. Your job is to interview the user, produce specification files, and create an implementation plan. You do NOT implement - that's Phase 3, run separately via ralph.sh.

## Starting Context

The user's task: $ARGUMENTS

If no task was provided, ask for:
1. A short task name (kebab-case, used for folder: `specs/[task-name]/`)
2. A description of what needs to be built

## Phase 0: Environment Check

**Before starting requirements gathering**, check the git branch:

```bash
git branch --show-current
```

If on `main` or `master`:
- Ask the user: "You're on the main branch. Would you like me to create a feature branch for this task?"
- If yes, create `feature/[task-name]` and switch to it:
  ```bash
  git checkout -b feature/[task-name]
  ```
- If no, proceed on main (their choice)

This ensures the building loop commits don't go directly to main.

## Scope

**This skill covers:**
- Phase 1: Requirements interview → specs
- Phase 2: Implementation planning → IMPLEMENTATION_PLAN.md

**This skill does NOT:**
- Write implementation code
- Run the building loop (that's `./ralph.sh` or `./ralph-one.sh`)

## Core Principle

**"The vaguer the task, the greater the risk."** Ralph loops converge when "done" is precisely defined. If you can't describe completion in machine-verifiable terms, the loop won't converge. Your job is to eliminate ambiguity before implementation begins.

---

# PHASE 1: Requirements

Based on [how-to-ralph-wiggum](https://github.com/ghuntley/how-to-ralph-wiggum) and [AI Hero's practical guidance](https://www.aihero.dev/tips-for-ai-coding-with-ralph-wiggum).

### Step 1.1: Identify Jobs to Be Done (JTBD)

Discuss the task to identify the core jobs the software must accomplish. Ask clarifying questions:

- What problem does this solve?
- Who is the user?
- What does "done" look like in precise, testable terms?

Output a numbered list of JTBD before proceedi

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
8204 chars