2
0

refactor(skills): migrate all 8 SKILL.md to pure-XML + apply audit fixes

Pure-XML body structure per marketplace-tools use-xml-tags.md (DEC-0013
D-XML, founder-approved): all markdown headings removed from skill
bodies, replaced with semantic tags (<objective>, <quick_start>,
<success_criteria> required; <essential_principles>, <when_to_use>,
<when_not_to_use>, <precondition_check>, <workflow>, <reference_guides>,
plus router <routing>/<intake>/<file_convention>/<guardrails>). Phases
kept as bold labels inside <workflow>. Frontmatter (name, description,
allowed-tools, metadata.version) preserved; all reference paths intact.

Audit fixes (REV 2026-05-21) folded into the per-skill migration:
- F1 i2s-persona: drop inline-research line (no WebFetch/WebSearch
  declared) -> point to i2s-recherche.
- F2 i2s-discovery: web_search -> WebSearch (correct tool name).
- F3 i2s-discovery/experiment-card/prototyp-konzept: document that
  WebFetch/WebSearch fire only on explicit confirmation for a single
  lookup (full research lives in i2s-recherche).
- F4 router: shorten 897-char description to ~480 (exhaustive trigger
  list lives in references/routing-table.md).
- F5 i2s-experiment-card: soften description preconditions (v0.2
  preferred, not enforced — matches the actual precondition check).

Verification (8 checks): no markdown headings, 3 required tags/skill,
frontmatter integrity, XML tags balanced (code-fence aware), local refs
resolve, 8 skills, gitignore present, drift-check exit 0. All green.

