bollwerkadmin/bollwerk
1
0
Fork 0
Code Issues 9 Pull requests Projects Releases Packages Wiki Activity Actions

fix(docs): Mermaid-Diagramme in Concept.md verbessern

Browse source 
- 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
1 changed files with 46 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

98
.github/knowledge-conduit/Concept.md vendored
View file

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