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)
- Relevante Dateien im Projekt suchen (Glob)
- CLAUDE.md / AGENTS.md pruefen
- No-Touch Zones identifizieren
- Aehnliche bestehende Implementierungen finden
Phase 3: Gezielte Rueckfragen (2-4, priorisiert)
Format - kurz und praezise:
Bevor ich loslege - kurze Klaerung:
- [KONKRETSTE FRAGE - WAS genau?]
- [ZWEITWICHTIGSTE FRAGE - WO/Welche Datei?]
- [Optional: Erfolgskriterium?]
- [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
1---2name: clarify-spec3description: 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.4---5
6# Clarify-Spec v2.0: Automatische Auftragsklarung
7
8## AKTIVIERUNG: Aggressiv - Lieber einmal zu oft!
9
10### AUTOMATISCH bei diesen Signalen (EINES genuegt!)
11
12| Signal | Beispiele | Warum problematisch |
13|--------|-----------|---------------------|
14| Kurzer Auftrag (<25 Woerter) | Mach den Export besser | Zu wenig Kontext |
15| Keine Dateinamen/Pfade | Optimiere die Performance | Scope unklar |
16| Vage Verben | besser, optimieren, fixen, machen, aendern, verbessern | Nicht operationalisierbar |
17| Unsichere Sprache | irgendwie, vielleicht, mal eben, schnell | Signalisiert Unklarheit |
18| Fehlende Erfolgskriterien | Kein damit, sodass, weil | Kein Ziel definiert |
19| Relative Begriffe | schneller, besser, schoener, einfacher | Ohne Baseline bedeutungslos |
20| Implizite Annahmen | Das uebliche, wie immer, standard | Kontext fehlt |
21
22### NICHT aktivieren NUR wenn ALLE erfuellt:
23- Konkreter Dateiname/Pfad genannt UND
24- Klares, messbares Ziel definiert UND
25- Erfolgskriterium erkennbar UND
26- Expliziter Skip-Befehl (mach einfach, keine Rueckfragen)
27
28## Workflow
29
30### Phase 1: Vagheits-Check (STRENG)
31
32Pruefe jeden Auftrag gegen diese Checkliste:
33
34[ ] Konkrete Datei/Komponente genannt?
35[ ] Klares, messbares Ziel definiert?
36[ ] Erfolgskriterium erkennbar?
37[ ] Scope abgegrenzt?
38[ ] Keine vagen Verben verwendet?
39
40Weniger als 4 Haken = RUECKFRAGEN STELLEN!
41
42### Phase 2: Kontext sammeln (still, ohne User-Interaktion)
43
441. Relevante Dateien im Projekt suchen (Glob)
452. CLAUDE.md / AGENTS.md pruefen
463. No-Touch Zones identifizieren
474. Aehnliche bestehende Implementierungen finden
48
49### Phase 3: Gezielte Rueckfragen (2-4, priorisiert)
50
51Format - kurz und praezise:
52
53Bevor ich loslege - kurze Klaerung:
54
551. [KONKRETSTE FRAGE - WAS genau?]
562. [ZWEITWICHTIGSTE FRAGE - WO/Welche Datei?]
573. [Optional: Erfolgskriterium?]
584. [Optional: Gibt es ein Beispiel/Referenz?]
59
60(Oder sag mach einfach - dann entscheide ich nach bestem Wissen.)
61
62Fragen-Prioritaet:
63
64| Prio | Typ | Beispiel-Fragen |
65|------|-----|-----------------|
66| 1 | WAS | Was genau meinst du mit besser? Welches Problem soll geloest werden? |
67| 2 | WO | Welche Datei/Komponente ist betroffen? Frontend oder Backend? |
68| 3 | ERFOLG | Woran erkenne ich, dass es fertig ist? Was ist das erwartete Ergebnis? |
69| 4 | BEISPIEL | Gibt es eine Referenz/Screenshot? Wie sieht der gewuenschte Output aus? |
70| 5 | KONTEXT | Fuer welchen Use Case? Wer ist der Nutzer dieser Funktion? |
71
72### Phase 4: Strukturierter Output (JSON fuer prompt-architect)
73
74Nach Antwort des Users, generiere strukturiertes JSON mit:
75- clarified_task.goal: Praezises Ziel in 1-2 Saetzen
76- clarified_task.problem_statement: Was ist das Problem
77- clarified_task.scope.files: Betroffene Dateien
78- clarified_task.scope.no_touch: Nicht anfassen
79- clarified_task.success_criteria: Messbare Kriterien
80- clarified_task.constraints: Einschraenkungen
81- metadata.original_request: Urspruenglicher Auftrag
82- metadata.confidence: high/medium/low
83
84### Phase 5: Bestaetigung mit Prompt-Vorschau
85
86Zeige dem User eine lesbare Zusammenfassung mit Ziel, Problem, Scope, Erfolgskriterien, Constraints.
87
88Frage: Soll ich loslegen? (ja / nein / anpassen: ...)
89Oder: /prompt-architect fuer einen strukturierten Best-Practice Prompt
90
91### Phase 6: Reaktion auf Bestaetigung
92
93| Antwort | Aktion |
94|---------|--------|
95| ja / ok / los / mach | Ausfuehren mit internem JSON-Kontext |
96| nein / stop / abbrechen | Abbrechen, nachfragen was stattdessen |
97| anpassen: ... | JSON modifizieren, erneut zeigen |
98| /prompt-architect | An prompt-architect Skill uebergeben |
99| mach einfach | Mit eigenem Ermessen ausfuehren |
100
101## Escape Hatches
102
103User kann Klaerung jederzeit ueberspringen mit:
104- Mach einfach
105- Entscheide selbst
106- Keine Rueckfragen
107- Egal, hauptsache X funktioniert
108- Just do it
109
110Bei Escape: Mit bestem Wissen ausfuehren, aber Annahmen dokumentieren.
111
112## Integration mit prompt-architect
113
114Nach erfolgreicher Klaerung kann der User /prompt-architect aufrufen.
115Der prompt-architect Skill nutzt das JSON aus Phase 4, um einen vollstaendigen
116Best-Practice Prompt nach Claude 4.x Standards zu generieren.
117
118Workflow:
119clarify-spec -> JSON Output -> prompt-architect -> Ausfuehrung
120
121## Metrik: Erfolg
122
123Der Skill ist erfolgreich wenn:
124- Weniger Nacharbeit nach Implementierung
125- User sagt Ja, genau das meinte ich
126- Erste Implementierung erfuellt alle Kriterien
127- Keine Das meinte ich nicht Situationen
tools-only