Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
7691b408e8e40f124b7721f03ae838f3139ef349
agent-skills/skills/i2s-experiment-card/SKILL.md
T
Philipp Sieder 7691b408e8 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).
2026-05-22 09:47:54 +02:00

7.5 KiB
Raw Blame History

name, description, allowed-tools, metadata
name description allowed-tools metadata
i2s-experiment-card 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. Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
version
1.0.0
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. </essential_principles>

<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>

  • ## 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> 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>
**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). 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

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_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.

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>

  • 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. </success_criteria>
View Git Blame Copy Permalink