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,81 @@
|
||||
# Recherche-Regeln — i2s-recherche (curated extract)
|
||||
|
||||
Curated from `plugin-shared/recherche-regeln.md`. Qualitaets- und Tiefen-Regeln fuer die Web-Recherche-Phase.
|
||||
|
||||
## Wann einfache, wann tiefe Recherche
|
||||
|
||||
| Trigger | Recherche-Tiefe | Tool |
|
||||
|---------|-----------------|------|
|
||||
| Einzelne Begriffsklaerung (z.B. "Was ist Co-Working?") | einfach, inline | `WebSearch` 1-2 Treffer |
|
||||
| Marktdaten / Verbreitung / Trend | tief, separater Workflow | `WebSearch` + `WebFetch` mehrere Quellen |
|
||||
| Bestehende Loesungen / Workarounds | tief | `WebSearch` mit Anbieter-Namen, `WebFetch` deren Seiten |
|
||||
| Zielgruppen-Aufenthaltsorte | tief, Stadt-spezifisch | lokale Verzeichnisse + Veranstaltungsseiten |
|
||||
| Verhaltens-Studien / Forschung | tief | wissenschaftliche Quellen bevorzugt |
|
||||
| Wettbewerbs-Deep-Dive | **out-of-scope** | nicht durchfuehren — Status quo == Wettbewerb |
|
||||
|
||||
## Quellen-Qualitaet
|
||||
|
||||
### Pflichten
|
||||
|
||||
- **Mindestens 2 unabhaengige Quellen** fuer zentrale Behauptungen (zentral = beeinflusst PS/Persona-Update).
|
||||
- **Primaerquellen vor Sekundaerquellen.** Statistisches Bundesamt > Branchen-Newsletter. Anbieter-Homepage > Blog-Review.
|
||||
- **Datum erfassen + pruefen:**
|
||||
- Marktdaten: max **2 Jahre** alt.
|
||||
- Verhaltens-Studien: max **5 Jahre** alt.
|
||||
- Faktische Daten (Geografie, demografische Strukturen): keine Altersgrenze, aber Quelle muss zitierbar bleiben.
|
||||
- **URL muss aufrufbar sein.** Keine Quellen-Halluzination. Wenn ein Treffer nicht via `WebFetch` ladbar ist: ausschliessen.
|
||||
|
||||
### Verzicht
|
||||
|
||||
- **Reddit / Twitter-Threads** nur als Indikator, nie als alleinige Quelle.
|
||||
- **Werbe-Sponsored-Content** ausschliessen (oft mit "Anzeige" oder "Promoted" markiert).
|
||||
- **KI-generierte Listicles** (typisch: "Top 10 X in 2024") nicht als Primaerquelle nutzen — oft Recycling ohne Recherche.
|
||||
|
||||
## Widerspruchs-Handling
|
||||
|
||||
Wenn 2+ Quellen widersprechen:
|
||||
|
||||
1. Beide nennen + Datum vergleichen — neuere Quelle hoeher gewichten.
|
||||
2. Wenn beide aktuell: `_(Widerspruch: <Quelle A> vs <Quelle B>)_` markieren im Report.
|
||||
3. Bei zentraler Behauptung: **dritte Quelle** suchen.
|
||||
4. Bei weiterhin offenem Widerspruch: als `## Offene Punkte` in idea2self-Datei.
|
||||
|
||||
## Stadt-spezifische Recherche
|
||||
|
||||
Pflichtfrage in Phase 2: "In welcher Stadt planst du Gespraeche mit deiner Zielgruppe?"
|
||||
|
||||
Bei Stadt bekannt:
|
||||
- **Lokale Veranstaltungen** suchen (Stadt-Webseite + Eventbrite + Meetup).
|
||||
- **Lokale Online-Gruppen** suchen (Stadt-Reddit, lokale Facebook-Gruppen, Nebenan.de).
|
||||
- **Lokale Anbieter** als Wettbewerber-Proxy (nicht als Wettbewerb fuer Pricing, sondern fuer Verhalten der Zielgruppe).
|
||||
- **Proxy-Gruppen:** wer ist nicht direkte Zielgruppe, aber regelmaessig im Kontakt mit ihr (Hausverwaltungen, Vereinsvorstaende, lokale Journalisten).
|
||||
|
||||
## Output pro Recherche-Frage
|
||||
|
||||
```markdown
|
||||
**Frage:** [Originalfrage aus Phase 2]
|
||||
|
||||
**Ergebnis:** [2-4 Saetze, Synthese aus Quellen]
|
||||
|
||||
**Quellen:**
|
||||
- [Titel] — [URL] — [Datum] — [Quellen-Typ: primaer/sekundaer]
|
||||
- [Titel] — [URL] — [Datum] — [Quellen-Typ]
|
||||
|
||||
**Einfluss auf PS:** [Konkrete Auswirkung, oder "keine"]
|
||||
**Einfluss auf Persona:** [Konkrete Auswirkung, oder "keine"]
|
||||
**v0.2-Vorschlag:** [Konkreter Aenderungstext, oder "keiner"]
|
||||
```
|
||||
|
||||
## Anti-Patterns
|
||||
|
||||
| Anti-Pattern | Korrektur |
|
||||
|--------------|-----------|
|
||||
| "Studien zeigen..." ohne konkrete Studie | Studie nennen oder Behauptung streichen |
|
||||
| Sekundaer-Zitat ohne Primaerquellen-Check | Primaerquelle nachschlagen oder als _(ungeklaert)_ markieren |
|
||||
| Mehrere Treffer als "Quellen" gezaehlt, die alle auf dieselbe Studie verweisen | nur als 1 Quelle zaehlen |
|
||||
| Recherche zu Idee statt zu Problem/Persona | zurueck zum PS-Anker — "was sagt das ueber Annas Verhalten?" |
|
||||
| Auslassen der Stadt-Frage | nicht erlaubt; Phase 2 muss sie stellen |
|
||||
|
||||
---
|
||||
|
||||
**Master version:** `plugin-shared/recherche-regeln.md`. Drift-check via `plugin-shared/drift-check.sh`.
|
||||
Reference in New Issue
Block a user