clarify-spec

Name: clarify-spec
Author: Svenja-dev

22installs5forks

How to install clarify-spec?

svenja-dev/claude-code-skills/clarify-spec

$npx -y skills add Svenja-dev/claude-code-skills --skill clarify-spec

Installs into the current project.

Summary

Klaert einen Auftrag NUR wenn er echt mehrdeutig ist und eigenes Recherchieren (Grep/Glob/Read der Projektdateien) die Unklarheit nicht aufloest. NICHT triggern bei: kurzen Auftraegen, vagen Verben allein ("fix X", "mach Y besser"), fehlenden Dateinamen. Das sind normale Alltagsa

Files · 1

View on GitHub

SKILL.md

1	# Clarify-Spec v3.0: Auftragsklaerung mit hoher Schwelle
2
3	## Grundhaltung
4
5	Dieser Skill ist kein Reflex. Sein Vorgaenger (v2.0 mit aggressiver
6	Rueckfrage-Schwelle) hat eine Frage-Schleife erzeugt, in der Lara nur noch
7	getippt hat statt Arbeit voranzubringen. Das ist der Fehler, den v3.0 verhindert.
8
9	Die Regel ist: **Erst selbst nachsehen. Dann eine Senior-Entscheidung treffen.
10	Nur wenn eine echte Ziel-Mehrdeutigkeit bleibt — einmal gebuendelt fragen.**
11
12	Ein kurzer Auftrag ist kein Problem. Ein vages Verb ist kein Problem. Ein fehlender
13	Dateiname ist kein Problem — den findet man mit Grep. Ein echt mehrdeutiges Ziel
14	ist ein Problem.
15
16	## Wann dieser Skill triggert (hohe Schwelle)
17
18	NUR wenn nach eigener Recherche mindestens eines davon zutrifft:
19
20	\| Echte Mehrdeutigkeit \| Beispiel \|
21	\|---\|---\|
22	\| Das Ziel selbst ist unklar/widerspruechlich \| "mach es wie besprochen" — es gibt keine Notiz, was besprochen wurde \|
23	\| Mehrere grundlegend verschiedene Interpretationen \| "raeum die Auth auf" — koennte Refactor, Logging, Token-Rotation oder Tests heissen, alle plausibel \|
24	\| Information fehlt, die NIRGENDS im Repo steht \| "nutz die neue API" — keine API im Code, kein Doc, kein Issue \|
25	\| Irreversible Aktion mit unklarem Scope \| "loesch die alten Branches" — welche genau? unwiederbringlich \|
26
27	## Wann dieser Skill NICHT triggert
28
29	Bei all dem: NICHT fragen — recherchieren und arbeiten.
30
31	- Kurzer Auftrag ("fix den Export-Bug") → Bug suchen, fixen.
32	- Vages Verb ("mach die Seite besser") → wenn der Kontext den Mangel klarmacht
33	(offensichtlicher Bug, kaputtes Layout): beheben. Wenn wirklich offen: EINE
34	gebuendelte Frage, was "besser" konkret heisst — aber erst nach Ansehen der Seite.
35	- Kein Dateiname genannt → Glob/Grep findet die Datei.
36	- "wie immer" / "das uebliche" → Git-History und bestehende Patterns zeigen das Uebliche.
37
38	## Workflow
39
40	### Phase 1: Eigenrecherche zuerst (immer, still, ohne User)
41
42	Bevor irgendeine Frage gestellt wird:
43
44	1. Relevante Dateien suchen (Glob/Grep) und lesen.
45	2. CLAUDE.md / AGENTS.md / Memory pruefen.
46	3. Git-History und aehnliche bestehende Implementierungen ansehen.
47	4. No-Touch-Zones identifizieren.
48
49	Nach Phase 1 ist die Frage in den allermeisten Faellen beantwortet. Dann: **direkt
50	arbeiten, Phase 2-4 ueberspringen.**
51
52	### Phase 2: Echtheits-Pruefung der Unklarheit
53
54	Bleibt nach Phase 1 etwas offen — pruefen: Ist das eine **echte
55	Ziel-Mehrdeutigkeit** (Tabelle oben) oder nur ein Detail, das eine
56	Senior-Entscheidung verträgt?
57
58	- Detail, das man vernuenftig selbst entscheiden kann → entscheiden, Annahme im
59	Ergebnis dokumentieren, weiterarbeiten.
60	- Echte Ziel-Mehrdeutigkeit → Phase 3.
61
62	### Phase 3: EIN gebuendelter Fragen-Block
63
64	Wenn gefragt werden muss: alle offenen Punkte auf einmal ueber das
65	`AskUserQuestion`-Tool (bis zu 4 Fragen gleichzeitig). Nicht nacheinander, nicht
66	ueber mehrere Nachrichten verteilt.
67
68	Fragen-Prioritaet — nur was wirklich offen ist:
69
70	\| Prio \| Typ \| Wann fragen \|
71	\|------\|-----\|-------------\|
72	\| 1 \| ZIEL \| Das Ziel selbst ist mehrdeutig — welche Interpretation? \|
73	\| 2 \| SCOPE \| Bei irreversiblen Aktionen: was genau ist betroffen? \|
74	\| 3 \| INFO \| Information fehlt, die nirgends im Repo steht \|
75
76	WAS/WO-Fragen ("welche Datei?", "Frontend oder Backend?") gehoeren NICHT hierher —
77	die beantwortet Phase 1.
78
79	### Phase 4: Nach den Antworten — autonom
80
81	Sobald die Antworten da sind: durcharbeiten bis fertig. Keine weitere
82	Rueckfrage, kein Approval-Checkpoint pro Schritt, kein erneutes Klaeren. Nur ein
83	echter, vorher unsichtbarer Blocker rechtfertigt eine weitere Frage.
84
85	## Escape Hatches
86
87	Klaerung wird komplett uebersprungen bei:
88	- "Mach einfach" / "Entscheide selbst" / "Keine Rueckfragen"
89	- "Egal, hauptsache X funktioniert" / "Just do it"
90
91	Bei Escape: mit bestem Wissen ausfuehren, getroffene Annahmen am Ende kurz nennen.
92
93	## Verhaeltnis zu prompt-architect
94
95	`prompt-architect` triggert NICHT mehr automatisch nach diesem Skill. Wenn ein
96	strukturierter Prompt gebraucht wird, ruft der User `/prompt-architect` explizit auf.

