Forschungsartefakte (Research Artifacts)
Forschung dokumentiert die externe Evidenz hinter einer Entscheidung: Technologiebewertungen, Bibliotheksvergleiche, Branchenpraxis-Umfragen. Forschung ist datiert, belegt und nur-anhängbar – eine Momentaufnahme dessen, was die Evidenz zu einem bestimmten Zeitpunkt besagte, keine lebendige Meinung.
Dieses Skill definiert, wie Forschung organisiert, formatiert und indiziert wird. Das Skill deep-research definiert, wie sie erhoben und kreuzvalidiert wird; living-docs verwaltet die Entscheidungen und Issues, die sie speist. Die drei Skills ergänzen sich. Forschungsartefakte sind OKF-Konzepte – siehe das Skill okf-knowledge-format für die Frontmatter-/reservierten Dateiregeln, die hier angewendet werden.
Verwendung dieses Skills (progressive Offenlegung)
Diese SKILL.md ist ein schlanker Stub – ein Auslöser plus ein Aufgaben-zu-Themen-Router. Der living-docs CLI enthält die vollständigen Forschungsregeln, Quellendisziplin, Struktur und die nachvollziehbare Kette und legt sie progressiv offen. Bevor Sie etwas verfassen, laden Sie das Thema für Ihre Aufgabe:
living-docs guide --list– entdecken Sie jedes Thema.living-docs guide <topic> --skill research-artifacts– laden Sie dieses Thema.
Die weitergeleitete Ausgabe ist minifiziertes JSON (Maschinenstandard); --plain für menschenlesbaren Text, --json um JSON zu erzwingen. Themen: rules, structure, research-report, research-index, research-general-references, about.
Dieser Stub ist ein reiner Router (ADR 0017): Er löst aus und zeigt auf Themen – er enthält keine Regeln inline. Die Quellendisziplin und die Forschung → Entscheidung → Issue-Kette sind Themen, die vor dem Verfassen geladen werden via guide rules --skill research-artifacts / guide structure --skill research-artifacts.
Wann es aufzurufen ist
- Aufzeichnen der Ergebnisse einer Forschungssitzung in
docs/research/–living-docs guide research-report --skill research-artifacts. - Strukturieren oder Indizieren einer Forschungsnotiz (
docs/research/NNNN-<slug>.md+ die Indexliste + die allgemeine Zusammenfassung) –living-docs guide research-index --skill research-artifacts/guide research-general-references --skill research-artifactsfür die Vorlagen,guide structure --skill research-artifactsfür die Layoutregeln. - Durchsetzung der Quellendisziplin für einen Entwurf (Primärquellen, Vendor-COI-Flags, Inferenz-vs-Fakt-Kennzeichnungen, Vertrauensstufen, Abruf-Fehlervermerke) –
living-docs guide rules --skill research-artifacts. - Aufbau der nachvollziehbaren Forschung → Entscheidung → Issue-Kette (eine akzeptierte Empfehlung muss ein ADR und dann Issues erreichen, in
living-docs) –living-docs guide structure --skill research-artifacts.