Idea2Self/agent-skills
2
0
Fork 0
Code Activity

feat(i2s-experiment-card): extract from monolith

Browse Source 
Step 8 of i2s-skill-split refactor. Fifth atomic sub-skill.

Contents:
- SKILL.md: 4 numbered phases (load context, 5 TAs, consistency,
  export) with precondition triple (## PS + ## Persona + ##
  Recherche-Report all required). description with explicit
  hypothesis/MVE/experiment triggers, anti-triggers naming
  i2s-recherche and i2s-prototyp-konzept.
- workflows/experiment-card.md: 5-step workflow with the 5 TAs
  and entscheidungslogik formalism. git mv from monolith with
  paths updated.
- references/kommunikationsregeln.md: curated extract with
  experiment-card-specific dialog heuristics (hypothesis as
  loesung, hypothesis-stacking, decision-threshold-pflicht,
  lassen-schwelle-pflicht).
- references/lean-startup.md: curated extract from
  plugin-shared/methodik.md, lean_startup block.
  Build-Measure-Learn miniformat, MVE-vs-MVP, evidenz-
  abstufungen, MVE-options-tabelle, anti-patterns.
- references/experiment-card-format.md: full markdown schema
  with filled example (Anna-Tauschboerse pilot, 14 days,
  measurable thresholds).

