AGENTS.md

Anleitung für KI-Agenten, die an dieser Knowledge Base arbeiten. Ziel: Konsistente Struktur, nachvollziehbare Änderungen, qualitativ hochwertige Markdown-Dateien für Obsidian.

Projektübersicht

jumankai ist eine grün-teale, regenerativ ausgerichtete KI-Beratungsorganisation im DACH-Raum.
Diese Knowledge Base enthält das Konzeptpapier, eine Ontologie zentraler Begriffe und Website-Inhalte.
Alles ist als Obsidian-Vault im Ordner G:/Meine Ablage/Knowledge_Bases/KBs/jumankai/ organisiert.

Ordnerstruktur

jumankai/
├── .obsidian/                          # Obsidian-Konfiguration (nicht anfassen)
├── konzeptpapier.md                    # ⚠️ ORIGINAL – nie editieren, nur lesen
├── AGENTS.md                           # Diese Datei
│
├── jumankai-konzept/                   # Aufbereitetes Konzeptpapier (chunked)
│   ├── 00_Index.md                     # Master-Index mit Wiki-Links zu allen Subdokumenten
│   ├── 01_Vision_und_Kernprinzipien.md
│   ├── 02_Regenerative_Organisation.md # ⚠️ Teile vertraulich (nicht veröffentlichen)
│   ├── 03_Organisationsstruktur_und_Rollen.md
│   ├── 04_Honorar_und_Verteilungsmodell.md
│   ├── 05_Digitale_Ethik.md
│   ├── 06_Mitgliedschaft.md
│   ├── 07_Kunden_und_Zielgruppe.md
│   ├── 08_Dienstleistungsangebot.md
│   ├── 09_Technologie_und_Architektur.md
│   ├── 10_Marketing_und_Positionierung.md
│   │
│   └── ontology/                       # Begriffswelt (idiosynkratische Konzepte)
│       ├── 00_Ontologie_Index.md       # Index + Mermaid-Diagramm
│       ├── ontologie-regenerative-organisation.md
│       ├── ontologie-teal-organisation.md
│       ├── ontologie-konsent.md
│       ├── ontologie-slow-org.md
│       ├── ontologie-care-arbeit.md
│       ├── ontologie-digitale-suffizienz.md
│       ├── ontologie-digitale-souveraenitaet.md
│       ├── ontologie-schnellboot-logik.md
│       ├── ontologie-human-in-the-lead.md
│       ├── ontologie-wirkung-vor-groesse.md
│       └── ontologie-360-grad-beratung.md
│
└── Veröffentlichungen/
    └── Website/
        ├── STRUCTURE-index.astro       # Astro-Template (Content-Slots)
        └── Website-Content-Landing-Page.md  # Befüllter Website-Text (zur Freigabe)

Konventionen

Dateinamen

Konzeptpapier-Chunks: XX_Titel_mit_Underscores.md (zweistellig nummeriert)
Ontologie: ontologie-kleingeschrieben-mit-bindestrichen.md
Website-Content: Website-Content-Seitenname.md

YAML-Frontmatter

Jede Datei beginnt mit:

---
tags:
  - tag1
  - tag2
status: in-progress | draft | vertraulich | final
---

status: vertraulich → Nicht außerhalb des Kernteams teilen.
status: in-progress → Noch in Abstimmung.
status: draft → Erster Entwurf, zur Freigabe.

Wiki-Links

Konzeptpapier-Chunks verlinken untereinander: [[03_Organisationsstruktur_und_Rollen]]
Konzeptpapier-Chunks verlinken zur Ontologie: [regenerativ](ontology/ontologie-regenerative-organisation.md)
Ontologie-Einträge verlinken zurück zu Konzeptpapier: [[../04_Honorar_und_Verteilungsmodell]]

Was zu tun ist (und was nicht)

✅ Erlaubt / erwünscht

Neue Ontologie-Einträge anlegen, wenn neue idiosynkratische Begriffe auftauchen
Bestehende Konzept-Chunks um neue Erkenntnisse ergänzen
Website-Content weiterentwickeln und an neue Positionierung anpassen
Querverweise zwischen Konzeptpapier und Ontologie pflegen
Status-Flags aktuell halten (in-progress → final)

❌ Nicht tun

konzeptpapier.md im Root editieren (ist das historische Original)
Ontologie-Einträge für selbsterklärende Begriffe anlegen (siehe Kriterien unten)
Status vertraulich bei Dateien ignorieren
Tags erfinden, die nicht ins Schema passen

Ontologie-Kriterien

Ein Begriff gehört in die Ontologie, wenn er nicht selbsterklärend ist, d.h. mindestens eines zutrifft:

Idiosynkratische Prägung – der Begriff hat bei jumankai eine spezifischere Bedeutung als im allgemeinen Sprachgebrauch (z.B. „Care-Arbeit”, „Schnellboot-Logik”)
Theoretischer Hintergrund – der Begriff referenziert eine externe Theorie, die Lesende kennen müssen (z.B. „Teal”, „Konsent”)
Abgrenzungsbedarf – der Begriff kann leicht mit einem ähnlichen verwechselt werden (z.B. „Konsent” ≠ „Konsens”, „Regeneration” ≠ „Nachhaltigkeit”)
Metapher mit System – der Begriff ist eine durchgängige Metapher im Konzept (z.B. „Schnellboot-Logik” / „Slow Org”)

Gegenbeispiele (nicht in die Ontologie)

EU AI Act → selbsterklärendes regulatorisches Referenzobjekt
DACH → geografische Abkürzung, allgemein bekannt
MVP → Branchenstandard
KMU → allgemein bekannt

Website-Content-Workflow

STRUCTURE-index.astro definiert die Content-Slots (hero, spotlight, footer etc.)
Website-Content-Landing-Page.md befüllt diese Slots mit finalem Text
Der Text ist auf Geschäftstreibende im DACH-Mittelstand zugeschnitten
Änderungen am Website-Text immer erst in der .md-Datei vornehmen, dann in Astro übertragen

Textprinzipien für die Website

Zielgruppe: Geschäftsführende, IT-Leiter, Change-Verantwortliche in KMU (250+ MA)
Ton: ruhig, fundiert, verbindlich – Gegenpol zum KI-Hype
USP immer präsent: „Keine KI auf unverstandene Prozesse”, „Mensch vor Technik”, „Wirkung vor Größe”
DACH-Kontext: Rechtssicherheit (EU AI Act), Datenschutz, XING neben LinkedIn

Schnellreferenz: Wichtige Dateien

Datei	Bedeutung
`jumankai-konzept/00_Index.md`	Einstiegspunkt – alle Links, Änderungshistorie
`jumankai-konzept/02_Regenerative_Organisation.md`	⚠️ Vertraulich – nicht extern teilen
`jumankai-konzept/05_Digitale_Ethik.md`	Rote Linien, Haltung, Open Source
`jumankai-konzept/10_Marketing_und_Positionierung.md`	SWOT, USP, Website-Konzept
`jumankai-konzept/ontology/00_Ontologie_Index.md`	Begriffswelt-Übersicht + Mermaid-Diagramm
`Veröffentlichungen/Website/Website-Content-Landing-Page.md`	Finaler Website-Text
`Veröffentlichungen/Website/STRUCTURE-index.astro`	Template – nicht den Text hier ändern

jumankai

Explorer