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!)

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:

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

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