michsindlinger/specwright/templates/skills/po-requirements

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 protected]
  When ich [email protected] 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 [email protected]
  When ich [email protected] 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]