2
0
Files
agent-skills/skills/i2s-experiment-card/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

117 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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."
allowed-tools: Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
metadata:
version: 1.0.0
---
# i2s-experiment-card — Hypothese + Experiment-Design
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.
## 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.
## 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 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.
## 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.
## Phases
### Phase 1 — Kontext laden
**Entry:** Vorbedingung erfuellt.
**Aktionen:**
1. Alle bisherigen Sektionen lesen: `## Idee`, `## Problem-Statement` (v0.2 wenn vorhanden), `## Persona` (v0.2), `## Recherche-Report`.
2. Voranalyse zeigen: "Bisheriger Stand gelesen. Riskanteste Kandidaten-Annahmen: [Liste 2-3]. Jetzt 5 Teilaspekte. [1] von 5."
**Exit:** Voranalyse bestaetigt oder Kandidaten-Annahmen-Liste korrigiert.
### Phase 2 — 5 Teilaspekte (gefuehrte Fragen)
**Entry:** Phase 1 abgeschlossen.
**Aktionen:**
1. **TA1 HYPOTHESE.** Riskanteste Annahme identifizieren, im Format "Wir glauben, dass [...] fuer [...] weil [...]" formulieren. Risikostufe Hoch/Mittel/Niedrig bewerten + begruenden.
2. **TA2 EXPERIMENT-DESIGN.** Optionen: Strasseninterviews (5-10 Gespraeche), Online-Umfrage, Landing-Page-Test, Prototyp-Test, Beobachtung. Pro Option: Mindest-Datenpunkte definieren.
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).
**Exit:** Alle 5 TAs sind beantwortet oder explizit als "Nicht erarbeitet" markiert.
### Phase 3 — Konsistenzpruefung
**Entry:** 5 TAs durch.
**Aktionen:**
1. Hypothese adressiert die **riskanteste** Annahme? Nicht eine bequeme?
2. Experiment ist mit verfuegbaren Ressourcen durchfuehrbar (Zeit, Zugang zur Zielgruppe)?
3. Metriken sind **messbar** (zaehlbar, beobachtbar)?
4. Entscheidungsschwellen sind **VOR** dem Experiment definiert?
5. "Lassen"-Schwelle ist konkret formuliert, nicht nur ein Disclaimer?
**Exit:** Keine offenen Konsistenz-Konflikte.
### Phase 4 — Export
**Entry:** Phase 3 abgeschlossen.
**Aktionen:**
1. `## Experiment-Card` Sektion in idea2self-Datei schreiben (Schema: `references/experiment-card-format.md`).
2. Versions-Header.
3. Changelog-Eintrag: `[Datum] Experiment-Card V<n> formuliert.`
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.
## Quick Reference
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` |
## Success Criteria
- [ ] Hypothese im "Wir glauben, dass ... fuer ... weil ..." Format formuliert.
- [ ] Risikostufe bewertet + begruendet.
- [ ] Experiment-Typ gewaehlt, Mindest-Datenpunkte definiert.
- [ ] Metriken mit Entscheidungsschwellen VOR Durchfuehrung definiert.
- [ ] Entscheidungslogik fuer alle drei Outcomes (Weiter/Aendern/Lassen) festgelegt.
- [ ] 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.