Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
main
agent-skills/skills/i2s-recherche/references/recherche-report-format.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

4.0 KiB
Raw Permalink Blame History

Recherche-Report-Format — i2s-recherche (curated extract)

Curated from plugin-shared/export-formate.md — <recherche_report_format> block.

Schema fuer ## Recherche-Report Sektion

## Recherche-Report

_Version V1 vom [Datum]_
_Stadt fuer Interviews: [Stadt]_
_Vorgaengerversion: [V<n-1> vom <Datum>] / Keine - Neuerstellung_

### Auf einen Blick
- **Problem:** [Wichtigste Erkenntnis, 1-2 Saetze]
- **Zielgruppe:** [Wichtigste Erkenntnis, 1-2 Saetze]
- **Interview-Setup:** [Wichtigste Erkenntnis zu Orten / Proxy, 1 Satz]

### Problem-Recherche

#### Frage 1: [Frage]
- **Ergebnis:** [Synthese 2-4 Saetze]
- **Quellen:**
  - [Titel] - [URL] - [Datum] - [primaer/sekundaer]
  - [Titel] - [URL] - [Datum] - [primaer/sekundaer]
- **Einfluss auf PS:** [konkret, oder "keine"]
- **v0.2-Vorschlag:** [konkreter Aenderungstext, oder "keiner"]

#### Frage 2: [Frage]
[analog]

#### Frage 3: [Frage]
[analog]

### Zielgruppen-Recherche

#### Frage 4: [Frage]
- **Ergebnis:** [Synthese]
- **Quellen:** [Liste]
- **Einfluss auf Persona:** [konkret, oder "keine"]
- **v0.2-Vorschlag:** [konkreter Aenderungstext, oder "keiner"]

#### Frage 5: [Frage]
[analog]

#### Frage 6: [Frage]
[analog]

### Interview-Vorbereitung

#### Konkrete Orte / Proxy-Gruppen in [Stadt]
1. **[Ort/Gruppe]** ([URL falls online]) — passt zu Persona-Aspekt: [...]. Ansprache-Hinweis: [...].
2. **[Ort/Gruppe]** ([URL]) — [analog]
3. **[Ort/Gruppe]** ([URL]) — [analog]

#### Ansprache-Vorschlag (1-2 Saetze)
[Wie wird die Zielgruppe angesprochen? Welche Worte werden vermieden? Was zieht?]

### Widersprueche & offene Punkte

- _(Widerspruch: <Quelle A> vs <Quelle B>)_ — [kurze Beschreibung] - **Status:** offen / dritte-Quelle-bestellt / akzeptiert
- [ ] [Weitere offene Punkte aus dem Recherche-Workflow]

Schreibregeln

  1. Versions-Header mit Vorgaengerversion + Stadt.
  2. "Auf einen Blick" ist Pflicht — 3 Bullets, je 1-2 Saetze. Wenn Recherche zu einer Cluster-Frage keine belastbare Aussage zulaesst: "Keine belastbaren Quellen gefunden, Frage bleibt offen".
  3. Pro Frage mindestens 2 Quellen, ausser explizit "Keine belastbaren Quellen".
  4. Quellen-Format durchgaengig [Titel] - [URL] - [Datum] - [primaer/sekundaer]. Keine bare URLs ohne Kontext.
  5. Interview-Vorbereitung Pflicht: mindestens 3 Orte/Proxy-Gruppen + Ansprache-Vorschlag.
  6. v0.2-Vorschlaege sind die Bruecke zu Phase 5 — auch wenn keine Aenderung noetig: explizit "keiner".
  7. Widersprueche in eigener Sub-Sektion am Ende, nicht in den Findings versteckt.

Beispiel (auszug)

## Recherche-Report

_Version V1 vom 2026-05-19_
_Stadt fuer Interviews: Leipzig_
_Vorgaengerversion: Keine - Neuerstellung_

### Auf einen Blick
- **Problem:** Tausch in Mehrfamilienhaeusern findet ueberwiegend gar nicht statt — wenige Whatsapp-Gruppen-Initiativen scheitern an Pflege-Aufwand. _(Recherche: NABU-Studie 2024, nebenan.de Blog 2023)_
- **Zielgruppe:** Mieter Mitte 30 mit Kind nutzen Whatsapp aktiv, sind aber bei neuen Apps zurueckhaltend. Lokale Veranstaltungen (Strassenfeste) sind echte Trefferpunkte.
- **Interview-Setup:** 3 Hausverwaltungen in Suedvorstadt offen fuer Pilot, 2 Strassenfeste in den naechsten 6 Wochen.

### Problem-Recherche

#### Frage 1: Gibt es Hinweise, dass Tauschen in Mehrfamilienhaeusern ein realer Bedarf ist?
- **Ergebnis:** Ja. NABU-Studie 2024 (n=2400) zeigt 64% der Befragten waeren bereit zu teilen, aber nur 8% tun es regelmaessig. Hauptgrund: keine Infrastruktur.
- **Quellen:**
  - NABU-Studie "Suffizienz im Alltag" 2024 - https://nabu.de/... - 2024-09 - primaer
  - nebenan.de Blog "Was Nachbarn voneinander wollen" - https://blog.nebenan.de/... - 2023-11 - sekundaer
- **Einfluss auf PS:** Bestaetigt das Beduerfnis. "Infrastruktur fehlt" ist konkreter als das aktuelle PS-Wording.
- **v0.2-Vorschlag:** "Beduerfnis nach niedrigschwelliger Tausch-Infrastruktur" statt "Beduerfnis nach lokalen Tauschmoeglichkeiten".

Master version: plugin-shared/export-formate.md. Drift-check via plugin-shared/drift-check.sh.

View Git Blame Copy Permalink