michsindlinger/.claude/skills/po-requirements

PO Requirements Skill

Project: Agent OS Web UI Generated: 2026-01-30 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 Projekt-Auswahl
  Given ich bin auf der Dashboard-Seite
  And multiple Projekte sind in der config.json definiert
  When ich auf das Projekt-Dropdown klicke
  And ich "my-saas-project" auswähle
  Then wird das Dashboard für my-saas-project geladen
  And die Sidebar zeigt den Projektnamen an

Bad Example (avoid):

# ❌ Zu technisch, mehrere Verhaltensweisen
Scenario: Projekt wechseln und Daten laden
  Given ich navigiere zu /dashboard
  When ich das Dropdown öffne und klicke
  Then wird ein GET zu /api/projects/:id gemacht
  And die Datenbank enthält die Projekte

Story Sizing

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

• Beispiel: "Add loading spinner to aos-button"

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

• Beispiel: "User can switch between projects"

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

• Beispiel: "Chat message streaming with WebSocket"

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 MVP release
• High user value
• Core feature (Dashboard, Chat, Workflow)

Medium:

• Nice to have
• Improves UX
• Polish items

Low:

• Future enhancement
• Edge case
• Rarely used

---

Project-Specific Patterns

Agent OS Web UI User Roles

• Developer: Primary user, uses all three views
• Power User: Uses keyboard shortcuts, command palette

Common Story Types

Dashboard/Kanban:

Feature: Kanban Card Drag-Drop
  Als Developer
  möchte ich Tasks zwischen Spalten ziehen,
  damit ich den Status schnell ändern kann.

Chat Interface:

Feature: Chat Message Streaming
  Als Developer
  möchte ich Claude's Antwort in Echtzeit sehen,
  damit ich den Fortschritt verfolgen kann.

Workflow Execution:

Feature: Workflow Progress Display
  Als Developer
  möchte ich den Fortschritt meiner Workflows sehen,
  damit ich weiß welcher Schritt gerade läuft.

---

Checklist for Good Stories

When creating a story, verify:

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