2
0
Files
agent-skills/skills/i2s-discovery/SKILL.md
T
Philipp Sieder 276c7b24fc chore(i2s): add metadata.version to all skill frontmatter
Per DEC-0013 D1 + R-008 (lint_skill_version hook) +
architecture-defaults (version lives at metadata.version, never
top-level). Router klarheit-mit-idea2self = 2.0.0 (continues the
monolith); the 7 i2s-* sub-skills = 1.0.0 (new).
2026-05-21 22:40:54 +02:00

120 lines
6.5 KiB
Markdown

---
name: i2s-discovery
description: "Idea2Self Discovery-Interview. Strukturiert eine vage Idee in einem 5-Schritt-Interview (Orientierung, Vertiefung adaptiv nach Ideen-Typ, Widerspruchspruefung, Bestaetigung, Datei-Bootstrap). Loest aus bei 'Discovery-Interview', 'vage Idee strukturieren', 'Idee erfassen', 'neue Idee starten' (wenn aus Router-Hand-off oder direkt), 'meine Idee in eine Datei bringen', 'idea2self-Datei anlegen', 'Idee in Struktur giessen'. NICHT aktivieren bei: 'Idea2Self starten / Sprint / Coaching' (dafuer klarheit-mit-idea2self Router), 'Problem-Statement erstellen' (dafuer i2s-problem-statement), 'Persona erstellen' (i2s-persona), oder wenn bereits eine idea2self-Datei mit ## Idee existiert und der Nutzer iterieren will (dafuer klarheit-mit-idea2self review-iterate). Output: ## Idee Sektion in neuer idea2self-<kurztitel>.md Datei. Sprache: Deutsch."
allowed-tools: Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
metadata:
version: 1.0.0
---
# i2s-discovery — Idea2Self Discovery-Interview
Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Schritt-Interview, das eine vage Idee in eine strukturierte Idee + persoenliche Passung + Scope-Ausschluss verwandelt. Legt am Ende die zentrale `idea2self-<kurztitel>.md` Datei an.
## Essential Principles
1. **Adaptiv nach Ideen-Typ.** Nach 2-3 Orientierungs-Fragen klassifizieren (Produkt / Wissen / Community / Content / Physisches / unklar). Folgefragen sind typ-spezifisch — generische Fragenliste ist Sediment.
2. **Persoenliche Passung ist Pflicht.** "Warum ich?" — ohne Verbindung zwischen Idee und Founder-Staerken/-Motivation bleibt die Datei tot. Wenn Nutzer ausweicht: konkrete Sub-Frage stellen ("Wer in deinem Netzwerk hat das Problem konkret?").
3. **Scope-Ausschluss vor Bestaetigung.** "Was wird bewusst NICHT gebaut?" gehoert in Schritt 2, nicht nachgelagert. Ohne Ausschluss bleibt der Scope diffus und der Action-Plan spaeter unmoeglich.
4. **Widerspruch wird benannt, nicht ignoriert.** "Einfach UND umfassend", "alle als Zielgruppe", "Loesung ohne Problem" — explizit thematisieren in Schritt 3. Optionen anbieten statt nachsichtig sein.
5. **Inline-Recherche moeglich, aber nicht Default.** Bei Wissensluecke des Nutzers: anbieten ("Soll ich kurz recherchieren?"). Erst auf Bestaetigung WebSearch nutzen. Ergebnisse als `_(Recherche)_` markieren.
## When to Use
- Nutzer hat eine **noch nicht strukturierte** Idee und will sie in Form bringen.
- Aus Router-Hand-off (Pfad 1 in `klarheit-mit-idea2self/references/routing-table.md`).
- Direkter Trigger: "Discovery-Interview", "vage Idee strukturieren", "Idee erfassen", "idea2self-Datei anlegen".
## When NOT to Use
- Es gibt bereits eine `idea2self-<idee>.md` mit ausgefuellter `## Idee` Sektion -> Router review-iterate oder direkter Sub-Skill je nach Iterations-Ziel.
- Nutzer will direkt zum Problem-Statement -> `i2s-problem-statement` (wenn Idee bereits klar genug fuer HMW-Formulierung).
- Generelles Idee-Brainstorming ohne Validierungsabsicht -> `compound-engineering:ce-brainstorm`.
## Phases
### Phase 1 — Orientierung
**Entry:** Skill aktiviert.
**Aktionen:**
1. Stelle 3 Orientierungs-Fragen (siehe `workflows/discovery.md` Schritt 1).
2. Aus den Antworten den **Ideen-Typ** ableiten.
3. Typ explizit zurueckspiegeln: "Klingt nach einer/m [Typ]-Idee. Korrekt?"
**Exit:** Ideen-Typ ist bestaetigt.
### Phase 2 — Vertiefung (adaptiv)
**Entry:** Ideen-Typ bestaetigt.
**Aktionen:**
1. Lade die typ-relevanten Kategorien aus `workflows/discovery.md` Schritt 2 (4 Kategorien: Problem/Motivation, Zielgruppe, Kontext/Ressourcen, Scope/Abgrenzung).
2. Stelle pro Kategorie 1-2 Fragen, max 4-6 insgesamt.
3. Bei Wissensluecke des Nutzers: Inline-Recherche anbieten (`web_search`).
4. Pflicht-Frage am Ende von Phase 2: "Was wird bewusst NICHT dazugehoeren?"
**Exit:** Alle 4 Kategorien beruehrt + Scope-Ausschluss benannt.
### Phase 3 — Widerspruchspruefung
**Entry:** Phase 2 abgeschlossen.
**Aktionen:**
1. Pruefe Antworten gegen die 4 typischen Konflikte (`workflows/discovery.md` Schritt 3).
2. Bei Konflikt: benennen, Optionen geben, Nutzer-Entscheidung einholen.
3. Bei keinem Konflikt: explizit "Keine inneren Widersprueche erkannt" sagen.
**Exit:** Konflikte sind geloest oder als offen markiert.
### Phase 4 — Bestaetigung
**Entry:** Phase 3 abgeschlossen.
**Aktionen:**
1. Verstaendnis zusammenfassen ("Du willst [X] fuer [Zielgruppe] bauen, weil [Motivation]. Kernproblem: [P]. Ressourcen: [R]. Ausschluss: [A]. Stimmt das?").
2. Auf Bestaetigung warten. Bei Korrektur: Phase 2 punktuell zurueckspringen.
**Exit:** Nutzer bestaetigt das zusammengefasste Verstaendnis.
### Phase 5 — Datei-Bootstrap
**Entry:** Bestaetigung erhalten.
**Aktionen:**
1. Kurztitel ableiten (3-5 Woerter, kebab-case).
2. `idea2self-<kurztitel>.md` aus `templates/idea2self-vorlage.md` anlegen.
3. `## Idee` Sektion nach `references/idee-format.md` ausfuellen.
4. Restliche Sektionen als leere Platzhalter einsetzen.
5. `## Changelog` mit erstem Eintrag (Datum + "Datei angelegt").
6. Datei dem Nutzer zeigen + Hand-off-Hinweis: "Naechster Schritt: Problem-Statement. Trigger: 'Problem-Statement erstellen' fuer `i2s-problem-statement`."
**Exit:** Datei existiert auf Disk, `## Idee` ist ausgefuellt, Hand-off ausgesprochen.
## Quick Reference
Kommunikation: `references/kommunikationsregeln.md` (Tonalitaet, Marker, Steuerbefehle).
Datei-Format: `references/idee-format.md` (Schema fuer `## Idee` Sektion).
Datei-Skelett: `templates/idea2self-vorlage.md`.
Workflow-Detail (alle 5 Schritte): `workflows/discovery.md`.
## Reference Index
| File | Purpose |
|------|---------|
| `workflows/discovery.md` | Vollstaendiger 5-Schritt-Interview-Ablauf mit Fragen |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker (Vorschlag/Annahme), Steuerbefehle |
| `references/idee-format.md` | Markdown-Schema fuer die `## Idee` Sektion |
| `templates/idea2self-vorlage.md` | Skelett der idea2self-Datei (wird in Phase 5 angelegt) |
## Success Criteria
- [ ] Ideen-Typ ist klassifiziert + bestaetigt.
- [ ] Idee ist in 1-2 Saetzen beschreibbar.
- [ ] Zielgruppe ist benannt (vage erlaubt, aber konkrete Person als Anker).
- [ ] Problem ist identifiziert.
- [ ] Persoenliche Motivation + Ressourcen (Stunden/Woche) sind klar.
- [ ] Scope-Ausschluss ist definiert.
- [ ] Innere Widersprueche sind benannt oder geloest.
- [ ] `idea2self-<kurztitel>.md` existiert mit `## Idee` Sektion + `## Changelog`.
- [ ] Hand-off zu `i2s-problem-statement` ist ausgesprochen.