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).
This commit is contained in:
Philipp Sieder
@@ -0,0 +1,141 @@
|
||||
---
|
||||
name: i2s-recherche
|
||||
description: "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."
|
||||
allowed-tools: Read Write Edit Glob Grep WebFetch WebSearch AskUserQuestion TodoRead TodoWrite
|
||||
---
|
||||
|
||||
# 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.
|
||||
Reference in New Issue
Block a user