# 🧭 KI-Cluster Roadmap

## 🎯 Projektziel
Ein autonomes, modulares KI-Entwicklungscluster für dein Homelab, das in der Lage ist:
- Software eigenständig zu **planen**, **entwickeln**, **testen** und **dokumentieren**,  
- mit dir als Benutzer **strategisch zu planen** und **Entscheidungen abzustimmen**,  
- **Langzeitwissen** zu speichern und daraus zu lernen,  
- und die gesamte Arbeit in **Planung** und **Code** klar zu trennen.

---

## 🗂️ Strukturprinzip

Jeder Roadmap-Punkt ist ein **eigener Unterordner**, der zwei Hauptbereiche enthält:

| Ordner | Zweck |
|--------|--------|
| **/Planung** | Enthält alle Konzepte, Architekturideen, Diagramme, Systembeschreibungen und Spezifikationen. |
| **/Entworfener_Code** | Beinhaltet den von der KI erzeugten, getesteten und funktionsfähigen Code, Skripte oder fertige Module. |

Diese Trennung erlaubt eine saubere Zusammenarbeit zwischen **Strategie- und Builder-Agenten**:
- Die Planung dient als Input für den Builder-Agenten.  
- Der fertige Code landet im Unterordner `/Entworfener_Code/`.  

---

## 📁 Verzeichnisstruktur

```plaintext
/                                  ← Projektwurzel
│
├── roadmap_readme.md              ← Diese Datei (Projektübersicht)
│
├── 00_Globale_Richtlinien/
│   ├── Planung/
│   │   ├── Einleitung_und_Scope.md
│   │   ├── Governance_und_Rollen.md
│   │   ├── Code_Style.md
│   │   ├── Namenskonventionen.md
│   │   └── Komponenten_Standardstruktur.md
│   └── Entworfener_Code/
│       ├── Dockerfile
│       ├── requirements.txt
│       └── app/
│           ├── start.py
│           ├── runtime_config.yaml
│           ├── config/
│           │   ├── config.yaml
│           │   └── logging.yaml
│           ├── code/
│           │   └── app/
│           │       └── main.py
│           └── src/
│               ├── __init__.py
│               ├── config_loader.py
│               └── logging_setup.py
│
├── 01_Modulerweiterungen/
│   ├── Planung/
│   │   ├── Architektur.md
│   │   └── (weitere Modul-Spezifikationen folgen)
│   ├── Entworfener_Code/
│   │   └── app/
│   │       └── src/
│   │           ├── logging_internal.py
│   │           └── logging_external.py
│   └── README.md
│
├── 02_API_Design_und_Kommunikation/
│   ├── Planung/
│   │   ├── API_Schnittstelle.md
│   │   ├── Kommunikationsprotokolle.md
│   │   └── Nachrichtenformate.md
│   ├── Entworfener_Code/
│   │   └── (API-Spezifikationen, JSON/YAML-Dateien, Tests)
│   └── README.md
│
├── 03_Router_und_Orchestrator/
│   ├── Planung/
│   │   ├── Router.md
│   │   ├── Routing_Logik.md
│   │   ├── Ereignissteuerung.md
│   │   └── Router_API_Integration.md
│   ├── Entworfener_Code/
│   │   └── (Router-Implementierungen, Skripte)
│   └── README.md
│
├── 04_Hauptagenten/
│   ├── Planung/
│   │   ├── StrategieAgent.md
│   │   ├── DenkerAgent.md
│   │   ├── BuilderAgent.md
│   │   ├── DiagrammAgent.md
│   │   ├── GedaechtnisAgent.md
│   │   └── Agenten_Logik_Vergleich.md
│   ├── Entworfener_Code/
│   │   └── (Agenten-Prototypen, Skripte, Konfigurationen)
│   └── README.md
│
├── 05_Hilfsagenten/
│   ├── Planung/
│   │   ├── MemoryManager.md
│   │   ├── WebResearchAgent.md
│   │   ├── EvaluatorAgent.md
│   │   ├── PolicyAgent.md
│   │   └── KommunikationsAgent.md
│   ├── Entworfener_Code/
│   │   └── (Hilfsagenten-Code, Datenmodule)
│   └── README.md
│
├── 06_Datenspeicher_und_Gedaechtnis/
│   ├── Planung/
│   │   ├── Speicherstruktur.md
│   │   ├── Projektkontext_Index.md
│   │   ├── Codebase_Indexierung.md
│   │   └── Zugriffssysteme.md
│   ├── Entworfener_Code/
│   │   └── (Implementierungen für Index/Embeddings/DB folgen)
│   └── README.md
│
├── 07_Workflow_und_Kommunikationsfluss/
│   ├── Planung/
│   │   ├── Workflow_Uebersicht.md
│   │   ├── Diagramme.md
│   │   └── Agenten_Fluss.md
│   ├── Entworfener_Code/
│   │   └── (Eventsteuerung, Workflow-Skripte)
│   └── README.md
│
├── 08_Builder_Autonomie/
│   ├── Planung/
│   │   ├── Builder_Prozess.md
│   │   ├── Testsysteme.md
│   │   ├── Dokumentationspipeline.md
│   │   └── Autonomie_Fluss.md
│   ├── Entworfener_Code/
│   │   └── (Builder-Agent Code, Testframeworks)
│   └── README.md
│
├── 09_Dokumentationssystem/
│   ├── Planung/
│   │   ├── HowTo_Generator.md
│   │   ├── API_Doku_Generator.md
│   │   └── Strukturkonzept.md
│   ├── Entworfener_Code/
│   │   └── (Dokumentationsgenerator, Skripte)
│   └── README.md
│
├── 10_Sicherheit_und_Policy/
│   ├── Planung/
│   │   ├── Datenschutz.md
│   │   ├── Compliance.md
│   │   └── Zugriffskontrolle.md
│   ├── Entworfener_Code/
│   │   └── (Policy-Module, Audit-Systeme)
│   └── README.md
│
├── 11_Infrastruktur/
│   ├── Planung/
│   │   ├── Deployment_Struktur.md
│   │   ├── Container_Setup.md
│   │   ├── Monitoring_System.md
│   │   └── Netzwerkarchitektur.md
│   ├── Entworfener_Code/
│   │   └── (Dockerfiles, Setup-Skripte)
│   └── README.md
│
└── 12_Zukunft_und_Erweiterungen/
    ├── Planung/
    │   ├── Neue_Modelle.md
    │   ├── CrossCluster_KI.md
    │   └── Lernsysteme.md
    ├── Entworfener_Code/
    │   └── (Prototypische Erweiterungen)
    └── README.md
```
---

## ⚙️ Arbeitsweise

1. **Planungsphase**  
   - Hier entsteht das Wissen, die Logik und die Struktur.  
   - Alles, was gedanklich erarbeitet oder modelliert wird, liegt in `/Planung/`.

2. **Implementierungsphase (KI-generiert)**  
   - Der Builder-Agent oder eine andere KI liest aus `/Planung/`.  
   - Sie erzeugt daraus Code, Tests und Dokumentation → legt alles in `/Entworfener_Code/` ab.

3. **Validierung & Rückkopplung**  
   - Wenn der Code funktioniert, kann der Builder-Agent automatisch  
     Planungsdokumente oder Diagramme in `/Planung/` aktualisieren.

---

## 🔗 Querverweise

Jeder Unterordner enthält am Ende seiner README:
```markdown
## Verweise
- [⬅ Zurück zur Hauptroadmap](../roadmap_readme.md)
- Nächster Schritt: [Router und Orchestrator](../03_Router_und_Orchestrator/README.md)
```
