Ralph TUI - JSON-Aufgaben erstellen
Konvertiert PRDs in das prd.json-Format für die autonome Ausführung mit ralph-tui.
Hinweis: Dieses Skill ist mit dem JSON-Tracker-Plugin von ralph-tui gebündelt. Zukünftige Tracker-Plugins (Linear, GitHub Issues usw.) werden eigene Skills zur Aufgabenerstellung mitbringen.
⚠️ WICHTIG: Die Ausgabe MUSS ein FLACHES JSON-Objekt mit "name" und "userStories" auf der HAUPTEBENE sein. NICHT den Inhalt in ein "prd"-Objekt oder "tasks"-Array packen. Siehe Abschnitt "Schema-Anti-Patterns" unten.
Die Aufgabe
Nehmen Sie ein PRD (Markdown-Datei oder Text) und erstellen Sie eine prd.json-Datei:
- Quality Gates extrahieren aus dem Abschnitt "Quality Gates" des PRD
- User Stories aus dem PRD parsen
- Quality Gates an die Abnahmekriterien jeder Story anhängen
- Abhängigkeiten zwischen den Stories einrichten
- Ausgabe bereit für
ralph-tui run --prd <pfad>
Schritt 1: Quality Gates extrahieren
Suchen Sie nach dem Abschnitt "Quality Gates" im PRD:
## Quality Gates
Diese Befehle müssen für jede User Story bestehen:
- `pnpm typecheck` - Typprüfung
- `pnpm lint` - Linting
Für UI-Stories zusätzlich:
- Im Browser mit dev-browser Skill überprüfen
Extrahieren Sie:
- Universelle Gates: Befehle, die für ALLE Stories gelten (z.B.
pnpm typecheck) - UI-Gates: Befehle, die nur für UI-Stories gelten (z.B. Browserüberprüfung)
Wenn kein Abschnitt "Quality Gates" existiert: Fragen Sie den Benutzer, welche Befehle bestehen sollen, oder verwenden Sie einen sinnvollen Standard wie npm run typecheck.
Ausgabeformat
Die JSON-Datei MUSS ein FLACHES Objekt auf der Hauptebene sein:
{
"name": "[Projektname aus PRD oder Verzeichnis]",
"branchName": "ralph/[feature-name-kebab-case]",
"description": "[Feature-Beschreibung aus PRD]",
"userStories": [
{
"id": "US-001",
"title": "[Story-Titel]",
"description": "Als [Benutzer] möchte ich [Funktion], um [Nutzen]",
"acceptanceCriteria": [
"Kriterium 1 aus PRD",
"Kriterium 2 aus PRD",
"pnpm typecheck besteht",
"pnpm lint besteht"
],
"priority": 1,
"passes": false,
"notes": "",
"dependsOn": []
},
{
"id": "US-002",
"title": "[UI-Story, die von US-001 abhängt]",
"description": "...",
"acceptanceCriteria": [
"...",
"pnpm typecheck besteht",
"pnpm lint besteht",
"Im Browser mit dev-browser Skill überprüfen"
],
"priority": 2,
"passes": false,
"notes": "",
"dependsOn": ["US-001"]
}
]
}
WICHTIG: Schema-Anti-Patterns (NICHT VERWENDEN)
Die folgenden Muster sind UNGÜLTIG und führen zu Validierungsfehlern:
❌ FALSCH: Wrapper-Objekt
{
"prd": {
"name": "...",
"userStories": [...]
}
}
Dies packt alles in ein "prd"-Objekt. TUN SIE DAS NICHT. Die Felder "name" und "userStories" müssen auf der HAUPTEBENE liegen.
❌ FALSCH: Verwendung von "tasks" statt "userStories"
{
"name": "...",
"tasks": [...]
}
Das Array heißt "userStories", nicht "tasks".
❌ FALSCH: Komplexe verschachtelte Strukturen
{
"metadata": {...},
"overview": {...},
"migration_strategy": {
"phases": [...]
}
}
Auch wenn das PRD Phasen/Meilensteine/Sprints beschreibt, MÜSSEN Sie diese in ein einziges "userStories"-Array abflachen.
❌ FALSCH: Verwendung von "status" statt "passes"
{
"userStories": [{
"id": "US-001",
"status": "open" // FALSCH!
}]
}
Verwenden Sie "passes": false für unerledigte Stories, "passes": true für erledigte.
✅ RICHTIG: Flache Struktur auf Hauptebene
{
"name": "Android Kotlin Migration",
"branchName": "ralph/kotlin-migration",
"userStories": [
{"id": "US-001", "title": "Scraper-Schnittstelle erstellen", "passes": false, "dependsOn": []},
{"id": "US-002", "title": "WeebCentralScraper implementieren", "passes": false, "dependsOn": ["US-001"]}
]
}
Story-Größe: Die #1 Regel
Jede Story muss in EINER ralph-tui-Iteration (~einem Agent-Kontextfenster) abschließbar sein.
Ralph-tui erzeugt für jede Iteration eine frische Agenteninstanz ohne Erinnerung an vorherige Arbeit. Wenn eine Story zu groß ist, hat der Agent nicht genug Kontext, um sie zu beenden.
Angemessene Größe:
- Datenbankspalte + Migration hinzufügen
- UI-Komponente zu einer bestehenden Seite hinzufügen
- Server-Action mit neuer Logik aktualisieren
- Filter-Dropdown zu einer Liste hinzufügen
Zu groß (teilen Sie diese):
- "Das gesamte Dashboard bauen" → Aufteilen in: Schema, Abfragen, UI-Komponenten, Filter
- "Authentifizierung hinzufügen" → Aufteilen in: Schema, Middleware, Login-UI, Session-Handling
- "Die API umgestalten" → Aufteilen in eine Story pro Endpunkt oder Muster
Faustregel: Wenn Sie die Änderung nicht in 2-3 Sätzen beschreiben können, ist sie zu groß.
Abhängigkeiten mit dependsOn
Verwenden Sie das dependsOn-Array, um anzugeben, welche Stories zuerst abgeschlossen sein müssen:
{
"id": "US-002",
"title": "API-Endpunkte erstellen",
"dependsOn": ["US-001"], // Wird erst ausgewählt, wenn US-001 bestanden ist
...
}
Ralph-tui wird:
- US-002 als "blockiert" anzeigen, bis US-001 abgeschlossen ist
- US-002 nie zur Ausführung auswählen, solange US-001 offen ist
- "Voraussetzungen: US-001" in den Prompt aufnehmen, wenn an US-002 gearbeitet wird
Richtige Abhängigkeitsreihenfolge:
- Schema/Datenbank-Änderungen (keine Abhängigkeiten)
- Backend-Logik (abhängig von Schema)
- UI-Komponenten (abhängig von Backend)
- Integration/Feinschliff (abhängig von UI)
Abnahmekriterien: Quality Gates + Story-spezifisch
Jede Story sollte Abnahmekriterien enthalten:
- Story-spezifische Kriterien aus dem PRD (was diese Story erreicht)
- Quality Gates aus dem Abschnitt "Quality Gates" des PRD (am Ende angehängt)
Gute Kriterien (überprüfbar):
- "
status-Spalte zur tasks-Tabelle mit Standardwert 'open' hinzufügen" - "Filter-Dropdown hat Optionen: Alle, Offen, Geschlossen"
- "Klicken auf Löschen zeigt Bestätigungsdialog"
Schlechte Kriterien (vage):
- ❌ "Funktioniert korrekt"
- ❌ "Benutzer kann X einfach machen"
- ❌ "Gute UX"
- ❌ "Behandelt Randfälle"
Konvertierungsregeln
- Quality Gates zuerst aus PRD extrahieren
- Jede User Story → ein JSON-Eintrag
- IDs: Sequenziell (US-001, US-002, usw.)
- Priorität: Basierend auf Abhängigkeitsreihenfolge (1 = höchste)
- dependsOn: Array mit Story-IDs, die diese Story benötigt
- Alle Stories:
passes: falseund leerenotes - branchName: Vom Feature-Namen ableiten, kebab-case, mit
ralph/präfix - Abnahmekriterien: Story-Kriterien + Quality Gates angehängt
- UI-Stories: Auch UI-spezifische Gates anhängen (Browserüberprüfung)
Ausgabeort
Standard: ./tasks/prd.json (neben den PRD-Markdown-Dateien)
Dies hält alle PRD-bezogenen Dateien im tasks/-Verzeichnis zusammen.
Oder geben Sie einen anderen Pfad an - ralph-tui verwendet ihn mit:
ralph-tui run --prd ./pfad/zu/prd.json
Beispiel
Eingabe-PRD:
# PRD: Aufgaben-Prioritätssystem
Fügen Sie Prioritätsstufen zu Aufgaben hinzu.
## Quality Gates
Diese Befehle müssen für jede User Story bestehen:
- `pnpm typecheck` - Typprüfung
- `pnpm lint` - Linting
Für UI-Stories zusätzlich:
- Im Browser mit dev-browser Skill überprüfen
## User Stories
### US-001: Prioritätsfeld zur Datenbank hinzufügen
**Beschreibung:** Als Entwickler muss ich Aufgabenpriorität speichern können.
**Abnahmekriterien:**
- [ ] Prioritätsspalte hinzufügen: 1-4 (Standard 2)
- [ ] Migration läuft erfolgreich
### US-002: Prioritätsabzeichen auf Aufgabenkarten anzeigen
**Beschreibung:** Als Benutzer möchte ich Aufgabenpriorität auf einen Blick sehen.
**Abnahmekriterien:**
- [ ] Abzeichen zeigt P1/P2/P3/P4 mit Farben
- [ ] Abzeichen ohne Hover sichtbar
### US-003: Prioritätsfilter-Dropdown hinzufügen
**Beschreibung:** Als Benutzer möchte ich Aufgaben nach Priorität filtern.
**Abnahmekriterien:**
- [ ] Filter-Dropdown: Alle, P1, P2, P3, P4
- [ ] Filter bleibt in URL erhalten
Ausgabe prd.json:
{
"project": "my-app",
"branchName": "ralph/task-priority",
"description": "Prioritätsstufen zu Aufgaben hinzufügen",
"userStories": [
{
"id": "US-001",
"title": "Prioritätsfeld zur Datenbank hinzufügen",
"description": "Als Entwickler muss ich Aufgabenpriorität speichern können.",
"acceptanceCriteria": [
"Prioritätsspalte hinzufügen: 1-4 (Standard 2)",
"Migration läuft erfolgreich",
"pnpm typecheck besteht",
"pnpm lint besteht"
],
"priority": 1,
"passes": false,
"notes": "",
"dependsOn": []
},
{
"id": "US-002",
"title": "Prioritätsabzeichen auf Aufgabenkarten anzeigen",
"description": "Als Benutzer möchte ich Aufgabenpriorität auf einen Blick sehen.",
"acceptanceCriteria": [
"Abzeichen zeigt P1/P2/P3/P4 mit Farben",
"Abzeichen ohne Hover sichtbar",
"pnpm typecheck besteht",
"pnpm lint besteht",
"Im Browser mit dev-browser Skill überprüfen"
],
"priority": 2,
"passes": false,
"notes": "",
"dependsOn": ["US-001"]
},
{
"id": "US-003",
"title": "Prioritätsfilter-Dropdown hinzufügen",
"description": "Als Benutzer möchte ich Aufgaben nach Priorität filtern.",
"acceptanceCriteria": [
"Filter-Dropdown: Alle, P1, P2, P3, P4",
"Filter bleibt in URL erhalten",
"pnpm typecheck besteht",
"pnpm lint besteht",
"Im Browser mit dev-browser Skill überprüfen"
],
"priority": 3,
"passes": false,
"notes": "",
"dependsOn": ["US-002"]
}
]
}
Ausführung mit ralph-tui
Nach dem Erstellen von prd.json:
ralph-tui run --prd ./tasks/prd.json
Ralph-tui wird:
- Stories aus prd.json laden
- Die Story mit der höchsten Priorität auswählen, die
passes: falseund keine blockierenden Abhängigkeiten hat - Einen Prompt mit Story-Details + Abnahmekriterien generieren
- Den Agenten ausführen, um die Story zu implementieren
- Bei Erfolg
passes: truesetzen - Wiederholen, bis alle Stories bestanden sind
Checkliste vor dem Speichern
- Quality Gates aus PRD extrahiert (oder Benutzer gefragt, falls fehlend)
- Jede Story in einer Iteration abschließbar
- Stories nach Abhängigkeit geordnet (Schema → Backend → UI)
-
dependsOnkorrekt für jede Story gesetzt - Quality Gates an die Abnahmekriterien jeder Story angehängt
- UI-Stories haben Browserüberprüfung (falls in Quality Gates angegeben)
- Abnahmekriterien sind überprüfbar (nicht vage)
- Keine zirkulären Abhängigkeiten