Branchen-Recherche-Framework (Industry Research Framework)
Dieser Skill ist ein Framework für Langform-Branchenforschung und veröffentlichungsreifes Schreiben. Es liefert keinen Scraper, keine Datenquelle und keine feste Berichtsvorlage; stattdessen schreibt es Konventionen vor, wie ein KI-Agent den Zustand persistiert, Beweise von Prosa trennt, Themendrift vermeidet, Überprüfungen plant und ein umfangreiches Forschungs-Backend in einen sauberen, leserorientierten Artikel oder Bericht verwandelt.
1. Motivation
Langform-Rechercheagenten neigen auf fünf wiederkehrende Arten zu scheitern:
- Themenüberanpassung: Eine aus einem Projekt destillierte Methode wird fälschlicherweise als universeller Rahmen behandelt.
- Prozessleck: Der endgültige Artikel liest sich wie ein Arbeitsprotokoll mit Formulierungen wie „der Benutzer hat bereitgestellt“ oder „das Material zeigt“.
- Beweisdrift: Quellen, Behauptungen, Unsicherheit und das Urteil des Autors verschmelzen zu einem undifferenzierten Argument.
- Vorgetäuschte Vollständigkeit: Ein Teilmeilenstein wird als endgültige Fertigstellung gemeldet, bevor Abdeckung, Überprüfung und Überarbeitung auf Leserqualität abgeschlossen sind.
- Tiefenkollaps: Ein Bericht erfüllt Quellenanzahlen und Abdeckungs-Checklisten, ist aber für die vom Benutzer erwartete Forschungstiefe zu kurz, komprimiert oder dünn.
Jeder Mechanismus in diesem Framework zielt auf einen dieser Fehler ab.
2. Geltungsbereich (Scope Contract)
Dieser Skill ist ein Ausführungs-Framework für die Erstellung substanzieller Forschungsergebnisse. Es ist kein Theoriesystem, keine Produktarchitektur und keine universelle Modellierungssprache.
In diesen Skill einbezogen:
- Prozess: Kalibrierung des Forschungsumfangs, stufenweise Ausführung, Quellenverarbeitung, Entwurf, Überprüfung, Überarbeitung und abschließende Bereinigung.
- Zustand: Aufgabenstatus, Fortschritt, Ergebnisse, Annahmen, Entscheidungen und Richtungsverfolgung.
- Prüfung: Quellen-, Anspruchs-, Unsicherheits-, Abdeckungs-, Tiefen- und Leserqualitätsprüfungen.
Außerhalb dieses Skills bleiben, sofern der Benutzer nicht explizit ein separates Systemdesign-Projekt anfordert:
- Domain-Ontologien, universelle Taxonomien oder verallgemeinerte Modellierungssprachen.
- Zwischendarstellungen, Bewertungssysteme, Einbettungen, Wissensgraphen oder Ranking-Engines.
- Dashboards, CLIs, Datenbanken, Automatisierungspipelines oder Produktarchitektur.
- Methoden-Manifeste, die nicht direkt das aktuelle Forschungsergebnis verbessern.
Wenn eine Aufgabe in die ausgeschlossenen Ebenen abzudriften beginnt, den aktuellen Ergebnispfad beibehalten, die Idee als zukünftige Erweiterung notieren und den Arbeitsablauf nicht erweitern.
3. Verhaltensbeschränkungen
- Ergebnis zuerst: Wenn die angeforderte Ausgabe ein Artikel oder Bericht ist, nicht abdriften in Systemdesign, Prompt-Design oder Workflow-Erläuterung.
- Research-Brief-Gate vor der Sammlung: Eine kompakte Klärungsrunde stellen, wenn entscheidungsrelevante Informationen fehlen.
- Zustand vor Maßstab: Bei langen Aufgaben den Aufgabenstatus in Dateien schreiben, bevor die Quellensammlung ausgeweitet wird.
- Beweise sind keine Prosa: Register, Protokolle, Prüflabel und Zugriffsfehler bleiben im Hintergrund, es sei denn, der Benutzer fordert einen Prüfanhang an.
- Tiefenbudget vor dem Schreiben: Die erwartete Tiefe, grobe Längenbandbreite, Einheiten-Expansionsplan und was „zu kurz“ für diese Aufgabe bedeuten würde, notieren.
- Stufenweise Ausführung: Planen, sammeln, analysieren, entwerfen, überprüfen, revidieren und Zustand aktualisieren, bevor zur nächsten Einheit übergegangen wird.
- Fortschritt auf Abschnittsebene: Komplexe Arbeit abschnittsweise, unternehmensbezogen, fallbezogen, zeitraumbezogen oder argumentbezogen schreiben; nicht den gesamten Bericht in einem Durchgang generieren.
- Optionale Linsen nur: Rahmen-/Kategorieanalyse, horizontale-vertikale Analyse, Kapitalanalyse und Übernahmeanalyse sind Werkzeuge, keine Standardstruktur.
- Überprüfung schließt den Kreislauf: Jeder Prüfbefund muss zu einer Überarbeitungsmaßnahme, einer herabgestuften Behauptung oder einer expliziten Einschränkung werden.
- Leserüberprüfung zuletzt: Lesbarkeit erst verbessern, nachdem fakten-, abdeckungs-, struktur- und tiefenbezogene Prüfungen stabil sind.
4. Architektur
Haupt-Agent
besitzt These, Struktur, endgültiges Urteil
Forschungs-Backend Veröffentlichungs-Frontend
Zustandsdateien These / Abschnitte
Quellenregister Mechanismen / Synthese
Anspruchsregister Gegenbeweise
Unsicherheitsliste leserorientierte Referenzen
Prüfprotokolle endgültige Prosa-Bereinigung
Unteragenten können begrenzte Teile des Backends inspizieren oder in Frage stellen, aber der Haupt-Agent besitzt das Argument und die endgültige Prosa.
5. Zustandsdateien
Für substanzielle Arbeit erstellen:
{task}/state/
task_spec.md # Ziel, Leser, Ausgabe, Umfang, Tiefe, Beweisstandard, Annahmen
progress.json # Phase, abgeschlossene Einheiten, offene Probleme, stale_count
findings.jsonl # anfügbare Ergebnisse und Urteile
directions_tried.json # bereits versuchte Richtungen
iteration_log.jsonl # Phasenzusammenfassungen
{task}/logs/
work.jsonl # Ausführungsentscheidungen
review.jsonl # Prüfbefunde und weitergeleitete Korrekturen
{task}/data/
source_registry.csv
claims_registry.csv
uncertainty_registry.csv
Zustandsdateien verwenden, um nach Kontextverlust wiederherzustellen. Nicht nur auf den Chat-Verlauf als Gedächtnis verlassen.
Kontext-Wiederherstellungsprotokoll
Bei Wiederaufnahme nach Kontextverlust, Sitzungsneustart oder Übergabe:
state/task_spec.mdfür Ziel, Umfang, Leser, Ausgabe, Tiefe, Beweisstandard und Annahmen lesen.state/progress.jsonfür aktuelle Phase, abgeschlossene Einheiten, offene Probleme, stale_count und nächste Aktion lesen.- Die neuesten Einträge in
state/findings.jsonlundstate/iteration_log.jsonllesen, um die aktuelle Richtung wiederherzustellen. state/directions_tried.jsonlesen, um fehlgeschlagene oder ausgeschöpfte Pfade zu vermeiden.- Ab dem entsprechenden Schritt in der Betriebsschleife fortfahren.
Abgeschlossene Phasen nicht erneut ausführen. Den Research-Brief nicht erneut stellen, wenn task_spec.md die Antworten bereits festhält.
6. Research-Brief-Gate
Vor der Sammlung entscheiden, ob die Anfrage genügend entscheidungsrelevante Informationen enthält. Wenn nicht, eine kompakte Fragestellung vor Beginn stellen. Die Stellvorlage sollte in der Regel 3-7 Fragen enthalten und die erwartete Länge oder Tiefe abdecken, wenn diese fehlt.
Nur nach fehlenden kritischen Informationen fragen:
- Forschungsobjekt und Umfangsgrenzen
- Ziel-Leser und Entscheidungskontext
- Ausgabeformat, Sprache und Veröffentlichungskontext
- erwartete Tiefe, grobe Längenbandbreite oder Tiefenstufe
- Muss abdeckende Einheiten, Ausschlüsse und Prioritätsbereiche
- erforderliche Quellen oder Materialien, Quellenausschlüsse und Beweisstandard
- Zeitraum, Geografie, Frist und ob Diagramme/Tabellen erwartet werden
Wenn der Benutzer bereits genügend Kontext geliefert hat, keine rituellen Fragen stellen. Fortfahren, Annahmen in task_spec.md festhalten und ungelöste nicht-kritische Details als Annahmen oder Unsicherheiten markieren.
Wenn nach einer Klärungsrunde kritische Details unbeantwortet bleiben, konservative Annahmen treffen, diese festhalten und mit einer begrenzten Stufe 1 beginnen, anstatt zu stocken.
7. Betriebsschleife
Für jede Phase:
- Das Research-Brief-Gate ausführen, dann den Umfang, die Eingaben, die Ausgabe und die Fertigstellungskriterien planen.
- Nur die Quellen sammeln oder verarbeiten, die für diese Phase benötigt werden.
- Quellen in Behauptungen, Unsicherheiten und Analyse-Notizen umwandeln.
- Einen begrenzten Abschnitt oder eine Einheit entwerfen.
- Den Abschnitt auf Beweise, Abdeckung, Struktur, Skepsis und Prosa überprüfen.
- Den Abschnitt und die Register überarbeiten.
- Den Fortschritt aktualisieren und die nächste Phase definieren.
Wenn ein Zyklus keine neuen Beweise, Fälle, Gegenbeispiele, Rahmen oder Urteile hinzufügt, stale_count erhöhen. Wenn stale_count >= 2, die strukturelle Perspektive wechseln, anstatt nur intensiver zu suchen.
Bei Langform-Ergebnissen die Quellenanzahl, Anspruchsanzahl, Linkanzahl oder Dateigröße nicht als Ersatz für Fertigstellung verwenden. Sie sind Backend-Gesundheitssignale, kein Beweis dafür, dass der fertige Bericht genügend Tiefe hat. Vor der endgültigen Zusammenstellung den Entwurf mit dem Tiefenbudget vergleichen und dünne Einheiten vor der Leserüberprüfung erweitern.
8. Quellen- und Anspruchsdisziplin
Quellen danach klassifizieren, was sie beweisen können:
- offizielle Materialien zeigen angegebene Position, Absicht, Produktoberfläche oder formelle Politik
- Primärdaten unterstützen messbare Behauptungen, wenn Definitionen und Erhebungsmethoden klar sind
- Expertenmaterialien erläutern Argumentation, Kontext und Interpretation
- Medienmaterialien zeigen öffentliche Rahmung, benötigen aber Bestätigung für harte Fakten
- Benutzer-/Community-Evidenz zeigt Rezeption, ist aber nicht automatisch repräsentativ
- Gegenbeweise begrenzen, schwächen oder widerlegen die Hauptbehauptung
Behauptungen separat klassifizieren:
- verifizierte Tatsache
- Quellenbehauptung
- Interpretation
- Autorenurteil
- Spekulation
Jede wichtige harte Behauptung sollte eine Konfidenzgrenze haben. Unternehmens-PR, Anlegerhoffnungen oder Medienverstärkung nicht in Tatsachen verwandeln.
9. Zeitplanung der Analyselinsen
Die Linse wählen, die zur Forschungsfrage passt:
- Rahmen-/Kategorieanalyse: Positionierung, Legitimität, Kategoriebildung, öffentliche Bedeutung und Medienübersetzung
- horizontale-vertikale Analyse: Zeitstrahltiefe plus aktueller Wettbewerber-/Substitutionsvergleich
- Übernahmeanalyse: Benutzerverhalten, Arbeitsablaufänderung, Ersatz, Reibung
- Kapitalanalyse: Preisgestaltung, Umsatz, Bewertung, Finanzierung, Kostenstruktur, Margen
- Organisations-/Talentanalyse: Betriebsmodell, Einstellung, Führung, Talentfluss
- Politik-/Legitimitätsanalyse: Regulierung, Compliance, Vertrauen, geopolitischer oder institutioneller Druck
- Gegenfallanalyse: stärkste alternative Erklärung und Fehlermodi
Eine primäre Linse und höchstens zwei sekundäre Linsen auswählen, es sei denn, der Benutzer fordert explizit einen multi-methodischen Bericht an.
Bei der Auswahl der Linsen references/optional-analysis-lenses.md lesen. references/horizontal-vertical-analysis.md erst lesen, nachdem diese Linse ausgewählt wurde.
10. Zeitplanung der Unteragenten
Unteragenten nur für begrenzte Arbeiten verwenden:
- Anforderungsbasierte Zuordnung
- Quellenfindung für separate Regionen, Akteure oder Quellenklassen
- Beweisketten-Verifikation
- Abdeckungsprüfung
- skeptische Überprüfung
- Strukturüberprüfung
- Überprüfung der Leserqualität, nachdem der Entwurf stabil ist
Ein Unteragenten-Prompt muss Ziel, zu inspizierende Dateien oder Abschnitte, Ausgabeformat, BESTANDEN/NICHT BESTANDEN-Kriterien und Grenzen enthalten. Unteragenten sollten nicht den gesamten Bericht umschreiben oder die These besitzen.
Vor der Delegierung references/subagents-and-review-loop.md lesen.
11. Finalisierung
Der endgültige Artikel oder Bericht sollte nur leserorientiertes Material enthalten:
- zuerst Schlussfolgerungen, wenn nützlich
- Umfangshinweis
- analytische Abschnitte, organisiert nach Argument, Fall, Zeitraum oder Mechanismus
- Synthese über Einheiten hinweg
- Gegenbeweise und Unsicherheit klar ausgedrückt
- Implikationen
- leserorientierter Referenzanhang
Entfernen:
- sichtbare Quellen-IDs
- Prüflabel
- Dateipfade
- „der Benutzer hat bereitgestellt“
- „das Material zeigt“
- „diese Quelle ergänzt“
- „dieser Abschnitt hat die Prüfung bestanden“
- übermäßige Einschränkungen, die das Urteil eher schwächen als klären
12. Validierung und Grenzen
Vor der Fertigstellungserklärung:
- Das Research-Brief-Gate wurde abgeschlossen oder Annahmen wurden festgehalten.
- Die erforderliche Abdeckung ist vollständig oder Einschränkungen sind explizit.
- Wichtige Behauptungen lassen sich auf Quellen oder Unsicherheitsaufzeichnungen zurückführen.
- Fakten, Quellenbehauptungen, Interpretationen und Autorenurteile bleiben unterscheidbar.
- Gegenbeweise wurden berücksichtigt.
- Der Entwurf erfüllt das Tiefenbudget oder erklärt explizit, warum die ursprünglich erwartete Tiefe nicht mehr angemessen ist.
- Die Leserüberprüfung wurde nach der faktenbezogenen, abdeckungsbezogenen, strukturellen und tiefenbezogenen Überprüfung durchgeführt.
- Die endgültige Prosa liest sich wie der Bericht eines Autors, nicht wie ein Agentenprozessbericht.
Grenzen:
- Das Framework reduziert Zitier- und Beweisfehler; es beseitigt sie nicht.
- Die Unteragentenüberprüfung ist eine Kontrolle, keine externe Wahrheit.
- Optionale Linsen können den Bericht überanpassen, wenn sie mechanisch verwendet werden.
- Zustandsdateien helfen bei der Wiederherstellung, aber sie funktionieren nur, wenn sie während der Aufgabe aktualisiert werden, nicht nachträglich rekonstruiert.
13. Ausführungsschutzvorrichtungen
Diese Schutzvorrichtungen verwenden, um Schleifen, Übererfassung und Umfangsabdrift zu verhindern:
- Quellensammlung: Wenn drei aufeinanderfolgende Suchläufe oder Quellendurchgänge keine relevanten Beweise hinzufügen, die Sammlung in diese Richtung einstellen,
directions_tried.jsonaktualisieren und skizzieren oder wenden. - Anspruchsextraktion: Wenn
source_registry.csvwächst, währendclaims_registry.csvdünn bleibt, die Sammlung pausieren und Behauptungen extrahieren, bevor weitere Quellen gesammelt werden. - Überprüfungsschleife: Vollständige Überprüfungs- und Überarbeitungszyklen auf zwei pro Abschnitt begrenzen, es sei denn, der Benutzer fordert mehr; ungelöste Probleme als Einschränkungen oder Folgemaßnahmen festhalten.
- Tiefenprüfung: Vor der Leserüberprüfung den Entwurf mit dem Tiefenbudget vergleichen und dünne Einheiten erweitern, bevor die Prosa optimiert wird.
- Umfangserweiterung: Wenn neue Arbeiten außerhalb von
task_spec.mdfallen, als vorgeschlagene Erweiterung notieren und vor einer Projekterweiterung fragen. - Unteragentenüberprüfung: Prompts müssen den Prüfer bitten, aktiv nach Problemen zu suchen; wenn kein Problem gefunden wird, muss der Prüfer angeben, welche Beweise BESTANDEN unterstützen.
14. Fallstricke (Gotchas)
Auf diese wiederkehrenden Fehlermuster achten:
- Register-Theater: Quellen- und Anspruchsregister sehen vollständig aus, aber die endgültige Prosa synthetisiert keine Mechanismen oder Kompromisse.
- Quellenauflistungsprosa: Absätze wiederholen „Quelle X sagt Y“, anstatt Beweise in leserorientierte Urteile umzuwandeln.
- Vorzeitige Leserpolitur: Die Prosa-Bereinigung beginnt, bevor Abdeckungs-, Beweis-, Struktur- und Tiefenprüfungen stabil sind.
- Linsenüberschreitung: Eine optionale Linse wird zum gesamten Bericht, selbst wenn die Frage des Benutzers eine einfachere Struktur erfordert.
- Unteragentenausbreitung: Prüfer oder Sammler werden gebeten, die These zu besitzen, den gesamten Bericht umzuschreiben oder den Umfang zu erweitern.
- Tiefenersatz: Linkanzahlen, Dateigröße oder Checklistenabdeckung werden als Beweis dafür behandelt, dass der Bericht tief genug ist.
Bei der Diagnose wiederholter Abdrift, der Verbesserung von Auswertungen oder der Anpassung des Frameworks an einen neuen Agenten references/gotchas.md lesen.
15. Harte Stopps
Den aktuellen Pfad stoppen und den Zustand reparieren, bevor fortgefahren wird, wenn einer dieser Fälle eintritt:
- Brief-Stopp: Eine substanzielle Forschungsaufgabe hat nach der Klärungsrunde keinen Leser, Umfang, Ausgabeform, Beweisstandard oder Tiefenbudget.
- Beweisstopp: Drei aufeinanderfolgende Suchläufe oder Quellendurchgänge fügen keine neuen relevanten Beweise, Fälle, Gegenbeispiele oder Urteile hinzu.
- Anspruchsstopp:
source_registry.csvwächst, währendclaims_registry.csvleer, allgemein oder vom Entwurf losgelöst bleibt. - Entwurfsstopp: Die endgültige Prosa enthält immer noch Prozesssprache, interne Quellen-IDs, Prüflabel oder Dateipfade.
- Leserqualitätsstopp: Die Leserüberprüfung wird abgeschlossen, während noch Abdeckungs-, Beweis-, Struktur- oder Tiefenprobleme offen sind.
- Umfangsüberschreitung: Der Agent hat sich in Systemdesign, Modellierungssprachen oder Produktarchitektur bewegt, ohne dass der Benutzer dies angefordert hat.
Bei einem harten Stopp den letzten stabilen Zustand sichern, die fehlenden Informationen dokumentieren, den Fortschritt aktualisieren und optional zu einer engeren Definition der Aufgabe zurückkehren.