Wie ein interaktiver Agent mir half, einen StreamDeck Icon Generator zu bauen – ohne dass ich eine einzige Zeile Code selbst schreiben musste.

---

Das Problem: Gute Prompts für autonome KI-Loops schreiben ist schwer

Du kennst das vielleicht: Du hast eine Idee für ein Tool oder einen Text, startest Claude Code, und dann… sitzt du da und überlegst, wie du deinen Prompt formulieren sollst.

Bei einfachen Aufgaben ist das kein Problem. Aber was, wenn du einen autonomen Loop starten willst? Einen Prozess, der selbstständig iteriert, bis dein Projekt fertig ist?

Genau hier kommt der Ralph Loop ins Spiel – und sein Briefing-Agent, der dir hilft, den perfekten Prompt zu konstruieren.

Wer mehr über Ralph Loop wissen will..

---

Was ist Ralph Loop?

Ralph Loop ist ein autonomer Iterations-Mechanismus für Claude Code. Statt einer einzelnen Antwort bekommst du einen Loop, der:

1. Arbeitet – führt deine Aufgabe aus
2. Prüft – verifiziert ob das Ergebnis stimmt
3. Iteriert – verbessert solange, bis ein Erfolgskriterium erreicht ist
4. Stoppt – erst wenn COMPLETE ausgegeben wird

Das Besondere: Du definierst vorher, wann „fertig“ bedeutet. Der Loop entscheidet dann selbst, ob er weitermachen muss.

Der Ralph Loop Zyklus: Arbeiten → Prüfen → Iterieren → Complete. Der Loop stoppt erst, wenn alle Erfolgskriterien erfüllt sind.

---

Das Briefing-Problem (strukturiert Ergebnisse beschreiben)

Einen guten Ralph Loop Prompt zu schreiben erfordert:

• Klare Erfolgskriterien (messbar!)
• Verifikationsschritte
• Sinnvolle Iterationslimits
• Die richtigen technischen Details

Deshalb habe ich mir den Ralph-Briefing Agent gebaut, der das löst. Er führt einen interaktiv durch alle notwendigen Fragen und generiert am Ende einen fix-fertigen Prompt.

Der Ralph-Briefing Workflow: Von der ersten Entscheidung (Text oder App?) bis zum fertigen Prompt in 4 Phasen.

---
name: ralph-briefing
description: Interaktiver Briefing-Agent für Ralph Loop Prompts. Führt durch Fragen und generiert perfekte /ralph-loop Commands für das offizielle Anthropic Plugin. Trigger - ralph briefing, loop prompt erstellen, ralph prompt, persistenter loop
---

# Ralph Briefing Agent

Dieser Skill führt interaktiv durch die Erstellung eines optimalen Ralph Loop Prompts.

## Aktivierung

Bei Aktivierung dieses Skills:

**STOPP** - Nicht direkt loslegen!

Antworte mit:
```
🔄 Ralph Briefing gestartet.

Ich helfe dir, einen perfekten Ralph Loop Prompt zu erstellen.
Der Loop läuft so lange, bis dein Ziel erreicht ist.

Lass uns starten...
```

Dann beginne mit **Phase 1**.

---

## Phase 1: Projekt-Typ

Frage den User:

```
**Was willst du bauen?**

1. 📝 **Text** (Blog, LinkedIn, Newsletter, Docs, Landingpage)
2. 💻 **App** (Web-App, CLI Tool, Script, API, Full-Stack)
```

Warte auf Antwort, dann weiter zu Phase 2a oder 2b.
.....

---

Übersicht über den Skill

Praxis-Beispiel: StreamDeck Icon Generator

Letzte Woche wollte ich ein Tool bauen, das intelligente Icons für mein StreamDeck XL generiert. Nicht langweilige Text-Buttons, sondern visuell ansprechende Icons mit:

• App-Logos als kleine Badges
• Selbsterklärenden Symbolen
• Kurzen Text-Labels

So lief das Briefing ab:

Phase 1: Projekt-Typ

🔄 Ralph Briefing gestartet.

Was willst du bauen?
1. 📝 Text
2. 💻 App

Ich wählte App – klar, ich will ja ein CLI-Tool.

Phase 2: Details

Der Agent fragte nach:

• App-Typ? → CLI Tool
• Was soll es machen? → StreamDeck Icons generieren mit KI
• Welche Features müssen funktionieren?
• Wie verifizieren? → CLI läuft und gibt 144×144 PNG aus

Phase 3: Technische Entscheidungen

Der Agent half auch bei technischen Fragen:

Welche Bild-API?

• DALL-E (OpenAI)
• Ideogram
• Nano Banana Pro (Google Gemini)

Wir entschieden uns für Nano Banana Pro – weil es bereits konfiguriert war und gut mit Text auf Bildern umgehen kann.

Icon-Größe?

• 144x144px für High DPI (empfohlen)
• Formate: PNG, JPEG, SVG

Phase 4: Prompt-Generierung

Am Ende generierte der Agent einen kompletten Ralph Loop Prompt:

/ralph-loop "
[AUFGABE]
Baue einen Smart Icon Generator für StreamDeck XL.

[TECHNOLOGIE]
- Bun statt Node.js
- Nano Banana Pro (Google Gemini API)
- Arbeitsverzeichnis: /Users/.../streamdeck-icon-generator/

[FEATURES]
1. Input parsen: StreamDeck Action als JSON oder Text
2. Smart Design: App erkennen, Logo + Symbol kombinieren
3. Prompt konstruieren: Visuell ansprechend, nicht nur Text
4. Bild generieren: 144x144px PNG

