203 lines
6.9 KiB
Markdown
203 lines
6.9 KiB
Markdown
# 🧭 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)
|
|
```
|