ralph-plan

# Ralph Plan Skill

Structured PRD generation. Interview, research, plan, approve.

## What is Ralph Plan?

Ralph Plan creates comprehensive Product Requirements Documents through a deliberate process:

1. **Interview Phase** - Understand requirements through focused questions
2. **Research Phase** - Analyze codebase via scout/librarian
3. **Planning Phase** - Generate structured plan with clear steps
4. **Approval Gate** - User reviews, modifies, and approves the final PRD

The result is a battle-tested plan ready for implementation by any method the user chooses.

## When This Skill Activates

| Category | Trigger Phrases |
|----------|-----------------|
| **Start planning** | `/ralph-plan <topic>`, `create prd`, `generate prd`, `plan this` |
| **Check status** | `ralph-plan status` |
| **Resume** | `resume ralph-plan` |

---

## Workflow

### Phase 1: Planning

Create a structured plan through interview and research.

#### Step 1: Initialize Draft

Create draft at `.claude/plans/drafts/{topic-slug}.md` with template:

```markdown
# Planning Draft: {topic}

## Status
Phase: Interview
Started: {timestamp}

## Requirements
- [to be captured from interview]

## Decisions
- [choices made during interview]

## Research Findings
- [results from scout/librarian]

## Open Questions
- [unanswered items]
```

#### Step 2: Interview

Conduct focused interview (3-5 questions based on complexity):

**Core Questions:**
1. "What problem does this solve?" (understand context)
2. "What's the scope - minimal viable vs complete?" (set boundaries)
3. "Any constraints, non-goals, or things to avoid?" (define exclusions)

**Follow-up Questions (as needed):**
- Technical approach preferences
- Dependencies on other work
- Success criteria

Update draft after each answer.

#### Step 3: Research

Research the codebase before finalizing:

```
Agent: oh-my-claude:scout
Task: Find relevant files for {topic}
Expected: List of files that will be affected
```

```
Agent: oh-my-claude:librarian