clarify-spec

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