Aan de Slag met Ralph Wiggum Deel 4: Geavanceerde Patronen & Probleemoplossing

Je hebt de basis geleerd en de methodologie onder de knie gekregen. Nu duiken we in geavanceerde technieken die hobbyisten van professionals onderscheiden.

Dit is je geavanceerde draaiboek—technieken voor complexe scenario's, uitgebreide probleemoplossing en enterprise-grade patronen die je tot een Ralph-expert maken.

Geavanceerde Prompt Engineering

Het Constraint Sandwich-patroon

Een van de meest effectieve patronen voor Ralph-prompts structureert beperkingen rondom de taak:

# BUILDING MODE

## Pre-Constraints (What to consider first)
- Read IMPLEMENTATION_PLAN.md
- Check progress.txt for prior learnings
- Study existing patterns in the codebase
- Verify dependencies are installed

## Core Task
[Your main instruction here]

## Quality Gates (Must pass before proceeding)
- All tests pass: npm test
- Type check passes: npm run type-check
- Linter passes: npm run lint
- No console.logs or debugger statements remain

## Post-Task Actions
- Commit with semantic message
- Update IMPLEMENTATION_PLAN.md
- Append learning to progress.txt

Dit patroon werkt omdat het Ralph's denkproces in de juiste volgorde stuurt, zoals gedocumenteerd in 11 Tips for AI Coding with Ralph Wiggum.

Bekijk echte voorbeelden: Blader door productie-promptbestanden van de community:

• snarktank/ralph — Complete prompt.md met constraint-structuur
• ClaytonFarr/ralph-playbook — PROMPT_plan.md en PROMPT_build.md templates
• peteristhegreat's gist — Ralph coding agent setup

De Socratische Prompttechniek

In plaats van Ralph precies te vertellen wat het moet doen, stel je vragen die tot betere oplossingen leiden:

Zwakke prompt:

Implement caching for the API.

Sterke prompt (Socratisch):

We need to improve API performance. Before implementing:

1. What are the slowest endpoints currently? (Analyze with profiler)
2. Which data changes frequently vs rarely?
3. What caching strategy best fits this access pattern?
4. Where should the cache layer live (app, Redis, CDN)?

After analysis, implement the most appropriate solution with tests.

Dit dwingt Ralph om systematisch door het probleem heen te denken, zoals benadrukt in The Ralph Playbook.

Het Escape Hatch-patroon

Geef Ralph altijd een uitweg als het vastloopt:

## If You Encounter a Blocker

1. Document the issue in progress.txt
2. Create a TODO.md file with:
   - What you tried
   - Why it didn't work
   - What needs human decision
3. Mark the current task as "blocked" in IMPLEMENTATION_PLAN.md
4. Move to the next independent task

DO NOT spin indefinitely on unsolvable problems.

Het Learning Accumulation-patroon

Structureer progress.txt om kennis op te bouwen:

After completing each task, append:

## [TIMESTAMP] [TASK-ID]: [Task Title]

### What Was Built
- Feature/change summary

### Technical Decisions
- Why this approach over alternatives

### Challenges & Solutions
- What went wrong and how it was fixed

### Learnings for Next Tasks
- Patterns to reuse
- Pitfalls to avoid

### Dependencies/Prerequisites for Related Tasks
- What's now available for other tasks

Dit creëert een kennisbank waar Ralph naar verwijst, waardoor herhaalde fouten worden voorkomen.

Geavanceerde Bestandsorganisatie

Multi-Mode Projectstructuur

Voor complexe projecten die alle drie de fases gebruiken:

project-root/
├── ralph/                    # Ralph-specific files
│   ├── phases/
│   │   ├── PROMPT_plan.md
│   │   ├── PROMPT_build.md
│   │   └── PROMPT_refactor.md  # Optional: separate refactor mode
│   ├── IMPLEMENTATION_PLAN.md
│   ├── progress.txt
│   ├── blockers.md             # Current blockers needing human input
│   └── loop.sh                 # Orchestrator script
├── specs/                    # Requirements
│   ├── architecture.md
│   ├── features/
│   │   ├── auth.md
│   │   └── api.md
│   └── non-functional.md     # Performance, security, etc.
├── docs/                     # Generated documentation
├── src/                      # Application code
└── tests/                    # Test suite

