From f93b4d0b7284ac67cc765c38fef141b4a826191d Mon Sep 17 00:00:00 2001
From: Jens Reinemann <reinemann@euris.de>
Date: Mon, 18 May 2026 13:03:13 +0200
Subject: [PATCH] fix(docs): Mermaid-Diagramme in Concept.md verbessern

- Emojis aus Mermaid-Nodes entfernt (verursachten Fragezeichen)
- Pipeline-Diagramm vereinfacht (single flowchart statt verschachtelter Subgraphs)
- Dateistruktur: Subgraph-Labels gekuerzt damit Text nicht verdeckt wird
---
 .github/knowledge-conduit/Concept.md | 98 +++++++++++++---------------
 1 file changed, 46 insertions(+), 52 deletions(-)

diff --git a/.github/knowledge-conduit/Concept.md b/.github/knowledge-conduit/Concept.md
index 779cd83..16b18c8 100644
--- a/.github/knowledge-conduit/Concept.md
+++ b/.github/knowledge-conduit/Concept.md
@@ -18,15 +18,15 @@ graph LR
 
 ```mermaid
 graph TD
-    G[� Knowledge Conduit<br/>Kanal zwischen Dev+AI-Teams] --> T1[Capability: Skill]
+    G[Knowledge Conduit] --> T1[Capability: Skill]
     G --> T2[Capability: Agent]
     G --> T3[Capability: Prompt]
     G --> T4[Capability: Instructions]
     T1 -->|Git-Delta| M1[Improvement]
     T3 -->|Git-Delta| M2[Improvement]
-    M1 -->|destilliert| GV1[Insight<br/>Score 8/10 🟡]
-    M2 -->|destilliert| GV2[Insight<br/>Score 9/10 🔴]
-    GV1 --> PR[Transfer<br/>Konkrete Patches]
+    M1 -->|destilliert| GV1[Insight - Score 8/10]
+    M2 -->|destilliert| GV2[Insight - Score 9/10]
+    GV1 --> PR[Transfer - Konkrete Patches]
     GV2 --> PR
 ```
 
@@ -146,25 +146,18 @@ Instructions-Dateien sind Einzeldateien. Der **Dateiname** ist der Capability-Sc
 ## Pipeline
 
 ```mermaid
-flowchart LR
-    subgraph "Phase 1: Extraction"
-        direction TB
-        GIT[(Git-History)] --> SCRIPT[kc-extract.py]
-        SCRIPT --> RAW[raw-improvements.md]
-    end
-    subgraph "Phase 2: Distillation"
-        direction TB
-        RAW2[raw-improvements.md] --> AGENT1[KI-Agent]
-        AGENT1 --> |"Klassifizieren\nScoren\nSanitizen"| DIST[distilled-insights.md]
-    end
-    subgraph "Phase 3: Transfer"
-        direction TB
-        DIST2[distilled-insights.md] --> AGENT2[KI-Agent]
-        ZIEL[Ziel-Repo] --> AGENT2
-        AGENT2 --> PATCHES[Konkrete Patches]
-    end
-    RAW --> RAW2
-    DIST --> DIST2
+flowchart TD
+    GIT[(Git-History)] --> SCRIPT[kc-extract.py]
+    SCRIPT --> RAW[raw-improvements.md]
+    RAW --> AGENT1[KI-Agent: Distillation]
+    AGENT1 -->|Klassifizieren + Scoren + Sanitizen| DIST[distilled-insights.md]
+    DIST --> AGENT2[KI-Agent: Transfer]
+    ZIEL[Ziel-Repo] --> AGENT2
+    AGENT2 --> PATCHES[transfer-proposals.md]
+
+    style SCRIPT fill:#2d4a2d,stroke:#4a7c4a
+    style AGENT1 fill:#4a3d2d,stroke:#7c6a4a
+    style AGENT2 fill:#2d3d4a,stroke:#4a6a7c
 ```
 
 ### Phase 1: Extraction (Script)
@@ -186,15 +179,15 @@ flowchart LR
 ```mermaid
 flowchart TD
     M[Improvement] --> K{Klassifizierung}
-    K -->|Bugfix für alle| C[🔴 Critical]
-    K -->|Generelle Verbesserung| E[🟡 Evolution]
-    K -->|Nur dieses Projekt| S[⚪ Specialized]
-    C --> SC[Score 1–10]
+    K -->|Bugfix fuer alle| C[CRITICAL]
+    K -->|Generelle Verbesserung| E[EVOLUTION]
+    K -->|Nur dieses Projekt| S[SPECIALIZED]
+    C --> SC[Score 1-10]
     E --> SC
-    S --> X[❌ Entfernt]
-    SC --> SAN[Sanitization<br/>Pfade, Tokens, IDs ersetzen]
-    SAN --> |Score ≥ 4| OUT[→ distilled-insights.md]
-    SAN --> |Score < 4| X
+    S --> X[Entfernt]
+    SC --> SAN[Sanitization]
+    SAN -->|Score ge 4| OUT[distilled-insights.md]
+    SAN -->|Score lt 4| X
 ```
 
 - Scored jedes Improvement (1–10) nach Übertragungswert
@@ -245,31 +238,32 @@ sequenceDiagram
 
 ```mermaid
 graph TD
-    subgraph ".github/skills/knowledge-conduit/"
-        SK[SKILL.md<br/>Skill-Dokumentation]
-        EX[kc-extract.py<br/>Phase 1 Script]
+    subgraph skills [skills/knowledge-conduit/]
+        SK[SKILL.md]
+        EX[kc-extract.py]
     end
-    subgraph ".github/prompts/"
-        OR[knowledge-conduit.prompt.md<br/>Orchestrator]
-        DI[kc-distill.prompt.md<br/>Phase 2]
-        PR[kc-transfer.prompt.md<br/>Phase 3]
+    subgraph prompts [prompts/]
+        OR[knowledge-conduit.prompt.md]
+        DI[kc-distill.prompt.md]
+        PR[kc-transfer.prompt.md]
     end
-    subgraph ".github/knowledge-conduit/output/"
-        RM[raw-improvements.md<br/>generiert]
-        DM[distilled-insights.md<br/>generiert]
-        PP[transfer-proposals.md<br/>generiert]
+    subgraph output [knowledge-conduit/output/]
+        RM[raw-improvements.md]
+        DM[distilled-insights.md]
+        PP[transfer-proposals.md]
     end
-    subgraph ".github/knowledge-conduit/"
-        CO[Concept.md<br/>Dieses Konzept]
+    subgraph concept [knowledge-conduit/]
+        CO[Concept.md]
     end
-    OR -->|"ruft auf"| EX
-    OR -->|"delegiert an"| DI
-    OR -->|"delegiert an"| PR
-    EX -->|"schreibt"| RM
-    DI -->|"liest"| RM
-    DI -->|"schreibt"| DM
-    PR -->|"liest"| DM
-    PR -->|"schreibt"| PP
+
+    OR -->|ruft auf| EX
+    OR -->|delegiert an| DI
+    OR -->|delegiert an| PR
+    EX -->|schreibt| RM
+    DI -->|liest| RM
+    DI -->|schreibt| DM
+    PR -->|liest| DM
+    PR -->|schreibt| PP
 ```
 
 | #   | Datei                          | Typ           | Ort                                |