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
This commit is contained in:
Jens Reinemann 2026-05-18 13:03:13 +02:00
parent bfa1f2b649
commit f93b4d0b72

View file

@ -18,15 +18,15 @@ graph LR
```mermaid
graph TD
G[<EFBFBD> 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 110]
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 (110) 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 |