People who liked this also viewed

6 picks

Type

clarify-spec

22installs5forks

View on GitHub

How to install clarify-spec?

svenja-dev/claude-code-skills/clarify-spec

$npx -y skills add Svenja-dev/claude-code-skills --skill clarify-spec

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Clarify-Spec v3.0: Auftragsklaerung mit hoher Schwelle
2
3	## Grundhaltung
4
5	Dieser Skill ist kein Reflex. Sein Vorgaenger (v2.0 mit aggressiver
6	Rueckfrage-Schwelle) hat eine Frage-Schleife erzeugt, in der Lara nur noch
7	getippt hat statt Arbeit voranzubringen. Das ist der Fehler, den v3.0 verhindert.
8
9	Die Regel ist: **Erst selbst nachsehen. Dann eine Senior-Entscheidung treffen.
10	Nur wenn eine echte Ziel-Mehrdeutigkeit bleibt — einmal gebuendelt fragen.**
11
12	Ein kurzer Auftrag ist kein Problem. Ein vages Verb ist kein Problem. Ein fehlender
13	Dateiname ist kein Problem — den findet man mit Grep. Ein echt mehrdeutiges Ziel
14	ist ein Problem.
15
16	## Wann dieser Skill triggert (hohe Schwelle)
17
18	NUR wenn nach eigener Recherche mindestens eines davon zutrifft:
19
20	\| Echte Mehrdeutigkeit \| Beispiel \|
21	\|---\|---\|
22	\| Das Ziel selbst ist unklar/widerspruechlich \| "mach es wie besprochen" — es gibt keine Notiz, was besprochen wurde \|
23	\| Mehrere grundlegend verschiedene Interpretationen \| "raeum die Auth auf" — koennte Refactor, Logging, Token-Rotation oder Tests heissen, alle plausibel \|
24	\| Information fehlt, die NIRGENDS im Repo steht \| "nutz die neue API" — keine API im Code, kein Doc, kein Issue \|
25	\| Irreversible Aktion mit unklarem Scope \| "loesch die alten Branches" — welche genau? unwiederbringlich \|
26
27	## Wann dieser Skill NICHT triggert
28
29	Bei all dem: NICHT fragen — recherchieren und arbeiten.
30
31	- Kurzer Auftrag ("fix den Export-Bug") → Bug suchen, fixen.
32	- Vages Verb ("mach die Seite besser") → wenn der Kontext den Mangel klarmacht
33	(offensichtlicher Bug, kaputtes Layout): beheben. Wenn wirklich offen: EINE
34	gebuendelte Frage, was "besser" konkret heisst — aber erst nach Ansehen der Seite.
35	- Kein Dateiname genannt → Glob/Grep findet die Datei.
36	- "wie immer" / "das uebliche" → Git-History und bestehende Patterns zeigen das Uebliche.
37
38	## Workflow
39
40	### Phase 1: Eigenrecherche zuerst (immer, still, ohne User)
41
42	Bevor irgendeine Frage gestellt wird:
43
44	1. Relevante Dateien suchen (Glob/Grep) und lesen.
45	2. CLAUDE.md / AGENTS.md / Memory pruefen.
46	3. Git-History und aehnliche bestehende Implementierungen ansehen.
47	4. No-Touch-Zones identifizieren.
48
49	Nach Phase 1 ist die Frage in den allermeisten Faellen beantwortet. Dann: **direkt
50	arbeiten, Phase 2-4 ueberspringen.**
51
52	### Phase 2: Echtheits-Pruefung der Unklarheit
53
54	Bleibt nach Phase 1 etwas offen — pruefen: Ist das eine **echte
55	Ziel-Mehrdeutigkeit** (Tabelle oben) oder nur ein Detail, das eine
56	Senior-Entscheidung verträgt?
57
58	- Detail, das man vernuenftig selbst entscheiden kann → entscheiden, Annahme im
59	Ergebnis dokumentieren, weiterarbeiten.
60	- Echte Ziel-Mehrdeutigkeit → Phase 3.
61
62	### Phase 3: EIN gebuendelter Fragen-Block
63
64	Wenn gefragt werden muss: alle offenen Punkte auf einmal ueber das
65	`AskUserQuestion`-Tool (bis zu 4 Fragen gleichzeitig). Nicht nacheinander, nicht
66	ueber mehrere Nachrichten verteilt.
67
68	Fragen-Prioritaet — nur was wirklich offen ist:
69
70	\| Prio \| Typ \| Wann fragen \|
71	\|------\|-----\|-------------\|
72	\| 1 \| ZIEL \| Das Ziel selbst ist mehrdeutig — welche Interpretation? \|
73	\| 2 \| SCOPE \| Bei irreversiblen Aktionen: was genau ist betroffen? \|
74	\| 3 \| INFO \| Information fehlt, die nirgends im Repo steht \|
75
76	WAS/WO-Fragen ("welche Datei?", "Frontend oder Backend?") gehoeren NICHT hierher —
77	die beantwortet Phase 1.
78
79	### Phase 4: Nach den Antworten — autonom
80
81	Sobald die Antworten da sind: durcharbeiten bis fertig. Keine weitere
82	Rueckfrage, kein Approval-Checkpoint pro Schritt, kein erneutes Klaeren. Nur ein
83	echter, vorher unsichtbarer Blocker rechtfertigt eine weitere Frage.
84
85	## Escape Hatches
86
87	Klaerung wird komplett uebersprungen bei:
88	- "Mach einfach" / "Entscheide selbst" / "Keine Rueckfragen"
89	- "Egal, hauptsache X funktioniert" / "Just do it"
90
91	Bei Escape: mit bestem Wissen ausfuehren, getroffene Annahmen am Ende kurz nennen.
92
93	## Verhaeltnis zu prompt-architect
94
95	`prompt-architect` triggert NICHT mehr automatisch nach diesem Skill. Wenn ein
96	strukturierter Prompt gebraucht wird, ruft der User `/prompt-architect` explizit auf.

People who liked this also viewed

6 picks

Type