joerglohrer
/
fOERbico
mirror of https://git.rpi-virtuell.de/Comenius-Institut/fOERbico
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
fOERbico/Orga/oer-community-webseite-orga/wissensgrundlagen
History
Jörg Lohrer 5d4561ab88 Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 
Verschiebt die gemeinsamen Wissensgrundlagen der oer.community-
Content-Pipeline aus dem irreführenden Pfad
  Orga/oer-community-webseite-orga/comenius-yaml-mcp/data/
in eine tool-neutrale Heimat:
  Orga/oer-community-webseite-orga/wissensgrundlagen/

Verschoben:
- comenius-yaml-mcp/data/felder.yaml      → wissensgrundlagen/felder.yaml
- comenius-yaml-mcp/data/personen.yaml    → wissensgrundlagen/personen.yaml
- comenius-yaml-mcp/data/schlagworte.yaml → wissensgrundlagen/schlagworte.yaml
- schlagwort-glossar-oer-community.md     → wissensgrundlagen/schlagwort-glossar.md

Neu:
- wissensgrundlagen/README.md erklärt Inhalt, Konsumenten und das
  Mensch-Maschine-Wissensbasis-Prinzip.

Hintergrund: Die YAMLs werden nicht nur von comenius-yaml-mcp gelesen,
sondern künftig auch von content-lint, mdparser/sync und LLM-Helferlein.
Der alte Pfad suggerierte Tool-Eigentum, das es nicht gibt.

Folgeanpassungen (eigene Commits in den jeweiligen Repos):
- comenius-yaml-mcp src/forgejo.ts: BASE_URL auf neuen Pfad anpassen,
  gleichzeitig Wechsel von Forgejo-Direktzugriff (Anubis-anfällig) auf
  GitHub-Mirror raw.githubusercontent.com/rpi-virtuell/...
- content-lint und mdparser/sync sollen ebenfalls aus diesem Pfad lesen.

Vollständiges ADR mit Begründung und Migrationsphasen:
oercommunity/docs/decisions/2026-04-08-restructure-wissensgrundlagen.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 		2026-04-08 16:07:27 +02:00
..
README.md Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 2026-04-08 16:07:27 +02:00
felder.yaml Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 2026-04-08 16:07:27 +02:00
personen.yaml Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 2026-04-08 16:07:27 +02:00
schlagwort-glossar.md Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 2026-04-08 16:07:27 +02:00
schlagworte.yaml Restrukturierung: Wissensgrundlagen in tool-neutrales Verzeichnis 2026-04-08 16:07:27 +02:00

README.md

Wissensgrundlagen für oer.community

Dieses Verzeichnis enthält die gemeinsamen Wissensgrundlagen für die oer.community-Content-Pipeline. Sie sind die kanonische Quelle für alle Inhalts- und Metadaten-Entscheidungen und werden von mehreren unabhängigen Tools gelesen.

Was hier liegt

Datei Zweck Konsumenten
felder.yaml Schema und Regeln für YAML-Frontmatter (Pflicht-/Optionalfelder, erlaubte Werte, Standardwerte, Ableitungslogik) comenius-yaml-mcp, content-lint, mdparser, der YAML-FRONTMATTER-ASSISTENT-PROMPT.md
personen.yaml Verzeichnis bekannter Autor:innen und ihrer Affiliations (mit ORCID, ROR, Standardangaben für creator-Feld) comenius-yaml-mcp, LLM-Helferlein, manuelle Redaktion
schlagworte.yaml Kanonische Schreibweisen aller Schlagworte (verhindert Synonyme und Tippfehler) comenius-yaml-mcp, content-lint (Validierung), LLM-Helferlein
schlagwort-glossar.md Menschenlesbare Beschreibung der Schlagworte mit Definitionen und Verwendungshinweisen Mensch, LLM-Prompts

Prinzip

Jede Wissensgrundlage existiert in zwei deckungsgleichen Formen:

  1. Maschinenlesbar (*.yaml) — Single Source of Truth, von Tools direkt geparst.
  2. Menschenlesbar (*.md) — für Autor:innen, Reviewer und LLM-Prompts ohne MCP-Setup.

Mittelfristig sollen die menschenlesbaren Pendants aus den YAMLs generiert werden, sodass kein Drift entsteht. Aktuell werden sie von Hand gepflegt; ein Konsistenz-Test (im oercommunity-Hub) ist geplant.

Wer liest die Wissensgrundlagen, wie?

  • comenius-yaml-mcp liest die YAMLs über HTTP von einem stabilen Endpunkt (siehe dort src/forgejo.ts). Aktuell wird der Pfad auf den GitHub-Mirror rpi-virtuell/FOERBICO_und_rpi-virtuell umgestellt, um Anubis zu umgehen.
  • content-lint soll perspektivisch seine Validierungsregeln aus felder.yaml ziehen statt sie hardcoded zu pflegen.
  • mdparser/sync soll für sein YAML→Event-Mapping ebenfalls auf felder.yaml zurückgreifen.
  • LLM-Helferlein (Claude, ChatGPT, lokale Modelle) konsumieren den menschenlesbaren YAML-FRONTMATTER-ASSISTENT-PROMPT.md (eine Etage höher) und die *.md-Dateien hier.

Erweiterung

Neue Wissensgrundlagen (z.B. Lizenzen, Zielgruppen, Affiliations) finden hier ihre Heimat ohne Umordnung. Konvention:

  • Maschinenlesbar als <thema>.yaml
  • Menschenlesbar als <thema>.md
  • Beide gleich benannt, damit klar ist welches Pendant zu welchem gehört
  • Konsumenten und Pflichtfelder im Header der YAML-Datei dokumentieren

Restrukturierung 2026-04-08

Bis zum 8. April 2026 lagen felder.yaml, personen.yaml und schlagworte.yaml unter comenius-yaml-mcp/data/ — ein irreführender Pfad, der sie als Eigentum eines einzelnen Tools darstellte. Sie sind in dieses tool-neutrale Verzeichnis umgezogen. Der schlagwort-glossar-oer-community.md ist mitumgezogen und in schlagwort-glossar.md umbenannt.

Begründung und Migrationsschritte: siehe ADR oercommunity/docs/decisions/2026-04-08-restructure-wissensgrundlagen.md im Orchestrierungs-Hub.