2
0
Files
agent-skills/skills/i2s-recherche/workflows/recherche.md
T
Philipp Sieder 571bbe2084 feat(i2s-recherche): extract from monolith
Step 7 of i2s-skill-split refactor. Fourth atomic sub-skill — first
one that uses external tools (WebFetch, WebSearch).

Contents:
- SKILL.md: 6 numbered phases (load + frame questions, show +
  stadt-frage, web-research, report, v0.2-vorschlaege, export)
  with entry/exit. description includes anti-trigger to
  compound-engineering:ce-web-researcher for non-Idea2Self
  research.
- workflows/recherche.md: 6-step workflow with two cluster
  schemas (Problem / Zielgruppe). git mv from monolith, paths
  updated to local refs.
- references/kommunikationsregeln.md: curated extract with
  recherche-specific dialog heuristics (no source halluci-
  nation, source-conflict-handling, scope-recovery).
- references/recherche-regeln.md: full curated extract -
  einfache vs tiefe recherche table, quellen-qualitaet pflichten
  (min 2 unabh quellen, primaer > sekundaer, datum-pflicht),
  widerspruchs-handling, stadt-spezifische recherche, output-
  schema pro frage, anti-patterns.
- references/recherche-report-format.md: curated markdown
  schema for ## Recherche-Report sektion with full filled
  example.

Tools include WebFetch + WebSearch (the recherche actually
hits the web). Read, Write, Edit, Glob, Grep, AskUserQuestion,
TodoRead, TodoWrite round out the set.

Precondition: ## Problem-Statement + ## Persona both required.
Output: ## Recherche-Report + optional v0.2-updates to PS and
Persona (only on explicit user confirmation).
2026-05-19 01:29:57 +02:00

104 lines
3.2 KiB
Markdown

# Workflow: Problemraum recherchieren
<required_reading>
1. references/kommunikationsregeln.md
2. references/recherche-regeln.md
3. references/recherche-report-format.md
</required_reading>
<process>
## Schritt 1: Kontext laden und Fragen ableiten
Lies ## Problem-Statement und ## Persona aus der idea2self-Datei.
Identifiziere:
- Unstuetzte Annahmen
- Unscharfe Begriffe
- Fehlende Daten
Leite 4-6 Recherche-Fragen in 2 Clustern ab:
Cluster A - Problem (aus PS):
1. Gibt es oeffentliche Hinweise, dass [Problem] fuer [Zielgruppe] relevant ist?
2. Welche bestehenden Loesungen/Workarounds existieren - und wo sind ihre Schwaechen?
3. Welche Rahmenbedingungen beeinflussen das Problemfeld nachweislich?
Cluster B - Zielgruppe (aus Persona):
1. Welche Erkenntnisse gibt es zu den Aufgaben und Beduerfnissen dieser Zielgruppe?
2. Wo sind Personen mit diesem Profil anzutreffen - physisch und digital?
3. Welche Personengruppen koennten als Proxy befragt werden?
## Schritt 2: Fragen zeigen und Stadt-Frage
"Aus deinem Problem-Statement und deiner Persona ergeben sich diese Recherche-Fragen:
**Problem:**
1. [Frage] 2. [Frage] 3. [Frage]
**Zielgruppe:**
1. [Frage] 2. [Frage] 3. [Frage]
Soll ich eine Frage ersetzen? Sonst starte ich."
Stadt-Frage: "In welcher Stadt planst du Gespraeche mit deiner Zielgruppe?"
## Schritt 3: Recherche durchfuehren
Ankuendigung: "Ich recherchiere jetzt zu [N] Punkten. Das dauert einen Moment."
Fuer jede Frage:
1. web_search mit spezifischen Suchbegriffen
2. Bei vielversprechenden Ergebnissen: web_fetch fuer Details
3. Ergebnis notieren mit Quellen-Angabe
Qualitaetskriterien (aus references/recherche-regeln.md):
- Mind. 2 unabhaengige Quellen fuer zentrale Behauptungen
- Primaerquellen bevorzugen
- Datum pruefen (nicht aelter als 2 Jahre fuer Marktdaten)
- Widersprueche benennen
## Schritt 4: Ergebnisse aufbereiten
Erstelle den Recherche-Report nach export-formate.md:
- Auf einen Blick (je 1-2 Saetze zu Problem + Zielgruppe)
- Problem-Recherche (Frage / Ergebnis / Einfluss auf PS / Vorschlag)
- Zielgruppen-Recherche (analog)
- Interview-Vorbereitung (Orte, Proxy-Gruppen, Ansprache)
## Schritt 5: v0.2-Vorschlaege ableiten
Basierend auf Recherche-Ergebnissen:
"Die Recherche legt folgende Aenderungen nahe:
**Problem-Statement:**
- [Konkreter Aenderungsvorschlag 1]
- [Konkreter Aenderungsvorschlag 2]
**Persona:**
- [Konkreter Aenderungsvorschlag 1]
- [Konkreter Aenderungsvorschlag 2]
Soll ich diese Aenderungen einarbeiten?"
Nach Bestaetigung: PS und Persona in der idea2self-Datei auf v0.2 aktualisieren.
## Schritt 6: Export
Schreibe ## Recherche-Report in idea2self-Datei.
Aktualisiere ## Problem-Statement und ## Persona auf v0.2 (wenn genehmigt).
Changelog aktualisieren.
Uebergabe:
"Recherche abgeschlossen. PS und Persona sind auf v0.2. Der naechste Schritt ist die Experiment-Card. Sage 'Weiter'."
</process>
<success_criteria>
- [ ] 4-6 Recherche-Fragen beantwortet
- [ ] Quellen-basierte Ergebnisse (nicht erfunden)
- [ ] Konkrete Aenderungsvorschlaege fuer PS und Persona
- [ ] Interview-Vorbereitung mit Orten und Ansprache
- [ ] PS und Persona auf v0.2 aktualisiert (nach Bestaetigung)
- [ ] idea2self-Datei aktualisiert mit ## Recherche-Report
</success_criteria>