Tools: includes WebFetch + WebSearch for inline interview-
technique research; rest unchanged from the workflow-skill
default set.
This commit is contained in:
Philipp Sieder
2026-05-19 01:32:43 +02:00
parent 571bbe2084
commit 052d0c6e60
5 changed files with 330 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/i2s-experiment-card/references/experiment-card-format.md
+111
View File
@@ -0,0 +1,111 @@
# Experiment-Card-Format — i2s-experiment-card (curated extract)
Curated from `plugin-shared/export-formate.md` — `<experiment_card_format>` block.
## Schema fuer `## Experiment-Card` Sektion
```markdown
## Experiment-Card
_Version [V1/V2/...] vom [Datum]_
_Vorgaengerversion: [V<n-1> vom <Datum>] / Keine - Neuerstellung_
### Hypothese
> **Wir glauben, dass [Annahme] fuer [Zielgruppe] weil [Begruendung].**
**Risikostufe:** [Hoch / Mittel / Niedrig]
**Begruendung der Risikostufe:** [1-2 Saetze]
### Experiment-Design
- **Typ:** [Strasseninterviews / Online-Umfrage / Landing-Page-Test / Prototyp-Test / Beobachtung]
- **Mindest-Datenpunkte:** [Zahl]
- **Zeitrahmen:** [z. B. "5 Tage, 2 Stunden pro Tag"]
- **Zugang zur Zielgruppe:** [Konkret — aus Recherche-Report Interview-Vorbereitung uebernommen]
### Metriken + Entscheidungsschwellen
| Metrik | Schwelle "bestaetigt" | Schwelle "widerlegt" |
|--------|----------------------|----------------------|
| [Metrik 1] | [Wert] | [Wert] |
| [Metrik 2] | [Wert] | [Wert] |
| [Metrik 3] | [Wert] | [Wert] |
### Interview-Leitfaden _(wenn Typ = Interview)_
**Eroeffnung:** [1-2 Saetze]
**Kernfragen:**
1. [Offene Frage, keine Suggestion]
2. [Offene Frage]
3. [Offene Frage]
**Abschluss:** [1-2 Saetze, inkl. ggf. Folge-Termin-Frage]
**Regeln:** offen fragen, nicht suggerieren, mehr zuhoeren als reden, Antworten nicht beurteilen.
### Entscheidungslogik
- **Weitermachen wenn:** [konkretes Kriterium, in Metrik-Werten ausgedrueckt]
- **Aendern wenn:** [konkretes Kriterium — was wuerde am Konzept geaendert?]
- **Lassen wenn:** [konkretes Kriterium — Pflichtfeld]
### Offene Punkte
- [ ] [Nur wenn geparkte Gedanken aus dem Workflow vorhanden]
```
## Schreibregeln
1. **Hypothese als Blockquote (`>`)** im exakten Format. Keine Variationen.
2. **Risikostufe** mit ein- bis zweisaetziger Begruendung. "Hoch ohne Begruendung" zaehlt nicht.
3. **Metriken-Tabelle** mit zwei Schwellen (bestaetigt / widerlegt) — beide Pflicht.
4. **"Lassen"-Schwelle** ist NIE optional. Wenn der Nutzer ausweicht: Workflow zurueck zu TA5.
5. **Interview-Leitfaden** nur wenn Typ = Interview. Bei anderen Typen die Sektion **weglassen**, nicht leer lassen.
6. **Zeitrahmen** konkret: Stunden / Tage. "Demnaechst" zaehlt nicht.
## Beispiel (gefuellt, V1)
```markdown
## Experiment-Card
_Version V1 vom 2026-05-19_
_Vorgaengerversion: Keine - Neuerstellung_
### Hypothese
> **Wir glauben, dass eine 4-Karten-Aushaengetafel im Hausflur die spontane Tauschnutzung in einem 12-Parteien-Haus binnen 14 Tagen auf mindestens 2 erfolgreiche Tauschvorgaenge bringt fuer Mieter Anfang 30 bis Mitte 40 mit Whatsapp-Skepsis weil die Schwelle gegenueber App-basierten Loesungen substantiell niedriger ist.**
**Risikostufe:** Hoch
**Begruendung der Risikostufe:** Die zentrale Annahme — App-Schwelle ist der Hauptblocker — ist unbelegt. Wenn das Karten-System genauso wenig genutzt wird wie eine App, kippt das gesamte Konzept.
### Experiment-Design
- **Typ:** Strasseninterviews + Pilot in 1 Haus
- **Mindest-Datenpunkte:** 8 Interviews + 14 Tage Pilot
- **Zeitrahmen:** Interviews ueber 5 Tage (je 1-2 pro Tag), Pilot 14 aufeinanderfolgende Tage
- **Zugang zur Zielgruppe:** Eigenes Haus (12 Parteien) + 2 Nachbarhaeuser ueber Hausverwaltung Suedvorstadt — Kontakt steht (siehe Recherche-Report)
### Metriken + Entscheidungsschwellen
| Metrik | Schwelle "bestaetigt" | Schwelle "widerlegt" |
|--------|----------------------|----------------------|
| Anzahl erfolgreicher Tauschvorgaenge in 14 Tagen | >= 2 | < 1 |
| Anzahl Bewohner, die mind. 1× zur Tafel gehen | >= 5 | <= 2 |
| Interview-Aussage "App-Schwelle real" | >= 6 von 8 bestaetigen | <= 2 von 8 bestaetigen |
### Interview-Leitfaden
**Eroeffnung:** "Ich teste eine Idee mit Karten im Hausflur statt App. Darf ich dich 5 Minuten dazu fragen?"
**Kernfragen:**
1. Wann hast du das letzte Mal jemandem etwas geliehen oder ausgeliehen — und wie ist das zustande gekommen?
2. Stell dir vor, im Hausflur haengen Karten "Suche Bohrmaschine fuer Samstag". Was waere dein erster Gedanke?
3. Was wuerde dich davon abhalten mitzumachen?
**Abschluss:** "Danke. Darf ich dir nach 2 Wochen kurz schreiben, ob du was dazu beobachtet hast?"
**Regeln:** offen fragen, nicht suggerieren, mehr zuhoeren als reden, Antworten nicht beurteilen.
### Entscheidungslogik
- **Weitermachen wenn:** >= 2 Tauschvorgaenge UND >= 5 Tafel-Besucher UND >= 6/8 Interviews bestaetigen App-Schwelle.
- **Aendern wenn:** >= 1 Tauschvorgang aber < 5 Tafel-Besucher (-> Distributions-Hebel testen, z. B. Hausverwaltung als Push).
- **Lassen wenn:** 0 Tauschvorgaenge UND <= 2 Tafel-Besucher — Karten-Hypothese ist widerlegt.
```
---
**Master version:** `plugin-shared/export-formate.md`. Drift-check via `plugin-shared/drift-check.sh`.
skills/i2s-experiment-card/references/kommunikationsregeln.md
+51
View File
@@ -0,0 +1,51 @@
# Kommunikationsregeln — i2s-experiment-card (curated extract)
Curated from `plugin-shared/kommunikationsregeln.md`. Experiment-Card-Workflow-relevante Regeln.
<tonality>
Nuechtern, sachlich, direkt. Keine Cheerleader-Sprache ("super Hypothese!"). Bei Hypothesen-Formulierung: klar und kurz.
</tonality>
<message_format>
- Max. 3-4 Saetze pro Nachricht im Dialog.
- Bei TA1 (Hypothese): Vorgeschlagene Formulierung als 1-Satz-Block zeigen.
- Bei TA2: Optionen-Liste als kurze Tabelle (Option / Aufwand / Datenqualitaet).
- Fortschrittsanzeige: "[X] von 5".
</message_format>
<kennzeichnung>
| Marker | Bedeutung |
|--------|-----------|
| _(Vorschlag)_ | KI-formulierte Hypothese, noch nicht bestaetigt |
| _(Annahme)_ | Vom Nutzer geaeusserte Annahme ohne Daten |
| _(Aus Recherche)_ | Behauptung gestuetzt durch Recherche-Report |
| _(Risikostufe: Hoch/Mittel/Niedrig)_ | Risikobewertung der Hypothese |
</kennzeichnung>
<steuerbefehle>
| Befehl | Aktion |
|--------|--------|
| Zurueck | Vorheriger Teilaspekt |
| Andere Hypothese | TA1 neu starten mit anderer Annahme |
| Anderes Experiment | TA2 neu starten mit anderem Typ |
| Reicht | Mit aktuellem Stand exportieren |
| Weiter | Naechster TA oder Phase |
</steuerbefehle>
<dialog_heuristiken_experiment>
- **Hypothese ist eine Loesungs-Beschreibung:** zurueck auf Annahme. "Was muss STIMMEN, damit das funktioniert?"
- **Mehrere Hypothesen gleichzeitig:** "Welche dieser Hypothesen wuerde dein Konzept am haertesten treffen, wenn sie falsch ist?"
- **Experiment ohne Entscheidungsschwelle:** Nicht akzeptieren. "Ab welchem Wert ist die Hypothese fuer dich widerlegt?"
- **"Wir schauen mal":** Cut. Konkrete Zahl einfordern.
- **"Lassen"-Schwelle fehlt:** "Was waere ein Ergebnis, bei dem du das Projekt einstellst? Wenn keines: ist deine Hypothese unfalsifizierbar?"
- **Interview-Leitfaden mit Suggestivfragen:** "Diese Frage gibt die Antwort vor. Formuliere offen: 'Was wuerdest du in dieser Situation tun?'"
- **Risikostufe ohne Begruendung:** "Warum Hoch und nicht Mittel? Eine Zeile reicht."
</dialog_heuristiken_experiment>
<export_rule>
Phase 4 schreibt `## Experiment-Card` Sektion + Versions-Header + Changelog-Eintrag. Schema: `references/experiment-card-format.md`. Hypothese-Formulierung ist Pflicht im genauen Format. Entscheidungsschwellen MUESSEN ausgefuellt sein — "Nicht erarbeitet" hier ist unzulaessig.
</export_rule>
---
**Master version:** `plugin-shared/kommunikationsregeln.md`. Drift-check via `plugin-shared/drift-check.sh`.
skills/i2s-experiment-card/references/lean-startup.md
+52
View File
@@ -0,0 +1,52 @@
# Lean Startup — i2s-experiment-card (curated extract)
Curated from `plugin-shared/methodik.md` — `<lean_startup>` block.
## Build-Measure-Learn im Idea2Self-Miniformat
```
Hypothese -> MVE -> Metriken -> Entscheidung
```
- **Hypothese:** explizit formuliert in der Experiment-Card. Format: "Wir glauben, dass [Annahme] fuer [Zielgruppe] weil [Begruendung]." Ohne dieses Format bleibt die Annahme unpruefbar.
- **MVE — Minimum Viable Experiment:** **nicht** MVP. Goal: minimaler Aufwand zur Falsifikation, nicht ein lauffaehiges Produkt. 5-10 Strasseninterviews schlagen 2 Wochen Landing-Page-Bau, wenn Interviews die Hypothese gleichermassen testen.
- **Metriken:** Entscheidungsschwelle wird **VOR** dem Experiment definiert. Nicht hinterher rationalisieren.
- **Entscheidung:** Drei Outcomes — Weitermachen / Aendern / Lassen. Das "Lassen" ist Pflichtfeld.
## Evidenz-Abstufungen
| Stufe | Beispiele | Anwendbarkeit in Idea2Self |
|-------|-----------|---------------------------|
| **Stark** | Validierte Daten, A/B-Tests, quantitative Analysen mit n > 100 | Selten in Pre-Launch — gehoert in spaetere Phasen |
| **Mittel** | Qualitative Interviews (5-15), Expertenschaetzungen, kleine Umfragen (n 20-50) | **Idea2Self-Standard.** Was das MVE in 95 % der Faelle liefert. |
| **Schwach** | Bauchgefuehl, einzelne Anekdoten, Branchen-Klischees | Nicht als Evidenz akzeptieren — bestenfalls als Hypothese, dann Experiment |
## Experiment-Typen (MVE-Optionen)
| Typ | Aufwand | Datenqualitaet | Best fit |
|-----|---------|----------------|----------|
| Strasseninterviews 5-10 | niedrig | mittel | Persona-Verhalten, Sprache der Zielgruppe |
| Online-Umfrage 20-50 | niedrig-mittel | mittel | Reichweiten-Check, grobe Praeferenzen |
| Landing-Page-Test | mittel | mittel-hoch | Conversion-Hypothese, Pricing-Reaktion |
| Prototyp-Test | mittel-hoch | hoch | Feature-Wert, User-Flow-Verstaendnis |
| Beobachtung | niedrig | hoch | Reales Verhalten in natuerlichem Kontext |
## Anti-Patterns
| Anti-Pattern | Korrektur |
|--------------|-----------|
| MVP statt MVE — "ich muss erstmal die App bauen" | "Welches Experiment beantwortet die Hypothese ohne App?" |
| Hypothesen-Stacking — 3 Annahmen in einem Satz | "Welche dieser 3 ist die riskanteste? Wir testen nur die." |
| Entscheidungsschwelle hinterher | Cut. Jetzt vor Durchfuehrung festzurren. |
| "Lassen"-Schwelle als Disclaimer ("im schlimmsten Fall...") | "Ab welchem konkreten Wert lasse ich es?" |
| Konfirmations-Suche statt Falsifikations-Versuch | "Was waere Evidenz GEGEN die Hypothese? Suche danach." |
## Verbindung zu anderen Idea2Self-Schritten
- **Vor i2s-experiment-card:** Recherche-Report liefert Hypothesen-Kandidaten. Wenn keine klaren Kandidaten: zurueck zu `i2s-recherche` mit besseren Fragen.
- **Nach i2s-experiment-card:** Prototyp-Konzept (`i2s-prototyp-konzept`) — Loesungsskizze fuer den Fall, dass die Hypothese sich bestaetigt.
- **Iteration:** Nach Experiment-Durchfuehrung: `klarheit-mit-idea2self` review-iterate -> ggf. neue Experiment-Card v0.2 mit naechster Hypothese.
---
**Master version:** `plugin-shared/methodik.md`. Drift-check via `plugin-shared/drift-check.sh`.