Joule-Wiki

Raw-Anleitung

3 Min. Lesezeit

Spiegelseite

Dies ist die Wiki-Browser-Version. Die Originaldatei liegt im Projekt-Root unter raw/README.md. Änderungen bitte in beide Versionen einpflegen.

raw/ — Rohquellen

Der raw/-Ordner ist die Eingangsschleuse des Wikis. Alles, was dort liegt, ist unveränderlich: die KI liest daraus, modifiziert aber nie den Inhalt. Das Wiki unter content/ ist die verarbeitete Sicht auf diese Quellen.

Wie reiche ich etwas ein?

  1. Datei(en) in raw/.inbox/ ablegen. Unterstützte Formate: PDF, DOCX, PPTX, XLSX, MD, TXT, PNG/JPG (Screenshots), MP3/MP4 (Mitschnitte), Links (als .url- oder .md-Datei mit URL drin).
  2. Sprechenden Dateinamen wählen. Beispiel: 2026-03-15_sap-joule-update_teched-keynote.pdf. Format: JJJJ-MM-TT_kurzes-thema_herkunft.endung. Hilft der KI (und uns) beim späteren Aufräumen.
  3. Optional: Kontext-Datei daneben legen. Eine .md-Datei gleichen Namens mit 1-2 Sätzen, was die Quelle ist und warum sie wichtig ist.
  4. Claude bitten, zu integrieren: „Integriere die neuen Dateien aus raw/.inbox/ ins Wiki.”

Wiederkehrende Formate (Briefings, Newsletter, Reportings)

Wenn du ein regelmäßiges Format einreichst — z.B. ein tägliches KI-Briefing oder einen wöchentlichen Marktreport — schreib das in den Kontext mit: „Tägliches KI-Briefing von … — wiederkehrendes Format.” Die KI erkennt das und legt nur für die erste Ausgabe eine eigene Quelle-Seite an. Alle Folgeausgaben fließen als kuratierte Extrakte in bestehende Wiki-Seiten (z.B. neue Kennzahlen direkt in Adoptionslage). Das hält das Wiki schlank — sonst hätten wir in drei Monaten 90 Quelle-Seiten, die sich 80 % überschneiden.

Gleiches Prinzip gilt für Quellen mit überwiegend Joule-fremdem Inhalt (z.B. ein allgemeines KI-Marktbriefing): Die KI übernimmt nur die Joule-relevanten Fakten, nicht alles. Details siehe Schema §5.1.1.

Was passiert danach?

Die KI folgt dem Ingest-Workflow aus dem Schema (CLAUDE.md) §5.1:

  1. Liest die Quelle (und bei Bildern: schaut sie sich an).
  2. Legt eine Quelle-Seite unter content/quellen/ an mit 5-Punkte-Zusammenfassung, Schlüsselzitaten, Metadaten.
  3. Aktualisiert oder erstellt betroffene Wiki-Seiten: Produktseiten, Konzepte, Entitäten, Projekte.
  4. Trägt Wikilinks in beide Richtungen ein.
  5. Bewegt die Datei von .inbox/ in einen passenden Unterordner: presse/, kundenprojekte/, sap-offiziell/, messen/, interne-notizen/ etc.
  6. Schreibt ins Log unter content/log.md.

Du bekommst am Ende einen Zusammenfassungsbericht: neue Seiten, aktualisierte Seiten, offene Fragen.

Ordnerstruktur (wächst organisch)

raw/
├── README.md            ← Originalversion dieses Textes
├── .inbox/              ← hier landet alles Neue
├── assets/              ← Bilder/Diagramme, die direkt in Wiki-Seiten eingebettet werden
├── sap-offiziell/       ← (entsteht bei Bedarf) Whitepapers, Release-Notes, Pressemitteilungen
├── presse/              ← (entsteht bei Bedarf) Artikel, Analystenberichte
├── kundenprojekte/      ← (entsteht bei Bedarf) projektbezogene Dokumente
├── messen/              ← (entsteht bei Bedarf) TechEd, Sapphire, andere Events
└── interne-notizen/     ← (entsteht bei Bedarf) Meetings, Mitschriften, Chats

Was gehört nicht hierher?

  • Rohentwürfe fertiger Wiki-Seiten → gehören direkt in content/.
  • Sensible personenbezogene Daten, solange das Wiki noch lokal auf einem PC liegt und kein Schutzkonzept existiert.
  • Dateien unter NDA, solange die NDA-Lage nicht geklärt ist — im Zweifel mit Martin sprechen.

Assets (Bilder)

Bilder, die in eine Wiki-Seite eingebettet werden sollen, gehören nach raw/assets/. Einbindung in Markdown:

![Architektur-Überblick](../../raw/assets/joule-architektur.png)

Fragen? → Martin Arnold.

← Meta · Inhaltsverzeichnis

Graphansicht

Backlinks