PO Requirements Skill

Project: [PROJECT_NAME] Generated: [DATE] Purpose: Guide for gathering requirements and creating user stories

When to Use

This skill guides you when:

• •Creating new user stories with /create-spec
• •Adding stories with /add-story
• •Adding quick tasks with /add-todo
• •Creating bug stories with /add-bug

Quick Reference

User Story Format

Feature: [Feature Name]
  Als [User Role]
  möchte ich [Action],
  damit [Benefit].

Acceptance Criteria (Gherkin)

• •Ein Verhalten pro Szenario: Fokussiert und testbar
• •Konkrete Werte: "100€" nicht "einen Betrag"
• •Nutzer-Perspektive: WAS passiert, nicht WIE
• •Max 2-3 "And" Steps: Pro Given/When/Then

Requirements Dialog Questions

Story Context:

1. •Was soll erreicht werden?
2. •Wer braucht das? (User Role)
3. •Warum ist das wichtig? (Business Value)

Story Details: 4. Was sind die Akzeptanzkriterien? (2-5 Szenarien) 5. Welche Edge Cases gibt es? 6. Gibt es Abhängigkeiten zu anderen Stories?

Prioritization: 7. Wie kritisch ist das? (Critical/High/Medium/Low) 8. Welcher User-Type profitiert am meisten?

Detailed Guidance

Gherkin Best Practices

Good Example:

Scenario: Erfolgreiche Registrierung mit valider Email
  Given ich bin auf der Registrierungsseite
  And kein Account existiert mit email@example.com
  When ich email@example.com und ein Passwort eingebe
  And ich auf "Registrieren" klicke
  Then wird mein Account erstellt
  And ich erhalte eine Bestätigungsemail
  And ich werde zum Dashboard weitergeleitet

Bad Example (avoid):

# ❌ Zu technisch, mehrere Verhaltensweisen
Scenario: Registrierung und Login
  Given ich navigiere zu /register.html
  When ich das Formular ausfülle und submitiere
  Then wird ein POST zu /api/users gemacht
  And die Datenbank enthält einen neuen Eintrag
  And ich kann mich einloggen

Story Sizing

XS (1 SP): Single file, < 50 LOC

• •Beispiel: "Add loading spinner to button"

S (2-3 SP): 2-3 files, < 200 LOC

• •Beispiel: "User can edit profile name"

M (5 SP): 4-5 files, < 400 LOC

• •Beispiel: "User registration with email verification"

Too Large:

• •If > 5 files or > 400 LOC: Split into multiple stories
• •If multiple features: Create separate stories

Priority Guidelines

Critical:

• •System doesn't work without it
• •Blocker for other work
• •Security issue

High:

• •Important for release
• •High user value
• •Frequently requested

Medium:

• •Nice to have
• •Improves UX
• •Optional feature

Low:

• •Future enhancement
• •Edge case
• •Rarely used

Dependency Types

Technical Dependency:

• •Story A must be done before Story B can start
• •Example: "API endpoint" before "Frontend integration"

No Dependency:

• •Stories can be done in any order
• •Parallel execution possible

Common Patterns

New Feature Story

Feature: Export User Data
  Als angemeldeter User
  möchte ich meine Daten als PDF exportieren,
  damit ich eine Kopie für meine Unterlagen habe.

Scenario: Erfolgreicher Export
  Given ich bin angemeldet
  And ich habe Daten in meinem Account
  When ich auf "Daten exportieren" klicke
  Then wird eine PDF-Datei generiert
  And die PDF enthält alle meine Daten
  And die PDF wird heruntergeladen

Enhancement Story

Feature: Bulk User Selection
  Als Administrator
  möchte ich mehrere User auf einmal auswählen,
  damit ich Aktionen effizienter durchführen kann.

Scenario: Auswahl mehrerer User mit Checkbox
  Given ich bin auf der User-Liste
  When ich die Checkboxen von 3 Usern anklicke
  Then sind 3 User ausgewählt
  And ich sehe "3 User ausgewählt"
  And Bulk-Aktionen sind verfügbar

Bug Fix Story

Feature: Fix Login Error Message
  Als User
  möchte ich eine hilfreiche Fehlermeldung sehen,
  damit ich verstehe warum Login fehlschlägt.

Scenario: Falsches Passwort zeigt klare Meldung
  Given ich habe einen Account mit user@example.com
  When ich user@example.com mit falschem Passwort eingebe
  Then sehe ich "Email oder Passwort ist falsch"
  And NICHT "Error 401"

Anti-Patterns to Avoid

❌ Vage Beschreibungen

• •"Als User möchte ich die App nutzen"
• •Better: "Als Administrator möchte ich User deaktivieren"

❌ Technische Details im Feature

• •"Als Developer möchte ich einen API Endpoint bauen"
• •Better: "Als User möchte ich mein Profil bearbeiten"

❌ Zu groß

• •"Als User möchte ich das komplette Profil-System nutzen"
• •Better: Split in: Profil ansehen, Profil bearbeiten, Avatar hochladen

❌ Mehrere Features in einer Story

• •"Als User möchte ich registrieren, einloggen, und Passwort zurücksetzen"
• •Better: 3 separate Stories

Checklist for Good Stories

When creating a story, verify:

• • Clear user role (wer?)
• • Specific action (was?)
• • Clear benefit (warum?)
• • 2-5 concrete acceptance criteria
• • Appropriate size (XS/S/M)
• • No technical implementation details
• • Testable scenarios
• • Dependencies identified

Project-Specific Patterns

[PROJECT_SPECIFIC_PATTERNS]