[ERFOLGSKRITERIEN]
Die Aufgabe ist COMPLETE wenn:
1. CLI akzeptiert StreamDeck Action als Input
2. CLI generiert ein 144x144px PNG
3. Icon zeigt VISUELL die Aktion
4. 3 Test-Icons erfolgreich generiert

[VERIFIKATION]
Nach jeder Iteration:
- Generiere Test-Icons
- Prüfe VISUELL: Ist das Icon selbsterklärend?
- Öffne in QSpace Pro zur Ansicht

Output COMPLETE NUR wenn alle Kriterien erfüllt.
" --completion-promise "COMPLETE" --max-iterations 35

---

Der Loop in Aktion

Setup: Git-Repository

Bevor der Loop startete, erstellte ich ein Git-Repository:

gh repo create streamdeck-icon-generator --private --clone

• git diff – sehen was geändert wurde
• git checkout . – alles zurücksetzen falls etwas schiefgeht

Start: Ohne Nachfragen

cd streamdeck-icon-generator
claude --dangerously-skip-permissions

Das Flag --dangerously-skip-permissions sorgt dafür, dass Claude nicht bei jeder Dateiänderung nachfragt. In einem Git-Repo mit Rollback-Option ist das sicher.

Ergebnis nach ~20 Iterationen

Der Loop baute eigenständig:

1. CLI-Struktur (src/cli.ts)
2. Input-Parser für JSON und Text
3. App-Erkennung (20+ bekannte Apps/Websites)
4. Prompt-Generator für Nano Banana Pro
5. Image-Processing mit Sharp

Die komplette Pipeline: Von StreamDeck Action Input über Smart Analysis und KI-Bildgenerierung zum fertigen 144x144px Icon.

Und generierte Test-Icons:

Icon	Beschreibung
Anthropic Docs	Dokument-Symbol mit „A“ Badge
Storytelling	Buch mit Feder
Claude Desktop	App-Start-Symbol mit Claude Badge

---

Problem erkannt, Problem gelöst

Die ersten Icons sahen gut aus – aber es fehlte etwas: Text-Labels.

Auf einem StreamDeck will man auf einen Blick sehen, was ein Button macht. Nur Symbole reichen nicht immer.

Also startete ich einen zweiten Loop mit angepasstem Prompt:

/ralph-loop "
[ANFORDERUNG]
Jedes Icon MUSS ein kurzes Text-Label haben:
- Position: Unten im Icon
- Länge: 1-8 Zeichen (z.B. 'DOCS', 'STORY', 'CLAUDE')
- Stil: Fett, gut lesbar, hoher Kontrast
..."

Nach weiteren 10 Iterationen hatte ich Icons mit lesbaren Labels.

---

Was ich gelernt habe

1. Messbare Kriterien sind alles

Vage Formulierungen wie „mach es schön“ funktionieren nicht. Der Ralph-Briefing Agent zwingt dich zu konkreten Kriterien:

❌ Vage	✅ Messbar
„Gute Icons“	„144x144px PNG mit lesbarem Label“
„Funktioniert“	„bun test zeigt 0 Fehler“
„Fertig wenn gut“	„3 Test-Icons visuell geprüft“

Der Unterschied: Vage Formulierungen führen zu endlosen Loops. Messbare Kriterien ermöglichen automatische Verifikation.

2. Git ist dein Sicherheitsnetz

• Den Fortschritt sehen
• Bei Problemen zurückrollen
• Verschiedene Ansätze vergleichen

3. Iteration schlägt Perfektion

Der erste Prompt war nicht perfekt. Die Icons hatten keine Text-Labels. Aber statt alles neu zu machen, konnte ich einfach einen zweiten Loop starten, der das spezifische Problem löste.

4. Der Briefing-Agent spart Zeit

• Die StreamDeck-Specs selbst recherchieren müssen
• Die API-Keys selbst zusammensuchen müssen
• Den Prompt-Aufbau erraten müssen

Der Agent hat mir geschätzt 30-45 Minuten reine Vorbereitungszeit gespart.

---

Wann Ralph-Briefing nutzen?

Der Agent ist besonders nützlich für:

• Apps/Tools mit mehreren Features
• Content-Projekte mit Qualitätsanforderungen
• Automatisierungen mit Verifikationsschritten
• Alles, wo du „fertig“ definieren musst

• Einmalige, einfache Aufgaben
• Reine Recherche-Fragen
• Aufgaben ohne klares Erfolgskriterium

Entscheidungshilfe: Links die idealen Anwendungsfälle, rechts wo du besser direkt loslegst.

---

Fazit: KI-Orchestrierung als Meta-Skill

Der Ralph-Briefing Agent zeigt, wohin die Reise geht: Wir werden weniger Code schreiben und mehr orchestrieren.

• Wie definiere ich klare Erfolgskriterien?
• Wie strukturiere ich eine komplexe Aufgabe?
• Wie verifiziere ich automatisch?

Der Briefing-Agent ist wie ein erfahrener Projektmanager, der die richtigen Fragen stellt, bevor ein Entwickler auch nur eine Zeile Code schreibt.

---

Nächste Schritte

Du willst das selbst ausprobieren? So geht’s:

1. Ralph-Briefing starten:

1. Fragen beantworten (Projekt-Typ, Features, Verifikation)

1. Generierten Prompt kopieren

1. In neuer Session mit Git-Repo starten:

1. Ralph Loop Prompt einfügen und beobachten

Der 5-Schritte-Workflow: Von der Idee zum autonomen Loop in wenigen Minuten.

Viel Erfolg beim Orchestrieren!

---

Erstellt am 10.01.2026 | Holger Gelhausen | AI PERFORMANCE-ACADEMY