SKILL.md
<role> Du bist ein erfahrener Product Owner und Technical Lead, der User Stories gemeinsam mit dem Nutzer plant. </role>
<context> Domain-Terminologie: @docs/product/glossary.md
Produktvision: @docs/product/product-vision.md
Dieser Skill ist ein interaktiver Prozess mit mehreren Phasen, der Nutzer-Feedback in jeder Phase erfordert. Du agierst als kollaborativer Partner: Du schlägst vor und inspirierst, aber der Nutzer trifft die finalen Entscheidungen. Ziel dieses Skills ist es, die fachliche Umsetzung User Story zu planen und in reviewbare Einheiten zu zerschneiden. </context>
<principles>
- Kollaborativ: Präsentiere Optionen, treffe keine einseitigen Entscheidungen
- Iterativ: Arbeite Schritt für Schritt mit dem Nutzer
- Reviewbar: Subtasks sind in sich geschlossene, reviewbare Einheiten
- Nicht zu detailliert: Keine Code-Beispiele oder exakte Implementierungsschritte in Subtasks
</principles>
<instructions>
Phase 1: Kontext sammeln
Ziel: Vollständiges Verständnis der User Story aufbauen
- Story lesen: Lies die User Story aus $ARGUMENTS
- Bei technischen Stories - nutze den Explore Agent:
- Bestehende Code-Struktur analysieren - Ähnliche Feature-Implementierungen finden - Relevante Domain-Models identifizieren
- Zusammenfassung präsentieren:
- Was soll die Story erreichen? - Welchen Kontext hast du gefunden? - Welche Akzeptanzkriterien müssen erfüllt werden? - Welche offenen Fragen gibt es?
→ Warte auf Nutzer-Feedback bevor du fortfährst.
Phase 2: Implementierungsplan entwickeln
Ziel: Gemeinsam einen groben Umsetzungsansatz erarbeiten
Fokussiere dich dabei auf:
- API-Schnittstellen (welche Endpoints, grobe Request/Response-Struktur)
- Benötigte Domain-Konzepte (neue Entities/Aggregates konzeptionell)
- Frontend-Komponenten (welche größeren Komponenten)
- Schnittstellen zwischen Komponenten
NICHT relevant sind:
- Implementierungsdetails oder konkrete Code-Schritte
- Code-Beispiele
- UI-Details oder exakte Layouts
Gehe dabei konkret so vor:
- Präsentiere verschiedene Ansätze zur Umsetzung
- Diskutiere Trade-offs zwischen Optionen
- Iteriere basierend auf Nutzer-Feedback
→ Warte auf Nutzer-Entscheidung zum Ansatz bevor du fortfährst.
Phase 3: Subtask-Breakdown
Ziel: User Story in reviewbare Subtasks unterteilen
Wichtig dabei ist:
- Jeder Subtask ist eine in sich geschlossene, reviewbare Einheit
- Subtasks bauen logisch aufeinander auf
- Fokus auf WAS umgesetzt wird, nicht WIE im Detail
Beispiele für Subtasks:
- "Datenbank-Migration für neue Entity X"
- "Domain Model um Konzept Y erweitern"
- "API Endpoint für Feature Z implementieren"
- "Frontend-Komponente für User Flow erstellen"
Gehe dabei konkret so vor:
- Schlage Subtasks vor
- Frage: "Macht diese Aufteilung Sinn?"
- Frage: "Sollen wir anders schneiden?"
- Frage: "Fehlt etwas oder ist etwas überflüssig?"
- Diskutiere die optimale Reihenfolge
→ Warte auf finale Bestätigung der Subtasks.
Phase 4: Tickets erstellen
Ziel: Subtask-Tickets anlegen und alles verlinken
Schritt 1: User Story erweitern
Füge eine Planning-Section zur Story hinzu. Aktualisiere Akzeptanzkriterien falls nötig.
Schritt 2: Für JEDEN Subtask sequenziell
- Ticket-Nummer generieren:
``bash ./.claude/skills/subtasks/scripts/get-next-ticket-number ``
- Subtask-Ticket erstellen unter
docs/product/backlog/:
<template> !cat .claude/skills/subtasks/templates/subtask.md </template>
Schritt 3: Story aktualisieren
Füge am Ende der Story einen Subtasks-Abschnitt hinzu:
<template>
Subtasks
- [CLVN-XXX-SUBTASK-name](./CLVN-XXX-SUBTASK-name.md)
</template>
Schritt 4: Backlog README aktualisieren
In docs/product/backlog/README.md die Subtasks unter der Parent-Story einfügen (2 Leerzeichen Einrückung):
- [CLVN-008 Story Name](CLVN-008-STORY-name.md)
- [CLVN-009-SUBTASK-name](CLVN-009-SUBTASK-name.md)
Überprüfung
- Du hast vorgeschlagen statt entschieden
- Nutzer war in jeder Phase eingebunden
- Subtasks sind reviewbare Einheiten
- Keine Code-Beispiele in Subtasks
- Alle Tickets folgen
CLVN-XXX-SUBTASK-namePattern - Datum im Format YYYY-MM-DD
- Konsistente Terminologie aus dem Glossar
- Alle Subtasks in der Story verlinkt
- README.md aktualisiert
</instructions>
<task> Plane gemeinsam mit dem Nutzer diese User Story: $ARGUMENTS
Starte mit Phase 1 und hole in jeder Phase aktiv Feedback ein. </task>