Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
276c7b24fc17195e390a7230be6a950f2f125ce8
agent-skills/skills/i2s-recherche/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

7.6 KiB
Raw Blame History

name, description, allowed-tools, metadata
name description allowed-tools metadata
i2s-recherche Idea2Self Problemraum-Recherche. Fuehrt eine quellenbasierte Web-Recherche zu Problem und Zielgruppe durch (4-6 Fragen in 2 Clustern), bereitet Interview-Vorbereitung mit Stadt + Orten vor, und schlaegt v0.2-Updates fuer Problem-Statement und Persona vor. Loest aus bei 'Problemraum recherchieren', 'Recherche zur Idee', 'Web-Recherche Idea2Self', 'Marktdaten zum Problem', 'wo finde ich meine Zielgruppe', 'Interview-Orte finden', 'Recherche-Report erstellen'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Persona erstellen' (i2s-persona), 'Experiment planen' (i2s-experiment-card), allgemeiner Web-Recherche ohne Idea2Self-Kontext (dafuer compound-engineering:ce-web-researcher), oder wenn Problem-Statement bzw. Persona noch fehlen. Vorbedingung: idea2self-Datei mit ## Problem-Statement und ## Persona. Output: ## Recherche-Report Sektion + optionale v0.2-Updates auf PS/Persona. Sprache: Deutsch. Read Write Edit Glob Grep WebFetch WebSearch AskUserQuestion TodoRead TodoWrite
version
1.0.0

i2s-recherche — Problemraum-Recherche

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.

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.

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

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.

Phases

Phase 1 — Kontext laden + Recherche-Fragen ableiten

Entry: Vorbedingung erfuellt.

Aktionen:

  1. PS + Persona lesen. Identifiziere: ungestuetzte Annahmen, unscharfe Begriffe, fehlende Daten.
  2. 4-6 Recherche-Fragen in 2 Clustern formulieren:
    • Cluster A — Problem (aus PS): Existenz, bestehende Loesungen, Rahmenbedingungen.
    • Cluster B — Zielgruppe (aus Persona): Verhalten, Orte, Proxy-Gruppen.
  3. Detailregeln + Beispiel-Fragen in workflows/recherche.md Schritt 1.

Exit: 4-6 Fragen liegen vor.

Phase 2 — Fragen zeigen + Stadt-Frage

Entry: Fragen liegen vor.

Aktionen:

  1. Beide Cluster dem Nutzer zeigen (Format in workflows/recherche.md Schritt 2).
  2. Frage: "Soll ich eine Frage ersetzen?" — max 1 Iteration.
  3. Stadt-Frage: "In welcher Stadt planst du Gespraeche mit deiner Zielgruppe?"

Exit: Fragen final, Stadt bekannt.

Phase 3 — Recherche durchfuehren

Entry: Phase 2 abgeschlossen.

Aktionen:

  1. Ankuendigung: "Ich recherchiere jetzt zu [N] Punkten. Das dauert einen Moment."
  2. Pro Frage: WebSearch mit spezifischen Suchbegriffen.
  3. Bei vielversprechenden Treffern: WebFetch fuer Details.
  4. Qualitaets-Gates aus references/recherche-regeln.md anwenden (min 2 unabhaengige Quellen fuer zentrale Behauptungen, Primaerquellen-Praeferenz, Datum-Check, Widerspruch-Markierung).
  5. Ergebnis je Frage notieren mit Quellen-Angabe (Titel + URL + Datum).

Exit: Alle Fragen haben quellengestuetzte Antworten oder explizit "Keine belastbaren Quellen gefunden".

Phase 4 — Report aufbereiten

Entry: Phase 3 abgeschlossen.

Aktionen:

  1. Recherche-Report nach references/recherche-report-format.md strukturieren:
    • Auf einen Blick (je 1-2 Saetze zu Problem + Zielgruppe).
    • Problem-Recherche (pro Frage: Ergebnis, Einfluss auf PS, v0.2-Vorschlag).
    • Zielgruppen-Recherche (analog).
    • Interview-Vorbereitung (Orte, Proxy-Gruppen, Ansprache-Vorschlag).
  2. Widersprueche zwischen Quellen als _(Widerspruch: <Quelle A> vs <Quelle B>)_ markieren.

Exit: Strukturierter Report-Entwurf liegt vor.

Phase 5 — v0.2-Vorschlaege ableiten

Entry: Phase 4 abgeschlossen.

Aktionen:

  1. Aus Recherche-Ergebnissen konkrete v0.2-Aenderungs-Vorschlaege fuer PS und Persona ableiten.
  2. Format: "Die Recherche legt folgende Aenderungen nahe: PS: [...]. Persona: [...]. Soll ich diese Aenderungen einarbeiten?"
  3. Auf Bestaetigung warten. Nicht still aktualisieren.
  4. Bei Ablehnung: Aenderungen als ## Offene Punkte in PS/Persona vermerken.

Exit: v0.2-Updates sind freigegeben oder als offen vermerkt.

Phase 6 — Export

Entry: Phase 5 abgeschlossen.

Aktionen:

  1. ## Recherche-Report neu schreiben (Schema: references/recherche-report-format.md).
  2. Bei freigegebenen v0.2-Updates: PS und Persona aktualisieren, Versions-Header bumpen, beide Sektionen mit _(Update aus Recherche, [Datum])_ markieren.
  3. ## Changelog aktualisieren: [Datum] Recherche v1 + PS/Persona v0.2-Sync.
  4. Hand-off: "Recherche abgeschlossen. Naechster Schritt: Experiment-Card. Trigger: 'Experiment planen' fuer i2s-experiment-card. Oder 'Weiter'."

Exit: Datei aktualisiert, Hand-off ausgesprochen.

Quick Reference

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

File Purpose
workflows/recherche.md Vollstaendiger 6-Schritt-Ablauf mit beiden Cluster-Fragebeispielen
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

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.
  • Quellen-Datum ist erfasst, ueberalterte Quellen markiert.
  • Widersprueche zwischen Quellen sind benannt.
  • Interview-Vorbereitung enthaelt mind. 3 konkrete Orte / Proxy-Gruppen + Ansprache-Vorschlag.
  • 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.
View Git Blame Copy Permalink