2
0
Files
agent-skills/skills/klarheit-mit-idea2self/SKILL.md
T
Philipp Sieder 3479384600 refactor(router): slim klarheit-mit-idea2self to routing pattern
Rewrite SKILL.md to be a pure router per workflow-skill design rules:

- description: trigger conditions only (AP-20). Entry triggers + explicit
  anti-triggers naming each i2s-* sub-skill.
- 3 numbered phases (intent / precondition / hand-off) with entry/exit
  criteria (AP-6, AP-7).
- Routing pattern with 8 paths: 7 hand-offs to i2s-* sub-skills + 1
  cross-cut workflow (review-iterate) kept internal.
- Reference set reduced to router-essentials: routing-table.md (new),
  kommunikationsregeln.md, artefakt-pipeline.md.
- Tools narrowed to read/write/edit/glob/grep/ask/todo.

Add references/routing-table.md with trigger -> sub-skill mapping,
precondition rules, hand-off message format, sequence diagram, and
anti-trigger guards.

Vestigial refs (methodik.md, export-formate.md, recherche-regeln.md)
and templates/prototyp-remixer-auswertung.md remain in router for now;
they will be removed in step 10b after sub-skill extraction so any
inter-step git mv preserves rename detection.

Step 3 of i2s-skill-split refactor.
2026-05-19 01:10:07 +02:00

138 lines
7.7 KiB
Markdown