8 parallel general-purpose subagents (one per SKILL.md, disjoint files).
This commit is contained in:
Philipp Sieder
2026-05-22 09:47:54 +02:00
parent 174026eb21
commit 7691b408e8
8 changed files with 213 additions and 195 deletions
+24 -25
View File
@@ -6,40 +6,40 @@ metadata:
version: 1.0.0
---
# i2s-action-plan — 14-Tage-Plan + WOOP-Obstacle-Plan
<objective>
Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-startbaren 14-Tage-Plan formen — inklusive **persoenlicher** Huerden via WOOP (Wish-Outcome-Obstacle-Plan, Oettingen). Das WOOP ist nicht Add-on, sondern Pflichtteil — bei Nebenprojekten scheitern mehr Vorhaben an inneren Huerden als an externen Risiken.
</objective>
## Essential Principles
<essential_principles>
1. **10 Aufgaben sind das Maximum.** Mehr fuehrt zu Scope-Overload und Nicht-Start. Wenn der Nutzer 15 nennt: 5 in `## Offene Punkte` parken.
2. **Deadlines sind Pflicht.** Kein Plan ohne Termin. "Demnaechst" zaehlt nicht. Realistisch: max 2 Aufgaben pro Woche bei Nebenprojekt.
3. **Quick Wins vor Strategie.** Aufwand klein + Wirkung gross zuerst — sie liefern Momentum. Strategische Brocken danach, mit konkreter Sequenz.
4. **WOOP ist nicht Add-on, sondern Pflicht.** TA6+TA7 (Hindernisse + Wenn-Dann) sind die wichtigsten Teilaspekte des Workflows. Bei Nebenprojekten scheitern Vorhaben an Prokrastination / Perfektionismus / Selbstzweifel — nicht an Markt.
5. **Wenn-Dann konkret, nicht generisch.** "Wenn ich keine Lust habe, dann arbeite ich trotzdem" ist nicht akzeptabel. "Wenn ich am Dienstagabend keine Lust habe, dann schreibe ich genau eine Karte ohne Anspruch" ist konkret.
</essential_principles>
## When to Use
<when_to_use>
- `## Prototyp-Konzept` existiert; `## Action-Plan` fehlt oder iteriert werden soll.
- Aus Router-Hand-off (Pfad 7) oder direkter Trigger ("Action-Plan erstellen", "WOOP").
- Nach 14-Tage-Pilot-Run: v0.2 mit Lessons aus dem ersten Sprint.
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Prototyp-Konzept` fehlt -> erst `i2s-prototyp-konzept`.
- Allgemeines Projekt-Management ohne Idea2Self-Kontext -> nicht modelliert; nutze `c-level-skills:chief-of-staff` o.ae.
- Nutzer will Strategie / OKRs auf laenger als 14 Tage -> `compound-engineering:ce-strategy` oder Routinen.
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden.
2. Auf `^## Prototyp-Konzept` matchen + Sektion-Inhalt > 100 Zeichen.
3. Fehlt -> abbrechen mit Hinweis: "`## Prototyp-Konzept` fehlt. Trigger zuerst `i2s-prototyp-konzept`."
</precondition_check>
## Phases
<workflow>
### Phase 1 — Kontext laden
**Phase 1 — Kontext laden**
**Entry:** Vorbedingung erfuellt.
@@ -49,7 +49,7 @@ Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-sta
**Exit:** Voranalyse bestaetigt.
### Phase 2 — 7 Teilaspekte
**Phase 2 — 7 Teilaspekte**
**Entry:** Phase 1 abgeschlossen.
@@ -64,7 +64,7 @@ Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-sta
**Exit:** Alle 7 TAs sind beantwortet, mind. 2 Hindernisse + Wenn-Dann-Plaene existieren.
### Phase 3 — Konsistenzpruefung
**Phase 3 — Konsistenzpruefung**
**Entry:** 7 TAs durch.
@@ -77,7 +77,7 @@ Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-sta
**Exit:** Keine offenen Konsistenz-Konflikte.
### Phase 4 — Export
**Phase 4 — Export**
**Entry:** Phase 3 abgeschlossen.
@@ -88,7 +88,7 @@ Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-sta
**Exit:** Datei aktualisiert.
### Phase 5 — Abschluss
**Phase 5 — Abschluss**
**Entry:** Phase 4 abgeschlossen.
@@ -103,24 +103,22 @@ Letzter Schritt im Idea2Self-Prozess. Aus dem Prototyp-Konzept einen konkret-sta
**Exit:** Nutzer hat die Zusammenfassung gesehen, Iterations-Pfad ist bekannt.
## Quick Reference
</workflow>
Kommunikation: `references/kommunikationsregeln.md`.
WOOP-Methodik: `references/woop.md` (Wish-Outcome-Obstacle-Plan nach Gabriele Oettingen).
Format-Schema: `references/action-plan-format.md`.
Workflow-Detail: `workflows/action-plan.md`.
## Reference Index
<quick_start>
Trigger: "Action-Plan erstellen" / "WOOP". Vorbedingung: idea2self-Datei mit `## Prototyp-Konzept` (> 100 Zeichen). Ablauf: 5 Phasen — Kontext laden, 7 Teilaspekte (inkl. WOOP TA6+TA7), Konsistenzpruefung, Export, Abschluss. Output: `## Action-Plan` Sektion inkl. `### Obstacle-Plan (WOOP)`. Details im Reference-Index unten.
</quick_start>
<reference_guides>
| File | Purpose |
|------|---------|
| `workflows/action-plan.md` | Vollstaendiger 5-Schritt-Ablauf mit 7 TAs + Anti-Patterns |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Action-Plan-spezifische Heuristiken (curated) |
| `references/woop.md` | WOOP-Methodik kompakt (curated aus plugin-shared/methodik.md) |
| `references/action-plan-format.md` | Markdown-Schema fuer `## Action-Plan` inkl. WOOP-Subsektion |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Umsetzungsziel ist konkret, ergebnisorientiert (nicht Vision) und in 14 Tagen erreichbar.
- [ ] 10 Aufgaben mit Prioritaet, Deadline, Abhaengigkeiten — Quick Wins zuerst.
- [ ] Externe Risiken sind mit Gegenmassnahmen versehen.
@@ -129,3 +127,4 @@ Workflow-Detail: `workflows/action-plan.md`.
- [ ] Pro Hindernis ist eine der Staerken aus `## Idee` zugeordnet.
- [ ] idea2self-Datei enthaelt `## Action-Plan` inkl. Obstacle-Plan + Versions-Header + Changelog.
- [ ] Abschluss-Zusammenfassung wurde gezeigt, Iterations-Pfad genannt.
</success_criteria>
+23 -21
View File
@@ -6,33 +6,36 @@ metadata:
version: 1.0.0
---
# i2s-discovery — Idea2Self Discovery-Interview
<objective>
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.
</objective>
## Essential Principles
<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.
</essential_principles>
## When to Use
<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_to_use>
## When NOT to Use
<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`.
</when_not_to_use>
## Phases
<quick_start>
Trigger "Discovery-Interview starten" oder "vage Idee strukturieren", keine Vorbedingung noetig. Entry-Point ist Phase 1 (Orientierung); danach laeuft das 5-Schritt-Interview durch bis Phase 5. Output: eine neue `idea2self-<kurztitel>.md` Datei mit ausgefuellter `## Idee` Sektion. Detaillierte Referenzen siehe Reference-Index unten.
</quick_start>
### Phase 1 — Orientierung
<workflow>
**Phase 1 — Orientierung**
**Entry:** Skill aktiviert.
@@ -43,19 +46,19 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
**Exit:** Ideen-Typ ist bestaetigt.
### Phase 2 — Vertiefung (adaptiv)
**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`).
3. Bei Wissensluecke des Nutzers: Inline-Recherche anbieten (`WebSearch`). Web-Tools (`WebSearch`/`WebFetch`) werden NUR auf explizite Nutzer-Bestaetigung und nur fuer eine einzelne Begriffsklaerung aktiviert — fuer volle Recherche an `i2s-recherche` verweisen.
4. Pflicht-Frage am Ende von Phase 2: "Was wird bewusst NICHT dazugehoeren?"
**Exit:** Alle 4 Kategorien beruehrt + Scope-Ausschluss benannt.
### Phase 3 — Widerspruchspruefung
**Phase 3 — Widerspruchspruefung**
**Entry:** Phase 2 abgeschlossen.
@@ -66,7 +69,7 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
**Exit:** Konflikte sind geloest oder als offen markiert.
### Phase 4 — Bestaetigung
**Phase 4 — Bestaetigung**
**Entry:** Phase 3 abgeschlossen.
@@ -76,7 +79,7 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
**Exit:** Nutzer bestaetigt das zusammengefasste Verstaendnis.
### Phase 5 — Datei-Bootstrap
**Phase 5 — Datei-Bootstrap**
**Entry:** Bestaetigung erhalten.
@@ -89,25 +92,23 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
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.
</workflow>
## Quick Reference
<reference_guides>
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) |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Ideen-Typ ist klassifiziert + bestaetigt.
- [ ] Idee ist in 1-2 Saetzen beschreibbar.
- [ ] Zielgruppe ist benannt (vage erlaubt, aber konkrete Person als Anker).
@@ -117,3 +118,4 @@ Workflow-Detail (alle 5 Schritte): `workflows/discovery.md`.
- [ ] Innere Widersprueche sind benannt oder geloest.
- [ ] `idea2self-<kurztitel>.md` existiert mit `## Idee` Sektion + `## Changelog`.
- [ ] Hand-off zu `i2s-problem-statement` ist ausgesprochen.
</success_criteria>
+25 -23
View File
@@ -1,45 +1,44 @@
---
name: i2s-experiment-card
description: "Idea2Self Experiment-Card-Workflow. Formuliert die riskanteste Annahme als pruefbare Hypothese (Wir-glauben-dass-fuer-weil-Form), waehlt ein Minimum-Viable-Experiment (Strasseninterview / Online-Umfrage / Landing-Page-Test / Prototyp-Test / Beobachtung), definiert Metriken mit Entscheidungsschwellen UND eine Weiter/Aendern/Lassen-Entscheidungslogik. Loest aus bei 'Experiment-Card erstellen', 'Hypothese formulieren', 'MVE-Design', 'Minimum Viable Experiment', 'Annahme pruefen', 'Lean Startup Hypothese', 'Entscheidungsschwelle festlegen', 'Interview-Leitfaden fuer Idea2Self'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Recherche zur Idee' (i2s-recherche), 'Prototyp-Konzept' (i2s-prototyp-konzept), oder wenn Recherche-Report noch fehlt. Vorbedingung: idea2self-Datei mit ## Problem-Statement v0.2, ## Persona v0.2 und ## Recherche-Report. Output: ## Experiment-Card Sektion. Sprache: Deutsch."
description: "Idea2Self Experiment-Card-Workflow. Formuliert die riskanteste Annahme als pruefbare Hypothese (Wir-glauben-dass-fuer-weil-Form), waehlt ein Minimum-Viable-Experiment (Strasseninterview / Online-Umfrage / Landing-Page-Test / Prototyp-Test / Beobachtung), definiert Metriken mit Entscheidungsschwellen UND eine Weiter/Aendern/Lassen-Entscheidungslogik. Loest aus bei 'Experiment-Card erstellen', 'Hypothese formulieren', 'MVE-Design', 'Minimum Viable Experiment', 'Annahme pruefen', 'Lean Startup Hypothese', 'Entscheidungsschwelle festlegen', 'Interview-Leitfaden fuer Idea2Self'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Recherche zur Idee' (i2s-recherche), 'Prototyp-Konzept' (i2s-prototyp-konzept), oder wenn Recherche-Report noch fehlt. Vorbedingung: idea2self-Datei mit ## Problem-Statement, ## Persona und ## Recherche-Report (v0.2 bevorzugt). Output: ## Experiment-Card Sektion. Sprache: Deutsch."
allowed-tools: Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
metadata:
version: 1.0.0
---
# i2s-experiment-card — Hypothese + Experiment-Design
<objective>
Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** riskanteste Annahme, formuliert sie als pruefbare Hypothese und designed das kleinstmoegliche Experiment, das diese Annahme bestaetigt oder widerlegt. Definiert Entscheidungsschwellen **vor** Durchfuehrung.
</objective>
## Essential Principles
<essential_principles>
1. **Eine Hypothese, nicht mehrere.** Wir testen die **riskanteste** Annahme — die, deren Wegfall das Konzept kippt. Andere Annahmen warten.
2. **Hypothesen-Format ist Pflicht.** "Wir glauben, dass [Annahme] fuer [Zielgruppe] weil [Begruendung]." Ohne diese Struktur bleibt die Hypothese unpruefbar.
3. **MVE, nicht MVP.** Minimum Viable **Experiment**, nicht Minimum Viable **Product**. Goal: Lernen, nicht Bauen. 5-10 Strasseninterviews schlagen 2 Wochen Landing-Page-Bau.
4. **Entscheidungsschwellen VOR dem Experiment.** Nicht hinterher rationalisieren. "Ab welchem Wert wuerdest du sagen: das reicht?" muss vor dem ersten Interview beantwortet sein.
5. **Drei Entscheidungs-Outcomes, nicht zwei.** Weitermachen / Aendern / Lassen — das **Lassen** ist die schwierigste, aber wichtigste Schwelle.
</essential_principles>
## When to Use
<when_to_use>
- `## Recherche-Report` existiert, `## Experiment-Card` fehlt oder soll iteriert werden.
- Aus Router-Hand-off (Pfad 5) oder direkter Trigger ("Experiment planen", "MVE", "Hypothese formulieren").
- Nach erstem Experiment-Lauf: neue Hypothese fuer naechste Schleife (v0.2).
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Recherche-Report` fehlt -> erst `i2s-recherche`.
- Nutzer will das Konzept selbst designen (Features, User Flow) -> `i2s-prototyp-konzept`.
- Allgemeine Hypothesen-Generierung ohne Idea2Self-Kontext -> nicht modelliert.
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden.
2. Auf `^## Problem-Statement` UND `^## Persona` UND `^## Recherche-Report` matchen, jeweils > 100 Zeichen Inhalt.
3. Fehlt eines davon -> abbrechen, Hand-off auf den voraussetzenden Sub-Skill.
</precondition_check>
## Phases
### Phase 1 — Kontext laden
<workflow>
**Phase 1 — Kontext laden**
**Entry:** Vorbedingung erfuellt.
@@ -49,7 +48,7 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
**Exit:** Voranalyse bestaetigt oder Kandidaten-Annahmen-Liste korrigiert.
### Phase 2 — 5 Teilaspekte (gefuehrte Fragen)
**Phase 2 — 5 Teilaspekte (gefuehrte Fragen)**
**Entry:** Phase 1 abgeschlossen.
@@ -59,11 +58,11 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
3. **TA3 METRIKEN.** Pro Metrik: Entscheidungsschwelle ("Ab welchem Wert ist die Hypothese bestaetigt?"). Anti-Pattern: keine Schwelle -> "Was waere ein Ergebnis, bei dem du sagst: das lasse ich?"
4. **TA4 INTERVIEW-LEITFADEN** (wenn TA2 = Interview): 3 wichtigste Fragen + Regeln (offene Fragen, keine Suggestiv, zuhoeren > reden, Eroeffnung + Abschluss).
5. **TA5 ENTSCHEIDUNGSLOGIK.** Drei Schwellen festzurren: "Weitermachen wenn ...", "Aendern wenn ...", "Lassen wenn ...".
6. Inline-Recherche zu Interview-Techniken / typischen Fehlern erlaubt (max 1× pro TA).
6. Inline-Recherche zu Interview-Techniken / typischen Fehlern erlaubt (max 1× pro TA). Web-Tools (WebFetch/WebSearch) nur auf Bestaetigung des Nutzers und nur fuer die Klaerung einer einzelnen Interview-Technik nutzen — keine Markt- oder Wettbewerbs-Recherche (die gehoert nicht in diesen Skill, sondern nach `i2s-recherche`).
**Exit:** Alle 5 TAs sind beantwortet oder explizit als "Nicht erarbeitet" markiert.
### Phase 3 — Konsistenzpruefung
**Phase 3 — Konsistenzpruefung**
**Entry:** 5 TAs durch.
@@ -76,7 +75,7 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
**Exit:** Keine offenen Konsistenz-Konflikte.
### Phase 4 — Export
**Phase 4 — Export**
**Entry:** Phase 3 abgeschlossen.
@@ -87,25 +86,27 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
4. Hand-off: "Experiment-Card ist fertig. Fuehre das Experiment durch — danach kommt das Prototyp-Konzept. Trigger: 'Prototyp-Konzept erstellen' fuer `i2s-prototyp-konzept`. Oder iteriere die Card via `klarheit-mit-idea2self` review-iterate."
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
</workflow>
## Quick Reference
<quick_start>
Trigger: "Experiment planen" / "MVE-Design". Vorbedingung: `## Recherche-Report` (sowie `## Problem-Statement` + `## Persona`) existiert in der idea2self-Datei. Ablauf: 5 Teilaspekte (Hypothese, Experiment-Design, Metriken, Interview-Leitfaden, Entscheidungslogik) durchgehen, Schwellen vor Durchfuehrung festzurren. Output: `## Experiment-Card` Sektion. Detaillierte Quellen siehe Reference-Index unten.
</quick_start>
<reference_guides>
Kommunikation: `references/kommunikationsregeln.md`.
Methodik (Lean Startup Build-Measure-Learn): `references/lean-startup.md`.
Format-Schema: `references/experiment-card-format.md`.
Workflow-Detail: `workflows/experiment-card.md`.
## Reference Index
| File | Purpose |
|------|---------|
| `workflows/experiment-card.md` | Vollstaendiger 4-Schritt-Ablauf mit 5 TAs + Anti-Patterns |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated) |
| `references/lean-startup.md` | Build-Measure-Learn, MVE > MVP, Evidenz-Abstufungen (curated extract aus methodik) |
| `references/experiment-card-format.md` | Markdown-Schema fuer `## Experiment-Card` |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Hypothese im "Wir glauben, dass ... fuer ... weil ..." Format formuliert.
- [ ] Risikostufe bewertet + begruendet.
- [ ] Experiment-Typ gewaehlt, Mindest-Datenpunkte definiert.
@@ -114,3 +115,4 @@ Workflow-Detail: `workflows/experiment-card.md`.
- [ ] Interview-Leitfaden vorhanden (wenn Experiment-Typ = Interview).
- [ ] idea2self-Datei enthaelt `## Experiment-Card` mit Versions-Header + Changelog-Eintrag.
- [ ] Hand-off zu `i2s-prototyp-konzept` ist ausgesprochen.
</success_criteria>
+25 -21
View File
@@ -6,40 +6,44 @@ metadata:
version: 1.0.0
---
# i2s-persona — Verhaltensbasierte Persona
<objective>
Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konkrete, verhaltensbasierte Persona — keine demografische Hochrechnung, sondern eine Arbeitshypothese mit Jobs-to-be-Done und Gains.
</objective>
## Essential Principles
<quick_start>
Trigger: "Persona erstellen". Vorbedingung: idea2self-Datei mit ausgefuellter `## Problem-Statement` Sektion. Ablauf: Kontext laden -> 5 Teilaspekte gefuehrt durchgehen -> Konsistenz pruefen -> 3 Varianten -> finale Variante als `## Persona` in dieselbe Datei schreiben. Output: `## Persona` Sektion mit Versions-Header + Changelog.
</quick_start>
<essential_principles>
1. **Verhaltensbasiert, nicht demografisch.** Eine Persona ist "wie verhaelt sie sich", nicht "wer sie ist". Demografie liefert Anker, JTBD und Gains liefern Handlungsbasis.
2. **Eine Person, kein Segment.** Eine konkrete Anker-Person (Name, Alter, Wohnsituation), nicht Aggregat-Daten. Hypothese, klar als solche markiert.
3. **JTBD ist Aufgabe, nicht Loesung.** "Ich will mein Werkzeug ausleihen ohne App-Account zu machen" ist ein Job. "Ich will deine Tauschboerse nutzen" ist nicht.
4. **Konsistenz zum Problem-Statement.** Wenn die Persona-Eigenschaften dem PS widersprechen (andere Werte, andere Lebenswelt), ist das ein Signal fuer Rueckwaerts-Update — nicht fuer kreative Verbiegung.
5. **Belastbare Arbeitshypothese > perfektes Profil.** Wir formulieren v0.1. Recherche und Interviews ueberarbeiten in v0.2.
</essential_principles>
## When to Use
<when_to_use>
- `## Idee` UND `## Problem-Statement` existieren in idea2self-Datei, `## Persona` fehlt oder soll iteriert werden.
- Aus Router-Hand-off (Pfad 3) oder direkter Trigger ("Persona erstellen", "Zielgruppe definieren").
- Iteration nach Recherche: v0.2 nach neuen Daten aus i2s-recherche.
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Problem-Statement` fehlt -> erst `i2s-problem-statement`.
- Nutzer will Marktrecherche / Wettbewerbsanalyse -> `i2s-recherche`.
- Nutzer will den Loesungs-Ansatz schaerfen -> `i2s-prototyp-konzept`.
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden.
2. Auf `^## Problem-Statement` matchen + Sektion-Inhalt > 100 Zeichen.
3. Fehlt -> abbrechen mit Hinweis: "`## Problem-Statement` fehlt. Trigger zuerst `i2s-problem-statement`."
</precondition_check>
## Phases
<workflow>
### Phase 1 — Kontext laden + Voranalyse
**Phase 1 — Kontext laden + Voranalyse**
**Entry:** Vorbedingung erfuellt.
@@ -50,7 +54,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
**Exit:** Voranalyse bestaetigt oder korrigiert.
### Phase 2 — 5 Teilaspekte (gefuehrte Fragen)
**Phase 2 — 5 Teilaspekte (gefuehrte Fragen)**
**Entry:** Phase 1 abgeschlossen.
@@ -61,11 +65,11 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
4. TA4 GEWINNE (3 vorausgewaehlte Gains-Leitfragen analog).
5. TA5 ERGAENZUNGEN (was macht diese Persona einzigartig).
6. Anti-Pattern-Detection (Stereotyp, JTBD als Loesung, zu viele Merkmale, Widerspruch zu PS).
7. Inline-Recherche nur fuer Berufsbezeichnungen / Lebensstil-Begriffe. NICHT Zielgruppen-Studien (gehoert in `i2s-recherche`).
7. Keine Web-Recherche in diesem Skill. Echte Recherche zu Zielgruppe / Lebenswelt gehoert in `i2s-recherche` (dieser Skill hat kein Web-Tool).
**Exit:** Alle 5 TAs beruehrt + Anti-Patterns geprueft.
### Phase 3 — Konsistenzpruefung
**Phase 3 — Konsistenzpruefung**
**Entry:** 5 TAs durch.
@@ -76,7 +80,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
**Exit:** Keine offenen Konsistenz-Konflikte.
### Phase 4 — Drei Varianten erzeugen
**Phase 4 — Drei Varianten erzeugen**
**Entry:** Phase 3 abgeschlossen.
@@ -89,7 +93,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
**Exit:** Eine finale Persona-Variante ist gewaehlt.
### Phase 5 — Export
**Phase 5 — Export**
**Entry:** Phase 4 abgeschlossen.
@@ -102,25 +106,25 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
## Quick Reference
</workflow>
<reference_guides>
Kommunikation: `references/kommunikationsregeln.md`.
Format-Schema: `references/persona-format.md`.
Workflow-Detail: `workflows/persona.md`.
## Reference Index
| File | Purpose |
|------|---------|
| `workflows/persona.md` | Vollstaendiger 5-Schritt-Ablauf mit 5 TAs + Anti-Patterns + Facilitation-Heuristiken |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle, Persona-spezifische Dialog-Heuristiken (curated) |
| `references/persona-format.md` | Markdown-Schema fuer `## Persona` (Persona-Profil-Tabelle + JTBD + Gains + Kontext) |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Persona ist verhaltensbasiert (nicht nur Demografie).
- [ ] JTBD und Gains sind als Hypothesen formuliert (mit `_(Vorschlag)_` / `_(Annahme)_` markiert).
- [ ] Anker-Person ist konkret (Name, Alter, Wohnsituation).
- [ ] Persona passt zum `## Problem-Statement` (keine offenen Widersprueche).
- [ ] idea2self-Datei enthaelt `## Persona` mit Versions-Header + Changelog-Eintrag.
- [ ] Hand-off zu `i2s-recherche` ist ausgesprochen.
</success_criteria>
+24 -22
View File
@@ -6,40 +6,39 @@ metadata:
version: 1.0.0
---
# i2s-problem-statement — Problem-Statement (HMW)
<objective>
Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes Problem-Statement im **How Might We**-Format. Erzeugt 3 Varianten zur Auswahl und schreibt die finale Version in die idea2self-Datei.
</objective>
## Essential Principles
<essential_principles>
1. **Aus Sicht der Zielgruppe, nicht der Loesung.** Problem-Statement beschreibt das Beduerfnis, nicht den geplanten Ansatz. "Wie koennen wir [Kontext] fuer [Zielgruppe] neu gestalten, damit [Beduerfnis] befriedigt wird — unter Beruecksichtigung von [Einschraenkungen]."
2. **7 Teilaspekte sind Pflicht, aber Tiefe ist adaptiv.** Pro Teilaspekt 1 Leitfrage + max 1 Vertiefung. Wenn Nutzer schon klar geantwortet hat -> weiter. Wenn vage -> Vertiefung.
3. **Drei Varianten, dann eine.** Wortgetreu / geschaerft / zugespitzt sind Sparring-Tool, nicht Output. Der Nutzer waehlt, kombiniert, der Skill iteriert max. 1× nach.
4. **Konsistenz gegen ## Idee.** Wenn Problem-Statement der Idee widerspricht (andere Zielgruppe / anderes Problem): explizit benennen, Update auf `## Idee` vorschlagen (Changelog-Eintrag).
5. **"Alle als Zielgruppe" ist nicht akzeptabel.** Im PS-Workflow muss die Zielgruppe konkreter werden als in `## Idee`. Wenn Nutzer ausweicht: Sub-Frage "Wer hat das Problem am DRINGENDSTEN?" einsetzen.
</essential_principles>
## When to Use
<when_to_use>
- `## Idee` existiert in der idea2self-Datei, `## Problem-Statement` fehlt oder soll iteriert werden.
- Aus Router-Hand-off (Pfad 2) oder direkter Trigger ("Problem-Statement erstellen", "HMW").
- Iteration nach Recherche: Nutzer hat neue Daten und will PS v0.2 schreiben.
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Idee` fehlt oder ist nur eine Ueberschrift -> erst `i2s-discovery`.
- Nutzer will direkt zur Persona -> `i2s-persona` (PS bleibt erstmal vage).
- Nutzer will den Loesungs-Ansatz schaerfen -> `i2s-prototyp-konzept` oder `i2s-experiment-card`.
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden (Pfad aus Nutzer-Prompt oder Standardort).
2. Auf `^## Idee` matchen + Sektion-Inhalt > 50 Zeichen.
3. Fehlt -> abbrechen mit Hinweis: "`## Idee` fehlt in `<datei>`. Trigger zuerst `i2s-discovery`."
</precondition_check>
## Phases
### Phase 1 — Kontext laden + Voranalyse
<workflow>
**Phase 1 — Kontext laden + Voranalyse**
**Entry:** Vorbedingung erfuellt.
@@ -50,7 +49,7 @@ Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes
**Exit:** Nutzer hat Voranalyse bestaetigt oder korrigiert.
### Phase 2 — 7 Teilaspekte (gefuehrte Fragen)
**Phase 2 — 7 Teilaspekte (gefuehrte Fragen)**
**Entry:** Phase 1 abgeschlossen.
@@ -62,7 +61,7 @@ Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes
**Exit:** Alle 7 TAs sind beruehrt (mit Antwort, "Ich weiss nicht", oder explizitem Ueberspringen).
### Phase 3 — Konsistenzpruefung
**Phase 3 — Konsistenzpruefung**
**Entry:** 7 TAs durch.
@@ -73,7 +72,7 @@ Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes
**Exit:** Keine offenen Konsistenz-Konflikte, oder offene Konflikte sind als `## Offene Punkte` in der Datei vermerkt.
### Phase 4 — Drei Varianten erzeugen
**Phase 4 — Drei Varianten erzeugen**
**Entry:** Phase 3 abgeschlossen.
@@ -86,7 +85,7 @@ Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes
**Exit:** Eine finale PS-Variante ist gewaehlt.
### Phase 5 — Export
**Phase 5 — Export**
**Entry:** Phase 4 abgeschlossen.
@@ -97,25 +96,27 @@ Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen `## Idee` ein scharfes
4. Hand-off: "Dein Problem-Statement ist in der Datei. Naechster Schritt: Persona. Trigger: 'Persona erstellen' fuer `i2s-persona`. Oder 'Weiter'."
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
</workflow>
## Quick Reference
<quick_start>
Loest aus bei "Problem-Statement erstellen" oder "HMW formulieren". Vorbedingung: eine idea2self-Datei mit ausgefuellter `## Idee` Sektion (sonst zuerst `i2s-discovery`). Der Skill fuehrt durch 7 Teilaspekte, erzeugt 3 Varianten zur Auswahl und schreibt das Ergebnis als `## Problem-Statement` Sektion in dieselbe Datei.
</quick_start>
<reference_guides>
Kommunikation: `references/kommunikationsregeln.md`.
Pipeline + Rueckwaerts-Update-Regeln: `references/artefakt-pipeline.md`.
Format-Schema: `references/problem-statement-format.md`.
Workflow-Detail (alle 5 Schritte, alle 7 TAs, alle Anti-Patterns): `workflows/problem-statement.md`.
## Reference Index
| File | Purpose |
|------|---------|
| `workflows/problem-statement.md` | Vollstaendiger 5-Schritt-Ablauf mit den 7 Teilaspekten + Anti-Patterns |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated) |
| `references/problem-statement-format.md` | Markdown-Schema fuer `## Problem-Statement` (HMW-Satz + 6 Sub-Sektionen) |
| `references/artefakt-pipeline.md` | Pipeline-Position + Rueckwaerts-Update-Regeln (curated) |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Alle 7 Teilaspekte sind bearbeitet oder bewusst markiert.
- [ ] HMW-Satz ist formuliert (`Wie koennen wir [Kontext] fuer [Zielgruppe]...`).
- [ ] Zielgruppe ist konkreter als in `## Idee`.
@@ -123,3 +124,4 @@ Workflow-Detail (alle 5 Schritte, alle 7 TAs, alle Anti-Patterns): `workflows/pr
- [ ] Scope-Ausschluss ist explizit benannt (in `## Idee` oder `## Problem-Statement`).
- [ ] idea2self-Datei enthaelt `## Problem-Statement` mit Versions-Header + Changelog-Eintrag.
- [ ] Hand-off zu `i2s-persona` ist ausgesprochen.
</success_criteria>
+27 -22
View File
@@ -6,40 +6,39 @@ metadata:
version: 1.0.0
---
# i2s-prototyp-konzept — Loesungsskizze + Scope
<objective>
Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Feedback + persoenlicher Passung **eine** Loesung formen und scharf abgrenzen. Generiert 5 Roh-Ideen, faechert sie auf, der Nutzer waehlt und schaerft.
</objective>
## Essential Principles
<essential_principles>
1. **Ideen-Werkstatt vor Konzept.** Erst 5 Roh-Ideen aus dem Problemraum + Recherche + Interessen synthetisieren, dann waehlen. Nicht direkt das erste Konzept ausbauen.
2. **5 Ideen muessen substanziell unterschiedlich sein.** Wenn alle 5 dasselbe in Variationen sind: zurueck. "Welche Richtung waere komplett anders?"
3. **Persoenliche Rollenpassung ist Pflichtfeld.** Builder / Coach / Kurator / Erklaerer / Gastgeber — eine Loesung, die nicht zur Rolle des Founders passt, scheitert nicht am Markt sondern an der Umsetzung.
4. **Scope IN UND Scope OUT explizit.** Was wird NICHT gebaut, ist genauso wichtig wie was gebaut wird. Ohne Scope-OUT bleibt der Action-Plan unmoeglich.
5. **Konzept, kein Bau.** Wir definieren das Konzept (Typ, Funktionen, Flow), nicht den lauffaehigen Prototyp. Der Bau lebt im Action-Plan.
</essential_principles>
## When to Use
<when_to_use>
- `## Experiment-Card` existiert + Experiment idealerweise durchgefuehrt; `## Prototyp-Konzept` fehlt oder iteriert werden soll.
- Aus Router-Hand-off (Pfad 6) oder direkter Trigger ("Prototyp-Konzept erstellen", "Loesungsideen entwickeln").
- Nach erstem Konzept-Run + neuen Erkenntnissen: v0.2 mit anderem Typ oder Scope.
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Experiment-Card` fehlt -> erst `i2s-experiment-card`.
- Nutzer will Aufgabenliste / 14-Tage-Plan -> `i2s-action-plan`.
- Allgemeines Produkt-Brainstorming ohne Idea2Self-Anker -> `compound-engineering:ce-brainstorm`.
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden.
2. Auf `^## Experiment-Card` matchen + Sektion-Inhalt > 100 Zeichen.
3. Fehlt -> abbrechen mit Hinweis: "`## Experiment-Card` fehlt. Trigger zuerst `i2s-experiment-card`."
</precondition_check>
## Phases
### Phase 1 — Kontext laden + Experiment-Status klaeren
<workflow>
**Phase 1 — Kontext laden + Experiment-Status klaeren**
**Entry:** Vorbedingung erfuellt.
@@ -52,20 +51,20 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
**Exit:** Experiment-Stand erfasst.
### Phase 2 — 4 Teilaspekte
**Phase 2 — 4 Teilaspekte**
**Entry:** Phase 1 abgeschlossen.
**Aktionen:**
1. **TA1 FEEDBACK.** Bisherige Loesungsidee + was Interviews bestaetigten/infrage stellten.
2. **TA2 INTERESSEN.** Persoenliche Zugkraft + Rollenpassung (Builder / Coach / Kurator / Erklaerer / Gastgeber).
3. **TA3 IDEEN-WERKSTATT.** Synthetisiere 5 substanziell unterschiedliche Roh-Ideen (Titel + Kurzbeschreibung). Praesentiere als `_(Vorschlag)_`. Feedback einholen, max. 2 Iterationsrunden. Optionale Inline-Recherche zu Formaten / Tools (NICHT Markt — das steht im Recherche-Report).
3. **TA3 IDEEN-WERKSTATT.** Synthetisiere 5 substanziell unterschiedliche Roh-Ideen (Titel + Kurzbeschreibung). Praesentiere als `_(Vorschlag)_`. Feedback einholen, max. 2 Iterationsrunden. Optionale Inline-Recherche zu Formaten / Tools (NICHT Markt — das steht im Recherche-Report). Web-Tools (WebFetch / WebSearch) werden hier nur auf ausdrueckliche Bestaetigung des Nutzers und ausschliesslich zur Klaerung von Formaten / Tools genutzt — nicht fuer Markt oder Wettbewerb, denn das steht bereits im Recherche-Report.
4. **TA4 KONZEPT.** Fuer die gewaehlte Idee: Typ (App / Service / Kurs / Community / ...), 3-5 Kernfunktionen, Scope IN, Scope OUT, User Flow in 3-5 Schritten.
5. Anti-Pattern-Detection: Idee ignoriert Interview-Feedback / alle 5 Ideen sind Variationen desselben / Ideen ignorieren Persona.
**Exit:** Alle 4 TAs sind durch, eine Idee ist gewaehlt + ausgearbeitet.
### Phase 3 — Konsistenzpruefung
**Phase 3 — Konsistenzpruefung**
**Entry:** Phase 2 abgeschlossen.
@@ -77,7 +76,7 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
**Exit:** Keine offenen Konsistenz-Konflikte.
### Phase 4 — Export
**Phase 4 — Export**
**Entry:** Phase 3 abgeschlossen.
@@ -89,25 +88,30 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
5. Hand-off: "Prototyp-Konzept steht. Letzter Schritt: Action-Plan. Trigger: 'Action-Plan erstellen' fuer `i2s-action-plan`. Oder 'Weiter'."
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
</workflow>
## Quick Reference
<quick_start>
Trigger: "Prototyp-Konzept erstellen" / "Loesungsideen entwickeln".
Vorbedingung: idea2self-Datei mit `## Experiment-Card`.
Ablauf: Kontext laden -> 4 Teilaspekte (Feedback, Interessen, Ideen-Werkstatt mit 5 Roh-Ideen, Konzept) -> Konsistenzpruefung -> Export.
Output: `## Prototyp-Konzept` Sektion (Typ, 3-5 Kernfunktionen, Scope IN/OUT, User Flow 3-5 Schritte).
</quick_start>
<reference_guides>
Kommunikation: `references/kommunikationsregeln.md`.
Format-Schema: `references/prototyp-konzept-format.md`.
Workflow-Detail: `workflows/prototyp-konzept.md`.
Optional Variantenanalyse: `templates/prototyp-remixer-auswertung.md`.
## Reference Index
| File | Purpose |
|------|---------|
| `workflows/prototyp-konzept.md` | Vollstaendiger 4-Schritt-Ablauf mit 4 TAs + Ideen-Werkstatt-Regeln |
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Prototyp-spezifische Heuristiken (curated) |
| `references/prototyp-konzept-format.md` | Markdown-Schema fuer `## Prototyp-Konzept` |
| `templates/prototyp-remixer-auswertung.md` | Optionale Variantenanalyse (3 Dimensionen, Kombinationen, Bewertung) |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] Experiment-Feedback ist einbezogen oder explizit als fehlend markiert.
- [ ] 5 substanziell unterschiedliche Roh-Ideen wurden generiert + bewertet.
- [ ] 1 Idee ist gewaehlt mit knapper Begruendung.
@@ -115,3 +119,4 @@ Optional Variantenanalyse: `templates/prototyp-remixer-auswertung.md`.
- [ ] Persoenliche Rolle ist reflektiert + matcht den Loesungstyp.
- [ ] idea2self-Datei enthaelt `## Prototyp-Konzept` mit Versions-Header + Changelog-Eintrag.
- [ ] Hand-off zu `i2s-action-plan` ist ausgesprochen.
</success_criteria>
+25 -21
View File
@@ -6,41 +6,45 @@ metadata:
version: 1.0.0
---
# i2s-recherche — Problemraum-Recherche
<objective>
Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `## Problem-Statement` und `## Persona`. Bereitet zugleich Interviews vor (Orte + Proxy-Gruppen + Ansprache). Triggert Rueckwaerts-Updates auf PS und Persona, wenn Recherche das nahelegt.
</objective>
## Essential Principles
<essential_principles>
1. **Quellenbasiert, nicht spekulativ.** Jede Behauptung im Recherche-Report braucht mindestens **eine** Quelle, zentrale Behauptungen **zwei unabhaengige**. Primaerquellen vor Sekundaerquellen.
2. **Recherche schaerft, nicht ersetzt.** Der Skill ersetzt keine Interviews. Recherche ist Vorbereitung — Interviews bringen den ground truth (gehoert in `i2s-experiment-card`).
3. **Rueckwaerts-Updates sind erlaubt + erwartet.** Wenn die Recherche zeigt, dass PS oder Persona falsch liegen: v0.2-Vorschlaege sind Pflicht, nicht optional. Aenderung nur nach Nutzer-Bestaetigung.
4. **Stadt-Frage frueh.** In welcher Stadt finden Interviews statt? Steuert Orts-Suche + lokale Proxy-Gruppen. Ohne diese Info bleibt Interview-Vorbereitung abstrakt.
5. **Quellen-Aktualitaet.** Marktdaten max 2 Jahre alt. Verhaltens-Studien max 5 Jahre. Aelter -> als `_(Quelle gealtert)_` markieren.
</essential_principles>
## When to Use
<when_to_use>
- `## Problem-Statement` UND `## Persona` existieren, `## Recherche-Report` fehlt oder ist veraltet.
- Aus Router-Hand-off (Pfad 4) oder direkter Trigger ("Problemraum recherchieren").
- Nach Interview-Runde: Re-Recherche mit neuen Hypothesen (v0.3).
</when_to_use>
## When NOT to Use
<when_not_to_use>
- `## Persona` fehlt -> erst `i2s-persona`.
- Allgemeine Web-Recherche ohne Idea2Self-Kontext -> `compound-engineering:ce-web-researcher`.
- Wettbewerbs-Deep-Dive (Pricing, Feature-Vergleich) -> noch nicht modelliert; fuer Idea2Self bewusst out-of-scope (Status quo == Wettbewerb).
</when_not_to_use>
## Precondition Check
<precondition_check>
**Vor Phase 1:**
1. idea2self-Datei laden.
2. Auf `^## Problem-Statement` UND `^## Persona` matchen, beide > 100 Zeichen Inhalt.
3. Wenn PS fehlt -> abbrechen, Hand-off `i2s-problem-statement`.
4. Wenn Persona fehlt -> abbrechen, Hand-off `i2s-persona`.
</precondition_check>
## Phases
<workflow>
### Phase 1 — Kontext laden + Recherche-Fragen ableiten
**Phase 1 — Kontext laden + Recherche-Fragen ableiten**
**Entry:** Vorbedingung erfuellt.
@@ -53,7 +57,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
**Exit:** 4-6 Fragen liegen vor.
### Phase 2 — Fragen zeigen + Stadt-Frage
**Phase 2 — Fragen zeigen + Stadt-Frage**
**Entry:** Fragen liegen vor.
@@ -64,7 +68,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
**Exit:** Fragen final, Stadt bekannt.
### Phase 3 — Recherche durchfuehren
**Phase 3 — Recherche durchfuehren**
**Entry:** Phase 2 abgeschlossen.
@@ -77,7 +81,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
**Exit:** Alle Fragen haben quellengestuetzte Antworten oder explizit "Keine belastbaren Quellen gefunden".
### Phase 4 — Report aufbereiten
**Phase 4 — Report aufbereiten**
**Entry:** Phase 3 abgeschlossen.
@@ -91,7 +95,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
**Exit:** Strukturierter Report-Entwurf liegt vor.
### Phase 5 — v0.2-Vorschlaege ableiten
**Phase 5 — v0.2-Vorschlaege ableiten**
**Entry:** Phase 4 abgeschlossen.
@@ -103,7 +107,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
**Exit:** v0.2-Updates sind freigegeben oder als offen vermerkt.
### Phase 6 — Export
**Phase 6 — Export**
**Entry:** Phase 5 abgeschlossen.
@@ -114,15 +118,13 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
4. Hand-off: "Recherche abgeschlossen. Naechster Schritt: Experiment-Card. Trigger: 'Experiment planen' fuer `i2s-experiment-card`. Oder 'Weiter'."
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
</workflow>
## Quick Reference
<quick_start>
Trigger "Problemraum recherchieren". Vorbedingung: idea2self-Datei mit `## Problem-Statement` UND `## Persona`. Output: `## Recherche-Report` Sektion plus optionale v0.2-Updates auf PS/Persona nach Bestaetigung. Referenz-Guides siehe Reference-Index unten.
</quick_start>
Kommunikation: `references/kommunikationsregeln.md`.
Recherche-Qualitaets-Regeln: `references/recherche-regeln.md`.
Format-Schema: `references/recherche-report-format.md`.
Workflow-Detail: `workflows/recherche.md`.
## Reference Index
<reference_guides>
| File | Purpose |
|------|---------|
@@ -130,8 +132,9 @@ Workflow-Detail: `workflows/recherche.md`.
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated) |
| `references/recherche-regeln.md` | Quellen-Qualitaet, Aktualitaet, Widerspruchs-Handling, einfache vs tiefe Recherche (curated) |
| `references/recherche-report-format.md` | Markdown-Schema fuer `## Recherche-Report` |
</reference_guides>
## Success Criteria
<success_criteria>
- [ ] 4-6 Recherche-Fragen sind beantwortet (oder explizit als "keine belastbaren Quellen" markiert).
- [ ] Jede zentrale Behauptung hat mindestens 2 unabhaengige Quellen, Primaerquellen bevorzugt.
@@ -141,3 +144,4 @@ Workflow-Detail: `workflows/recherche.md`.
- [ ] v0.2-Vorschlaege fuer PS und Persona sind formuliert + vom Nutzer entschieden.
- [ ] idea2self-Datei enthaelt `## Recherche-Report`. PS und Persona ggf. auf v0.2 aktualisiert mit `_(Update aus Recherche)_` Marker.
- [ ] Hand-off zu `i2s-experiment-card` ist ausgesprochen.
</success_criteria>
+40 -40
View File
@@ -1,39 +1,38 @@
---
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."
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/Sprint/Coaching', 'Idee strukturieren', 'idea2self iterieren/ueberarbeiten/review'. Routet anschliessend an spezialisierte i2s-* Skills. NICHT aktivieren bei direkten Artefakt-Triggern (z.B. 'Problem-Statement erstellen', 'Persona erstellen', 'Action-Plan / WOOP') — dafuer die jeweiligen i2s-* Skills. Vollstaendige Trigger-Mapping-Tabelle: references/routing-table.md. Sprache: Deutsch."
allowed-tools: Read Write Edit Glob Grep AskUserQuestion TodoRead TodoWrite
metadata:
version: 2.0.0
---
# Klarheit mit Idea2Self — Router
<objective>
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.
</objective>
## Essential Principles
<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.
</essential_principles>
## When to Use
<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_to_use>
## When NOT to Use
<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`.
</when_not_to_use>
## Quick-Start-Trace
### Beispiel A — Happy Path (neue Idee)
<quick_start>
**Beispiel A — Happy Path (neue Idee)**
**Input:** "Ich habe da eine Idee fuer eine Nachbarschafts-Tauschboerse. Wie packe ich das an?"
@@ -50,7 +49,7 @@ Trigger-Phrase: "Discovery-Interview starten".
Soll ich die Diskussion an `i2s-discovery` uebergeben?
```
### Beispiel B — Precondition-Gap
**Beispiel B — Precondition-Gap**
**Input:** "Persona erstellen fuer meine Tauschboersen-Idee."
@@ -68,7 +67,7 @@ Trigger-Phrase: "Problem-Statement erstellen".
Soll ich PS zuerst aufsetzen, oder hast du das Problem anderweitig schon dokumentiert?
```
### Beispiel C — No-Match
**Beispiel C — No-Match**
**Input:** "Bau mir einen Marketing-Funnel fuer mein neues Coaching-Angebot."
@@ -85,9 +84,9 @@ strukturieren" — wir starten den Idea2Self-Prozess.
Fuer Marketing-Arbeit ohne Idea2Self-Schritte: nutze `marketing-skills:*`
(z.B. `marketing-skills:marketing-strategy-pmm`).
```
</quick_start>
## Routing Pattern
<routing>
```
intake (intent + optional file path)
|
@@ -104,10 +103,10 @@ intake (intent + optional file path)
```
Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing-table.md`.
</routing>
## Phases
### Phase 1 — Intent erkennen
<workflow>
**Phase 1 — Intent erkennen**
**Entry:** Skill ist aktiviert.
@@ -118,7 +117,7 @@ Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing
**Exit:** Intent ist auf genau einen der 8 Routing-Pfade gemappt **oder** als No-Match klassifiziert.
### Phase 1b — No-Match-Handling
**Phase 1b — No-Match-Handling**
**Entry:** Phase 1 hat keinen Pfad-Match erzeugt.
@@ -132,7 +131,7 @@ Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing
**Exit:** Nutzer ist informiert. Skill wartet auf Nachfrage oder verlaesst die Konversation.
### Phase 2 — Vorbedingung pruefen
**Phase 2 — Vorbedingung pruefen**
**Entry:** Intent ist gemappt.
@@ -143,7 +142,7 @@ Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing
**Exit:** Voraussetzungen sind erfuellt oder explizit uebergangen.
### Phase 3 — Hand-off oder Iteration
**Phase 3 — Hand-off oder Iteration**
**Entry:** Phase 2 erfolgreich abgeschlossen.
@@ -152,9 +151,9 @@ Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing
- 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).
</workflow>
## Intake (wenn Intent unklar)
<intake>
```
Was moechtest du tun?
@@ -171,15 +170,15 @@ Wenn du eine bestehende idea2self-Datei hast, nenne den Dateipfad.
```
Warte auf Antwort, bevor du fortfaehrst.
</intake>
## File Convention
<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`.
</file_convention>
## Quick Reference — Kommunikation
<communication_quick_reference>
Vollstaendige Regeln: `references/kommunikationsregeln.md`.
- Nuechtern, sachlich, direkt. Keine Motivation, keine Emojis, keine Superlative.
@@ -188,9 +187,9 @@ Vollstaendige Regeln: `references/kommunikationsregeln.md`.
- 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.
</communication_quick_reference>
## Reference Index
<reference_guides>
| File | Purpose |
|------|---------|
| `references/routing-table.md` | Trigger-Phrasen -> Sub-Skill + Vorbedingungs-Pruefung |
@@ -198,17 +197,9 @@ Vollstaendige Regeln: `references/kommunikationsregeln.md`.
| `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 |
</reference_guides>
## 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.
## Guardrails (Never)
<guardrails>
Gebuendelte Negativliste. Verstoesse machen den Router unzuverlaessig — gilt fuer JEDE Interaktion.
1. **Never self-execute.** Der Router formuliert kein Problem-Statement, keine Persona, keinen Plan — niemals. Selbst wenn der Nutzer draengt: an den zustaendigen `i2s-*` Skill uebergeben.
@@ -219,3 +210,12 @@ Gebuendelte Negativliste. Verstoesse machen den Router unzuverlaessig — gilt f
6. **Never skip the file-state read.** Vor jedem Hand-off (Pfad 2-7) wird die idea2self-Datei gelesen und der vorhandene Sektions-Stand gegen die Vorbedingung gehalten. Implizite Annahmen sind verboten.
7. **Never bypass user context.** Wenn Nutzer einen Dateipfad genannt hat oder im Verlauf einen Stand etabliert hat: dieser Stand gilt, nicht ein hypothetischer Standardstand.
8. **Never iterate the same clarification.** Maximal **eine** Klaerungsfrage pro Ambiguitaet. Wenn die Antwort weiter unklar bleibt: in Phase 1b (No-Match) gehen, nicht weiter nachfragen.
</guardrails>
<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.
</success_criteria>