clarify-spec skill

---
name: clarify-spec
description: |
  AKTIVIERT SICH AUTOMATISCH bei vagen Auftraegen. LIEBER EINMAL ZU OFT NACHFRAGEN als falsch implementieren.

  Erkennungsmerkmale (EINES genuegt!):
  - Auftrag <25 Woerter
  - Keine konkreten Dateinamen/Pfade
  - Vage Verben: besser, optimieren, fixen, machen, aendern, verbessern, anpassen, erweitern, refactoren, aufraumen, ueberarbeiten
  - Unsichere Sprache: irgendwie, vielleicht, mal eben, schnell, einfach, bisschen, koennte, sollte
  - Fehlende Erfolgskriterien: Kein damit, sodass, weil, um zu
  - Relative Begriffe ohne Kontext: schneller, besser, schoener, einfacher

  Output ist STRUKTURIERTES JSON fuer prompt-architect Skill.
  Escape: mach einfach, keine Rueckfragen, entscheide selbst ueberspringt Klaerung.
triggers:
  - /clarify
  - /spec
  - /was-genau
  - /praezisieren
  - /klaeren
---

# Clarify-Spec v2.0: Automatische Auftragsklarung

## AKTIVIERUNG: Aggressiv - Lieber einmal zu oft!

### AUTOMATISCH bei diesen Signalen (EINES genuegt!)

| Signal | Beispiele | Warum problematisch |
|--------|-----------|---------------------|
| Kurzer Auftrag (<25 Woerter) | Mach den Export besser | Zu wenig Kontext |
| Keine Dateinamen/Pfade | Optimiere die Performance | Scope unklar |
| Vage Verben | besser, optimieren, fixen, machen, aendern, verbessern | Nicht operationalisierbar |
| Unsichere Sprache | irgendwie, vielleicht, mal eben, schnell | Signalisiert Unklarheit |
| Fehlende Erfolgskriterien | Kein damit, sodass, weil | Kein Ziel definiert |
| Relative Begriffe | schneller, besser, schoener, einfacher | Ohne Baseline bedeutungslos |
| Implizite Annahmen | Das uebliche, wie immer, standard | Kontext fehlt |

### NICHT aktivieren NUR wenn ALLE erfuellt:
- Konkreter Dateiname/Pfad genannt UND
- Klares, messbares Ziel definiert UND
- Erfolgskriterium erkennbar UND
- Expliziter Skip-Befehl (mach einfach, keine Rueckfragen)

## Workflow

### Phase 1: Vagheits-Check (STRENG)

Pruefe jeden Auftrag gegen diese Checkliste:

[ ] Konkrete Datei/Komponente genannt?
[ ] Klares, messbares Ziel definiert?
[ ] Erfolgskriterium erkennbar?
[ ] Scope abgegrenzt?
[ ] Keine vagen Verben verwendet?

Weniger als 4 Haken = RUECKFRAGEN STELLEN!

### Phase 2: Kontext sammeln (still, ohne User-Interaktion)

1. Relevante Dateien im Projekt suchen (Glob)
2. CLAUDE.md / AGENTS.md pruefen
3. No-Touch Zones identifizieren
4. Aehnliche bestehende Implementierungen finden

### Phase 3: Gezielte Rueckfragen (2-4, priorisiert)

Format - kurz und praezise:

Bevor ich loslege - kurze Klaerung:

1. [KONKRETSTE FRAGE - WAS genau?]
2. [ZWEITWICHTIGSTE FRAGE - WO/Welche Datei?]
3. [Optional: Erfolgskriterium?]
4. [Optional: Gibt es ein Beispiel/Referenz?]

(Oder sag mach einfach - dann entscheide ich nach bestem Wissen.)

Fragen-Prioritaet:

| Prio | Typ | Beispiel-Fragen |
|------|-----|-----------------|
| 1 | WAS | Was genau meinst du mit besser? Welches Problem soll geloest werden? |
| 2 | WO | Welche Datei/Komponente ist betroffen? Frontend oder Backend? |
| 3 | ERFOLG | Woran erkenne ich, dass es fertig ist? Was ist das erwartete Ergebnis? |
| 4 | BEISPIEL | Gibt es eine Referenz/Screenshot? Wie sieht der gewuenschte Output aus? |
| 5 | KONTEXT | Fuer welchen Use Case? Wer ist der Nutzer dieser Funktion? |

### Phase 4: Strukturierter Output (JSON fuer prompt-architect)

Nach Antwort des Users, generiere strukturiertes JSON mit:
- clarified_task.goal: Praezises Ziel in 1-2 Saetzen
- clarified_task.problem_statement: Was ist das Problem
- clarified_task.scope.files: Betroffene Dateien
- clarified_task.scope.no_touch: Nicht anfassen
- clarified_task.success_criteria: Messbare Kriterien
- clarified_task.constraints: Einschraenkungen
- metadata.original_request: Urspruenglicher Auftrag
- metadata.confidence: high/medium/low

### Phase 5: Bestaetigung mit Prompt-Vorschau

Zeige dem User eine lesbare Zusammenfassung mit Ziel, Problem, Scope, Erfolgskriterien, Constraints.

Frage: Soll ich loslegen? (ja / nein / anpassen: ...)
Oder: /prompt-architect fuer einen strukturierten Best-Practice Prompt

### Phase 6: Reaktion auf Bestaetigung

| Antwort | Aktion |
|---------|--------|
| ja / ok / los / mach | Ausfuehren mit internem JSON-Kontext |
| nein / stop / abbrechen | Abbrechen, nachfragen was stattdessen |
| anpassen: ... | JSON modifizieren, erneut zeigen |
| /prompt-architect | An prompt-architect Skill uebergeben |
| mach einfach | Mit eigenem Ermessen ausfuehren |

## Escape Hatches

User kann Klaerung jederzeit ueberspringen mit:
- Mach einfach
- Entscheide selbst
- Keine Rueckfragen
- Egal, hauptsache X funktioniert
- Just do it

Bei Escape: Mit bestem Wissen ausfuehren, aber Annahmen dokumentieren.

## Integration mit prompt-architect

Nach erfolgreicher Klaerung kann der User /prompt-architect aufrufen.
Der prompt-architect Skill nutzt das JSON aus Phase 4, um einen vollstaendigen
Best-Practice Prompt nach Claude 4.x Standards zu generieren.

Workflow:
clarify-spec -> JSON Output -> prompt-architect -> Ausfuehrung

## Metrik: Erfolg

Der Skill ist erfolgreich wenn:
- Weniger Nacharbeit nach Implementierung
- User sagt Ja, genau das meinte ich
- Erste Implementierung erfuellt alle Kriterien
- Keine Das meinte ich nicht Situationen