Ralph Prompt Builder (Master Orchestrator)

Overview

Master skill for generating prompts optimized for the Ralph Wiggum autonomous loop technique. This orchestrator analyzes your task description and routes to the appropriate specialized generator:

Quick Start

Generate any Ralph prompt:

Use ralph-prompt-builder to create a prompt for: [describe your task]

Example:

Use ralph-prompt-builder to create a prompt for: Implementing user authentication with JWT for our Express API

The skill will:

1. Classify your task
2. Route to the appropriate generator
3. Guide you through required inputs
4. Output a ready-to-use Ralph prompt

Task Classification

How Tasks Are Classified

Classification Questions

To classify your task, consider:

1. Is this creating something new from scratch or modifying existing code?

   • New from scratch → Project or Multi-Task
   • Modifying existing → Single Task or Multi-Task

2. How many distinct deliverables?

   • One deliverable → Single Task
   • 2-5 related deliverables → Multi-Task
   • Complete application/tool → Project
   • Analysis document → Research

3. Does it involve investigation before action?

   • Yes, research required → Research
   • No, implementation focus → Single/Multi/Project

4. What's the completion criteria?

   • Tests pass → Single Task
   • Multiple features working → Multi-Task
   • Complete app running → Project
   • Document produced → Research

Classification Examples

Single Task Examples

• "Fix the race condition in token refresh"
• "Add pagination to the users endpoint"
• "Refactor database queries to use async/await"
• "Write tests for the auth module"
• "Optimize the image upload function"

Multi-Task Examples

• "Implement CRUD for Products resource"
• "Add login, signup, logout, and password reset"
• "Set up CI/CD pipeline with lint, test, build, deploy"
• "Add validation, error handling, and logging to API"
• "Create user, profile, and settings endpoints"

Project Examples

• "Build a REST API for a todo list application"
• "Create a CLI tool for database migrations"
• "Build a URL shortener service"
• "Create a markdown documentation generator"
• "Build an authentication microservice"

Research Examples

• "Analyze the codebase for security vulnerabilities"
• "Compare React vs Vue vs Svelte for our needs"
• "Create a migration plan from MongoDB to PostgreSQL"
• "Audit dependencies for outdated packages"
• "Document the current API architecture"

Workflow

Step 1: Describe Your Task

Provide a description including:

• What needs to be done
• What technology/context
• Any specific requirements
• Desired outcome

Template:

Task: [What you want to accomplish]
Context: [Relevant background - tech stack, existing code, etc.]
Requirements: [Specific requirements or constraints]
Outcome: [What success looks like]

Step 2: Review Classification

The orchestrator will classify your task and explain why:

CLASSIFICATION: [Task Type]
REASONING: [Why this classification]
GENERATOR: ralph-prompt-[type]

Does this classification look correct? If not, specify your preferred type.

Step 3: Provide Generator Inputs

Each generator requires specific inputs:

Single Task:

• Task description
• Success criteria (how to verify)
• Completion promise text

Multi-Task:

• List of tasks
• Dependencies between tasks
• Final completion promise

Project:

• Project description
• Tech stack
• Feature list
• Completion promise

Research:

• Research objective
• Scope (in/out)
• Deliverable format
• Completion promise

Step 4: Generate & Review

The appropriate generator creates the prompt. Review and customize:

1. Verify requirements are complete
2. Check verification commands are correct
3. Confirm completion criteria match your needs
4. Adjust max-iterations recommendation

Step 5: Execute with Ralph

/ralph-wiggum:ralph-loop "[generated prompt]" --completion-promise "[YOUR_PROMISE]" --max-iterations [recommended]

Generator Summaries

ralph-prompt-single-task

Purpose: Focused

...