Het Checkpoint-systeem

Maak checkpoints aan voor langlopende projecten:

# ralph/checkpoints/checkpoint-YYYY-MM-DD-description.md

## Project State
- Branch: feature/user-management
- Commit: abc123
- Tasks completed: 15/30
- Blockers: None

## Ralph Configuration
- Mode: Building
- Max iterations: 100
- Completion promise: "MILESTONE COMPLETE"

## Next Steps
1. Complete user role management (TASK-016 to TASK-020)
2. Then regenerate plan for Phase 2 features
3. Consider splitting into separate Ralph session

## Learnings So Far
- Database schema changes require migration strategy
- Test data setup takes 2-3 iterations
- Auth patterns now stable and reusable

PRD's Opzetten voor Ralph

Een goed gestructureerd PRD is cruciaal voor het succes van Ralph. Dit is een alternatief voor de specs/*.md + IMPLEMENTATION_PLAN.md-aanpak—sommige teams geven de voorkeur aan JSON voor machine-leesbaarheid.

Hulpmiddelen: Ralph TUI bevat /ralph-tui-prd om interactief PRD's te maken en /ralph-tui-create-json om ze naar JSON te converteren. snarktank/ralph biedt PRD-gestuurd taakbeheer met automatische branching en flowchart-visualisatie.

prd.json Template

{
  "project": "Todo API",
  "schema_version": "2.0",
  "final_tests": ["npm test", "npm run type-check", "npm run lint"],
  "stories": [
    {
      "id": "S001",
      "priority": 1,
      "title": "User Authentication",
      "category": "backend",
      "description": "Implement JWT-based authentication with login/logout",
      "acceptance": [
        "User can register with email/password",
        "User can login and receive JWT token",
        "Protected routes require valid JWT",
        "User can logout and invalidate token"
      ],
      "steps_to_verify": [
        "Run: npm test -- auth.test.ts",
        "Verify all 12 auth tests pass",
        "Check JWT is stored in httpOnly cookie",
        "Verify token expiry works correctly"
      ],
      "tests": ["npm test -- auth.test.ts"],
      "estimated_complexity": "medium",
      "depends_on": [],
      "passes": false
    },
    {
      "id": "S002",
      "priority": 2,
      "title": "Todo CRUD Endpoints",
      "category": "backend",
      "description": "Create POST, GET, PUT, DELETE endpoints for todos",
      "acceptance": [
        "POST /api/todos creates a todo",
        "GET /api/todos returns user's todos only",
        "PUT /api/todos/:id updates a todo",
        "DELETE /api/todos/:id deletes a todo"
      ],
      "steps_to_verify": [
        "Run: npm test -- todos.test.ts",
        "Test with Postman or curl",
        "Verify authorization works"
      ],
      "tests": ["npm test -- todos.test.ts"],
      "estimated_complexity": "medium",
      "depends_on": ["S001"],
      "passes": false
    }
  ]
}

Belangrijke PRD-principes

Binaire Geslaagd/Gefaald-criteria: Elke taak heeft geautomatiseerde verificatie nodig. Zoals The Ralph Playbook benadrukt: "Maak het beter" is niet testbaar—"Alle tests slagen met 80%+ dekking" wel.

Atomaire taken: Als een taak 500+ regels code vereist, splits hem dan op. Elk verhaal zou in 2-3 iteraties klaar moeten zijn.

Het passes-veld: Ralph zet dit op true wanneer het klaar is. De loop gaat door totdat alle taken slagen.

Testvereisten: Elk verhaal moet specificeren hoe voltooiing automatisch geverifieerd wordt. Geen handmatige verificatiestappen.

Veelvoorkomende Valkuilen en Hoe Je Ze Vermijdt

Te Ambitieus Beginnen

Fout: 50 iteraties draaien op je eerste Ralph-project.

Oplossing: Begin met 10-20 iteraties om kosten en gedrag te begrijpen. Zoals gedocumenteerd in community tips, kan een loop van 50 iteraties $50-100+ kosten.

Vage Voltooiingscriteria

Fout: "Maak de app sneller" of "Verbeter de UI"

Oplossing: Gebruik specifieke, testbare criteria:

• ✅ "Verlaag API-responstijd tot onder 200ms (geverifieerd door load tests)"
• ✅ "Alle Lighthouse-scores boven 90"
• ✅ "Testdekking boven 80% op alle modules"

Geen Geautomatiseerde Verificatie

Fout: Taken die menselijk oordeel vereisen, zoals "maak het er mooi uit laten zien"

Oplossing: Ralph heeft binaire geslaagd/gefaald-condities nodig. Als je er geen geautomatiseerde test voor kunt schrijven, kan Ralph het niet verifiëren. Zoals The Ralph Playbook stelt: "Backpressure beats direction."

Taken Te Groot

Fout: "Bouw het hele authenticatiesysteem" als één taak

Oplossing: Splits op in kleinere verhalen:

• S001: Gebruikersregistratie-endpoint
• S002: Login-endpoint met JWT
• S003: Token-vernieuwingsmechanisme
• S004: Wachtwoord-resetflow
• S005: E-mailverificatie

Contextlimieten Negeren

Fout: Ralph oneindig laten draaien zonder verse context

Oplossing: Gebruik de Bash-loopmethode in plaats van de plugin voor langlopende projecten—elke iteratie krijgt een vers contextvenster. Dit is een belangrijk inzicht uit Geoffrey Huntley's guide.

Wanneer welke methode gebruiken:

• < 20 iteraties: Plugin (/ralph-loop) is prima—eenvoudigere setup, context blijft beheersbaar
• 20-40 iteraties: Beide werken; bash-loop heeft de voorkeur voor consistentie
• > 40 iteraties: Bash-loop vereist—voorkomt contextdegradatie en hallucinatie

De plugin draait alles in één enkel contextvenster, dat na verloop van tijd volloopt. De bash-loopmethode start een verse Claude-instantie per iteratie, waarbij alleen de codebase-status wordt overgedragen.

Geen Kostenmonitoring

Fout: API-uitgaven niet bijhouden tijdens ontwikkeling

Oplossing: Stel factureringswaarschuwingen in en begin met lage iteratieaantallen. Monitor kosten per iteratie. Houd je uitgaven bij op https://console.anthropic.com

Verkeerde Taaktypen

Goede Ralph-taken:

• Tests migreren van Jest naar Vitest
• CRUD-endpoints toevoegen met tests
• Goed gespecificeerde features implementeren
• Refactoren met bestaande testdekking

Slechte Ralph-taken:

• "Zoek uit waarom de app traag is" (exploratie)
• "Maak de UI mooier" (subjectief)
• "Fix deze rare bug" (vereist diepe debugging-context)
• UX-beslissingen die esthetisch oordeel vereisen

Het Thrashing-probleem

Symptoom: Ralph loopt vast in een lus—dezelfde fout, dezelfde fix-poging, dezelfde mislukking.

Oplossingen:

• Stel --max-iterations in om schade te beperken
• Controleer je tests—zijn ze te strikt of onduidelijk?
• Splits de taak op in kleinere, meer atomaire stukken
• Voeg expliciete debugstappen toe aan je prompt
• Controleer of afhankelijkheden correct geïnstalleerd zijn

Uitgebreide Probleemoplossingsgids

Probleem: Ralph Maakt Steeds Dezelfde Fout

Symptomen:

• Dezelfde fout over meerdere iteraties
• Tests falen met identiek bericht
• Ralph probeert steeds dezelfde aanpak

Oorzaken:

1. Test is dubbelzinnig of onjuist geschreven
2. Prompt bevat geen foutfeedback
3. Ralph mist context over waarom de aanpak faalt

Oplossingen:

Fix 1: Werk de test bij

// Bad: Vague assertion
expect(result).toBeTruthy();

// Good: Specific assertion
expect(result).toEqual({
  id: expect.any(String),
  email: 'test@example.com',
  createdAt: expect.any(Date)
});

Fix 2: Voeg foutfeedback toe aan de prompt

If tests fail:
1. Read the test output carefully
2. Identify the specific assertion that failed
3. Check if you're testing the wrong behavior
4. Try a different approach if current one fails twice

Fix 3: Voeg expliciete debugstappen toe

Before implementing:
1. Add console.log to see actual vs expected values
2. Run test in isolation: npm test -- --testNamePattern="specific test"
3. Verify mock data matches what code expects

Fix 4: Gebruik het Escape Hatch-patroon

Als Ralph na meerdere pogingen blijft falen, gebruik dan het Escape Hatch-patroon om de blokkade te documenteren en door te gaan naar de volgende taak in plaats van eindeloos rond te draaien.

Probleem: Ralph Genereert Onveilige Code

Symptomen:

• Wachtwoorden opgeslagen als platte tekst
• SQL-injectiekwetsbaarheden
• Ontbrekende authenticatiecontroles
• CORS ingesteld op "*"

Preventie:

Voeg een beveiligingschecklist toe aan de prompt:

## Security Checklist (MUST verify before committing)

Authentication:
- [ ] Passwords hashed with bcrypt (min 12 rounds)
- [ ] JWTs signed with secure secret (min 32 chars)
- [ ] httpOnly cookies for token storage
- [ ] No secrets in code (use env variables)

Authorization:
- [ ] All protected routes have auth middleware
- [ ] User can only access own resources
- [ ] Admin endpoints check role

Input Validation:
- [ ] All user input validated with Zod/Joi
- [ ] SQL/NoSQL injection prevented (use ORMs)
- [ ] XSS prevention (sanitize HTML)
- [ ] Rate limiting on sensitive endpoints

CORS:
- [ ] Specific origins only (not "*")
- [ ] Credentials: true only with specific origin

Probleem: Contextvenster Uitgeput

Symptomen:

• Ralph begint delen van prompts te negeren
• Kwaliteit neemt af na iteratie 30-40
• Ralph stopt met het volgen van beperkingen

Zoals JeredBlu's guide uitlegt, is dit precies waarom de bash-loopmethode met verse context per iteratie "fundamenteel beter is voor langlopende taken."

Oplossingen:

Oplossing 1: Gebruik de Bash-loopmethode

# loop.sh - Fresh context each iteration
while true; do
  claude < PROMPT_build.md

  # Check if done
  if grep -q "ALL TASKS COMPLETE" progress.txt; then
    echo "Build complete!"
    break
  fi

  sleep 2
done

Oplossing 2: Contextcompressie-prompt

Over /compact: Het /compact-commando comprimeert je gesprekscontext, zodat je kunt doorwerken zonder belangrijke details te verliezen. Gebruik het proactief voordat je contextlimieten bereikt. Zie Mastery Part 2 voor wanneer je /compact vs /clear moet gebruiken.

Every 10 iterations, before continuing:

1. Run: /compact to compress context
2. Summarize current state:
   - Tasks completed
   - Current task in progress
   - Key patterns established
3. Continue with fresh focus

Oplossing 3: Splits Lange Sessies

# Session 1: Core features (Tasks 1-10)
/ralph-loop "$(cat PROMPT_build.md)" --max-iterations 30

# Review, commit, take a break

# Session 2: Advanced features (Tasks 11-20)
/ralph-loop "$(cat PROMPT_build.md)" --max-iterations 30

Probleem: Ralph Stopt Niet (Thrashing)

Symptomen:

• Bereikt max-iterations zonder af te ronden
• Maakt wijzigingen, draait ze terug, herhaalt
• Progress.txt toont circulaire logica

Voor diepere analyse van Ralph's besluitvorming bij thrashing laat Braintrust's debugging guide zien hoe je LLM-observabiliteitstools kunt gebruiken om te begrijpen wat er gebeurt.

Diagnose:

Controleer progress.txt op patronen:

[14:30] Trying approach A...
[14:35] Approach A failed, trying approach B...
[14:40] Approach B failed, trying approach A again...

Oplossingen:

Oplossing 1: Voeg poging-tracking toe

Track attempts in progress.txt:

[Iteration X] TASK-005: Attempt #1 - Trying JWT with RSA
[Iteration Y] TASK-005: Attempt #2 - Trying JWT with HS256
[Iteration Z] TASK-005: Attempt #3 - Adding fallback

If task has 3 failed attempts:
1. Mark task as "blocked"
2. Document in blockers.md
3. Move to next task

Oplossing 2: Vereenvoudig acceptatiecriteria

# Too complex (causes thrashing)
- API must be performant, secure, and scalable

# Specific (Ralph can verify)
- API responds in <200ms (verified by tests)
- All endpoints require authentication (verified by tests)
- Can handle 100 concurrent requests (load test passes)

Probleem: Testdekking Daalt na Verloop van Tijd

Symptomen:

• Vroege taken hebben uitstekende tests
• Latere taken hebben minimale tests
• Dekking onder het doel

Oorzaak: Ralph geeft prioriteit aan opleveren boven testen als het niet wordt afgedwongen.

Oplossing: Voeg een testdekkingspoort toe aan de prompt:

## Test Requirements (STRICT)

Every commit MUST include tests for:
1. Happy path (success case)
2. Error cases (4xx, 5xx)
3. Edge cases (empty input, missing fields)
4. Authorization (access control)

Before committing, run: npm test -- --coverage

MINIMUM COVERAGE REQUIRED:
- Statements: 80%
- Branches: 75%
- Functions: 80%
- Lines: 80%

If coverage drops below threshold:
- DO NOT commit
- Add missing tests
- Re-run coverage

Probleem: Ralph Negeert Bestaande Patronen

Symptomen:

• Nieuwe code gebruikt andere patronen dan bestaande code
• Inconsistente bestandsstructuur
• Meerdere manieren om hetzelfde te doen

Oplossing: Voeg patroondocumentatie toe aan je prompt. Neem de daadwerkelijke bestandsstructuur en naamgevingsconventies van je project op zodat Ralph ze consistent volgt:

## Codebase Patterns (MUST FOLLOW)

Before implementing any feature:
1. Study existing features as reference (e.g., the user module)
2. Follow the same directory structure and file organization
3. Reuse established naming conventions and code patterns
4. Only deviate if specs explicitly require it

If unsure about a pattern, check how similar features are implemented
in the codebase before writing new code.

Geavanceerde Ralph-TUI Configuratie

Ralph-TUI ondersteunt aanpassingen via een configuratiebestand in ~/.ralph-tui/config.json.

Aangepaste Taakprioriteiten

Overschrijf de standaard prioriteitsvolgorde:

{
  "taskPriority": {
    "TASK-001": 10,
    "TASK-005": 9,
    "TASK-002": 8
  }
}

Ralph-TUI toont taken in deze volgorde, zelfs als IMPLEMENTATION_PLAN.md ze anders opsomt.

Uitvoerfiltering

Filter logregels op trefwoord of regex:

{
  "logFilters": {
    "exclude": ["Reading", "Skipping"],
    "include": ["✓", "✗", "completed", "failed"]
  }
}

Dit verbergt ruis (bestandslezingen) en benadrukt belangrijke gebeurtenissen (testresultaten, taakvoltooiing).

Exportformaten

Kies het logexportformaat:

{
  "exportFormat": "markdown"
}

Opties: txt, markdown, json, html

Markdown-export genereert:

# Ralph-TUI Log Export
**Project:** my-saas-app
**Duration:** 2h 15m
**Tasks Completed:** 12 / 15

## Iteration 1
[10:05:12] Reading specs...
...

Integratie met Andere Tools

Stuur Ralph-TUI-events naar externe systemen:

{
  "webhooks": {
    "taskComplete": "https://myapp.com/api/ralph-task-complete",
    "testFailure": "https://myapp.com/api/ralph-test-failed"
  }
}

Wanneer Ralph een taak voltooit, stuurt Ralph-TUI een POST naar je webhook:

{
  "event": "taskComplete",
  "taskId": "TASK-003",
  "timestamp": "2026-01-16T10:30:45Z",
  "iteration": 12
}

Toepassingen:

• Projectmanagementtools bijwerken (Linear, Jira)
• Slack-notificaties versturen
• CI/CD-pipelines triggeren bij taakvoltooiing

Probleemoplossing voor Ralph-TUI

Ralph-TUI Detecteert de Ralph-loop Niet

Symptoom: ralph-tui run toont "Waiting for Ralph loop..." oneindig.

Oorzaak: Ralph-TUI zoekt naar een draaiend ralph-proces in de huidige directory. Als je Ralph in een andere directory hebt gestart, vindt Ralph-TUI het niet.

Oplossing:

1. Voer ps aux | grep ralph uit om het Ralph-proces te vinden
2. Noteer de werkdirectory via lsof -p <pid>
3. cd naar die directory en voer ralph-tui run opnieuw uit

Alternatief: Specificeer expliciet het Ralph-proces-ID:

ralph-tui run --pid 12345

Sessie Verloren/Corrupt

Symptoom: Ralph-TUI toont "Session data corrupted" bij het opstarten.

Oorzaak: Ralph-TUI slaat sessiestatus op in ~/.ralph-tui/sessions/<project-name>.json. Als Ralph halverwege een iteratie crasht, kan het sessiebestand incompleet zijn.

Oplossing:

1. Verwijder de corrupte sessie: rm ~/.ralph-tui/sessions/my-project.json
2. Herstart Ralph-TUI: ralph-tui run

Ralph-TUI maakt een nieuwe sessie aan, maar je verliest de historische context (eerdere iteraties verschijnen niet in de logs).

Preventie: Schakel sessieback-ups in via de configuratie:

{
  "sessionBackups": {
    "enabled": true,
    "interval": 300
  }
}

Dit maakt elke 5 minuten back-ups aan in ~/.ralph-tui/sessions/backups/.

Prestatieproblemen met Grote Logs

Symptoom: Ralph-TUI wordt traag of reageert niet meer na enkele uren monitoring.

Oorzaak: De logbuffer groeit tot 100.000+ regels, waardoor rendering vertraagt.

Oplossing:

1. Exporteer logs periodiek: druk elk uur op e
2. Schakel logrotatie in via de configuratie:

{
  "logRotation": {
    "maxLines": 10000,
    "archiveOld": true
  }
}

Wanneer logs 10.000 regels bereiken, archiveert Ralph-TUI oude logs naar ~/.ralph-tui/archives/ en leegt de buffer.

Alternatief: Vergroot de terminalbuffer als je terminal dit ondersteunt (bijv. iTerm2 → Preferences → Profiles → Terminal → Scrollback lines).

Poortconflicten

Symptoom: ralph-tui run faalt met "Port 9876 already in use".

Oorzaak: Ralph-TUI gebruikt poort 9876 voor interne communicatie. Een ander proces gebruikt deze.

Oplossing:

1. Vind het conflicterende proces: lsof -i :9876
2. Stop het of gebruik een andere poort:

ralph-tui run --port 9999

Permanente oplossing: Stel een standaardpoort in via de configuratie:

{
  "port": 9999
}

Headless Visuele Feedback met Playwright MCP

Voor bash-loop-runs zonder zichtbare browser raadt JeredBlu Playwright MCP aan voor visuele verificatie.

Wat is MCP? Model Context Protocol (MCP) is een open standaard waarmee Claude verbinding kan maken met externe diensten—databases, API's, browserautomatisering en meer. MCP-servers breiden Claude's mogelijkheden uit voorbij tekstverwerking. Zie Mastery Part 7: MCP Servers voor setup en configuratie.

Maak .mcp.json aan in je project-root:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--headless", "--output-dir", "screenshots"]
    }
  }
}

Verwijs er vervolgens naar in je PROMPT_build.md:

After implementing, use Playwright to:
1. Navigate to the local server URL
2. Take a screenshot: screenshots/[task-name].png

Include the screenshot filename in your progress.txt entry.

Dit geeft je visuele verificatie van Ralph's werk zonder dat je Claude for Chrome of een zichtbaar browservenster nodig hebt. Screenshots verzamelen zich in je projectmap en bieden een visuele audit trail van wat Ralph heeft gebouwd.

Wanneer Playwright MCP vs Ralph-TUI gebruiken:

• Ralph-TUI: Realtime logmonitoring, taakorkestratie, toetsenbordbesturing
• Playwright MCP: Headless visuele verificatie, screenshot-audit trails, CI/CD-integratie

Beide tools vullen elkaar aan—gebruik Ralph-TUI voor live monitoring en Playwright MCP voor visuele verificatie.

Enterprise-patronen

Multi-Developer Ralph-coördinatie

Wanneer meerdere ontwikkelaars Ralph op hetzelfde project gebruiken, wordt coördinatie cruciaal. Er bestaan verschillende tools hiervoor:

• ralph-orchestrator — Ondersteunt 7+ AI-backends (Claude, Gemini, Copilot, etc.) met een persona/hat-systeem voor gespecialiseerde taken
• multi-agent-ralph-loop — Parallelle werkstroom-orkestratie voor het gelijktijdig draaien van meerdere Ralph-instanties
• ralph-loop-agent — Vercel's TypeScript SDK-wrapper voor programmatische controle

Patroon 1: Feature Branch Ralph

# Developer A
git checkout -b feature/auth
# Run Ralph for auth tasks
./loop.sh build --tasks "TASK-001 to TASK-005"

# Developer B (different branch)
git checkout -b feature/payments
# Run Ralph for payment tasks
./loop.sh build --tasks "TASK-010 to TASK-015"

# Merge both when complete

Patroon 2: Gedeelde Voortgangsregistratie

# team-progress.md

## Active Ralph Sessions

### Developer: Alice
- Branch: feature/auth
- Tasks: TASK-001 to TASK-005
- Status: In Progress (3/5 complete)
- ETA: 2 hours

### Developer: Bob
- Branch: feature/payments
- Tasks: TASK-010 to TASK-015
- Status: Complete
- Ready for: Code review

## Blocked Tasks Needing Team Discussion
- TASK-008: Payment provider API unclear
- TASK-014: Architecture decision needed

Ralph + CI/CD-integratie

Automatiseer Ralph-runs in je pipeline:

# .github/workflows/ralph-build.yml
name: Ralph Autonomous Build

on:
  workflow_dispatch:
    inputs:
      tasks:
        description: 'Task range (e.g., TASK-001 to TASK-005)'
        required: true

jobs:
  ralph-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Setup Claude Code
        run: curl -fsSL https://claude.ai/install.sh | bash

      - name: Run Ralph Loop
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          ./loop.sh build \
            --tasks "${{ github.event.inputs.tasks }}" \
            --max-iterations 30

      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v5
        with:
          title: "Ralph Build: ${{ github.event.inputs.tasks }}"
          body: |
            Autonomous build completed by Ralph Wiggum

            Tasks completed:
            ${{ github.event.inputs.tasks }}

            See progress.txt for details.

Een Claude-abonnement Kiezen voor Ralph

Ralph werkt met Claude-abonnementen of API-toegang. Hier is de snelle gids:

• Claude Pro ($20/mnd) — 10-30 iteraties/sessie, goed voor leren en zijprojecten
• Claude Max 5x ($100/mnd) — 50-150 iteraties/sessie, ideaal voor dagelijkse ontwikkeling
• Claude Max 20x ($200/mnd) — 200-600+ iteraties/sessie, professionele langlopende loops

Aanbeveling: Begin met Pro om de workflow te leren. Upgrade naar Max 5x zodra je Ralph dagelijks gebruikt—het is 5x de capaciteit voor 5x de prijs, wat eerlijk is. Ga voor Max 20x als je klantwerk doet of uitgebreide autonome sessies nodig hebt.

De ROI-berekening: Voor $200/maand voor Max 20x, als Ralph je slechts 5 uur bespaart (bij $40/uur facturering), heeft het zichzelf al terugverdiend. De meeste serieuze gebruikers rapporteren 20-40+ uur besparing per maand.

Tips voor Kostenbeheer

• Stel altijd --max-iterations in — Je echte vangnet
• Begin klein — 10-20 iteraties totdat je de kosten begrijpt
• Gerichte prompts = minder iteraties — Vage prompts verbranden tokens
• Houd je gebruik bij — Controleer op https://claude.ai/settings

Conclusie

Je hebt nu de geavanceerde technieken behandeld die je helpen meer uit Ralph te halen. Deze technieken stellen je in staat om complexe, productieklare projecten met vertrouwen aan te pakken. Je weet hoe je problemen kunt voorkomen voordat ze optreden en ze snel kunt oplossen wanneer ze zich voordoen.

Voor aanvullende bronnen: verken The Ralph Playbook voor uitgebreide methodologiedocumentatie, Geoffrey Huntley's originele guide voor de filosofie achter de techniek, en JeredBlu's praktische guide voor kant-en-klare configuraties.