---
name: klarheit-mit-idea2self
description: "Idea2Self Facilitator-Router. Entry-Point fuer den Idea2Self-Prozess: vage Idee zu Action-Plan + WOOP. Loest aus bei 'Ich habe eine Idee', 'Idea2Self starten', 'Idea2Self Sprint', 'Idea2Self Launchpad durchfuehren', 'Idea2Self Coaching', 'Klarheit zur Idee', 'Coach mich bei Umsetzung meiner Idee', 'Idee strukturieren', 'Geschaeftsidee entwickeln', 'Gruendungsidee', 'Nebenprojekt starten', 'ich komme nicht weiter mit meiner Idee', 'ich schaffe es nicht anzufangen', sowie 'idea2self-Datei ueberarbeiten', 'idea2self iterieren', 'idea2self review'. Routet anschliessend an spezialisierte i2s-* Skills. NICHT aktivieren bei direkten Artefakt-Triggern wie 'Problem-Statement erstellen' (dafuer i2s-problem-statement), 'Persona erstellen' (i2s-persona), 'Problemraum recherchieren' (i2s-recherche), 'Experiment planen / MVE-Design' (i2s-experiment-card), 'Prototyp-Konzept erstellen' (i2s-prototyp-konzept), 'Action-Plan erstellen / WOOP' (i2s-action-plan), 'Discovery-Interview / vage Idee strukturieren' (i2s-discovery). Sprache: Deutsch."
allowed-tools: Read Write Edit Glob Grep AskUserQuestion TodoRead TodoWrite
---
# Klarheit mit Idea2Self — Router
Entry-Point fuer den Idea2Self-Prozess. Routet zwischen sieben spezialisierten Workflow-Skills und uebernimmt selbst nur drei cross-cut-Aufgaben: idea2self-Datei anlegen, Sequenz-Empfehlung geben, bestehende Datei iterieren.
## Essential Principles
1. **Routing only.** Der Router fuehrt selbst keine Artefakt-Workflows aus. Er erkennt das Intent, prueft Vorbedingungen, und uebergibt an den passenden `i2s-*` Skill.
2. **idea2self-Datei ist die einzige Quelle der Wahrheit.** Der Router legt sie an (`idea2self-<idee>.md`, kebab-case, 3-5 Woerter). Jeder Sub-Skill liest sie vor seiner Arbeit und schreibt seinen Abschnitt zurueck.
3. **Vorbedingungs-Pruefung vor Hand-off.** Persona braucht Problem-Statement, Experiment-Card braucht Recherche, etc. Wenn eine Vorbedingung fehlt: dem Nutzer den fehlenden Sub-Skill nennen, nicht selbst nachholen.
4. **Sequenz-Empfehlung, kein Zwang.** Standard-Reihenfolge 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7. Nutzer kann ueberspringen, wenn er Infos anderweitig vorhaelt.
5. **Iteration als Router-Capability.** Bestehende idea2self-Datei ueberarbeiten lebt im Router (`workflows/review-iterate.md`) — ein separater Sub-Skill wuerde nur duplizieren.
## When to Use
- Nutzer beschreibt eine vage Idee, will sie strukturieren ("ich habe da eine Idee", "wie packe ich das an?").
- Nutzer fragt nach dem gesamten Idea2Self-Sprint / Launchpad / Coaching-Format.
- Nutzer hat eine bestehende `idea2self-<idee>.md` und will sie ueberarbeiten / iterieren / Konsistenz checken.
- Nutzer ist unsicher, welcher Artefakt-Schritt als naechstes dran ist.
## When NOT to Use
- Nutzer triggert direkt einen Artefakt-Workflow ("Persona erstellen", "Problem-Statement erstellen", "Action-Plan erstellen") -> der jeweilige `i2s-*` Skill aktiviert sich von selbst, der Router bleibt aus.
- Nutzer will Web-Recherche zu seinem Problemraum -> `i2s-recherche` direkt.
- Generelles Brainstorming ohne Idee-Bezug -> kein `i2s-*` Skill, nutze `compound-engineering:ce-brainstorm`.
## Routing Pattern
```
intake (intent + optional file path)
|
+-- "neue Idee" -> i2s-discovery (no prereq)
|
+-- "Problem-Statement" -> i2s-problem-statement (prereq: ## Idee)
+-- "Persona" -> i2s-persona (prereq: ## Problem-Statement)
+-- "Recherche" -> i2s-recherche (prereq: PS + Persona)
+-- "Experiment-Card" -> i2s-experiment-card (prereq: PS + Persona + Recherche)
+-- "Prototyp-Konzept" -> i2s-prototyp-konzept (prereq: Experiment-Card)
+-- "Action-Plan" -> i2s-action-plan (prereq: Prototyp-Konzept)
|
+-- "ueberarbeiten" -> workflows/review-iterate.md (router-internal)
```
Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing-table.md`.
## Phases
### Phase 1 — Intent erkennen
**Entry:** Skill ist aktiviert.
**Aktionen:**
1. Pruefe Nutzer-Nachricht gegen die Trigger-Spalte in `references/routing-table.md`.
2. Falls Nutzer einen Dateipfad nennt: idea2self-Datei laden, vorhandene Sektionen registrieren.
3. Falls Intent unklar: `<intake>`-Block (siehe unten) anzeigen, eine Antwort erfragen.
**Exit:** Intent ist auf genau einen der 8 Routing-Pfade gemappt.
### Phase 2 — Vorbedingung pruefen
**Entry:** Intent ist gemappt.
**Aktionen:**
1. Aus `references/routing-table.md` die Vorbedingungs-Spalte lesen.
2. Falls Vorbedingung erfuellt (Sektion existiert in idea2self-Datei): weiter.
3. Falls Vorbedingung fehlt: Nutzer informieren: "Voraussetzung X fehlt. Trigger zuerst `/<voraussetzungs-skill>` oder bestaetige, dass du X anderweitig vorhaltst."
**Exit:** Voraussetzungen sind erfuellt oder explizit uebergangen.
### Phase 3 — Hand-off oder Iteration
**Entry:** Phase 2 erfolgreich abgeschlossen.
**Aktionen:**
- Fuer Pfad 1-7: Nenne den zustaendigen Sub-Skill und die Trigger-Phrase, mit der der Nutzer ihn aktiviert. Beispiel: "Sage 'Persona erstellen' fuer `i2s-persona`."
- Fuer Pfad 8 (ueberarbeiten): `workflows/review-iterate.md` lesen und exakt befolgen.
**Exit:** Sub-Skill ist genannt (Pfad 1-7) oder Review-Workflow ist abgeschlossen (Pfad 8).
## Intake (wenn Intent unklar)
```
Was moechtest du tun?
1. Neue Idee starten
2. Problem-Statement erstellen -> i2s-problem-statement
3. Persona erstellen -> i2s-persona
4. Problemraum recherchieren -> i2s-recherche
5. Experiment-Card erstellen -> i2s-experiment-card
6. Prototyp-Konzept erstellen -> i2s-prototyp-konzept
7. Action-Plan erstellen (mit WOOP) -> i2s-action-plan
8. Bestehende Datei ueberarbeiten -> router-internal
Wenn du eine bestehende idea2self-Datei hast, nenne den Dateipfad.
```
Warte auf Antwort, bevor du fortfaehrst.
## File Convention
Die zentrale Datei heisst `idea2self-<idee>.md` (Kurztitel, 3-5 Woerter, kebab-case). Wird in `i2s-discovery` Schritt 5 angelegt — der Router stellt nur sicher, dass sie existiert, bevor Sub-Skills aktiv werden.
Datei-Skelett (waechst pro Workflow-Durchlauf): siehe `templates/idea2self-vorlage.md`.
## Quick Reference — Kommunikation
Vollstaendige Regeln: `references/kommunikationsregeln.md`.
- Nuechtern, sachlich, direkt. Keine Motivation, keine Emojis, keine Superlative.
- Alltagssprache. Sprache des Nutzers beibehalten.
- `_(Vorschlag)_` / `_(Annahme)_` fuer ungeklaerte Inhalte.
- Max. 3-4 Saetze pro Nachricht. Strukturierte Ausgaben duerfen laenger sein.
- Steuerbefehle: "Export", "Zurueck", "Ich weiss es nicht", "Ueberspringen", "Weiter".
- Fortschrittsanzeige: "[X] von Y" pro Workflow.
## Reference Index
| File | Purpose |
|------|---------|
| `references/routing-table.md` | Trigger-Phrasen -> Sub-Skill + Vorbedingungs-Pruefung |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated extract aus `plugin-shared/`) |
| `references/artefakt-pipeline.md` | Pipeline-Uebersicht + idea2self-Datei-Lifecycle (curated extract) |
| `workflows/review-iterate.md` | Bestehende Datei ueberarbeiten (router-cross-cut) |
| `templates/idea2self-vorlage.md` | Datei-Skelett, wird in i2s-discovery angelegt |
## Success Criteria
- [ ] Nutzer-Intent ist auf genau einen Routing-Pfad gemappt.
- [ ] Vorbedingungen sind geprueft. Fehlende Vorbedingungen werden mit Hand-off-Hinweis adressiert, nicht still uebergangen.
- [ ] Bei Pfad 1-7: der zustaendige Sub-Skill ist genannt mit Trigger-Phrase. Der Router fuehrt den Workflow NICHT selbst aus.
- [ ] Bei Pfad 8: `workflows/review-iterate.md` ist ausgefuehrt, idea2self-Datei wurde aktualisiert, Changelog-Eintrag vorhanden.
- [ ] idea2self-Datei bleibt die alleinige Quelle der Wahrheit. Keine parallelen Notizen.