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